evolcore 0.0.41-test.1 → 0.0.41-test.2

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 (127) hide show
  1. package/CHANGELOG.md +49 -36
  2. package/dist/agents/baseagent.js +68 -6
  3. package/dist/agents/codex-runner.js +62 -43
  4. package/dist/aun/aid/agentmd.js +98 -11
  5. package/dist/aun/aid/client.js +1 -1
  6. package/dist/aun/aid/control-aid.js +26 -2
  7. package/dist/aun/aid/identity.js +91 -0
  8. package/dist/aun/aid/index.js +1 -1
  9. package/dist/aun/aid/managed-operation.js +1 -1
  10. package/dist/aun/aid/ownership-operation.js +23 -22
  11. package/dist/aun/menu/client.js +27 -0
  12. package/dist/aun/msg/p2p.js +3 -8
  13. package/dist/aun/service-proxy.js +17 -0
  14. package/dist/channels/aun.js +321 -34
  15. package/dist/cli/agent-command.js +5 -2
  16. package/dist/cli/agent-create.js +991 -233
  17. package/dist/cli/agent.js +49 -10
  18. package/dist/cli/aid-bind-command.js +48 -19
  19. package/dist/cli/aun-commands.js +44 -16
  20. package/dist/cli/daemon-commands.js +1 -0
  21. package/dist/cli/index.js +24 -1
  22. package/dist/cli/init-channel.js +1 -1
  23. package/dist/cli/init.js +75 -1
  24. package/dist/cli/managed-command-guard.js +13 -1
  25. package/dist/cli/provider-command.js +57 -0
  26. package/dist/cli/restart-monitor.js +4 -2
  27. package/dist/cli/stats.js +10 -3
  28. package/dist/cli/task-context.js +19 -0
  29. package/dist/config/boot-log.js +3 -2
  30. package/dist/config/config-field-policy.js +12 -7
  31. package/dist/config/config-manager.js +138 -6
  32. package/dist/config/owner-config.js +2 -2
  33. package/dist/config/peer-role-resolver.js +2 -1
  34. package/dist/config/provider-ipc-service.js +132 -0
  35. package/dist/config/provider-menu-request.js +58 -0
  36. package/dist/config/providers-management.js +78 -5
  37. package/dist/config/resolved-config-op.js +8 -1
  38. package/dist/config/schema-migration.js +322 -8
  39. package/dist/config-store.js +10 -1
  40. package/dist/contracts/ecweb-service-protocol.js +2 -1
  41. package/dist/core/agent-application-service.js +60 -11
  42. package/dist/core/agent-create-status.js +203 -0
  43. package/dist/core/agent-creation-claim.js +177 -0
  44. package/dist/core/agent-ipc-registration.js +39 -18
  45. package/dist/core/agent-runtime.js +193 -23
  46. package/dist/core/auth/agent-delegation.js +4 -2
  47. package/dist/core/auth/auth-gateway.js +66 -1
  48. package/dist/core/auth/authorization-audit.js +41 -5
  49. package/dist/core/auth/delegation-authorization.js +2 -1
  50. package/dist/core/auth/operation-authorizer.js +28 -6
  51. package/dist/core/auth/operation-catalog.js +14 -1
  52. package/dist/core/channel-loader.js +2 -0
  53. package/dist/core/command/agent-control.js +257 -14
  54. package/dist/core/command/cli-intent-parser.js +6 -2
  55. package/dist/core/command/command-handler.js +64 -55
  56. package/dist/core/command/memory-slash.js +1 -1
  57. package/dist/core/command/menu-catalog.js +5 -0
  58. package/dist/core/command/menu-handler.js +64 -18
  59. package/dist/core/command/menu-protocol.js +15 -1
  60. package/dist/core/command/provider-menu.js +46 -0
  61. package/dist/core/command/slash-handler.js +2 -1
  62. package/dist/core/daemon-control.js +18 -13
  63. package/dist/core/event-catalog.js +10 -0
  64. package/dist/core/evolagent-registry.js +3 -1
  65. package/dist/core/evolagent.js +8 -6
  66. package/dist/core/file-integrity/store.js +11 -0
  67. package/dist/core/handoff/ipc-registration.js +3 -0
  68. package/dist/core/initialization/service.js +491 -0
  69. package/dist/core/ipc-registration.js +34 -22
  70. package/dist/core/memory/consolidation-ops-records.js +95 -0
  71. package/dist/core/memory/consolidation-trigger.js +19 -2
  72. package/dist/core/memory/consolidation.js +19 -8
  73. package/dist/core/memory/memory-admin.js +1 -1
  74. package/dist/core/memory/relation-sweep.js +11 -6
  75. package/dist/core/message/aun-ipc-sender.js +73 -67
  76. package/dist/core/message/im-renderer.js +18 -0
  77. package/dist/core/message/message-bridge.js +35 -3
  78. package/dist/core/message/response-engine.js +32 -28
  79. package/dist/core/model/catalog-service.js +1 -1
  80. package/dist/core/model/config-scope.js +5 -7
  81. package/dist/core/ownership/owner-resolver.js +755 -143
  82. package/dist/core/permission/approval-gateway.js +103 -403
  83. package/dist/core/permission/ec-command-parser.js +32 -4
  84. package/dist/core/permission/index.js +1 -0
  85. package/dist/core/permission/permission-result.js +78 -0
  86. package/dist/core/permission/tool-policy.js +7 -43
  87. package/dist/core/system-session/memory.js +37 -7
  88. package/dist/directory/owner-directory-cache.js +2 -2
  89. package/dist/ecweb/init-menu.js +32 -0
  90. package/dist/index.js +17 -5
  91. package/dist/ipc.js +85 -25
  92. package/dist/paths.js +3 -0
  93. package/dist/proxy/manager.js +6 -7
  94. package/dist/trigger/authorization.js +27 -17
  95. package/dist/trigger/feedback.js +2 -3
  96. package/dist/trigger/ipc-service.js +105 -78
  97. package/dist/trigger/local-files.js +2 -1
  98. package/dist/trigger/manager.js +5 -3
  99. package/dist/trigger/scheduler.js +88 -6
  100. package/dist/utils/atomic-write.js +28 -0
  101. package/dist/utils/error-utils.js +24 -0
  102. package/dist/utils/logger.js +68 -1
  103. package/dist/utils/welcome.js +1 -1
  104. package/kits/docs/INDEX.md +1 -0
  105. package/kits/docs/aun/SDK.md +4 -1
  106. package/kits/docs/evolcore/INDEX.md +1 -0
  107. package/kits/docs/evolcore/agent.md +8 -1
  108. package/kits/docs/evolcore/aid.md +67 -17
  109. package/kits/docs/evolcore/config.md +11 -1
  110. package/kits/docs/evolcore/group.md +1 -1
  111. package/kits/docs/evolcore/provider.md +50 -0
  112. package/kits/docs/identity/AID_PROFILE_SPEC.md +52 -17
  113. package/kits/rules/01-overview.md +3 -0
  114. package/kits/rules/04-relation.md +1 -1
  115. package/kits/schemas/_meta.json +2 -2
  116. package/kits/schemas/agent-config.schema.16.json +3 -3
  117. package/kits/schemas/relation-config.schema.11.json +17 -0
  118. package/kits/skills/.switches.json +8 -0
  119. package/kits/skills/ec-agent-create/SKILL.md +3 -0
  120. package/kits/skills/ec-identity/SKILL.md +2 -2
  121. package/kits/skills/ec-skill/scripts/skill.mjs +6 -0
  122. package/kits/skills/ec-trigger/SKILL.md +5 -13
  123. package/kits/skills/thread-ops/SKILL.md +5 -0
  124. package/kits/templates/system-fragments/venue.md +1 -1
  125. package/package.json +3 -3
  126. package/dist/core/memory/forget-log.js +0 -96
  127. package/dist/core/message/create-status.js +0 -96
@@ -138,7 +138,7 @@ ec group rules <from> <group-id> publish
138
138
 
139
139
  ## 收到群邀请:Owner 审核
140
140
 
141
- Agent 的 AUN 主渠道收到定向邀请后,由 daemon 查询待处理邀请并向当前 `owners[]` 的每位 Owner
141
+ Agent 的 AUN 主渠道收到定向邀请后,由 daemon 查询待处理邀请并向当前协议共识 Owner
142
142
  发送加密私聊卡片。卡片提供“接受入群”和“拒绝邀请”;收到邀请不会自动加入,也不启动模型。
143
143
  接受/拒绝操作先记录决定,再查询当前邀请并调用 SDK,最终结果另行通知 Owner。
144
144
 
@@ -0,0 +1,50 @@
1
+ # ec provider — 宿主 Provider 注册表
2
+
3
+ 管理 daemon 级 providers.json;单数命令 provider,没有 providers 别名。仅宿主控制终端可执行,要求 daemon 在线和本机 control token。Agent 托管任务携带会话或 delegation 凭据时返回 FORBIDDEN;Agent owner/admin 不等于 DaemonOwner。帮助无需 daemon 或配置。
4
+
5
+ ## 命令集
6
+
7
+ ~~~text
8
+ ec provider list [--format json]
9
+ ec provider show <provider-id> [--format json]
10
+ ec provider create --file <path> [--format json]
11
+ ec provider import --file <path> [--format json]
12
+ ec provider update <provider-id> --file <path> [--format json]
13
+ ec provider delete <provider-id> [--format json]
14
+ ~~~
15
+
16
+ - list/show 返回完整脱敏配置和 revision;API key、headers、queryParams 中的凭据不回显。
17
+ - create/update 的文件必须是单个完整 Provider 对象;update 仅替换已存在的 ID,不是字段 patch 或 upsert。
18
+ - import 还接受只有一项的 Provider ID 映射或 providers 包装。每次仅导入一个 Provider,忽略源 ID、始终生成新 provider-N;不自动覆盖或合并。
19
+ - 文件为 UTF-8(可带 BOM),不超过 1 MiB。CLI 将绝对路径交给 daemon 读取,不在 argv 传递 JSON 或凭据;无 --text 参数。
20
+ - update 中的 <redacted> 保留对应旧凭据;省略字段表示清除。create/import 不接受脱敏占位符。
21
+ - delete 遇到 defaults、Agent 或 relation 的 Provider/fallback 引用时拒绝,返回非敏感引用路径;没有 force/级联删除。配置损坏或引用目录不可读时也拒绝删除。
22
+
23
+ ## 完整对象示例
24
+
25
+ ~~~json
26
+ {
27
+ "name": "Example",
28
+ "common": {
29
+ "baseUrl": "https://example.test/v1",
30
+ "apiKey": "$EXAMPLE_API_KEY"
31
+ },
32
+ "services": { "text": {} }
33
+ }
34
+ ~~~
35
+
36
+ apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
37
+
38
+ ## 输出与并发
39
+
40
+ 文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
41
+
42
+ 常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、FORBIDDEN(Agent 托管入口)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
43
+
44
+ 不提供 if-revision 等参数。daemon 自动读取当前 revision 并通过共享层 CAS 提交;冲突时不自动重试。配置变更用于后续新请求,无需 reload/restart;首次安装本功能的 daemon 代码仍需宿主重新加载。
45
+
46
+ ## Menu 对应
47
+
48
+ 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。
49
+
50
+ 只接受 DaemonOwner Control 或已认证 ECWeb Menu,Agent Channel 拒绝;Control 写入必须加密。Catalog 仅发布 process 条目,provider.list 支持 menu values 查询。完整示例与错误语义见仓库 docs/provider-menu-protocol-design.md。
@@ -1,26 +1,61 @@
1
- # AID 档案规范
1
+ # agent.md 名片规范
2
2
 
3
- <!-- TODO: 填充 AID 档案格式规范 -->
3
+ `https://{aid}/agent.md` 是主体在 AUN 网络上的标准名片,格式为 YAML frontmatter + Markdown 正文 + 尾部签名块。
4
4
 
5
- ## 档案类型
5
+ ## 权威来源
6
6
 
7
- | 类型 | 位置 | 说明 |
7
+ | 文档 | 说明 |
8
+ |------|------|
9
+ | `$AUN_PROTOCOL_DOCS/Ownership协议定义2.1.md` §2.3 | 当前权威;字段定义、group/org 分支、六态共识 |
10
+ | `$AUN_PROTOCOL_DOCS/../agent.md/SCHEMA.md` | Ownership 2.0 历史版本,仅供参考 |
11
+ | `node_modules/@agentunion/fastaun/dist/agent-md-schema.js` | 运行时实际校验逻辑,谁说了算以它为准 |
12
+
13
+ (`$AUN_PROTOCOL_DOCS` = `$PACKAGE_ROOT/node_modules/@agentunion/fastaun/_packed_docs/protocol`)
14
+
15
+ ## 字段约束(运行时生效)
16
+
17
+ **必填**:
18
+
19
+ | 字段 | 类型 | 约束 |
8
20
  |------|------|------|
9
- | 自身人格 | `$SELF_DIR/persona.md` | 行为规范、人格定义 |
10
- | 关系档案 | `$RELATIONS_DIR/<peerKey>/profile.md` | 对端关系记录(含具体群实例) |
21
+ | `aid` | string | DNS 型正则 `^[A-Za-z0-9_][A-Za-z0-9_-]*(\.[A-Za-z0-9_][A-Za-z0-9_-]*)+$` |
22
+ | `name` | string | 非空 |
23
+ | `type` | string | 非空;可扩展,预设值见下表 |
24
+ | `version` | string | 严格 SemVer `\d+\.\d+\.\d+` |
25
+
26
+ **可选**:
27
+
28
+ | 字段 | 约束 |
29
+ |------|------|
30
+ | `description` | string,≤100 码点 |
31
+ | `avatar` | string,≤256 码点 |
32
+ | `tags` | string[] |
33
+ | `exttype` | string,描述 `type` 的具体形态 |
34
+ | `owner` | AID 字符串(group/org 必填,human 禁止) |
35
+ | `ownership` | Ownership 2.1 声明对象 |
36
+ | `entity_cert_fingerprint` | `sha256:<64位小写hex>`(group/org 必填) |
37
+
38
+ **硬性约束**:payload ≤ 4096 字节,尾签区 ≤ 2048 字节,UTF-8,禁 YAML anchor/alias/tag。
39
+
40
+ ## type 预设值
41
+
42
+ `type` 是可扩展字符串,协议允许应用自定义。预设值:
43
+
44
+ `human` / `agent` / `group` / `service` / `device` / `org` / `host` / `custom`
11
45
 
12
- ## persona.md 结构
46
+ ## EvolCore 单边约束(与协议无关)
13
47
 
14
- ```markdown
15
- # <agent-name>
48
+ - `ec aid agentmd set` 可修改字段:`name` / `type` / `description` / `version` / `tags` / `exttype`
49
+ - 创建名片时默认值:`type=agent`、`description="EvolCore AI agent."`、`version="1.0.0"`
50
+ - `human` 禁止 `owner`/`ownership`;`group`/`org` 必须带 `owner` + `entity_cert_fingerprint`
16
51
 
17
- ## 基本信息
18
- - AID: <aid>
19
- - 名称: <name>
52
+ ## 示例文件
20
53
 
21
- ## 行为规范
22
- (定义称呼、语气、风格等)
54
+ 位于 `$PACKAGE_ROOT/node_modules/@agentunion/fastaun/_packed_docs/agent.md/examples/`:
23
55
 
24
- ## 能力声明
25
- (对外公开的能力描述)
26
- ```
56
+ | 文件 | 说明 |
57
+ |------|------|
58
+ | `human-developer.md` | human 类型 |
59
+ | `codeagent-claudecode.md` | agent 类型(Claude Code) |
60
+ | `signed-openclaw-lobster.md` | 带尾部签名的完整示例 |
61
+ | `群组-开发团队.md` | group 类型 |
@@ -40,6 +40,9 @@ AID(Agent Identifier)是主体在 AUN 网络中的唯一身份标识,格
40
40
  | `device` | 设备或嵌入式节点 |
41
41
  | `org` | 组织主体 |
42
42
  | `host` | EvolCore 控制主机的 daemon AID;名称通常为 `<Win/Linux/MacOS>主机-<aid前缀>` |
43
+ | `custom` | 自定义主体类型 |
44
+
45
+ 上表为预设值;协议允许应用扩展任意类型字符串,解析方应保留并容忍未知值。`exttype` 字段可进一步描述 `type` 的具体形态。
43
46
 
44
47
  > **群属于关系层**:`group` 是对端的一种,具体群实例的数据与其它对端一样落关系层
45
48
  > `$RELATIONS_DIR/<peerKey>/`(见 `04-relation.md`),不落环境层。
@@ -65,7 +65,7 @@ relations/
65
65
  | 自定义角色 | 按配置 | 缺失/非法时安全兜底 **`readonly`** | 按 agent 角色模板定义 |
66
66
  | none | — | — | 无有效关系角色,拒绝访问 |
67
67
 
68
- 角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。进程级 `daemon-owner` 与这里的
68
+ 角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。Agent 级 `owner` 角色只由当前有效的 Ownership 2.1 协议共识确定;进程级 `daemon-owner` 与这里的
69
69
  Agent/relation 角色正交,不会在 auth 层提升为 `owner`;AUN 的 Owner 只能由当前 Agent AID 的
70
70
  Ownership 2.1 新鲜共识确认,daemon/Agent 根配置和手写 relation.role 都不授予 Owner。
71
71
  DaemonOwner 仅获得明确列入进程控制面的操作权限。共识未知时不回退旧配置;非 AUN 渠道保持现有规则。
@@ -16,7 +16,7 @@
16
16
  {
17
17
  "version": 16,
18
18
  "date": "2026-10-27",
19
- "description": "合并 v15 模型与 Provider 配置调整,并增加 Owner 通讯录和 Owner Agent 名录的入站联系开关;旧配置直接迁移到 v16"
19
+ "description": "合并模型与 Provider 配置调整,并增加 Owner 通讯录和 Owner Agent 名录的入站联系开关;旧配置直接迁移到 v16"
20
20
  }
21
21
  ]
22
22
  },
@@ -48,7 +48,7 @@
48
48
  "schema": "agent-config",
49
49
  "version": 16,
50
50
  "date": "2026-10-27",
51
- "description": "合并 v15 模型与 Provider 配置调整,增加 Owner 名录入站联系开关;旧配置直接迁移到 v16,保留既有 access 配置"
51
+ "description": "合并模型与 Provider 配置调整,增加 Owner 名录入站联系开关;旧配置直接迁移到 v16,保留既有 access 配置"
52
52
  },
53
53
  {
54
54
  "schema": "providers",
@@ -105,15 +105,15 @@
105
105
  "type": "array",
106
106
  "items": {
107
107
  "type": "string",
108
- "description": "一个 Agent owner 的身份标识,通常为 AID。"
108
+ "description": "兼容的绑定目标 AID;初次绑定前可作为 Owner 兼容来源,协议关系建立后 Owner 以 Ownership 2.1 共识为准。"
109
109
  },
110
110
  "uniqueItems": true,
111
111
  "x-merge": "list",
112
- "description": "Agent 所有者身份列表;用于 owner 级控制和通知"
112
+ "description": "兼容的 Ownership 绑定目标列表;初次绑定前可作为 Owner 兼容来源,协议关系建立后不能作为 owner 级授权依据。"
113
113
  },
114
114
  "owner": {
115
115
  "type": "string",
116
- "description": "本地兼容的单个 Agent Owner AID;与 owners 合并读取",
116
+ "description": "本地兼容的单个 Ownership 绑定目标 AID;与 owners 合并读取,初次绑定前可作为 Owner 兼容来源",
117
117
  "x-merge": "scalar"
118
118
  },
119
119
  "fullaccess": {
@@ -160,6 +160,23 @@
160
160
  "type": "object",
161
161
  "x-merge": "dict"
162
162
  },
163
+ "baseagents": {
164
+ "type": "object",
165
+ "additionalProperties": false,
166
+ "description": "关系级仅可配置 runner 行为参数;model 与 effort 仅支持 Agent 级。",
167
+ "patternProperties": {
168
+ "^[a-z][a-z0-9_-]*$": {
169
+ "type": "object",
170
+ "additionalProperties": false,
171
+ "properties": {
172
+ "agentProgressSummaries": { "type": "boolean" },
173
+ "excludeDynamicSections": { "type": "boolean" },
174
+ "enableRequestUserInput": { "type": "boolean" }
175
+ }
176
+ }
177
+ },
178
+ "x-merge": "dict"
179
+ },
163
180
  "flush_delay": {
164
181
  "type": "number",
165
182
  "x-merge": "scalar"
@@ -23,6 +23,14 @@
23
23
  "enabled": true,
24
24
  "locked": true
25
25
  },
26
+ "ec-trigger": {
27
+ "enabled": true,
28
+ "locked": false
29
+ },
30
+ "ec-identity": {
31
+ "enabled": true,
32
+ "locked": false
33
+ },
26
34
  "ec-agent-create": {
27
35
  "enabled": true,
28
36
  "locked": false
@@ -21,6 +21,9 @@ license: MIT
21
21
 
22
22
  1. 确定新 Agent 的完整 AID、实际需求 Owner、项目路径和 base agent。
23
23
  AID 使用 `{name}.{issuer}`,如 `helper.agentid.cn`;不要从显示名猜测 AID。
24
+ daemon 控制 AID 不得复用为普通 Agent;已验签名片 `type: host` 的 AID 也不得复用。
25
+ 遇到 `CONTROL_AID_RESERVED` / `HOST_AID_RESERVED` 时停止该目标的创建,另选助手身份;
26
+ `--force` 不能绕过身份冲突。普通 `ec` 前缀不构成禁止条件,以实际身份用途为准。
24
27
  2. 使用 `ec agent list`、`ec agent show <aid>` 检查是否已有目标或创建记录。
25
28
  已有记录先检查进度和错误,不因上次命令超时就重新创建。
26
29
  3. 代办创建时,把实际需求 Owner 传给 `--owner`;创建者不必成为新 Agent 的 Owner。
@@ -100,14 +100,14 @@ ec contact unblock <aid> # 仅 owner
100
100
  - 托管会话里 `add` **不可以凭空加任何人**,只能针对当前私聊对端;结果进 `pending`,
101
101
  给 Owner 发审核卡片,Owner 点了"通过"才变 `active`。
102
102
  - `block` 只影响**本端入站**,不代表对端也拉黑了你。而且写操作会被 daemon 拒绝发送。
103
- - Owner 关系来自 `config.json` 的 `owners[]`,**不能用 `ec contact` 改**。
103
+ - Owner 关系以 Ownership 2.1 协议共识为准;`config.json` 的 `owner/owners` 只保留兼容绑定目标,不授予 Owner 权限。Owner 不能用 `ec contact` 改。
104
104
  列表里 `"source": "owner"` 的那些条目是自动物化的,不可删。
105
105
 
106
106
  ## 六、数据落在哪
107
107
 
108
108
  ```
109
109
  $EVOLCORE_HOME/agents/<selfAid>/
110
- ├── config.json ← Agent 配置(channels/models/owners),联系人不在里面
110
+ ├── config.json ← Agent 配置(channels/models/兼容绑定目标),联系人不在里面
111
111
  ├── contact.json ← ★ 联系人簿本体,独立 schema($schema_version: 3)
112
112
  └── data/contact/
113
113
  ├── operations.jsonl ← 每次变更的操作日志
@@ -99,6 +99,12 @@ function assertPermission(scope) {
99
99
  const chatType = ctx?.chatType;
100
100
  const target = scope === 'local' ? '本机级' : 'Agent 级';
101
101
 
102
+ // The daemon has already authenticated this task's fullaccess identity.
103
+ // Do not trust the environment marker by itself; it is only present here
104
+ // after the managed command context was validated through IPC.
105
+ if (ctx?.processRole === 'fullaccess-run' && ctx?.dataScope === 'daemon'
106
+ && ctx?.permissionMode === 'fullaccess' && ctx?.authorizedBy) return;
107
+
102
108
  if (chatType === 'group') {
103
109
  throw new Error(
104
110
  `拒绝:${target}技能开关不支持在群聊中操作。请在私聊中提出,或由管理员在宿主终端执行。`
@@ -36,24 +36,18 @@ license: MIT
36
36
  | 类型 | 谁在执行 | 用在哪 | 坑 |
37
37
  |---|---|---|---|
38
38
  | `trigger-session` | daemon 专属的 trigger 会话,**与用户对话隔离** | 周期巡检、生成摘要、独立判断。默认同 trigger 复用一条会话 | 只有它支持 `--baseagent`;`--trigger-thread per-run` 每次都开新会话 |
39
- | `target-session` | 把提示词**当成一条消息**投进目标会话,由那个会话的 agent 处理 | 要在用户的对话里、带着上下文做的**轻量**事;跨话题复查(`--check-every`) | 不支持 `feedback=silent`;也不支持 `execution.thread`。**不跑复杂任务**(见下) |
39
+ | `target-session` | 把提示词**当成一条消息**投进目标会话,由那个会话的 agent 处理 | 要在用户的对话里、带着上下文做的事;跨话题复查(`--check-every`) | 不支持 `feedback=silent`;目标会话被占用会等/冲突;也**不支持** `execution.thread` |
40
40
  | `script` | 确定性脚本,不过模型 | 只看数、查文件、调 IPC、算东西——**不需要模型判断**时优先用,又快又便宜 | 走沙箱,脚本不能读受保护路径;宿主执行要求独立批准 |
41
41
 
42
- **结论**:用户要"看到结果"→ trigger-session 跑完,用 target feedback 把**结论**投到用户会话。
43
- 用户要"带着对话上下文做点小事"(复查提醒、追问、确认,几句话内完成)→ target-session。
44
- 用户要"有人替我去做判断"→ trigger-session。脚本能做的别用模型。
45
-
46
- **target-session 不跑复杂任务**:它就在用户的会话里执行,中间过程全部挤进用户上下文,
47
- 执行期间还占用该会话(后到触发与用户消息都排队)。凡是生成/分析/巡检类输出可能超过
48
- 几句话的,一律 trigger-session 跑完再投递结论,别把重活塞进用户的主会话。
42
+ **结论**:用户要"看到结果"→ 让结果落在**用户会话**(trigger-session + target feedback,
43
+ 或 target-session)。用户要"有人替我去做判断"→ trigger-session。脚本能做的别用模型。
49
44
 
50
45
  ## 三、投递目标:结果落在哪
51
46
 
52
- `feedback.strategy` 四个可用值:
47
+ `feedback.strategy` 三个可用值:
53
48
 
54
49
  - **`target`** — 送到 `--target-*` 指定的会话。**最常用**。
55
50
  - **`origin`** — 送回创建它的那条会话。在某个话题里建、想回到该话题,用这个(比手写 target 稳)。
56
- - **`event_session`** — 事件触发专属:路由回**事件来源的那个会话**(如 `task:error` 回到出错会话、`session:idle` 回到闲置会话),复用其上下文与加密状态;找不到原会话时失败关闭。只在事件源下有意义。
57
51
  - **`silent`** — 不投递结果,只做副作用(只用于 `trigger-session` / `script`)。
58
52
 
59
53
  单聊最省事的写法(AUN):
@@ -88,9 +82,7 @@ ec trigger create --cron '0 9 * * *' --tz Asia/Shanghai \
88
82
 
89
83
  ## 五、反直觉的语义(文档没写透的)
90
84
 
91
- - **cron 按"下一个匹配时刻"计算,不是从创建时刻加整周期**:17:41 建 `0 */2 * * *`,
92
- `*/2` 匹配的是偶数小时(0/2/…/18),下一个匹配是 18:00——想"从现在起每 2 小时",
93
- 要按当前时刻对齐写表达式(如 `0 17-23/2 * * *`),或改用 `--every 2h`(真正的相对间隔)。
85
+ - **cron 从"创建那一刻"起算下一次**:17:41 建 `0 */2 * * *`,下次是 19:00,不是 18:00。
94
86
  - **一次性来源自动关**:`--once` / `--delay` / `--at` 跑完一轮自动 `disable`,定义保留。
95
87
  - **错过的时间点合并**:默认 `missedPolicy=run_once`,daemon 停机期间错过的几次只补跑一次。
96
88
  - **并发**:默认 `forbid`——同一会话正被另一个 run 占用时,**后到的直接被 skip**;
@@ -96,6 +96,11 @@ ec thread history <来源peer>/<来源threadId> --after <发送于的时间戳>
96
96
  2. 对端已给最终答案?→ **删除复查 + 回来源话题汇报**。
97
97
  3. 对端还在处理?→ 调整周期,或什么都不做。
98
98
 
99
+ **复查职责**:你仍是发出委托的本端 Agent。先确认当前话题是否收到对端的业务回复;
100
+ 上下文不足时读取当前话题历史。信封中的“原消息”是已发给对端的背景,不是本轮待执行任务,
101
+ 不要代替对端在本机查找源码或执行原委托。尚无业务回复时只输出 `[[NOOP]]`,不要重复发送原问题。
102
+ 无人值守复查不发起阻塞式用户问题;需要人工补充信息时,向来源话题说明缺口并结束本轮。
103
+
99
104
  ```bash
100
105
  ec trigger delete <trig_id> # 完成:删除,不留残留
101
106
  ec trigger update <trig_id> --every 30m # 放宽
@@ -6,7 +6,7 @@ PACKAGE_ROOT: {{PACKAGE_ROOT}} # evolcore 安装目录(kits/rules/docs)
6
6
  evolcoreMode: dev # evolcore 以源码仓库运行,$PACKAGE_ROOT/src 下的代码可直接查看和修改
7
7
  {{/}}
8
8
  {{?evolcoreMode=install}}
9
- evolcoreMode: install # evolcore 为全局安装包,$PACKAGE_ROOT 下代码可查看但不应直接修改;发现 bug 时生成 markdown 报告并通过附件消息发送给 evol.agentid.cn
9
+ evolcoreMode: install # evolcore 为全局安装包,$PACKAGE_ROOT 下代码可查看但不应直接修改;发现 bug 时可在本地生成 markdown 报告,只有用户明确要求时才外发
10
10
  {{/}}
11
11
  {{?venueUid}}
12
12
  venueUid: {{venueUid}}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evolcore",
3
- "version": "0.0.41-test.1",
3
+ "version": "0.0.41-test.2",
4
4
  "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -58,14 +58,14 @@
58
58
  "prepublishOnly": "npm test"
59
59
  },
60
60
  "dependencies": {
61
- "@agentunion/fastaun": "0.5.26",
61
+ "@agentunion/fastaun": "0.5.28",
62
62
  "@anthropic-ai/claude-agent-sdk": "0.3.300",
63
63
  "@modelcontextprotocol/sdk": "^1.29.0",
64
64
  "ajv": "^8.20.0",
65
65
  "chokidar": "^5.0.0",
66
66
  "cron-parser": "^5.5.0",
67
67
  "dotenv": "^17.4.2",
68
- "ec-web": "0.0.41-test.1",
68
+ "ec-web": "0.0.41-test.2",
69
69
  "ignore": "7.0.5",
70
70
  "image-type": "^6.0.0",
71
71
  "partial-json": "0.1.7",
@@ -1,96 +0,0 @@
1
- /**
2
- * forget-log.ts — 遗忘日志 FORGET-LOG.md(审计记录,不是记忆)
3
- *
4
- * 遗忘机制每动一条记忆,就在**该记忆所在层**的 `archive/FORGET-LOG.md` 追加一行:
5
- * 时间、动作、记忆、理由、来源。理由是针对这一条记忆的,不是针对一次整理的
6
- * (一次整理的总结是 feedback,见 consolidation-ops-records.ts)。
7
- *
8
- * 只记遗忘:forget 会话里的续期 / 归档 / 合并归档、它们的回撤,以及会话外的
9
- * `/memory archive` / `/memory restore`。其他模式 `--replaces` 产生的归档不记——
10
- * 那是记忆产生与泛化的过程,理由在 ops.jsonl。长期记忆的推迟审查(deferCandidate)
11
- * 只刷 mtime,也不记。
12
- *
13
- * 放在 archive/ 下:archive/ 不在任何索引与召回路径上(rebuildIndex 只扫 consolidated/,
14
- * `/memory list --archived` 只扫 archive/consolidated/),整理会话的读取范围也不含它。
15
- * 只追加、不轮转,不随整理批次目录清理。只由 daemon 写,模型只能经 ec memory 命令间接产生行。
16
- */
17
- import fs from 'fs';
18
- import path from 'path';
19
- import { logger } from '../../utils/logger.js';
20
- /** 审计日志,不是记忆,不进索引。路径相对 memory 根目录。 */
21
- export const FORGET_LOG_RELPATH = path.join('archive', 'FORGET-LOG.md');
22
- /** 理由上限(按码点计)。超长拒绝而不截断:截断会丢意思,让模型自己缩短。 */
23
- export const FORGET_REASON_MAX_CHARS = 80;
24
- const HEADER = [
25
- '# 遗忘日志',
26
- '',
27
- '> 审计记录,不是记忆,不进索引。由 daemon 追加,请勿手改。',
28
- '',
29
- '| 时间 | 动作 | 记忆 | 理由 | 来源 |',
30
- '|---|---|---|---|---|',
31
- '',
32
- ].join('\n');
33
- export function forgetLogPath(memoryDir) {
34
- return path.join(memoryDir, FORGET_LOG_RELPATH);
35
- }
36
- /** 理由归一:去首尾空白,换行与连续空白压成一个空格。 */
37
- export function normalizeForgetReason(raw) {
38
- return (raw ?? '').replace(/\s+/g, ' ').trim();
39
- }
40
- /** 校验理由:必填、≤80 字。返回归一后的理由,或给模型看的错误说明。 */
41
- export function checkForgetReason(raw) {
42
- const reason = normalizeForgetReason(raw);
43
- if (!reason) {
44
- return { ok: false, error: "forget 模式每条操作都要带 --reason '<理由>',说明这一条记忆为什么续期 / 归档 / 合并" };
45
- }
46
- const len = [...reason].length;
47
- if (len > FORGET_REASON_MAX_CHARS) {
48
- return { ok: false, error: `--reason 不能超过 ${FORGET_REASON_MAX_CHARS} 字(当前 ${len} 字),请缩短后重试` };
49
- }
50
- return { ok: true, reason };
51
- }
52
- /** 记忆文件路径 → slug。归档目标可能带时间戳后缀,调用方应传源路径。 */
53
- export function slugOfMemoryFile(filePath) {
54
- return path.basename(filePath).replace(/\.md$/, '');
55
- }
56
- /** 来源列:整理会话用批次目录名(带 agent AID,owner 层多 agent 共用时靠它区分)。 */
57
- export function batchSourceLabel(batchDir) {
58
- return batchDir ? path.basename(batchDir) : 'forget';
59
- }
60
- function cell(value) {
61
- return normalizeForgetReason(value).replace(/\|/g, '\\|');
62
- }
63
- function formatLocalTime(d) {
64
- const pad = (n) => String(n).padStart(2, '0');
65
- const offsetMin = -d.getTimezoneOffset();
66
- const sign = offsetMin >= 0 ? '+' : '-';
67
- const abs = Math.abs(offsetMin);
68
- return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} `
69
- + `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())} `
70
- + `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`;
71
- }
72
- /**
73
- * 追加一行。文件不存在时先写表头。
74
- * 失败只告警不抛:文件操作已经成功,不能因为日志写不进去让调用方以为操作失败。
75
- * 返回是否写入成功,回撤据此决定要不要补「撤销」行。
76
- */
77
- export function appendForgetLog(memoryDir, row) {
78
- const line = `| ${formatLocalTime(row.now ?? new Date())} | ${cell(row.action)} | ${cell(row.slug)} | ${cell(row.reason)} | ${cell(row.source)} |\n`;
79
- const filePath = forgetLogPath(memoryDir);
80
- try {
81
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
82
- try {
83
- fs.writeFileSync(filePath, HEADER, { encoding: 'utf-8', flag: 'wx' });
84
- }
85
- catch (e) {
86
- if (e?.code !== 'EEXIST')
87
- throw e;
88
- }
89
- fs.appendFileSync(filePath, line, 'utf-8');
90
- return true;
91
- }
92
- catch (e) {
93
- logger.warn(`[Memory] 遗忘日志写入失败(${filePath}): ${e?.message};未记入的行: ${line.trim()}`);
94
- return false;
95
- }
96
- }
@@ -1,96 +0,0 @@
1
- import fs from 'fs';
2
- import path from 'path';
3
- import { randomUUID } from 'node:crypto';
4
- import { creationOwnershipBinding } from '../ownership/owner-resolver.js';
5
- const FILE = 'create-status.json';
6
- export function readCreateStatus(agentDir) {
7
- try {
8
- const raw = fs.readFileSync(path.join(agentDir, FILE), 'utf-8');
9
- return JSON.parse(raw);
10
- }
11
- catch {
12
- return null;
13
- }
14
- }
15
- /** 删除构建进度文件(agent 删除时清理)。非 purge 删除只移除 config.json,
16
- * 故需显式清理本文件,避免目录残留陈旧进度。 */
17
- export function removeCreateStatus(agentDir) {
18
- try {
19
- fs.rmSync(path.join(agentDir, FILE), { force: true });
20
- }
21
- catch { /* ignore */ }
22
- }
23
- /** 构建进度写入器。每次状态变更原子落盘(写临时文件 + rename)。 */
24
- export class CreateStatusWriter {
25
- agentDir;
26
- status;
27
- creationId = randomUUID();
28
- constructor(agentDir, aid, context) {
29
- this.agentDir = agentDir;
30
- const now = Date.now();
31
- this.status = { aid, creationId: this.creationId, ...context, status: 'in_progress', currentPhase: null, steps: [], error: null, startedAt: now, updatedAt: now };
32
- fs.mkdirSync(agentDir, { recursive: true });
33
- this.flush(true);
34
- }
35
- begin(phase) {
36
- this.status.currentPhase = phase;
37
- this.status.steps.push({ phase, state: 'in_progress', ts: Date.now() });
38
- this.flush();
39
- }
40
- done(phase, detail) { this.mark(phase, 'done', detail); }
41
- warn(phase, detail) { this.mark(phase, 'warn', detail); }
42
- /** Immutable correlation; a later CLI bind/transfer must not replace it. */
43
- setOwnershipBinding(binding) {
44
- const expected = creationOwnershipBinding({
45
- operation: binding.operation, operation_id: binding.operationId,
46
- sub_aid: binding.subjectAid, owner_aid: binding.ownerAid,
47
- base_relation_version: binding.baseRelationVersion, target_relation_version: binding.targetRelationVersion,
48
- status: 'pending',
49
- }, this.status.aid, this.status.ownerAid ?? '');
50
- if (!this.status.requesterAid || binding.source !== 'agent_create' || !expected) {
51
- throw new Error('Creation Ownership binding does not match the creation request');
52
- }
53
- if (this.status.ownershipBinding) {
54
- if (this.status.ownershipBinding.operationId !== binding.operationId) {
55
- throw new Error('Creation Ownership binding is already recorded');
56
- }
57
- return;
58
- }
59
- if (this.status.status !== 'in_progress')
60
- throw new Error('Agent creation has already finished');
61
- this.status.ownershipBinding = expected;
62
- this.flush();
63
- }
64
- finishReady() { this.status.status = 'ready'; this.status.currentPhase = null; this.flush(); }
65
- finishFailed(phase, error) {
66
- this.mark(phase, 'failed', error);
67
- this.status.status = 'failed';
68
- this.status.error = error;
69
- this.status.currentPhase = null;
70
- this.flush();
71
- }
72
- mark(phase, state, detail) {
73
- const step = [...this.status.steps].reverse().find(s => s.phase === phase);
74
- if (step) {
75
- step.state = state;
76
- if (detail)
77
- step.detail = detail;
78
- step.ts = Date.now();
79
- }
80
- else {
81
- this.status.steps.push({ phase, state, detail, ts: Date.now() });
82
- }
83
- this.flush();
84
- }
85
- flush(initial = false) {
86
- // A failed worker or a deleted Agent must not overwrite a newer creation.
87
- if (!initial && readCreateStatus(this.agentDir)?.creationId !== this.creationId) {
88
- throw new Error('Agent creation record was removed or replaced');
89
- }
90
- this.status.updatedAt = Date.now();
91
- const file = path.join(this.agentDir, FILE);
92
- const tmp = `${file}.tmp`;
93
- fs.writeFileSync(tmp, JSON.stringify(this.status, null, 2));
94
- fs.renameSync(tmp, file);
95
- }
96
- }