@ aragon- agent/ core (韩语)

可出版的 阿拉贡代理公司 引擎: 零对接, 依赖性注入 TypeScript代理运行时间 .

所需资源

• 节点.js 18 引擎依赖于全球 fetch 编号 : AbortController 被建入18+节点.
• 仅限无害环境管理 ——本包船为原生ES模块("type": "module") (中文(简体) ). 假设它与 import这不可能 require()- 从普通JS.
• 可选本地道具 —— 说 ajv 财务报告和审定财务报表 isolated-vm 为: optionalDependencies数字 : 软件包没有它们(使用了内置验证器倒置,并且 沙盒模块是懒载的). 安装 isolated-vm 只有使用 @aragon-agent/core/sandbox/* 代码代理沙盒.

安装

npm install @aragon-agent/core
# optional — only if you use the isolated-vm CodeAct sandbox:
npm install isolated-vm

ajv 财务报告和审定财务报表 isolated-vm 为: 可选依赖关系数字 :

• ajv ——工具参数校验器在出现时使用;内置倒计时 验证符以其他方式使用.
• isolated-vm ——仅供 @aragon-agent/core/sandbox/* 模块,其中 懒惰并从未从包根导入(isolated-vm 实值 与Electron's等一些嵌入式V8运行时不相容.

使用量

import { AragonAgent, getProviderRegistry, initProviders } from '@aragon-agent/core';

initProviders();

const agent = new AragonAgent({
  systemPrompt: 'You are a coding agent.',
  model: { providerId: 'anthropic', modelId: 'claude-...', baseUrl: '...' },
  tools: [],
  providerRegistry: getProviderRegistry(),
  getApiKey: () => process.env.ANTHROPIC_API_KEY,
});

await agent.prompt('Hello');

AragonAgent 是引擎的别名 Agent 课.

此片段的完整, 类型检查过的版本( 假工具 + 提供者设置)

• 代理人建造) examples/minimal.ts。 。 。 . 它只是编译( 从未点击过网络) , 也不属于已发布的 柏油弹.

入境点

构建

npm run build   # tsc → dist/*.js + *.d.ts
npm test        # vitest (smoke + public-api contract + no-host-coupling guard)

核查再利用

npm test 财务报告和审定财务报表 examples/minimal.ts 只证明软件包 编译改为: 证明已建 dist/ 其实是 运行 外部消费者:

npm run verify:dist   # build dist/, then run examples/consumer-smoke/run.mjs

run.mjs 导入此软件包 名称 (单位:千美元)@aragon-agent/core)通过 节点的 软件包自引用,所以节点解决它通过 package.json#exports → ./dist/index.js 一样 (exports map + NodeNext + .js extension) 外部工程路径 npm install @aragon-agent/core 点击量, 无 将软件包放入 node_modules输入离线 stub LLM 供应商, 运行一个 AragonAgent.prompt() 转向端到端(零网络), 并声称 exports 子路径在运行时全部解析 。 成功打印 [consumer-smoke] OK。 。 。 .

对于毫不含糊的"另一个工程安装并再利用它"检查(它也) 覆盖运行 无 选项 ajv 编号 : isolated-vm 道士,请看 包入新项目黄金核查 examples/consumer-smoke/README.md。 。 。 .

运行时间 公共- API 表面被冻结 src/__tests__/public-api.test.ts 并记录了人类在 API.md页:1 no-host-coupling 测试 使套件免去主机-repo进口和遗留品牌泄漏.

出版

此软件包会发布到 npm 的公众登记册中. 运行发行 软件包目录 因此软件包级别 prepublishOnly 钩火和一 新鲜 dist/ 构建 :

cd packages/core
npm run build                 # produce dist/
npm pack --dry-run --json     # inspect the tarball file list (no upload)
npm publish                   # publishConfig.access:"public" is baked in

(从 repo 根可以等量运行) npm publish -w packages/core. ) (中文(简体) )

注释:

• publishConfig.access 设置为 "public",所以没有 --access public 旗帜 要不然,范围化包将默认为有限/私人包.

• 出版账户必须拥有 @aragon-agent npm 范围/org 在此之前 第一次发表。 纵然如此 access:"public",在您范围内发布 403/404没有失败。 创建 @aragon-agent 在npmjs(或 切换到您的账户所拥有的范围,并相应重命名软件包.

• files 是负载的白名单. 归宿 .gitignore 忽略 dist/不过npm的 files: ["dist", "CHANGELOG.md"] 优先和 运出已建的输出。 不要"简化" files 字段,或 已公布的柏油球将空出 . npm pack --dry-run --json 应该永远 列表 dist/index.js。 。 。 .

• 仓库元数据指向 https://github.com/xdrshjr/AragonAgent。 。 。 .

  如果寄存器移动, 使用帮助脚本或更新 repository 编号 : homepage 编号 : bugs 发布前:

  node scripts/stamp-org.mjs <org>     # or: ARAGON_REPO_ORG=<org> node scripts/stamp-org.mjs
  node scripts/check-publishable.mjs   # exits non-zero if the placeholder remains in package.json
  

  prepublishOnly 运行 check-publishable.mjs 在建筑之前,任何出版 使用未标记的占位符的尝试是自动被硬锁的.

许可证

麻省理工学院.