evolcore 0.0.47 → 0.0.48

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.
Files changed (218) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/bin/ec-build.mjs +86 -0
  3. package/dist/agent-template/jobs.js +12 -4
  4. package/dist/agent-template/runtime.js +139 -39
  5. package/dist/agent-template/service.js +66 -13
  6. package/dist/agents/baseagent.js +60 -20
  7. package/dist/agents/claude-runner.js +34 -17
  8. package/dist/agents/codex-runner.js +31 -16
  9. package/dist/agents/ecagent-runner.js +7 -4
  10. package/dist/agents/gemini-runner.js +5 -2
  11. package/dist/agents/runner-types.js +5 -21
  12. package/dist/aun/aid/agentmd.js +5 -1
  13. package/dist/aun/service-proxy.js +4 -2
  14. package/dist/build-identity.json +1 -0
  15. package/dist/channels/aun.js +81 -24
  16. package/dist/channels/daemon.js +9 -25
  17. package/dist/cli/aun-commands.js +86 -51
  18. package/dist/cli/code-stats.js +19 -8
  19. package/dist/cli/command-log.js +1 -1
  20. package/dist/cli/daemon-commands.js +44 -43
  21. package/dist/cli/directory.js +7 -1
  22. package/dist/cli/ecmsg-gateway.js +5 -2
  23. package/dist/cli/index.js +2 -8
  24. package/dist/cli/init-channel.js +4 -6
  25. package/dist/cli/init.js +72 -50
  26. package/dist/cli/invoke-command.js +1 -1
  27. package/dist/cli/provider-command.js +74 -13
  28. package/dist/cli/role.js +61 -17
  29. package/dist/cli/stats.js +3 -3
  30. package/dist/cli/thread-command.js +16 -51
  31. package/dist/config/boot-log.js +3 -9
  32. package/dist/config/builtin-roles.js +5 -7
  33. package/dist/config/config-manager.js +2 -6
  34. package/dist/config/daemon-services.js +30 -3
  35. package/dist/config/gateway-config.js +2 -2
  36. package/dist/config/invoke-ipc-service.js +6 -4
  37. package/dist/config/peer-bind-code.js +3 -4
  38. package/dist/config/peer-book-store.js +62 -229
  39. package/dist/config/peer-book.js +26 -27
  40. package/dist/config/peer-role-resolver.js +16 -1
  41. package/dist/config/provider-identity-migration.js +4 -1
  42. package/dist/config/provider-ipc-service.js +56 -11
  43. package/dist/config/provider-menu-request.js +24 -5
  44. package/dist/config/provider-templates.js +127 -0
  45. package/dist/config/providers-config.js +59 -8
  46. package/dist/config/providers-management.js +467 -49
  47. package/dist/config/role-command-service.js +248 -1
  48. package/dist/config/schema-migration.js +105 -4
  49. package/dist/core/agent-application-service.js +6 -1
  50. package/dist/core/agent-runtime.js +4 -0
  51. package/dist/core/auth/agent-delegation.js +2 -1
  52. package/dist/core/auth/auth-gateway.js +2 -1
  53. package/dist/core/auth/delegation-authorization.js +3 -0
  54. package/dist/core/auth/operation-authorizer.js +25 -0
  55. package/dist/core/auth/operation-catalog.js +28 -64
  56. package/dist/core/capability/providers/codex-capability-provider.js +7 -8
  57. package/dist/core/channel-loader.js +18 -0
  58. package/dist/core/command/agent-control.js +32 -0
  59. package/dist/core/command/command-handler.js +81 -85
  60. package/dist/core/command/menu-catalog.js +1 -0
  61. package/dist/core/command/menu-handler.js +61 -149
  62. package/dist/core/command/menu-protocol.js +7 -1
  63. package/dist/core/command/provider-menu.js +13 -3
  64. package/dist/core/command/role-menu.js +47 -23
  65. package/dist/core/command/slash-handler.js +26 -43
  66. package/dist/core/command/team-workspace-items.js +81 -12
  67. package/dist/core/command/team-workspace-team.js +9 -71
  68. package/dist/core/command/topic-slash.js +9 -30
  69. package/dist/core/daemon-bootstrap.js +8 -1
  70. package/dist/core/daemon-control.js +7 -7
  71. package/dist/core/evolagent-registry.js +14 -1
  72. package/dist/core/file-integrity/store.js +2 -0
  73. package/dist/core/handoff/runtime.js +37 -1
  74. package/dist/core/inference/text-inference.js +3 -1
  75. package/dist/core/initialization/service.js +11 -6
  76. package/dist/core/interaction-router.js +3 -0
  77. package/dist/core/invoke/executors/text.js +72 -19
  78. package/dist/core/ipc-registration.js +2 -1
  79. package/dist/core/message/aun-ipc-sender.js +165 -55
  80. package/dist/core/message/im-renderer.js +1 -1
  81. package/dist/core/message/message-bridge.js +51 -334
  82. package/dist/core/message/message-log.js +5 -0
  83. package/dist/core/message/message-queue.js +22 -0
  84. package/dist/core/message/message-utils.js +8 -0
  85. package/dist/core/message/response-engine.js +429 -116
  86. package/dist/core/message/send-routing.js +5 -1
  87. package/dist/core/model/catalog-service.js +31 -11
  88. package/dist/core/model/model-capabilities.js +22 -4
  89. package/dist/core/model/model-catalog.js +1 -0
  90. package/dist/core/ownership/owner-resolver.js +328 -50
  91. package/dist/core/permission/protected-paths.js +6 -6
  92. package/dist/core/relation/peer-identity.js +23 -1
  93. package/dist/core/relation/same-owner-proof.js +81 -112
  94. package/dist/core/session/adapters/codex-session-file-adapter.js +96 -15
  95. package/dist/core/session/session-file-health.js +13 -7
  96. package/dist/core/session/session-fs-store.js +91 -35
  97. package/dist/core/session/session-manager.js +68 -24
  98. package/dist/core/session/session-mapper.js +14 -34
  99. package/dist/core/session/session-transcript.js +5 -1
  100. package/dist/core/task/task-activity-store.js +84 -0
  101. package/dist/core/task/task-recovery-service.js +12 -0
  102. package/dist/core/thread/command-parser.js +7 -12
  103. package/dist/core/thread/thread-context-storage.js +3 -2
  104. package/dist/core/thread/thread-operation.js +2 -13
  105. package/dist/core/thread/thread-service.js +15 -46
  106. package/dist/directory/owner-directory-admission.js +1 -1
  107. package/dist/directory/owner-directory-cache.js +45 -28
  108. package/dist/directory/owner-directory-markdown.js +13 -1
  109. package/dist/directory/owner-directory-query-operation.js +29 -3
  110. package/dist/directory/owner-directory-remarks.js +11 -3
  111. package/dist/eck/message-renderer.js +84 -24
  112. package/dist/ecweb/basic-settings-service.js +3 -1
  113. package/dist/ecweb/message-context-service.js +1 -1
  114. package/dist/ecweb/pairing.js +4 -3
  115. package/dist/ecweb/providers-service.js +26 -1
  116. package/dist/ecweb/runtime/lifecycle.js +18 -8
  117. package/dist/ecweb/runtime/proxy-access.js +74 -0
  118. package/dist/ecweb/runtime/supervisor.js +4 -2
  119. package/dist/event-center/registry.js +13 -2
  120. package/dist/event-center/runtime.js +103 -11
  121. package/dist/event-center/script-runner.js +5 -5
  122. package/dist/index.js +92 -59
  123. package/dist/ipc.js +13 -2
  124. package/dist/outputs/events.js +62 -0
  125. package/dist/outputs/protocol.js +102 -0
  126. package/dist/outputs/service.js +279 -0
  127. package/dist/paths.js +3 -0
  128. package/dist/proxy/manager.js +43 -13
  129. package/dist/services/index.js +89 -4
  130. package/dist/services/ipc-operation.js +4 -15
  131. package/dist/services/pack-manager.js +12 -1
  132. package/dist/services/router.js +21 -6
  133. package/dist/services/script-runner.js +5 -4
  134. package/dist/services/validation.js +1 -1
  135. package/dist/stats/budget.js +1 -1
  136. package/dist/stats/db.js +19 -0
  137. package/dist/stats/index.js +1 -1
  138. package/dist/stats/{price-resolver.js → model-resolver.js} +305 -24
  139. package/dist/stats/normalizer.js +2 -0
  140. package/dist/stats/query.js +35 -27
  141. package/dist/stats/role-budget.js +5 -2
  142. package/dist/stats/writer.js +10 -6
  143. package/dist/trigger/audit.js +7 -0
  144. package/dist/trigger/authorization.js +105 -11
  145. package/dist/trigger/feedback.js +10 -0
  146. package/dist/trigger/history.js +37 -11
  147. package/dist/trigger/ipc-service.js +12 -1
  148. package/dist/trigger/manager.js +1 -0
  149. package/dist/trigger/scheduler.js +7 -5
  150. package/dist/trigger/script-executor.js +2 -1
  151. package/dist/trigger/script-sandbox.js +9 -3
  152. package/dist/trigger/validation.js +22 -0
  153. package/dist/utils/cross-platform.js +73 -26
  154. package/dist/utils/error-dict.json +94 -4
  155. package/dist/utils/error-utils.js +27 -4
  156. package/dist/utils/evolcore-version.js +36 -65
  157. package/dist/utils/msg-diag.js +1 -0
  158. package/dist/utils/process-introspect.js +12 -7
  159. package/dist/utils/process-tree.js +50 -2
  160. package/dist/utils/windows-shell-trust.js +2 -0
  161. package/dist/workbench/protocol.js +80 -0
  162. package/dist/workbench/service.js +359 -0
  163. package/ecagent/dist/types.d.ts +6 -2
  164. package/kits/docs/context-assembly.md +1 -1
  165. package/kits/docs/evolcore/INDEX.md +2 -2
  166. package/kits/docs/evolcore/config.md +12 -0
  167. package/kits/docs/evolcore/directory.md +22 -3
  168. package/kits/docs/evolcore/ecweb-lifecycle.md +15 -0
  169. package/kits/docs/evolcore/model.md +10 -0
  170. package/kits/docs/evolcore/peer.md +19 -65
  171. package/kits/docs/evolcore/provider.md +123 -3
  172. package/kits/docs/evolcore/role.md +80 -0
  173. package/kits/docs/evolcore/services.md +6 -6
  174. package/kits/docs/evolcore/team-workspace.md +1 -1
  175. package/kits/docs/evolcore/thread-chain.md +14 -15
  176. package/kits/docs/evolcore/tool-authorization.md +5 -0
  177. package/kits/docs/evolcore/trigger.md +10 -0
  178. package/kits/eck_message_manifest.json +12 -0
  179. package/kits/provider-templates.json +1213 -0
  180. package/kits/rules/04-relation.md +3 -3
  181. package/kits/schemas/_meta.json +14 -2
  182. package/kits/schemas/contact-book.schema.4.json +52 -0
  183. package/kits/schemas/providers.schema.3.json +200 -0
  184. package/kits/skills/.switches.json +4 -0
  185. package/kits/skills/ability/references/calling.md +1 -1
  186. package/kits/skills/ec-group/SKILL.md +2 -2
  187. package/kits/skills/ec-identity/SKILL.md +19 -72
  188. package/kits/skills/ec-provider/SKILL.md +221 -0
  189. package/kits/skills/ec-provider/scripts/check-model.mjs +80 -0
  190. package/kits/skills/ec-trigger/SKILL.md +1 -1
  191. package/kits/skills/thread-ops/SKILL.md +34 -21
  192. package/kits/templates/message-fragments/group-batch-item.md +1 -1
  193. package/kits/templates/message-fragments/group-batch.md +1 -1
  194. package/kits/templates/message-fragments/inject-default.md +1 -1
  195. package/kits/templates/message-fragments/interrupt-insert.md +1 -0
  196. package/kits/templates/message-fragments/item-group.md +1 -1
  197. package/kits/templates/message-fragments/item-private.md +1 -1
  198. package/kits/templates/message-fragments/thread-context.md +1 -1
  199. package/kits/templates/message-fragments/trigger-session.md +1 -1
  200. package/kits/templates/message-fragments/trigger-thread-check.md +1 -1
  201. package/kits/templates/roles/admin.json +2 -19
  202. package/kits/templates/roles/member.json +0 -3
  203. package/kits/templates/system-fragments/baseagent.md +6 -0
  204. package/kits/templates/system-fragments/commands.md +3 -3
  205. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  206. package/kits/templates/system-fragments/relation.md +1 -1
  207. package/kits/templates/system-fragments/thread.md +6 -5
  208. package/package.json +6 -4
  209. package/scripts/agent-template/inspect.mjs +4 -1
  210. package/scripts/agent-template/shared/common.mjs +2 -3
  211. package/scripts/agent-template/shared/template-contract.mjs +2 -1
  212. package/scripts/agent-template/shared/template-package.mjs +9 -2
  213. package/scripts/agent-template/shared/template-runtime.mjs +20 -5
  214. package/scripts/agent-template/team-pack.mjs +6 -3
  215. package/dist/cli/peer.js +0 -127
  216. package/dist/config/peer-operation-service.js +0 -132
  217. package/dist/config/peer-request-service.js +0 -532
  218. package/dist/core/command/connect-menu.js +0 -624
@@ -7,29 +7,65 @@
7
7
  ~~~text
8
8
  ec provider list [--format json]
9
9
  ec provider show <provider-id> [--format json]
10
+ ec provider templates [template-id] [--format json]
10
11
  ec provider create --file <path> [--format json]
12
+ ec provider create --template <template-id> --file <inputs.json> [--format json]
11
13
  ec provider import --file <path> [--format json]
12
14
  ec provider update <provider-id> --file <path> [--format json]
15
+ ec provider update <provider-id> --template <template-id> --file <inputs.json> [--format json]
13
16
  ec provider delete <provider-id> [--format json]
14
17
  ec provider sync [--format json]
15
18
  ~~~
16
19
 
17
20
  - 默认输出可读文本:list 为列表,show 为分层配置详情,create/import/update/delete 为操作结果,sync 为同步摘要(导入、别名、引用更新、默认选择、待处理项、告警和备份)。`--format json` 保留完整 `{ ok, data }` 或 `{ ok, code, error, data? }` 响应,供脚本使用。失败退出码非零。
18
21
  - list 显示 ID、名称、域名和服务类型;show 展示脱敏配置,两者均显示 revision。API key、headers、queryParams 中的凭据不回显;完整脱敏注册表可用 `list --format json` 获取。
19
- - create/update 的文件必须是单个完整 Provider 对象;update 仅替换已存在的 ID,不是字段 patch 或 upsert。
22
+ - 普通 create/update 的文件必须是单个完整 Provider 对象;update 仅替换已存在的 ID,不是字段 patch 或 upsert。使用 --template 时文件改为下述模板输入对象。
20
23
  - import 还接受只有一项的 Provider ID 映射或 providers 包装。保存时按规范化完整 hostname 生成稳定的 `provider-` 八位数字 ID;同域配置进入冲突/合并流程,不会因当前环境重新编号。
21
- - 文件为 UTF-8(可带 BOM),不超过 1 MiB。CLI 将绝对路径交给 daemon 读取,不在 argv 传递 JSON 或凭据;无 --text 参数。
24
+ - 文件为 UTF-8(可带 BOM),不超过 1 MiB。宿主 CLI 解析相对路径;托管 CLI 保留获准 argv,由 daemon 按会话工程解析路径,不在 argv 传递 JSON 或凭据;无 --text 参数。非托管模板参数例外见下文。
22
25
  - update 中的 <redacted> 保留对应旧凭据;省略字段表示清除。create/import 不接受脱敏占位符。
23
26
  - delete 遇到 defaults、Agent 或 relation 的 Provider/fallback 引用时拒绝,返回非敏感引用路径;没有 force/级联删除。配置损坏或引用目录不可读时也拒绝删除。
24
27
 
25
28
  ## 托管查询的命令边界
26
29
 
30
+ templates 与 list/show 使用同一只读管理权限,支持 DaemonOwner 的委托查询。
31
+
27
32
  在托管 Codex 会话中,直接执行独立的 `ec provider list --format json` 或 `ec provider show <provider-id> --format json`。
28
33
  不要将查询嵌入 PowerShell 赋值、管道或多语句脚本,例如 `$result = ec provider list --format json | ConvertFrom-Json`。
29
34
  无法安全解析并绑定到实际 EC 参数的复合命令会在执行前拒绝,需拆成独立工具调用;Shell 审批通过不等于内部 EC 调用已获得单次审批。
30
35
 
31
36
  会话进入新任务后,同一命令仍需当前任务的审批。`approval_not_found` 表示当前命令缺少匹配审批;历史任务的同命令审批不会将新任务误报为 `task_revoked`,也不会被复用授权。
32
37
 
38
+ ## 内置国产端点模板
39
+
40
+ 模板目录随包发布在 kits/provider-templates.json,由 Core 统一读取与生成。当前 13 家厂商、24 个产品模板;MiMo Token Plan 可选国内、新加坡、欧洲地域。仅收录现行标准 API 与套餐,不自动迁移旧套餐配置,也不自动切换默认模型。
41
+
42
+ 输入文件示例(密钥为字面量环境变量引用):
43
+
44
+ ~~~json
45
+ {
46
+ "apiKey": "$GLM_PLAN_KEY",
47
+ "serviceTypes": ["ecagent", "claude", "codex"],
48
+ "inputs": {}
49
+ }
50
+ ~~~
51
+
52
+ 可选 name(2–20 字符)、serviceTypes、inputs、templateRevision。inputs 按模板字段填写,如百炼标准 API 的 workspaceId,MiMo 套餐的 region(默认 cn)。模板详情返回目录 revision;填写 templateRevision 后,目录变动返回 CONFLICT,必须重新预览。模板 revision 与 Provider 注册表 revision 独立。
53
+
54
+ 托管 create/update --template 仅接受 --file,包括 fullaccess 任务;daemon 再次校验此限制。非托管宿主终端还可使用 --api-key、--name、--services(逗号分隔)、可重复 --input 字段=值。--file 与这些内联参数互斥;TTY 自动补齐缺少的必填项,Key 不回显;非 TTY 不等待输入。宿主可用整字段环境变量引用避免把真实 Key 写入 shell 历史;CLI 自身命令日志始终脱敏。
55
+
56
+ ~~~bash
57
+ ec provider templates glm-coding --format json
58
+ ec provider create --template glm-coding --file ./inputs.json
59
+ # 仅非托管宿主终端
60
+ ec provider create --template mimo-token-plan --api-key '$MIMO_PLAN_KEY' --input region=cn
61
+ ~~~
62
+
63
+ 同域只保留一个 Provider。create 遇到同域返回 PROVIDER_CONFLICT 和目标 providerId,不覆盖;使用 update <provider-id> --template ... 显式合并。单独添加 API 默认生成支持的基座服务和 text;同域已有基座时,后加 API 默认只生成 text;Plan 默认生成其支持的基座。显式 serviceTypes 决定替换范围。保留公共地址/凭据,必要时换算新增服务的相对路径并设置独立 Key,未选中服务的有效连接保持原样;同域不同协议或端口不能合并。
64
+
65
+ ECWeb 基础设置和首次设置页复用同一模板界面:选择产品和密钥 → 预览前后配置及受影响服务 → 确认加入草稿 → 保存设置(首次设置为“下一步”)。预览和取消均不写配置,连续添加同域 API/Plan 可一次保存。标准/套餐凭据分别使用。目录和真实推理验证保持独立。
66
+
67
+ ECWeb 接口均经过现有宿主管理授权:GET /api/providers/templates,GET /api/providers/templates/<id>,POST /api/providers/templates/<id>/preview。预览 body 为输入对象,或 {config, draft?:{providerId, provider, imports}};响应包含 templateRevision、注册表 revision、providerId、existing、serviceTypes、conflicts、before、provider、references,所有凭据脱敏。批量保存仍用 PATCH /api/providers,imports 可携带 {template:{templateId, config}} 恢复脱敏输入;模板输入须包含预览时选择的 serviceTypes/templateRevision,避免保存时变更分配规则。
68
+
33
69
  ## 本机扫描与统一配置
34
70
 
35
71
  `ec provider sync` 通过在线 daemon 执行以下一次性事务,不需要输入文件。旧命令名 `sync-local` 不再接受:
@@ -109,8 +145,92 @@ hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一
109
145
 
110
146
  不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
111
147
 
148
+ ## 连接错误补录卡片
149
+
150
+ Provider schema v3 增加 `services.<type>.catalogPath`、`apiKey`、`headers`、`queryParams`。
151
+ `catalogPath` 是相对 `common.baseUrl` 的目录基础路径,最终追加 `/models`;省略时沿用服务 API 路径,
152
+ 空字符串使用公共基础地址。目录地址必须同源;目录子路径失败可尝试同源根 `/models`,401/403 不回退。
153
+ 目录地址、服务协议和有效凭据共同参与运行时及持久目录缓存标识。
154
+
155
+ 服务级 Key 未声明时继承 `common.apiKey`,声明后独立使用,支持整字段环境变量引用。
156
+ 显式空 Key 不回退公共 Key,缺失/空环境变量直接报错。服务级 headers/queryParams 整组覆盖,
157
+ 省略表示继承,`{}` 表示清空。独立 Key 与公共认证头/认证查询参数可能冲突时,要求显式覆盖对应组。
158
+ 旧配置没有覆盖字段时保持原语义。导入导出、脱敏、模型目录与推理均使用目标服务的有效连接。
159
+ 单服务带密钥导出只包含该服务的有效凭据;不带密钥导出移除公共和服务级 Key、headers、queryParams。
160
+
161
+ 错误字典 `error-dict.json` 支持 `action: "ask"`。`question.handler` 为
162
+ `provider-connection`,`fields` 指定需要重新收集的 `apiKey` / `baseUrl`,
163
+ `includeMissing` 指定仅在当前连接缺失时追加收集的字段。例如:
164
+
165
+ ~~~json
166
+ {
167
+ "id": "invalid-api-key",
168
+ "match": "invalid api key",
169
+ "action": "ask",
170
+ "type": "auth_error",
171
+ "message": "请更新服务商凭据",
172
+ "question": {
173
+ "handler": "provider-connection",
174
+ "fields": ["apiKey"],
175
+ "includeMissing": ["baseUrl"]
176
+ }
177
+ }
178
+ ~~~
179
+
180
+ 按数组顺序匹配首条规则;`ask` 不自动重试。已有 retry/stop/ignore 语义不变。
181
+ 缺失环境变量、缺失密钥及明确的认证失败可触发补录;普通 403、余额不足、限流和
182
+ 密钥校验服务繁忙不一律转成凭据问题。
183
+
184
+ 卡片只在有明确连接上下文的 AUN 人类私聊里发送,且操作者须具备当前宿主的 DaemonOwner
185
+ 权限。serviceType、style、path 完全来自原 Provider 或实际执行上下文,不弹出询问、不按
186
+ 域名或错误文本推测。没有 Provider 时按已知基座协议创建服务商并绑定到原 Agent;上下文
187
+ 不足时保留原错误提示。卡片授权不放开 agent-tool 的 provider.create/update。
188
+
189
+ 单输入框按 baseURL → API Key / Token 分步收集,收齐后通过既有校验和 revision CAS 保存;
190
+ 取消、15 分钟到期或 daemon 重启会丢弃未保存输入。同一 Provider 已有待处理卡片时合并提示。
191
+ 原服务商的域名不可变,模型设置及服务路径保留。每次提交复核操作者、会话和配置绑定,
192
+ 旧卡片不能覆盖其他管理操作。
193
+
194
+ 会话切换工程或继续执行新任务、环境变量中的实际地址或密钥变化,也会使旧补录/重试卡片
195
+ 失效。授权校验等待期间发生取消或超时,回调不会继续保存;已失效的待处理卡片不会阻挡
196
+ 同一 Provider 的新补录。缺失地址且无法确定既有 Provider 域名的历史配置须由管理界面修复,
197
+ 不会根据填写内容擅自改变服务商身份。
198
+
199
+ 原生连接复用各基座的实际凭据解析优先级,包括 Claude settings、Codex 显式 bearer token
200
+ 和 auth.json。转为 Provider 时保留已知请求头及查询参数。已有 Provider 的密钥修复写入目标服务,
201
+ 继承的请求头/查询参数先复制到该服务,再同步其中标准 Bearer/API Key 及
202
+ key/api_key/apikey/access_token 参数,避免旧值覆盖新密钥,也不改其他服务的公共凭据。
203
+
204
+ 凭据回答只接受加密私聊卡片回调,不提供普通聊天或 slash 命令的密钥输入回退。Core 在
205
+ 消息持久化及观察者转发之前消费卡片回复,日志不记录卡片回答正文;输入不会送给模型。
206
+ 卡片携带 sensitive 标记,输入框是否遮罩由客户端实现决定。
207
+
208
+ 保存后对原目标模型执行一次真实推理,输入仅为“Reply only OK. No explanation.”,
209
+ 输出上限 64 tokens。按服务协议发送 Messages、Responses、Chat Completions 或 Gemini generateContent;
210
+ 不读取目录、不带原消息/历史/工具、不自动重试、不切换备用模型。HTTP 成功且有可用文本才算通过,
211
+ 空响应、错误响应和不完整的 Responses 不能证明可用;缺少明确目标模型时也不声称验证通过。
212
+ 这适用于 manual 配置及没有模型目录接口的服务。验证通过才提供“重试原请求”按钮,
213
+ 点击后重查权限及原会话绑定;不自动重放失败请求。验证失败保留已保存结果并明确提示。
214
+
112
215
  ## Menu 对应
113
216
 
114
- name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 仅支持 list/detail,CLI show 对应 detail;update 使用 args.resource=provider 和完整 JSON 字符串 value;action 支持 create/import/delete。全部写入要求 expectedRevision。
217
+ name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 支持 list/detail/templates,CLI show 对应 detail;普通 update 使用 args.resource=provider 和完整 JSON 字符串 value;action 支持 create/import/delete。全部写入要求 expectedRevision。
218
+
219
+ App 模板契约(均使用 name=provider、scope=process):
220
+
221
+ | 请求 | 参数 |
222
+ |---|---|
223
+ | menu.query | view=templates,可选 templateId;返回目录或单模板详情 |
224
+ | menu.action,action=preview-template | templateId、config(模板输入);返回与 ECWeb 一致的脱敏预览,不写入 |
225
+ | menu.action,action=create | expectedRevision、templateId、config;与原 provider 参数互斥 |
226
+ | menu.update | resource=provider-template、providerId、templateId、expectedRevision;value 为模板输入的 JSON 字符串 |
227
+
228
+ 示例请求:
229
+
230
+ ~~~json
231
+ {"type":"menu.action","name":"provider","action":"preview-template","args":{"scope":"process","templateId":"glm-coding","config":{"apiKey":"$GLM_PLAN_KEY"}}}
232
+ ~~~
233
+
234
+ preview-template 虽不写入,也因可能携带密钥而要求加密 Control 或已认证 ECWeb 管理入口。保存 config 携带预览的 templateRevision,注册表 expectedRevision 取预览 revision。NOT_FOUND 表示未知模板,INVALID_ARGUMENT 表示输入/协议/字段无效,CONFLICT 表示目录或注册表变化,PROVIDER_CONFLICT 表示同域已存在,FORBIDDEN 表示权限/加密入口不满足。App 界面由对应项目按此契约接入。
115
235
 
116
236
  只接受 DaemonOwner Control 或已认证 ECWeb Menu,Agent Channel 拒绝;Control 写入必须加密。Catalog 仅发布 process 条目,provider.list 支持 menu values 查询。完整示例与错误语义见仓库 docs/provider-menu-protocol-design.md。
@@ -0,0 +1,80 @@
1
+ # ec role — 角色配额与角色申请
2
+
3
+ 触发词:角色配额、角色限额、关闭限额、取消配额、usageLimits、申请角色、审批角色。
4
+
5
+ ## 角色用量配额
6
+
7
+ 配额是目标 Agent 的角色定义 `usageLimits`,限制模型费用;不是消息准入频率
8
+ `access.requestLimit`,也不是存储配额或企业团队积分。使用本命令即可,无需自己编写维护脚本。
9
+
10
+ ```bash
11
+ # 托管会话省略 --self,默认当前 Agent;宿主终端必须明确 --self
12
+ ec role quota show member --format json
13
+ ec role quota set member --enabled true --limit 10 --currency CNY --reset daily --scope subject --cost-basis gateway
14
+ ec role quota disable member
15
+ ec role quota inherit customer
16
+
17
+ # DaemonOwner 或可信 /fa 任务可以指定同一 daemon 下的其他本机 Agent
18
+ ec role quota show member --self game.agentid.cn --format json
19
+ ec role quota disable member --self game.agentid.cn
20
+ ```
21
+
22
+ | 选项 | 值与含义 |
23
+ |---|---|
24
+ | `--enabled` | `true` / `false`,是否启用限制 |
25
+ | `--limit` | 非负金额或 `unlimited`;`0` 表示额度耗尽,不表示关闭;`unlimited` 保存为 `null` |
26
+ | `--currency` | `CNY` / `USD`,人民币 / 美元 |
27
+ | `--reset` | `daily` / `weekly` / `monthly` / `never`,每天 / 每周 / 每月 / 累计不重置 |
28
+ | `--cost-basis` | `gateway` / `official`,网关价 / 官方价 |
29
+ | `--scope` | `subject` / `role`,每个对端独立额度 / 同角色共享额度 |
30
+
31
+ `set` 只修改明确传入的字段,不自动启用限制。启用时必须已有金额或同时指定 `--limit`。
32
+ `disable` 只设置 `enabled=false`,保留金额、周期等设置以便以后启用。
33
+ `inherit` 删除角色自己的整个 `usageLimits`,恢复动态继承 member 的配额。
34
+ 周期沿用 daemon 本地时区,每周从周一开始;这些命令不清空或回写历史用量。
35
+
36
+ `show` 返回 `usageLimits`(该角色自身配置)、`effectiveUsageLimits`(按现有继承规则选取的配额)、
37
+ `applicable` 和 `enforced`(当前是否实际执行有限额度)。`limitAmount=null` 表示不限额,
38
+ 即使 `enabled=true` 也不会拦截;`--enabled true --limit unlimited` 因此会返回 `enforced=false`。
39
+ 缺省计费口径为 gateway、范围为 subject、周期为 daily、币种为 CNY。
40
+ 自定义角色未显式配置额度时继承 member;首次部分修改会以当前继承额度为基础保存独立配置,
41
+ 此后不再随 member 配额变化。`owner/admin` 免于角色用量配额,查询返回 `applicable=false`,写入返回 `NOT_SUPPORTED`。
42
+
43
+ 角色定义的创建、修改、删除和重置仅 DaemonOwner 可管理,包含权限、模型约束和配额字段。
44
+ 普通 Agent Owner 只能为所属 Agent 选择已有角色:设置私聊、群聊、内部联系人默认角色,
45
+ 或给指定关系分配、撤销角色。Admin 保留读取权限,不能修改定义或分配角色;
46
+ 自定义角色的命令授权和 `bypass` 均不能突破这些边界。默认角色设置使用 `role.assign`,
47
+ 不再与定义写入 `role.policy.write` 共用授权。
48
+
49
+ `quota show` 保留当前 Agent Owner/Admin 的读取权限;`set/disable/inherit` 要求 DaemonOwner 管理授权。
50
+ DaemonOwner 和可信 `/fa` 可指定同一 daemon 的其他本机 Agent,无需兼任目标 Agent Owner。
51
+ `/fa` 的既有准入和可信执行授权不变,仅移除配额入口额外叠加的目标 Owner 检查。
52
+ 宿主终端通过 daemon 校验的本机 control token 执行配额命令,不再冒用 Agent Owner 身份;daemon 不可用时失败关闭。
53
+ 远程主机不在 `--self` 范围内,应使用已授权的 Menu 管理接口。
54
+
55
+ 写入复用角色编辑器的 schema 校验、revision 冲突检查、原子写入、完整性登记和角色变更审计。
56
+ 返回非零退出码就按错误处理,不以传输成功代替写入成功。写后角色缓存按文件变化刷新,后续额度检查使用新值,
57
+ 不需要重启或 reload;已经开始执行的模型调用不会由配额变更中断。
58
+ `--format json` 在失败时也返回 `{ ok: false, code, error, data? }`,保留权限拒绝和 revision 冲突信息。
59
+
60
+ 角色额度耗尽时,daemon 通过自己的 AID 向当前 DaemonOwner 发送加密 action card,
61
+ 不调用模型,也不要求耗尽额度的 Agent 代为审批。卡片展示目标 Agent、角色及已用/上限金额,
62
+ DaemonOwner 可输入高于当前已用金额的新上限,或选择暂不调整。调整影响该角色所有关系使用的配额配置。
63
+ 同一角色、策略及计费周期的申请在 15 分钟内合并;卡片 15 分钟过期,发送失败允许下次请求重试。
64
+ 回调校验点击身份、渠道、加密、当前主机归属、配额周期和配置 revision,配置已变化时拒绝覆盖。
65
+ 审批复用角色定义写入、校验和审计入口;通过后在原会话显式重试,不自动重放原请求。
66
+
67
+ ## 角色提升申请
68
+
69
+ 保留原有命令与语义,`list` 列出申请记录,不是角色定义列表。
70
+
71
+ ```bash
72
+ ec role request <peer-aid> --role <role-id> [--reason '<text>'] [--self <agent-aid>]
73
+ ec role list [--status pending|approved|rejected|expired] [--self <agent-aid>]
74
+ ec role approve <request-id> [--reason '<text>'] [--self <agent-aid>]
75
+ ec role reject <request-id> [--reason '<text>'] [--self <agent-aid>]
76
+ ```
77
+
78
+ 申请不立即授予角色,审批通过后才修改关系角色;审批仅当前 Agent 的协议 Owner 可执行。
79
+ 命令支持 `--format json`。直接分配或撤销关系角色沿用
80
+ `ec config set role <role-id> --self <agent-aid> --peer <peer-aid>` / `ec config unset role ...`。
@@ -57,7 +57,7 @@ ec services pack list
57
57
  }
58
58
  ```
59
59
 
60
- `enabled=false` 时所有 `services.*` 静默丢弃(总闸,用 `ec services enable` 打开)。`rateLimit` 按调用方 AID 独立计,`service` 管业务调用、`builtin` 管内置查询;缺省值即上表所列,省掉这个键等价于用缺省。
60
+ 总闸默认开启,缺少 `services-config.json` 或省略 `enabled` 均为 `true`。显式 `enabled=false` 时所有 `services.*` 静默丢弃(用 `ec services enable` 打开),非法或不可读配置仍关闭。`rateLimit` 按调用方 AID 独立计,`service` 管业务调用、`builtin` 管内置查询;缺省值即上表所列,省掉这个键等价于用缺省。
61
61
 
62
62
  ## 三、你的服务叫什么
63
63
 
@@ -347,13 +347,13 @@ agent 的 owner"是两个层级——一台机器上可以挂着不同 Owner 的
347
347
  - **总闸**是整机决策:开了这个 AID 就对外接活了,所以独立成一档。
348
348
  - **调用**不判本机权限:发出去的消息由对端准入决定,本机这边无权干涉。
349
349
 
350
- ### `pack add` 不自动开总闸
350
+ ### `pack add` 保留总闸
351
351
 
352
- 装包时若不存在 `services-config.json`,会建一份 **`enabled: false`** 的。装包
353
- (owner / admin)和开服务(daemonOwner + fullaccess)是两件事;自动开机等于让
354
- 装包顺带绕过总闸那道闸。
352
+ 装包时若不存在 `services-config.json`,会按默认策略建一份 **`enabled: true`** 的。
353
+ 已有配置原样保留,包括显式关闭。装包(owner / admin)和修改总闸
354
+ (daemonOwner + fullaccess)仍有各自的授权检查。
355
355
 
356
- 装完之后要显式开:
356
+ 曾显式关闭的 Agent 可手动开启:
357
357
 
358
358
  ```bash
359
359
  ec services enable
@@ -25,7 +25,7 @@ ec team navigation update --replace-json '[{"id":"capture","title":"输入资料
25
25
 
26
26
  `upsert`、`remove` 和 `replace` 每次只允许选择一种模式。入口 ID 和路径必须各自唯一。暂时还不存在的目标可以通过 `availability: "unavailable"` 和 `reason` 先登记,目标就绪后再用相同 ID upsert 为正常入口。
27
27
 
28
- 成员配置保存在 Agent `config.json` 的 `team` AID 数组中。每个成员必须同时是当前 Agent 联系人簿中的 active AUN 私聊联系人;联系人簿由现有 Contact Book API 读取,当前落盘文件为 `peers.json`(旧 `contact.json` 已迁移)。Core 不接受群组、未接受或被阻止联系人:
28
+ 成员配置保存在 Agent `config.json` 的 `team` AID 数组中。成员资格统一依据 Owner 名录,要求可用的人类或 Agent 条目且有 Owner 归属;名录未就绪时明确返回不可用。团队校验不读取 peers.json,也不回退本地对端表;实际通信仍经过本地黑名单检查:
29
29
 
30
30
  ```bash
31
31
  ec team members show
@@ -34,7 +34,7 @@ ec thread summary set <threadId> '<摘要内容>' --name '<新标题>' --self <s
34
34
 
35
35
  - 同一对端有多条并行任务线(项目 A、项目 B 分开管理)
36
36
  - 跨 agent 委托:A 向 B 发起一个话题,B 接收后在自己的话题里处理
37
- - 需要给某段对话贴标签、跟踪状态(pending / in_progress / completed / archived)
37
+ - 需要标记某条讨论线已经结束(closed)或不再响应(archived)
38
38
  - 想保存话题摘要(summary),供下次激活时快速恢复上下文
39
39
  - 整理完成或废弃的话题时(删除话题)
40
40
 
@@ -47,9 +47,8 @@ ec thread summary set <threadId> '<摘要内容>' --name '<新标题>' --self <s
47
47
  ```bash
48
48
  ec thread peers # 列出该 agent 有话题的所有对端
49
49
  ec thread list <peer>
50
- ec thread list <peer> --status in_progress
51
- ec thread list <peer> --label 项目A
52
- ec thread list <peer> --unlabeled
50
+ ec thread list <peer> --status closed
51
+ ec thread list <peer> --status archived
53
52
  ec thread list <peer> --sort recent --limit 20
54
53
  ec thread list <peer> --format json
55
54
  ```
@@ -86,7 +85,7 @@ ec msg history --thread <threadId>
86
85
 
87
86
  ```bash
88
87
  ec thread create <peer> --name '项目A需求讨论'
89
- ec thread create <peer> --name '项目A' --label 项目A --status in_progress
88
+ ec thread create <peer> --name '项目A' --status active
90
89
  ```
91
90
 
92
91
  创建成功后返回 `threadId`,格式为 `thread-<ms>-<seq4>-<rand4>`(如 `thread-1791028341906-0000-136a`)。创建时会自动向对端发一条系统消息通知。
@@ -96,12 +95,10 @@ ec thread create <peer> --name '项目A' --label 项目A --status in_progress
96
95
  ```bash
97
96
  ec thread rename <threadId> '新名称'
98
97
  ec thread rename main:<aidA>:<aidB> '新名称' # 主话题改名
99
- ec thread label <threadId> 重要
100
- ec thread label <threadId> --clear # 清除标签
101
- ec thread status <threadId> completed # pending|in_progress|completed|archived
98
+ ec thread status <threadId> closed # active|closed|archived
102
99
  ```
103
100
 
104
- 主话题可以改名(落在会话存档的 `name` 字段),但**不能**打标签或改状态——label/status 只对话题生效。
101
+ 主话题可以改名(落在会话存档的 `name` 字段),但**不能**改状态——status 只对话题生效。
105
102
  `current` 可能解析到主话题;执行状态更新前先运行 `ec thread show current --format json`,确认
106
103
  `threadId` 是 `thread-...`。若是 `main:...`(显示为 `[主话题]`),跳过 `ec thread status`,
107
104
  只写 summary 或直接回复结果。
@@ -326,12 +323,14 @@ ec thread check-index # 同 rebuild-index --check
326
323
 
327
324
  ## 话题状态值
328
325
 
329
- | 值 | 含义 |
330
- |---|---|
331
- | `pending` | 待开始(默认) |
332
- | `in_progress` | 进行中 |
333
- | `completed` | 已完成 |
334
- | `archived` | 已归档 |
326
+ | 值 | 含义 | 收到新消息时 |
327
+ |---|---|---|
328
+ | `active` | 正常讨论(默认) | 正常处理 |
329
+ | `closed` | 讨论完毕(模型判定) | 自动回退 `active` 并正常处理 |
330
+ | `archived` | 已归档,不再响应 | 不处理。私聊回「话题已归档」,群聊静默丢弃 |
331
+
332
+ `closed` 是可逆的软状态,仍出现在默认列表里;`archived` 才从默认列表隐藏。话题的**进展**写在 summary,
333
+ 不要用状态表达任务进度。
335
334
 
336
335
  ## 常见错误码
337
336
 
@@ -72,6 +72,11 @@ flowchart TD
72
72
 
73
73
  Agent Owner 和 DaemonOwner 是两个独立身份维度。一个人可以同时拥有两者,但不能仅凭某个 Agent 的 Owner 角色推导出主机所有权。
74
74
 
75
+ 角色定义(包括权限、模型约束和额度)的创建、修改、删除、重置由 DaemonOwner 管理。
76
+ Agent Owner 可为所属 Agent 设置默认角色、给指定关系分配或撤销已有角色,以及审批关系角色申请。
77
+ 定义写入使用 `role.policy.write`,默认与关系分配使用 `role.assign/revoke`;Admin 和自定义角色不能越过此边界。
78
+ 可信 fullaccess 沿用下述通用授权,角色配额入口不再另行要求目标 Agent Owner 身份。
79
+
75
80
  ```text
76
81
  Owner + bypass
77
82
  = Agent Owner 身份
@@ -29,6 +29,16 @@
29
29
 
30
30
  ## 查询
31
31
 
32
+ 执行授权使用创建者的当前身份,和执行会话、结果投递对象分开。新定义的 `creator` 由 daemon
33
+ 从已认证会话固定记录,普通修改不能替换创建者;角色和权限模式在执行时重新判定,不持久授权。
34
+ 调度器把身份绑定到本次 run/attempt 后交给模型或脚本,目标话题的 owner/admin 角色不能提权。
35
+ daemon 来源使用独立的 `daemon-service` 身份,不映射为关系 owner;fullaccess 仍验证批准来源。
36
+ 工具执行边界继续核验身份和策略变化。重启恢复由调度器按原 checkpoint 重新授权,队列中的旧
37
+ Trigger 消息不能凭 `originControl` 或其他序列化字段自行恢复权限。
38
+
39
+ Owner 与同 Owner 证据共用 30 分钟缓存及查询退避。证据暂不可用时保持 Trigger 启用并延后重试;
40
+ 明确的权限失效才停用并通知。以前已经停用的 Trigger 不会因升级自动启用。
41
+
32
42
  ```bash
33
43
  ec trigger list
34
44
  ec trigger list --all
@@ -159,6 +159,18 @@
159
159
  },
160
160
  "description": "跨话题上下文注入(来源话题 + 空洞提示 + 复查 Trigger)"
161
161
  },
162
+ {
163
+ "id": "msg-interrupt-insert",
164
+ "type": "file",
165
+ "file": "$KITS_MESSAGE_FRAGMENTS/interrupt-insert.md",
166
+ "order": 1,
167
+ "needsInjection": true,
168
+ "when": {
169
+ "var": "isInterruptInsert",
170
+ "eq": true
171
+ },
172
+ "description": "中断插入提示:只给因上一轮被新消息中断而插入的那一条挂一行标记(与 kind 正交,不改变该条自身的信封渲染)"
173
+ },
162
174
  {
163
175
  "id": "msg-private-default",
164
176
  "type": "file",