@nexum-hub/agent 0.0.0-stage → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +129 -2
- package/contracts/v2/common.schema.json +262 -0
- package/contracts/v2/fixtures/inputs.json +244 -0
- package/contracts/v2/fixtures/wire.json +6493 -0
- package/contracts/v2/model/agent.close.input.schema.json +14 -0
- package/contracts/v2/model/agent.close.output.schema.json +101 -0
- package/contracts/v2/model/agent.list.input.schema.json +57 -0
- package/contracts/v2/model/agent.list.output.schema.json +220 -0
- package/contracts/v2/model/agent.open.input.schema.json +35 -0
- package/contracts/v2/model/agent.open.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
- package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
- package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
- package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
- package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
- package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
- package/contracts/v2/wire/bodies.schema.json +383 -0
- package/contracts/v2/wire/envelope.schema.json +2280 -0
- package/contracts/v2/wire/events.schema.json +242 -0
- package/contracts/v2/wire/maintenance.schema.json +308 -0
- package/contracts/v2/wire/operations.schema.json +1791 -0
- package/contracts/v2/wire/stream.schema.json +74 -0
- package/contracts/v2/wire/types.schema.json +2616 -0
- package/dist/adapters/mcp-http.d.ts +22 -0
- package/dist/adapters/mcp-http.js +472 -0
- package/dist/adapters/mcp-http.js.map +1 -0
- package/dist/adapters/mcp-oauth.d.ts +29 -0
- package/dist/adapters/mcp-oauth.js +653 -0
- package/dist/adapters/mcp-oauth.js.map +1 -0
- package/dist/adapters/mcp-wire.d.ts +21 -0
- package/dist/adapters/mcp-wire.js +307 -0
- package/dist/adapters/mcp-wire.js.map +1 -0
- package/dist/adapters/mcp.d.ts +56 -0
- package/dist/adapters/mcp.js +1989 -0
- package/dist/adapters/mcp.js.map +1 -0
- package/dist/adapters/openapi-http.d.ts +29 -0
- package/dist/adapters/openapi-http.js +504 -0
- package/dist/adapters/openapi-http.js.map +1 -0
- package/dist/adapters/openapi-request.d.ts +26 -0
- package/dist/adapters/openapi-request.js +597 -0
- package/dist/adapters/openapi-request.js.map +1 -0
- package/dist/adapters/openapi-schema.d.ts +22 -0
- package/dist/adapters/openapi-schema.js +471 -0
- package/dist/adapters/openapi-schema.js.map +1 -0
- package/dist/adapters/openapi-typegen.d.ts +11 -0
- package/dist/adapters/openapi-typegen.js +185 -0
- package/dist/adapters/openapi-typegen.js.map +1 -0
- package/dist/adapters/openapi-types.d.ts +99 -0
- package/dist/adapters/openapi-types.js +2 -0
- package/dist/adapters/openapi-types.js.map +1 -0
- package/dist/adapters/openapi.d.ts +7 -0
- package/dist/adapters/openapi.js +768 -0
- package/dist/adapters/openapi.js.map +1 -0
- package/dist/application/activation.d.ts +28 -0
- package/dist/application/activation.js +289 -0
- package/dist/application/activation.js.map +1 -0
- package/dist/application/attachments.d.ts +24 -0
- package/dist/application/attachments.js +87 -0
- package/dist/application/attachments.js.map +1 -0
- package/dist/application/authority.d.ts +32 -0
- package/dist/application/authority.js +213 -0
- package/dist/application/authority.js.map +1 -0
- package/dist/application/catalog.d.ts +11 -0
- package/dist/application/catalog.js +177 -0
- package/dist/application/catalog.js.map +1 -0
- package/dist/application/config.d.ts +24 -0
- package/dist/application/config.js +140 -0
- package/dist/application/config.js.map +1 -0
- package/dist/application/connection.d.ts +35 -0
- package/dist/application/connection.js +465 -0
- package/dist/application/connection.js.map +1 -0
- package/dist/application/data-plane.d.ts +35 -0
- package/dist/application/data-plane.js +437 -0
- package/dist/application/data-plane.js.map +1 -0
- package/dist/application/diagnostics.d.ts +4 -0
- package/dist/application/diagnostics.js +65 -0
- package/dist/application/diagnostics.js.map +1 -0
- package/dist/application/dispatcher.d.ts +4 -0
- package/dist/application/dispatcher.js +16 -0
- package/dist/application/dispatcher.js.map +1 -0
- package/dist/application/main.d.ts +12 -0
- package/dist/application/main.js +167 -0
- package/dist/application/main.js.map +1 -0
- package/dist/application/maintenance.d.ts +27 -0
- package/dist/application/maintenance.js +244 -0
- package/dist/application/maintenance.js.map +1 -0
- package/dist/application/packages.d.ts +25 -0
- package/dist/application/packages.js +208 -0
- package/dist/application/packages.js.map +1 -0
- package/dist/application/processes.d.ts +49 -0
- package/dist/application/processes.js +180 -0
- package/dist/application/processes.js.map +1 -0
- package/dist/application/run-view.d.ts +17 -0
- package/dist/application/run-view.js +286 -0
- package/dist/application/run-view.js.map +1 -0
- package/dist/application/runtime.d.ts +78 -0
- package/dist/application/runtime.js +1747 -0
- package/dist/application/runtime.js.map +1 -0
- package/dist/application/tasks.d.ts +38 -0
- package/dist/application/tasks.js +23 -0
- package/dist/application/tasks.js.map +1 -0
- package/dist/application/user-state.d.ts +20 -0
- package/dist/application/user-state.js +52 -0
- package/dist/application/user-state.js.map +1 -0
- package/dist/application/work-git.d.ts +14 -0
- package/dist/application/work-git.js +67 -0
- package/dist/application/work-git.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +40 -0
- package/dist/cli.js.map +1 -0
- package/dist/contracts/caller.d.ts +51 -0
- package/dist/contracts/caller.js +95 -0
- package/dist/contracts/caller.js.map +1 -0
- package/dist/contracts/error-data.d.ts +6 -0
- package/dist/contracts/error-data.js +51 -0
- package/dist/contracts/error-data.js.map +1 -0
- package/dist/contracts/errors.d.ts +10 -0
- package/dist/contracts/errors.js +28 -0
- package/dist/contracts/errors.js.map +1 -0
- package/dist/contracts/json.d.ts +9 -0
- package/dist/contracts/json.js +104 -0
- package/dist/contracts/json.js.map +1 -0
- package/dist/contracts/types.d.ts +122 -0
- package/dist/contracts/types.js +19 -0
- package/dist/contracts/types.js.map +1 -0
- package/dist/contracts/validation.d.ts +4 -0
- package/dist/contracts/validation.js +157 -0
- package/dist/contracts/validation.js.map +1 -0
- package/dist/contracts/wire-validation.d.ts +9 -0
- package/dist/contracts/wire-validation.js +399 -0
- package/dist/contracts/wire-validation.js.map +1 -0
- package/dist/contracts/wire.d.ts +1083 -0
- package/dist/contracts/wire.js +62 -0
- package/dist/contracts/wire.js.map +1 -0
- package/dist/extension-api.d.ts +12 -0
- package/dist/extension-api.js +2 -0
- package/dist/extension-api.js.map +1 -0
- package/dist/extensions/api.d.ts +72 -0
- package/dist/extensions/api.js +2 -0
- package/dist/extensions/api.js.map +1 -0
- package/dist/extensions/host-requests.d.ts +23 -0
- package/dist/extensions/host-requests.js +60 -0
- package/dist/extensions/host-requests.js.map +1 -0
- package/dist/extensions/materials.d.ts +37 -0
- package/dist/extensions/materials.js +691 -0
- package/dist/extensions/materials.js.map +1 -0
- package/dist/extensions/package-loader.d.ts +28 -0
- package/dist/extensions/package-loader.js +177 -0
- package/dist/extensions/package-loader.js.map +1 -0
- package/dist/extensions/packages.d.ts +73 -0
- package/dist/extensions/packages.js +441 -0
- package/dist/extensions/packages.js.map +1 -0
- package/dist/extensions/registry.d.ts +92 -0
- package/dist/extensions/registry.js +1540 -0
- package/dist/extensions/registry.js.map +1 -0
- package/dist/extensions/resources.d.ts +105 -0
- package/dist/extensions/resources.js +595 -0
- package/dist/extensions/resources.js.map +1 -0
- package/dist/extensions/state.d.ts +25 -0
- package/dist/extensions/state.js +10 -0
- package/dist/extensions/state.js.map +1 -0
- package/dist/extensions/transfer.d.ts +81 -0
- package/dist/extensions/transfer.js +16 -0
- package/dist/extensions/transfer.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/maintenance/configuration.d.ts +79 -0
- package/dist/maintenance/configuration.js +1503 -0
- package/dist/maintenance/configuration.js.map +1 -0
- package/dist/maintenance/credentials.d.ts +23 -0
- package/dist/maintenance/credentials.js +177 -0
- package/dist/maintenance/credentials.js.map +1 -0
- package/dist/maintenance/files.d.ts +2 -0
- package/dist/maintenance/files.js +40 -0
- package/dist/maintenance/files.js.map +1 -0
- package/dist/maintenance/npm.d.ts +71 -0
- package/dist/maintenance/npm.js +1013 -0
- package/dist/maintenance/npm.js.map +1 -0
- package/dist/maintenance/oauth.d.ts +45 -0
- package/dist/maintenance/oauth.js +686 -0
- package/dist/maintenance/oauth.js.map +1 -0
- package/dist/maintenance/requests.d.ts +347 -0
- package/dist/maintenance/requests.js +959 -0
- package/dist/maintenance/requests.js.map +1 -0
- package/dist/maintenance/work-git.d.ts +29 -0
- package/dist/maintenance/work-git.js +776 -0
- package/dist/maintenance/work-git.js.map +1 -0
- package/dist/process/backend.d.ts +54 -0
- package/dist/process/backend.js +39 -0
- package/dist/process/backend.js.map +1 -0
- package/dist/process/environment-windows.d.ts +15 -0
- package/dist/process/environment-windows.js +151 -0
- package/dist/process/environment-windows.js.map +1 -0
- package/dist/process/environment.d.ts +28 -0
- package/dist/process/environment.js +410 -0
- package/dist/process/environment.js.map +1 -0
- package/dist/process/launch.d.ts +31 -0
- package/dist/process/launch.js +281 -0
- package/dist/process/launch.js.map +1 -0
- package/dist/process/managed.d.ts +36 -0
- package/dist/process/managed.js +459 -0
- package/dist/process/managed.js.map +1 -0
- package/dist/process/output-log.d.ts +50 -0
- package/dist/process/output-log.js +552 -0
- package/dist/process/output-log.js.map +1 -0
- package/dist/process/pipes.d.ts +16 -0
- package/dist/process/pipes.js +588 -0
- package/dist/process/pipes.js.map +1 -0
- package/dist/process/pty.d.ts +22 -0
- package/dist/process/pty.js +512 -0
- package/dist/process/pty.js.map +1 -0
- package/dist/process/windows-conout-worker.d.ts +1 -0
- package/dist/process/windows-conout-worker.js +90 -0
- package/dist/process/windows-conout-worker.js.map +1 -0
- package/dist/process/windows-conout.d.ts +46 -0
- package/dist/process/windows-conout.js +140 -0
- package/dist/process/windows-conout.js.map +1 -0
- package/dist/process/windows-helper.d.ts +43 -0
- package/dist/process/windows-helper.js +255 -0
- package/dist/process/windows-helper.js.map +1 -0
- package/dist/process/windows-job.d.ts +39 -0
- package/dist/process/windows-job.js +224 -0
- package/dist/process/windows-job.js.map +1 -0
- package/dist/process/windows-pipes.d.ts +16 -0
- package/dist/process/windows-pipes.js +475 -0
- package/dist/process/windows-pipes.js.map +1 -0
- package/dist/results/artifacts.d.ts +118 -0
- package/dist/results/artifacts.js +873 -0
- package/dist/results/artifacts.js.map +1 -0
- package/dist/results/encoder.d.ts +57 -0
- package/dist/results/encoder.js +1179 -0
- package/dist/results/encoder.js.map +1 -0
- package/dist/results/mcp.d.ts +95 -0
- package/dist/results/mcp.js +656 -0
- package/dist/results/mcp.js.map +1 -0
- package/dist/results/media.d.ts +19 -0
- package/dist/results/media.js +301 -0
- package/dist/results/media.js.map +1 -0
- package/dist/results/normalize.d.ts +29 -0
- package/dist/results/normalize.js +464 -0
- package/dist/results/normalize.js.map +1 -0
- package/dist/runtime/control-scripts.d.ts +23 -0
- package/dist/runtime/control-scripts.js +242 -0
- package/dist/runtime/control-scripts.js.map +1 -0
- package/dist/runtime/engine.d.ts +177 -0
- package/dist/runtime/engine.js +1159 -0
- package/dist/runtime/engine.js.map +1 -0
- package/dist/runtime/globals.d.ts +1 -0
- package/dist/runtime/globals.js +31 -0
- package/dist/runtime/globals.js.map +1 -0
- package/dist/runtime/material-retention.d.ts +34 -0
- package/dist/runtime/material-retention.js +671 -0
- package/dist/runtime/material-retention.js.map +1 -0
- package/dist/runtime/modules.d.ts +50 -0
- package/dist/runtime/modules.js +320 -0
- package/dist/runtime/modules.js.map +1 -0
- package/dist/runtime/names.d.ts +2 -0
- package/dist/runtime/names.js +22 -0
- package/dist/runtime/names.js.map +1 -0
- package/dist/runtime/operations.d.ts +20 -0
- package/dist/runtime/operations.js +137 -0
- package/dist/runtime/operations.js.map +1 -0
- package/dist/runtime/paths.d.ts +3 -0
- package/dist/runtime/paths.js +38 -0
- package/dist/runtime/paths.js.map +1 -0
- package/dist/runtime/promises.d.ts +9 -0
- package/dist/runtime/promises.js +78 -0
- package/dist/runtime/promises.js.map +1 -0
- package/dist/runtime/retention.d.ts +88 -0
- package/dist/runtime/retention.js +735 -0
- package/dist/runtime/retention.js.map +1 -0
- package/dist/runtime/run-log.d.ts +30 -0
- package/dist/runtime/run-log.js +207 -0
- package/dist/runtime/run-log.js.map +1 -0
- package/dist/runtime/scripts.d.ts +84 -0
- package/dist/runtime/scripts.js +387 -0
- package/dist/runtime/scripts.js.map +1 -0
- package/dist/runtime/tasks.d.ts +54 -0
- package/dist/runtime/tasks.js +290 -0
- package/dist/runtime/tasks.js.map +1 -0
- package/dist/sdk/maintenance.d.ts +3 -0
- package/dist/sdk/maintenance.js +80 -0
- package/dist/sdk/maintenance.js.map +1 -0
- package/dist/sdk/output-extension.d.ts +3 -0
- package/dist/sdk/output-extension.js +44 -0
- package/dist/sdk/output-extension.js.map +1 -0
- package/dist/sdk/output.d.ts +52 -0
- package/dist/sdk/output.js +350 -0
- package/dist/sdk/output.js.map +1 -0
- package/dist/sdk/runtime.d.ts +3 -0
- package/dist/sdk/runtime.js +26 -0
- package/dist/sdk/runtime.js.map +1 -0
- package/dist/sdk/sh.d.ts +3 -0
- package/dist/sdk/sh.js +384 -0
- package/dist/sdk/sh.js.map +1 -0
- package/dist/sdk/state.d.ts +2 -0
- package/dist/sdk/state.js +69 -0
- package/dist/sdk/state.js.map +1 -0
- package/dist/sdk/transfer.d.ts +3 -0
- package/dist/sdk/transfer.js +141 -0
- package/dist/sdk/transfer.js.map +1 -0
- package/dist/services/extensions.d.ts +19 -0
- package/dist/services/extensions.js +183 -0
- package/dist/services/extensions.js.map +1 -0
- package/dist/services/state.d.ts +37 -0
- package/dist/services/state.js +125 -0
- package/dist/services/state.js.map +1 -0
- package/dist/services/transfer.d.ts +86 -0
- package/dist/services/transfer.js +948 -0
- package/dist/services/transfer.js.map +1 -0
- package/dist/storage/schema.d.ts +8 -0
- package/dist/storage/schema.js +241 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/sqlite.d.ts +241 -0
- package/dist/storage/sqlite.js +1855 -0
- package/dist/storage/sqlite.js.map +1 -0
- package/dist/storage/transfers.d.ts +90 -0
- package/dist/storage/transfers.js +2 -0
- package/dist/storage/transfers.js.map +1 -0
- package/dist/transfer/io.d.ts +74 -0
- package/dist/transfer/io.js +425 -0
- package/dist/transfer/io.js.map +1 -0
- package/dist/transfer/offers.d.ts +72 -0
- package/dist/transfer/offers.js +380 -0
- package/dist/transfer/offers.js.map +1 -0
- package/dist/transfer/stream-slots.d.ts +12 -0
- package/dist/transfer/stream-slots.js +28 -0
- package/dist/transfer/stream-slots.js.map +1 -0
- package/dist/work/catalog.d.ts +43 -0
- package/dist/work/catalog.js +198 -0
- package/dist/work/catalog.js.map +1 -0
- package/dist/work/discovery.d.ts +70 -0
- package/dist/work/discovery.js +465 -0
- package/dist/work/discovery.js.map +1 -0
- package/dist/work/service.d.ts +83 -0
- package/dist/work/service.js +703 -0
- package/dist/work/service.js.map +1 -0
- package/package.json +66 -4
package/README.md
CHANGED
|
@@ -1,3 +1,130 @@
|
|
|
1
|
-
#
|
|
1
|
+
# NexumAgent
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Nexum 的独立、公开 TypeScript Agent 项目。它是运行在用户本地系统的 Agent,面向多种 AI Host 与 Agent Runtime;与 Nexum Cloud 分仓维护,可通过 Git Submodule 被主仓库引用。
|
|
4
|
+
|
|
5
|
+
## 当前状态
|
|
6
|
+
|
|
7
|
+
**正在实现可编程运行时,整体验收尚未完成。** 当前 CLI 支持 `--help`、`--version` 及明确选择 profile 的 `run --profile development|production`;连接与运行入口已接线,不能据此宣称完整版本已交付。已实现的内部基础包括:
|
|
8
|
+
|
|
9
|
+
- `contracts/v2` 的八个工具输入/输出 Schema、可信 wire envelope、独立数据面描述及跨 TS/Go 正反例,以及独立 Draft 7 脚本入参校验;
|
|
10
|
+
- 原生 SQLite 的绑定/迁移、运行接纳与去重、输入单次消费、工作关闭、后台资源交接、历史筛选、共享值条件写入/删除及重启中断;共享值删除后保留版本序列,避免旧读取版本误写重建值;
|
|
11
|
+
- 独立 JavaScript 作用域、编译与调用分离、动态 import/require、Node/npm 准入、原生 ESM/CJS 条件、显式文件模块与缓存换版检查;
|
|
12
|
+
- `.js` JSON 头部、自动收录/冲突检查、来源命名空间与手册生成、默认 30 项和高频 Top 20 的完整定义选择;
|
|
13
|
+
- 独立于观察请求的运行协调、代码/输入快照、同次执行的单次输入续接、协作取消/总期限、历史重放和结果保存边界;
|
|
14
|
+
- 个人、Agent 和项目指令与 Skills 发现、项目 visibility 过滤、README 摘要、工作资料的创建/串行刷新/关闭及固定快照,以及按修订保存的脚本/npm 手册;
|
|
15
|
+
- 扩展实例/运行绑定的资源登记、身份去重、当前授权、后台交接及信号解除;运行终态等待真实 `closed` 证据,清理尝试有界,失败与未确认项保留在本地记录中;
|
|
16
|
+
- 公共扩展工厂、方法注册/发布、调用上下文与权限检查,以及初始化失败清理、占用保护、停用和脚本来源 lease;
|
|
17
|
+
- SDK operation 持久登记、原生 Promise 拒绝归属及真实结算收尾,未 `await` 的受管调用同样阻止运行提前结束,普通同步值和二进制对象不经过 JSON 转换;
|
|
18
|
+
- 使用同一扩展协议注册的 `runtime.requestInput`、`state.agent/user` 和 `output` 门面;状态服务按方法声明及当前 key 权限绑定,用户范围通过独立 Cloud authority 接口访问;
|
|
19
|
+
- `output` 的文本、JSON、图片、音频、资源链接、嵌入资源和混合结果意图包装,以及受预算约束的 JS 值规范化和 Agent 本地结果编码;
|
|
20
|
+
- `work/resources` 的原子登记、固定内容与 SHA-256、目录分页/当前权限、真实流关闭、到期/丢失反馈,以及标准 MCP 内容构建和 Resources 的 `text/blob` 正文;保存结果只含规范化数据和资源身份,媒体 bytes 在授权交付时读取。
|
|
21
|
+
- 受管 `sh/transfer`、npm 扩展加载与五类贡献整体发布、MCP Tasks/Host 请求/订阅和 OpenAPI 适配、维护请求及 npm 执行组件;
|
|
22
|
+
- WSS 身份绑定、短期授权、HTTP 数据面、多附件、README 更新及应用组合入口,以及从实际源码生成的独立公开类型包 `@nexum-hub/sdk`。
|
|
23
|
+
|
|
24
|
+
以上是待整体验收的开发快照。MCP/API 配置与 OAuth、用户共享数据的 Cloud authority、远端资源投影、Task 保护、清理器及安装脚本已有实现;真实链路、配额边界、原生服务与三平台支持仍须按最终源码分别验证。Console 进程控制和 MCP Apps 尚未完整承接,不能宣称所有 AI Host 特性已交付。媒体验证覆盖格式、尺寸/时长和有界 metadata,不声明已完整解码所有像素、动画帧或音频样本。Node VM 用于执行作用域,系统安全由目标 OS/容器负责,不提供恶意代码安全沙箱。
|
|
25
|
+
|
|
26
|
+
此仓库不包含 Nexum Cloud 的私有代码、配置、Token 或生产部署资源。
|
|
27
|
+
|
|
28
|
+
## 文档
|
|
29
|
+
|
|
30
|
+
[Nexum browser 完整设计与验收资料](docs/browser/README.md)包含 SDK、类型、插件连接、生命周期、结果、独立 npm 包和逐项验收,以及 Avru/原始接口资料的本地归档。[可选包候选实现](packages/browser/README.md)已开始实现并进行组件测试,不作为 Agent 默认依赖或默认安装项;完整能力、原生浏览器验收和发行尚未完成。
|
|
31
|
+
|
|
32
|
+
## npm 开发版发布
|
|
33
|
+
|
|
34
|
+
本仓库的 npm 目标包为 `@nexum-hub/agent`、`@nexum-hub/sdk` 和可选的 `@nexum-hub/browser`;首次统一发行版本为 **`0.0.1`**,验证期仍使用 npm `next` 分发标签,不预先标记稳定版 `latest`。发布入口为手动触发的 GitHub Actions `npm-next.yml`,依次选择 SDK → Agent → Browser,并固定只从 `main` 发行。三包当前标记 `UNLICENSED`,公开可安装不等于开源授权。已发布的 `@nexum-hub/sdk@0.0.1-next.0` 作为历史版本保留,不覆盖或重发。
|
|
35
|
+
|
|
36
|
+
**首次 npm 发布需要 `@nexum-hub` scope 的真实发布权限。** 可在 GitHub 仓库 Secrets 临时设置有对应包权限的 `NPM_PUBLISH_TOKEN` 进行首发;首发成功后为三个包分别配置 GitHub Trusted Publisher:仓库 `bYiyLi/NexumAgent`、工作流文件 `npm-next.yml`,允许 `npm publish`,然后删除该临时 Secret。后续 CI 使用 OIDC,无需长期 npm Token。Token、OTP 和用户配置不能进入仓库或输出日志。
|
|
37
|
+
|
|
38
|
+
Agent 的 `nexum-agent` CLI 命令名称保留;npm 分发不意味着已注册系统用户服务或完成三平台安装验收。是否真正发布以 npm Registry 的版本和 dist-tag 为准。
|
|
39
|
+
|
|
40
|
+
## 本地开发
|
|
41
|
+
|
|
42
|
+
需要 Node.js 24.22.1(当前验证基线)、pnpm 10.34.5:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
pnpm install --frozen-lockfile
|
|
46
|
+
pnpm check
|
|
47
|
+
pnpm build
|
|
48
|
+
node dist/cli.js --help
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
`pnpm check` 执行 TypeScript 类型检查、构建及 Node 内置测试,测试进程带 `--experimental-vm-modules`。GitHub Actions 配置 Linux、macOS、Windows 的原生 Node 检查矩阵;实际通过状态以对应提交的运行结果为准。
|
|
52
|
+
|
|
53
|
+
## owner 的保留与容量配置
|
|
54
|
+
|
|
55
|
+
owner 可直接在所选 profile 的 `config.json` 中添加可选 `storage` 和 `retention`;不增加另一个配置文件或脚本 SDK。development 使用 `~/.nexum-dev/config.json`,production 使用 `~/.nexum/config.json`。保留原有 `server_url` 和 `token`,配置只由该本地账户读取,不要把完整文件交给 AI 或提交到仓库。
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"storage": { "max_managed_bytes": 21474836480 },
|
|
60
|
+
"retention": {
|
|
61
|
+
"work_idle_ms": 86400000,
|
|
62
|
+
"run_history_ms": 2592000000,
|
|
63
|
+
"run_logs_ms": 604800000,
|
|
64
|
+
"input_attachments_ms": 86400000,
|
|
65
|
+
"artifact_ms": 604800000,
|
|
66
|
+
"material_copies_ms": 604800000
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
上例是要合并进现有配置的字段,数值为默认值;字节和毫秒均使用正安全整数,生成的到期日期必须处于协议支持的 RFC 3339 范围(不超过 9999 年),未知字段会被拒绝。省略这些配置继续使用默认策略。配置在下次正常启动时读取,新保留策略只用于新对象;已有记录、产物和 Task 的原保留承诺继续有效。缩短新对象的期限不会提前删除旧对象;容量限制覆盖受管数据,不覆盖依赖包、用户项目或任意 Node/sh 写入。更新安装器默认逐字保留已有配置,明确替换配置时才采用新的内容。
|
|
72
|
+
|
|
73
|
+
## 运行日志
|
|
74
|
+
|
|
75
|
+
每个运行的 console 输出保存在当前 profile 的 `logs/runs/<runId>/console.log`,文件滚动保留最新内容,包含首行在内最多 50 MiB。它使用原生 Node 文件及流能力,按实际增长申请受管容量;运行终态等待已接纳的写入真正完成。
|
|
76
|
+
|
|
77
|
+
日志是 UTF-8 文本,首行 `NEXUM_RUN_LOG_V1` 后的 JSON 记录原日志流的 `startOffset/endOffset`,后续为 console 正文。`agent.run.get` 只返回有界预览;发生裁剪或预览不完整时,返回保留范围、实际文件位置及 `dataOffset/nextOffset`,可以通过获准 Node 文件能力继续读取。活跃日志再次滚动后须重新核对范围。旧版本保留的普通文本日志继续可读;丢失或被外部改写的文件明确报告不可用。
|
|
78
|
+
|
|
79
|
+
## 仓库关系
|
|
80
|
+
|
|
81
|
+
- 此仓库拥有 Agent 的源码、独立 Git 历史、构建与未来发布流程。
|
|
82
|
+
- Nexum Cloud 仓库只引用本仓库的固定提交,不复制源码或隐式追踪最新主分支。
|
|
83
|
+
- 接口和生命周期沿已确定的可编程 Agent 设计实施;脚本不直接访问内部数据库或管理对象。
|
|
84
|
+
|
|
85
|
+
## 许可
|
|
86
|
+
|
|
87
|
+
代码仓库公开可见;目前尚未确定开源许可证。在正式确定许可证前,不对外授予额外的复用权利。
|
|
88
|
+
|
|
89
|
+
## 本地安装候选与原生用户服务
|
|
90
|
+
|
|
91
|
+
安装组件使用固定 Node `24.22.1`、`--experimental-vm-modules` 和明确的 `run --profile development|production`。macOS 使用用户 LaunchAgent,Linux 使用 `systemd --user`,Windows 使用当前用户 `InteractiveToken` 任务。它们不提权、不保存用户密码;登录会话与无人登录启动不同,安装器不会自动启用 Linux linger。Windows 任务负责登录启动与启停,启动器以原生 Job 约束自身及继承的进程树,任务退出时由系统关闭 Job,避免只停启动器而留下 Node。现有启动器对 Agent 非零退出每次等待 10 秒、至多重试 255 次;退出 0 立即停止,不能仅靠 Task Scheduler 的启动失败重试承诺程序退出后重启。正式 Agent 诊断统一写入 profile 内有界的 `logs/agent.log`;macOS LaunchAgent 将 stdout/stderr 指向 `/dev/null`,避免重复生成无界服务日志。Linux stdout/stderr 由 journald 管理,Windows 任务不另写服务日志。
|
|
92
|
+
|
|
93
|
+
公开扩展类型由单一源码生成,不需要把 Agent 的运行服务安装到扩展项目中:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
node scripts/build-extension-api.mjs
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
`packages/extension-api` 的本地 npm 包只包含生成的声明、空 ESM 入口和说明;没有私有 Core manager、Agent 初始化或凭据。当前尚未发布到 npm。
|
|
100
|
+
|
|
101
|
+
创建本机平台的安装候选时,需要独立提供 Ed25519 私钥;不要把私钥放进源码、产物目录或 CI artifact:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
pnpm run build:candidate \
|
|
105
|
+
--out-dir /absolute/candidate-output \
|
|
106
|
+
--signing-key-file /absolute/private-release-key.pem
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
构建在隔离目录编译,按锁文件准备实际生产依赖,包含固定 Node/npm,并检查 `node-pty`、`koffi` 能在本平台加载。输出为平台归档、整个归档的 SHA-256、独立签名和单独可审阅的 `installer-kit`。首次 bootstrap 运行 kit 中的脚本,不从尚未验证的程序归档中提取并执行验证器。Agent 的 browser 资料归档、测试、本机 state/log/config/tmp 不进入程序归档;不同 OS/架构不能共用一份原生依赖产物。
|
|
110
|
+
|
|
111
|
+
安装前,从独立可信渠道取得发布者公钥及预期 digest。安装器不信任归档或 manifest 自带的公钥,也不会先执行归档里的 Node 进行自证。完整安装脚本位于 `scripts/install.sh`、`scripts/install.ps1`,它们先按内置官方 SHA-256 校验 bootstrap Node。已有可信的固定版本 Node 时,也可直接运行下列入口:
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
node scripts/install-agent.mjs \
|
|
115
|
+
--archive /absolute/nexum-agent-platform.tar.gz \
|
|
116
|
+
--sha256 EXPECTED_SHA256 \
|
|
117
|
+
--signature-file /absolute/nexum-agent-platform.tar.gz.sig \
|
|
118
|
+
--public-key-file /absolute/independently-trusted-public.pem \
|
|
119
|
+
--profile development
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
首次安装通过标准输入提供包含 `server_url`、`token` 的 JSON;不要把 Token 放进 argv、服务定义或日志。production 要求 HTTPS;development 使用自己的 Server URL 与 `~/.nexum-dev`。配置写入所选 profile 的私有 `config.json`。默认注册并请求启动当前用户服务,`--no-start` 只安装/启用持久定义而不立即启动,`--no-register` 仅准备程序和可检查的 manifest。临时 home 只允许与 `--no-register` 一起使用,供隔离验证。
|
|
123
|
+
|
|
124
|
+
再次安装新签名归档会保留配置;若明确替换凭据,需要 `--replace-config` 并重新从标准输入提供配置。程序先验签并固定到私有副本,校验平台与完整内容后,才停止旧服务、切换版本和请求启动。命令失败或结果未知时,先检查真实服务及版本状态,不盲目重放更新。
|
|
125
|
+
|
|
126
|
+
已有选定版本时,`--no-register` 只准备新程序与独立预览,保留原 `active.json`、配置及服务启动文件;它不能与更换既有配置混用。Windows 预览使用单独的 `service-preview-launch.ps1`,不会改变原任务下次启动的目标。清理仍保护原选定版本;正式切换需执行常规安装更新。
|
|
127
|
+
|
|
128
|
+
选定程序目录下的 `scripts/service.mjs` 提供 `install/start/stop/status/remove --profile ...`。`stop` 同时关闭以后自动启动;`start` 重新启用。退出码 `0` 停止,不自动重启;需要重启使用 `75`,其它非零故障按各平台的有界策略重启,Windows 沿上面的任务及启动器分工。安装入口的 `--cleanup --profile ...` 只清理有安装凭据且不再 active 的旧程序版本,不删除工作资料、运行记录或凭据,不执行旧 Node,也不接管旧 PID。
|
|
129
|
+
|
|
130
|
+
`Agent install candidates` 是手动触发的三平台候选构建、临时安装与原生用户服务生命周期工作流。服务测试使用临时 home 和含路径 hash 的唯一标签,实际验证 0/75/故障退出、停止、恢复及注销,不使用真实用户的 Agent profile;Linux 仅在受守卫的 GitHub-hosted 临时 runner 中按需准备当前 UID 的 user manager,不启用 linger,不启动第二个 manager,也不退出已有 manager。其中签名密钥为一次性测试身份,不能当作正式发布信任锚。`Optional browser package` 独立检查可选包,不成为 Agent 默认安装或测试的依赖。这些工作流定义不代表对应提交已经 CI 通过,也不代表用户服务的真实登录、登出、重启和上线已完成验收。
|
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://schemas.nexum.local/agent/v2/common.schema.json",
|
|
4
|
+
"$defs": {
|
|
5
|
+
"id": {
|
|
6
|
+
"type": "string",
|
|
7
|
+
"minLength": 1,
|
|
8
|
+
"maxLength": 256
|
|
9
|
+
},
|
|
10
|
+
"waitMs": {
|
|
11
|
+
"type": "integer",
|
|
12
|
+
"minimum": 0,
|
|
13
|
+
"maximum": 30000
|
|
14
|
+
},
|
|
15
|
+
"limit": {
|
|
16
|
+
"type": "integer",
|
|
17
|
+
"minimum": 1,
|
|
18
|
+
"maximum": 100
|
|
19
|
+
},
|
|
20
|
+
"cursor": {
|
|
21
|
+
"type": "string",
|
|
22
|
+
"minLength": 1,
|
|
23
|
+
"maxLength": 4096
|
|
24
|
+
},
|
|
25
|
+
"time": {
|
|
26
|
+
"type": "string",
|
|
27
|
+
"format": "date-time"
|
|
28
|
+
},
|
|
29
|
+
"requestId": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"pattern": "^req_[0-9]{13}_[0-9a-f]{32}$"
|
|
32
|
+
},
|
|
33
|
+
"status": {
|
|
34
|
+
"enum": [
|
|
35
|
+
"accepted",
|
|
36
|
+
"preparing_inputs",
|
|
37
|
+
"running",
|
|
38
|
+
"waiting_input",
|
|
39
|
+
"cancelling",
|
|
40
|
+
"succeeded",
|
|
41
|
+
"failed",
|
|
42
|
+
"cancelled",
|
|
43
|
+
"interrupted"
|
|
44
|
+
]
|
|
45
|
+
},
|
|
46
|
+
"error": {
|
|
47
|
+
"type": "object",
|
|
48
|
+
"properties": {
|
|
49
|
+
"code": {
|
|
50
|
+
"type": "string",
|
|
51
|
+
"minLength": 1,
|
|
52
|
+
"maxLength": 256
|
|
53
|
+
},
|
|
54
|
+
"message": {
|
|
55
|
+
"type": "string",
|
|
56
|
+
"maxLength": 4096
|
|
57
|
+
},
|
|
58
|
+
"details": {
|
|
59
|
+
"type": "object"
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
"required": ["code", "message"],
|
|
63
|
+
"additionalProperties": false
|
|
64
|
+
},
|
|
65
|
+
"hostAttachment": {
|
|
66
|
+
"oneOf": [
|
|
67
|
+
{
|
|
68
|
+
"type": "object",
|
|
69
|
+
"properties": {
|
|
70
|
+
"file_id": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"minLength": 1,
|
|
73
|
+
"maxLength": 256
|
|
74
|
+
},
|
|
75
|
+
"download_url": {
|
|
76
|
+
"type": "string",
|
|
77
|
+
"minLength": 1,
|
|
78
|
+
"maxLength": 8192
|
|
79
|
+
},
|
|
80
|
+
"file_name": {
|
|
81
|
+
"type": "string",
|
|
82
|
+
"maxLength": 1024
|
|
83
|
+
},
|
|
84
|
+
"mime_type": {
|
|
85
|
+
"type": "string",
|
|
86
|
+
"maxLength": 256
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"required": ["file_id", "download_url"],
|
|
90
|
+
"additionalProperties": false
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"type": "object",
|
|
94
|
+
"properties": {
|
|
95
|
+
"uri": {
|
|
96
|
+
"type": "string",
|
|
97
|
+
"minLength": 1,
|
|
98
|
+
"maxLength": 4096
|
|
99
|
+
}
|
|
100
|
+
},
|
|
101
|
+
"required": ["uri"],
|
|
102
|
+
"additionalProperties": false
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"type": "object",
|
|
106
|
+
"properties": {
|
|
107
|
+
"transferId": {
|
|
108
|
+
"type": "string",
|
|
109
|
+
"minLength": 1,
|
|
110
|
+
"maxLength": 256
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
"required": ["transferId"],
|
|
114
|
+
"additionalProperties": false
|
|
115
|
+
}
|
|
116
|
+
]
|
|
117
|
+
},
|
|
118
|
+
"attachments": {
|
|
119
|
+
"type": "array",
|
|
120
|
+
"maxItems": 20,
|
|
121
|
+
"items": {
|
|
122
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/hostAttachment"
|
|
123
|
+
}
|
|
124
|
+
},
|
|
125
|
+
"caller": {
|
|
126
|
+
"oneOf": [
|
|
127
|
+
{
|
|
128
|
+
"type": "object",
|
|
129
|
+
"properties": {
|
|
130
|
+
"principalId": {
|
|
131
|
+
"type": "string",
|
|
132
|
+
"minLength": 1,
|
|
133
|
+
"maxLength": 256
|
|
134
|
+
},
|
|
135
|
+
"clientId": {
|
|
136
|
+
"type": "string",
|
|
137
|
+
"minLength": 1,
|
|
138
|
+
"maxLength": 256
|
|
139
|
+
},
|
|
140
|
+
"host": {
|
|
141
|
+
"type": "string",
|
|
142
|
+
"maxLength": 256
|
|
143
|
+
},
|
|
144
|
+
"model": {
|
|
145
|
+
"type": "string",
|
|
146
|
+
"maxLength": 256
|
|
147
|
+
},
|
|
148
|
+
"hostRef": {
|
|
149
|
+
"type": "string",
|
|
150
|
+
"minLength": 1,
|
|
151
|
+
"maxLength": 256
|
|
152
|
+
},
|
|
153
|
+
"hostCapabilities": {
|
|
154
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/hostCapabilities"
|
|
155
|
+
},
|
|
156
|
+
"hostFeatures": {
|
|
157
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/hostFeatures"
|
|
158
|
+
},
|
|
159
|
+
"source": {
|
|
160
|
+
"const": "mcp"
|
|
161
|
+
},
|
|
162
|
+
"grantId": {
|
|
163
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/id"
|
|
164
|
+
}
|
|
165
|
+
},
|
|
166
|
+
"required": ["principalId", "clientId"],
|
|
167
|
+
"additionalProperties": false,
|
|
168
|
+
"dependentRequired": {
|
|
169
|
+
"hostRef": ["hostCapabilities"],
|
|
170
|
+
"hostCapabilities": ["hostRef"],
|
|
171
|
+
"hostFeatures": ["hostRef", "hostCapabilities"]
|
|
172
|
+
}
|
|
173
|
+
},
|
|
174
|
+
{
|
|
175
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/ownerSessionCaller"
|
|
176
|
+
}
|
|
177
|
+
]
|
|
178
|
+
},
|
|
179
|
+
"hostFeatures": {
|
|
180
|
+
"type": "object",
|
|
181
|
+
"properties": {
|
|
182
|
+
"sampling": {
|
|
183
|
+
"type": "object",
|
|
184
|
+
"properties": {
|
|
185
|
+
"context": {
|
|
186
|
+
"type": "object"
|
|
187
|
+
},
|
|
188
|
+
"tools": {
|
|
189
|
+
"type": "object"
|
|
190
|
+
}
|
|
191
|
+
},
|
|
192
|
+
"additionalProperties": false
|
|
193
|
+
},
|
|
194
|
+
"elicitation": {
|
|
195
|
+
"type": "object",
|
|
196
|
+
"properties": {
|
|
197
|
+
"form": {
|
|
198
|
+
"type": "object",
|
|
199
|
+
"properties": {
|
|
200
|
+
"applyDefaults": {
|
|
201
|
+
"type": "boolean"
|
|
202
|
+
}
|
|
203
|
+
},
|
|
204
|
+
"additionalProperties": true
|
|
205
|
+
},
|
|
206
|
+
"url": {
|
|
207
|
+
"type": "object"
|
|
208
|
+
}
|
|
209
|
+
},
|
|
210
|
+
"additionalProperties": false
|
|
211
|
+
},
|
|
212
|
+
"roots": {
|
|
213
|
+
"type": "object",
|
|
214
|
+
"properties": {
|
|
215
|
+
"listChanged": {
|
|
216
|
+
"type": "boolean"
|
|
217
|
+
}
|
|
218
|
+
},
|
|
219
|
+
"additionalProperties": false
|
|
220
|
+
}
|
|
221
|
+
},
|
|
222
|
+
"additionalProperties": false
|
|
223
|
+
},
|
|
224
|
+
"hostCapabilities": {
|
|
225
|
+
"type": "object",
|
|
226
|
+
"properties": {
|
|
227
|
+
"sampling": {
|
|
228
|
+
"type": "boolean"
|
|
229
|
+
},
|
|
230
|
+
"elicitation": {
|
|
231
|
+
"type": "boolean"
|
|
232
|
+
},
|
|
233
|
+
"roots": {
|
|
234
|
+
"type": "boolean"
|
|
235
|
+
}
|
|
236
|
+
},
|
|
237
|
+
"required": ["sampling", "elicitation", "roots"],
|
|
238
|
+
"additionalProperties": false
|
|
239
|
+
},
|
|
240
|
+
"ownerSessionCaller": {
|
|
241
|
+
"type": "object",
|
|
242
|
+
"properties": {
|
|
243
|
+
"principalId": {
|
|
244
|
+
"$ref": "https://schemas.nexum.local/agent/v2/common.schema.json#/$defs/id"
|
|
245
|
+
},
|
|
246
|
+
"clientId": {
|
|
247
|
+
"type": "string",
|
|
248
|
+
"pattern": "^nexum-console:[0-9a-f]{64}$"
|
|
249
|
+
},
|
|
250
|
+
"source": {
|
|
251
|
+
"const": "owner_session"
|
|
252
|
+
},
|
|
253
|
+
"sessionRef": {
|
|
254
|
+
"type": "string",
|
|
255
|
+
"pattern": "^[0-9a-f]{64}$"
|
|
256
|
+
}
|
|
257
|
+
},
|
|
258
|
+
"required": ["principalId", "clientId", "source", "sessionRef"],
|
|
259
|
+
"additionalProperties": false
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
}
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"contract": "agent.list",
|
|
4
|
+
"valid": true,
|
|
5
|
+
"value": {}
|
|
6
|
+
},
|
|
7
|
+
{
|
|
8
|
+
"contract": "agent.list",
|
|
9
|
+
"valid": false,
|
|
10
|
+
"value": {
|
|
11
|
+
"projectsCursor": "page"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"contract": "agent.list",
|
|
16
|
+
"valid": false,
|
|
17
|
+
"value": {
|
|
18
|
+
"agentId": "a",
|
|
19
|
+
"cursor": "p"
|
|
20
|
+
}
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
"contract": "agent.open",
|
|
24
|
+
"valid": true,
|
|
25
|
+
"value": {
|
|
26
|
+
"agentId": "a"
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"contract": "agent.open",
|
|
31
|
+
"valid": true,
|
|
32
|
+
"value": {
|
|
33
|
+
"agentId": "a",
|
|
34
|
+
"contextId": "ctx",
|
|
35
|
+
"projectId": "p"
|
|
36
|
+
}
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"contract": "agent.open",
|
|
40
|
+
"valid": false,
|
|
41
|
+
"value": {
|
|
42
|
+
"agentId": "a",
|
|
43
|
+
"path": "/work",
|
|
44
|
+
"projectId": "p"
|
|
45
|
+
}
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"contract": "agent.close",
|
|
49
|
+
"valid": true,
|
|
50
|
+
"value": {
|
|
51
|
+
"contextId": "ctx"
|
|
52
|
+
}
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
"contract": "agent.close",
|
|
56
|
+
"valid": false,
|
|
57
|
+
"value": {
|
|
58
|
+
"contextId": "ctx",
|
|
59
|
+
"force": true
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"contract": "agent.run.start",
|
|
64
|
+
"valid": true,
|
|
65
|
+
"value": {
|
|
66
|
+
"contextId": "ctx",
|
|
67
|
+
"script": "return 1",
|
|
68
|
+
"input": null,
|
|
69
|
+
"waitMs": 0,
|
|
70
|
+
"requestId": "req_1794591000000_0123456789abcdef0123456789abcdef"
|
|
71
|
+
}
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"contract": "agent.run.start",
|
|
75
|
+
"valid": true,
|
|
76
|
+
"value": {
|
|
77
|
+
"contextId": "ctx",
|
|
78
|
+
"scriptName": "browser/capture.js"
|
|
79
|
+
}
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"contract": "agent.run.start",
|
|
83
|
+
"valid": false,
|
|
84
|
+
"value": {
|
|
85
|
+
"contextId": "ctx",
|
|
86
|
+
"script": "x",
|
|
87
|
+
"scriptName": "x.js"
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"contract": "agent.run.start",
|
|
92
|
+
"valid": false,
|
|
93
|
+
"value": {
|
|
94
|
+
"contextId": "ctx",
|
|
95
|
+
"script": "x",
|
|
96
|
+
"timeoutMs": 0
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
"contract": "agent.run.get",
|
|
101
|
+
"valid": true,
|
|
102
|
+
"value": {
|
|
103
|
+
"agentId": "a",
|
|
104
|
+
"runId": "r"
|
|
105
|
+
}
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
"contract": "agent.run.get",
|
|
109
|
+
"valid": true,
|
|
110
|
+
"value": {
|
|
111
|
+
"agentId": "a",
|
|
112
|
+
"requestId": "req_1794591000000_0123456789abcdef0123456789abcdef"
|
|
113
|
+
}
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"contract": "agent.run.get",
|
|
117
|
+
"valid": false,
|
|
118
|
+
"value": {
|
|
119
|
+
"agentId": "a",
|
|
120
|
+
"runId": "r",
|
|
121
|
+
"requestId": "req_1794591000000_0123456789abcdef0123456789abcdef"
|
|
122
|
+
}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"contract": "agent.run.input",
|
|
126
|
+
"valid": true,
|
|
127
|
+
"value": {
|
|
128
|
+
"agentId": "a",
|
|
129
|
+
"runId": "r",
|
|
130
|
+
"waitId": "w",
|
|
131
|
+
"input": false
|
|
132
|
+
}
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
"contract": "agent.run.input",
|
|
136
|
+
"valid": false,
|
|
137
|
+
"value": {
|
|
138
|
+
"agentId": "a",
|
|
139
|
+
"runId": "r",
|
|
140
|
+
"waitId": "w"
|
|
141
|
+
}
|
|
142
|
+
},
|
|
143
|
+
{
|
|
144
|
+
"contract": "agent.run.cancel",
|
|
145
|
+
"valid": true,
|
|
146
|
+
"value": {
|
|
147
|
+
"agentId": "a",
|
|
148
|
+
"runId": "r"
|
|
149
|
+
}
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"contract": "agent.run.cancel",
|
|
153
|
+
"valid": false,
|
|
154
|
+
"value": {
|
|
155
|
+
"agentId": "a",
|
|
156
|
+
"runId": "r",
|
|
157
|
+
"waitMs": 1
|
|
158
|
+
}
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
"contract": "agent.run.list",
|
|
162
|
+
"valid": true,
|
|
163
|
+
"value": {
|
|
164
|
+
"agentId": "a",
|
|
165
|
+
"source": "history",
|
|
166
|
+
"from": "2026-11-14T00:00:00Z",
|
|
167
|
+
"limit": 100
|
|
168
|
+
}
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"contract": "agent.run.list",
|
|
172
|
+
"valid": false,
|
|
173
|
+
"value": {
|
|
174
|
+
"agentId": "a",
|
|
175
|
+
"source": "replay"
|
|
176
|
+
}
|
|
177
|
+
},
|
|
178
|
+
{
|
|
179
|
+
"contract": "agent.run.list",
|
|
180
|
+
"valid": false,
|
|
181
|
+
"value": {
|
|
182
|
+
"agentId": "a",
|
|
183
|
+
"from": "2026-99-14T00:00:00Z"
|
|
184
|
+
}
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"contract": "agent.run.start",
|
|
188
|
+
"valid": true,
|
|
189
|
+
"value": {
|
|
190
|
+
"contextId": "ctx",
|
|
191
|
+
"script": "return 1",
|
|
192
|
+
"attachments": [
|
|
193
|
+
{
|
|
194
|
+
"file_id": "f",
|
|
195
|
+
"download_url": "https://example.com/f"
|
|
196
|
+
},
|
|
197
|
+
{
|
|
198
|
+
"uri": "nexum://agents/a/resources/r"
|
|
199
|
+
}
|
|
200
|
+
]
|
|
201
|
+
}
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"contract": "agent.run.start",
|
|
205
|
+
"valid": false,
|
|
206
|
+
"value": {
|
|
207
|
+
"contextId": "ctx",
|
|
208
|
+
"script": "return 1",
|
|
209
|
+
"attachments": [
|
|
210
|
+
{
|
|
211
|
+
"path": "/tmp/secret"
|
|
212
|
+
}
|
|
213
|
+
]
|
|
214
|
+
}
|
|
215
|
+
},
|
|
216
|
+
{
|
|
217
|
+
"contract": "wire",
|
|
218
|
+
"valid": true,
|
|
219
|
+
"value": {
|
|
220
|
+
"type": "cancel",
|
|
221
|
+
"id": "rpc"
|
|
222
|
+
}
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"contract": "wire",
|
|
226
|
+
"valid": false,
|
|
227
|
+
"value": {
|
|
228
|
+
"type": "cancel",
|
|
229
|
+
"id": "rpc",
|
|
230
|
+
"runId": "r"
|
|
231
|
+
}
|
|
232
|
+
},
|
|
233
|
+
{
|
|
234
|
+
"contract": "wire",
|
|
235
|
+
"valid": false,
|
|
236
|
+
"value": {
|
|
237
|
+
"type": "invoke",
|
|
238
|
+
"id": "rpc",
|
|
239
|
+
"operation": "agent.run.start",
|
|
240
|
+
"context": {},
|
|
241
|
+
"input": {}
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
]
|