evolcore 0.0.41-test.0 → 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.
- package/CHANGELOG.md +62 -0
- package/dist/agents/baseagent-availability.js +1 -1
- package/dist/agents/baseagent.js +88 -49
- package/dist/agents/claude-runner.js +177 -92
- package/dist/agents/codex-runner.js +146 -71
- package/dist/agents/ecagent-runner.js +1 -1
- package/dist/agents/gemini-runner.js +1 -1
- package/dist/aun/aid/agentmd.js +98 -11
- package/dist/aun/aid/client.js +1 -1
- package/dist/aun/aid/control-aid.js +26 -2
- package/dist/aun/aid/identity.js +91 -0
- package/dist/aun/aid/index.js +1 -1
- package/dist/aun/aid/managed-operation.js +1 -1
- package/dist/aun/aid/ownership-operation.js +23 -22
- package/dist/aun/group/fs-download.js +39 -0
- package/dist/aun/group/identity.js +36 -21
- package/dist/aun/group/operations.js +5 -0
- package/dist/aun/menu/client.js +27 -0
- package/dist/aun/msg/managed-operation.js +68 -7
- package/dist/aun/msg/p2p.js +8 -8
- package/dist/aun/service-proxy.js +53 -12
- package/dist/channels/aun.js +633 -32
- package/dist/channels/daemon.js +15 -1
- package/dist/cli/agent-command.js +5 -2
- package/dist/cli/agent-create.js +991 -233
- package/dist/cli/agent.js +49 -10
- package/dist/cli/aid-bind-command.js +48 -19
- package/dist/cli/aun-commands.js +48 -36
- package/dist/cli/daemon-commands.js +679 -697
- package/dist/cli/fs-command.js +64 -2
- package/dist/cli/index.js +72 -5
- package/dist/cli/init-channel.js +1 -1
- package/dist/cli/init.js +75 -1
- package/dist/cli/managed-command-guard.js +17 -1
- package/dist/cli/model.js +40 -40
- package/dist/cli/provider-command.js +57 -0
- package/dist/cli/proxy-command.js +92 -0
- package/dist/cli/restart-monitor.js +4 -2
- package/dist/cli/role.js +85 -0
- package/dist/cli/stats.js +10 -3
- package/dist/cli/task-context.js +19 -0
- package/dist/config/access-policy.js +7 -2
- package/dist/config/boot-log.js +39 -1
- package/dist/config/config-field-policy.js +17 -39
- package/dist/config/config-manager.js +183 -44
- package/dist/config/config-operation-service.js +5 -19
- package/dist/config/contact-book-store.js +47 -21
- package/dist/config/contact-book.js +18 -12
- package/dist/config/contact-operation-service.js +3 -4
- package/dist/config/contact-request-service.js +11 -0
- package/dist/config/daemon-services.js +11 -0
- package/dist/config/gateway-config.js +88 -594
- package/dist/config/owner-config.js +2 -2
- package/dist/config/peer-role-resolver.js +15 -12
- package/dist/config/provider-ipc-service.js +132 -0
- package/dist/config/provider-menu-request.js +58 -0
- package/dist/config/providers-config.js +12 -7
- package/dist/config/providers-import.js +3 -21
- package/dist/config/providers-management.js +78 -5
- package/dist/config/resolved-config-op.js +11 -1
- package/dist/config/role-command-service.js +166 -0
- package/dist/config/role-request-service.js +193 -0
- package/dist/config/schema-migration.js +1000 -25
- package/dist/config-store.js +89 -4
- package/dist/contracts/ecweb-instance.js +41 -0
- package/dist/contracts/ecweb-service-protocol.js +4 -1
- package/dist/core/agent-application-service.js +60 -11
- package/dist/core/agent-create-status.js +203 -0
- package/dist/core/agent-creation-claim.js +177 -0
- package/dist/core/agent-ipc-registration.js +39 -18
- package/dist/core/agent-runtime.js +194 -24
- package/dist/core/auth/agent-delegation.js +6 -3
- package/dist/core/auth/auth-gateway.js +67 -2
- package/dist/core/auth/authorization-audit.js +58 -11
- package/dist/core/auth/delegation-authorization.js +5 -2
- package/dist/core/auth/operation-authorizer.js +43 -6
- package/dist/core/auth/operation-catalog.js +45 -7
- package/dist/core/channel-loader.js +2 -0
- package/dist/core/command/agent-control.js +260 -21
- package/dist/core/command/agent-storage-menu.js +5 -3
- package/dist/core/command/cli-intent-parser.js +8 -3
- package/dist/core/command/command-handler.js +112 -154
- package/dist/core/command/connect-menu.js +11 -3
- package/dist/core/command/data-root-resolver.js +5 -4
- package/dist/core/command/memory-slash.js +16 -8
- package/dist/core/command/menu-catalog.js +10 -6
- package/dist/core/command/menu-handler.js +106 -73
- package/dist/core/command/menu-protocol.js +15 -1
- package/dist/core/command/provider-menu.js +46 -0
- package/dist/core/command/role-menu.js +147 -30
- package/dist/core/command/slash-handler.js +125 -255
- package/dist/core/daemon-control.js +26 -27
- package/dist/core/event-catalog.js +10 -0
- package/dist/core/evolagent-registry.js +7 -5
- package/dist/core/evolagent.js +10 -8
- package/dist/core/file-integrity/store.js +11 -0
- package/dist/core/handoff/ipc-registration.js +3 -0
- package/dist/core/inference/text-inference.js +31 -40
- package/dist/core/initialization/service.js +491 -0
- package/dist/core/ipc-registration.js +40 -24
- package/dist/core/memory/consolidation-context.js +51 -5
- package/dist/core/memory/consolidation-ops-records.js +96 -1
- package/dist/core/memory/consolidation-trigger.js +208 -191
- package/dist/core/memory/consolidation.js +333 -35
- package/dist/core/memory/index-manager.js +27 -5
- package/dist/core/memory/memory-admin.js +45 -5
- package/dist/core/memory/memory-writer.js +163 -18
- package/dist/core/memory/relation-idle-monitor.js +119 -58
- package/dist/core/memory/relation-sweep.js +55 -45
- package/dist/core/message/aun-ipc-sender.js +81 -69
- package/dist/core/message/im-renderer.js +25 -4
- package/dist/core/message/message-admission.js +89 -4
- package/dist/core/message/message-bridge.js +66 -21
- package/dist/core/message/response-engine.js +108 -35
- package/dist/core/model/catalog-service.js +5 -3
- package/dist/core/model/config-scope.js +29 -71
- package/dist/core/model/field-scope.js +1 -1
- package/dist/core/model/model-catalog.js +30 -41
- package/dist/core/model/model-diagnostics.js +4 -3
- package/dist/core/model/model-fallback.js +10 -7
- package/dist/core/model/model-permission.js +3 -2
- package/dist/core/ownership/owner-resolver.js +772 -158
- package/dist/core/permission/approval-gateway.js +103 -403
- package/dist/core/permission/ec-command-parser.js +62 -6
- package/dist/core/permission/index.js +1 -0
- package/dist/core/permission/permission-result.js +78 -0
- package/dist/core/permission/sandbox-runtime.js +18 -1
- package/dist/core/permission/tool-policy.js +21 -46
- package/dist/core/relation/peer-identity.js +64 -1
- package/dist/core/role/runtime-policy.js +72 -13
- package/dist/core/session/session-capsule.js +1 -1
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +20 -0
- package/dist/core/session/session-renew.js +3 -3
- package/dist/core/skill/index-generator.js +15 -5
- package/dist/core/system-session/memory.js +43 -8
- package/dist/core/thread/thread-service.js +19 -6
- package/dist/directory/owner-directory-admission.js +95 -0
- package/dist/directory/owner-directory-authorization.js +309 -0
- package/dist/directory/owner-directory-cache.js +635 -0
- package/dist/eck/kit-renderer.js +2 -2
- package/dist/ecweb/basic-settings-service.js +33 -40
- package/dist/ecweb/init-menu.js +32 -0
- package/dist/ecweb/message-context-service.js +110 -0
- package/dist/index.js +93 -19
- package/dist/ipc.js +247 -29
- package/dist/paths.js +7 -0
- package/dist/proxy/command.js +122 -0
- package/dist/proxy/ipc-service.js +68 -0
- package/dist/proxy/manager.js +484 -0
- package/dist/proxy/service-supervisor.js +603 -0
- package/dist/response-system/engines/v1/proactive-flow.js +16 -6
- package/dist/trigger/authorization.js +27 -17
- package/dist/trigger/feedback.js +2 -3
- package/dist/trigger/ipc-service.js +105 -78
- package/dist/trigger/local-files.js +2 -1
- package/dist/trigger/manager.js +5 -3
- package/dist/trigger/scheduler.js +88 -6
- package/dist/utils/atomic-write.js +28 -0
- package/dist/utils/cross-platform.js +14 -0
- package/dist/utils/ecweb-supervisor.js +258 -83
- package/dist/utils/error-utils.js +26 -2
- package/dist/utils/logger.js +92 -6
- package/dist/utils/package-version-info.js +4 -2
- package/dist/utils/welcome.js +1 -1
- package/kits/docs/INDEX.md +1 -0
- package/kits/docs/aun/SDK.md +4 -1
- package/kits/docs/channels/aun.md +9 -0
- package/kits/docs/evolcore/INDEX.md +1 -0
- package/kits/docs/evolcore/agent.md +8 -1
- package/kits/docs/evolcore/aid.md +67 -17
- package/kits/docs/evolcore/config.md +28 -7
- package/kits/docs/evolcore/contact.md +3 -0
- package/kits/docs/evolcore/fs.md +11 -0
- package/kits/docs/evolcore/group.md +1 -1
- package/kits/docs/evolcore/memory-architecture.md +2 -2
- package/kits/docs/evolcore/memory-consolidation.md +32 -8
- package/kits/docs/evolcore/memory.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +4 -0
- package/kits/docs/evolcore/model.md +23 -20
- package/kits/docs/evolcore/msg.md +4 -7
- package/kits/docs/evolcore/provider.md +50 -0
- package/kits/docs/identity/AID_PROFILE_SPEC.md +52 -17
- package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
- package/kits/rules/01-overview.md +3 -0
- package/kits/rules/04-relation.md +1 -1
- package/kits/schemas/_meta.json +37 -4
- package/kits/schemas/agent-config.schema.13.json +8 -3
- package/kits/schemas/agent-config.schema.16.json +891 -0
- package/kits/schemas/daemon.schema.9.json +366 -0
- package/kits/schemas/defaults.schema.5.json +406 -127
- package/kits/schemas/relation-config.schema.11.json +277 -0
- package/kits/schemas/role-config.schema.1.json +7 -7
- package/kits/skills/.switches.json +4 -0
- package/kits/skills/ec-agent-create/SKILL.md +3 -0
- package/kits/skills/ec-identity/SKILL.md +2 -2
- package/kits/skills/ec-service-proxy/SKILL.md +118 -0
- package/kits/skills/ec-skill/scripts/skill.mjs +6 -0
- package/kits/skills/personal-assistant/SKILL.md +176 -0
- package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
- package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
- package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
- package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
- package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
- package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
- package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
- package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
- package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
- package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
- package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
- package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
- package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
- package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
- package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
- package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
- package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
- package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
- package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
- package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
- package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
- package/kits/skills/thread-ops/SKILL.md +5 -0
- package/kits/templates/memory-consolidation/forget.md +19 -6
- package/kits/templates/memory-consolidation/notes.md +1 -1
- package/kits/templates/memory-consolidation/profile.md +2 -2
- package/kits/templates/memory-consolidation/promote.md +20 -3
- package/kits/templates/roles/member.json +8 -1
- package/kits/templates/system-fragments/baseagent.md +2 -2
- package/kits/templates/system-fragments/memory.md +4 -4
- package/kits/templates/system-fragments/venue.md +1 -1
- package/package.json +7 -3
- package/dist/core/message/create-status.js +0 -96
|
@@ -38,8 +38,14 @@
|
|
|
38
38
|
**统一入口 `launchConsolidation()`**:所有触发路径——关系整理链、手动调用、定时检查、上下文压缩、renew / `/new`——都收口到这一个函数。它负责整理的完整生命周期:启动前把 `pending/` 加锁移入 `processing/`,序列化上下文文件,**直接创建整理会话**,会话结束后通过 `onConsolidationComplete` 处理收尾(归位、checkpoint、定稿索引、反馈)。
|
|
39
39
|
|
|
40
40
|
**整理一律以关系为单位**,一个会话只处理一个关系。触发方:
|
|
41
|
-
-
|
|
42
|
-
-
|
|
41
|
+
- **关系整理链**(主路径,内容驱动):每个关系一个计时器,对该关系依次跑 notes → generalize → promote(仅 owner 关系),每步收尾后再判定下一步。
|
|
42
|
+
- 空闲到期:最后一次活动后 `idleHours`(默认 1 小时)没有新活动。只跑候选攒够 `minBatchItems`(默认 3)条的步骤,不够的推迟。
|
|
43
|
+
- 兜底到期:最早一次未整理的活动满 `maxUnconsolidatedHours`(默认 8 小时),持续聊天也会到期。有 1 条候选就跑。
|
|
44
|
+
- 候选:notes 数 pending 里的 note,generalize 数本关系 `to-generalize`,promote 数本关系 **与 agent 层**的 `to-promote`。
|
|
45
|
+
- 活动:真实入站(含群里未被 @ 的消息;owner 插话不算)、往该关系写 note、群链按发言人写入该关系。
|
|
46
|
+
- 触发来源 `relation-idle`,**不反馈**。
|
|
47
|
+
- **定时检查**(时间驱动):evolcore trigger 的 `script` 模式每小时执行,逐关系检查画像到期(profile:还没有画像且已有记忆,或画像生成后有新建记忆且画像满 `profileRegenDays`;距上次尝试不满 `profileRegenDays` 不再拉起)和关系层超期记忆(forget),外加 agent 层、owner 层的 forget。agent 层有 `to-promote` 时也在这里按 owner 关系兜底拉起 promote(标签不是 generalize 打的,或泛化收尾时还没有 owner 关系目录)。一个会话只处理一个关系或一层,同样的整理已在排队或在跑时跳过。
|
|
48
|
+
- **泛化收尾跨层触发**:generalize 会话成功收尾时,若 agent 层有 `to-promote`,立即按 owner 关系拉起 promote(排在本 agent 的串行队列里,槽位一空就跑)。本次 generalize 若就是 owner 关系整理链的一步则跳过——链的下一步就是 promote。agent 级记忆不挂任何关系,关系整理链等不到它的空闲,这是它的主路径;agent 层标签不攒批,有 1 条就跑。触发来源 `relation-idle`,不反馈。
|
|
43
49
|
- **手动 / compact / renew / `/new`**:直接对当前关系调用 `launchConsolidation()`。
|
|
44
50
|
|
|
45
51
|
**并发与排队**:同一 agent 同时只能有一个整理会话在跑;全局最多 5 个 agent 并发。超出的请求排队,前一个结束后自动启动下一个。
|
|
@@ -52,7 +58,7 @@
|
|
|
52
58
|
|---|---|---|---|---|
|
|
53
59
|
| `notes` | 当前关系的 `pending/` + 会话历史 | relation 正式记忆 | 值不值得长期留下 | 否 |
|
|
54
60
|
| `generalize` | 关系级里带 `to-generalize` 的记忆 | agent 正式记忆 | **普遍性**:换成别的对端也成立 | 否 |
|
|
55
|
-
| `promote` |
|
|
61
|
+
| `promote` | 关系级与 agent 层带 `to-promote` 的记忆 | owner 正式记忆 | **权威性**:owner 定下、对所有 agent 有效 | **是** |
|
|
56
62
|
| `profile` | 该关系索引里的全部记忆 | 一条带 `profile` 标签的 relation 记忆 | 归纳对端这个主体 | 否 |
|
|
57
63
|
| `forget` | mtime 超过 `forgetAfterDays` 的记忆 | 无新结论,只做续期 / 合并 / 归档 | 这条还成立吗 | 否 |
|
|
58
64
|
|
|
@@ -79,6 +85,7 @@ ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话
|
|
|
79
85
|
- **目标 slug 已存在且未在 `--replaces` 里列出 → 拒绝**,报错回传已有文件路径。这是防止漏用 `--replaces` 导致静默覆盖的闸门。
|
|
80
86
|
- **正文上限 10KB**,超出报 `MEMORY_TOO_LARGE`。这不是技术限制,而是记忆的性质决定的:一条记忆应当是**一句话能说清的结论**。内容确实那么多时,拆成多条分别 `create`,或把细节留在归档文件里、记忆只记结论。
|
|
81
87
|
- `--reason` 写进批次目录的 `ops.jsonl` 操作流水,不进记忆正文。结论属于记忆,判断依据属于过程记录。
|
|
88
|
+
- forget 模式下 `update` / `archive` / `create --replaces` 必须带 `--reason`(≤80 字,针对这一条记忆),`update` 只能 `--touch`,`archive` 一次一条;理由另记入遗忘日志(见第八节)。
|
|
82
89
|
|
|
83
90
|
### 跨层路径
|
|
84
91
|
|
|
@@ -140,7 +147,8 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
140
147
|
**其他写入限制**:
|
|
141
148
|
|
|
142
149
|
- **整理一律以关系为单位:带前缀的路径里 peerKey 必须是本次会话所属关系**,所有模式都一样。整理会话的可读根只含当前关系的 `consolidated/`,允许写别的关系等于对读不到的目录做归档,绕过 grants 边界。没有所属关系的会话(owner 层 / agent 层 forget)不接受带前缀的路径。
|
|
143
|
-
-
|
|
150
|
+
- 保留前缀 `agent/` 指本 agent 的 `personal/memory/consolidated/`(`agent/consolidated/x.md`)。它不是关系名,不受"必须是所属关系"限制;promote 从 agent 层取候选时用它寻址。
|
|
151
|
+
- 唯一的例外是群聊 notes 的 `--peer`:按发言人把记忆写进发言人自己的关系。被写入的关系在群的整理链结束后各记一次活动,按它自己的空闲 / 兜底计时整理。
|
|
144
152
|
- `profile` 标签的记忆,一个关系只能有一条。重新生成必须用 `--replaces` 指定旧的那条。
|
|
145
153
|
- `to-promote` 只能打在对端是 owner 的关系上。群聊关系额外检查发言人身份,owner 本人说的话可以打。
|
|
146
154
|
- 全局总开关是 `memory.enableRelation`。它关闭时,五种模式和手动调用全部拒绝。
|
|
@@ -156,7 +164,7 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
156
164
|
**`notes` 模式**的输入是:
|
|
157
165
|
|
|
158
166
|
- `pending/` 里的全部 note
|
|
159
|
-
- 会话历史(整理会话带了该关系的路由时生成话题快照:`compress` / `session-new` / `manual`,以及关系整理链 `relation-idle
|
|
167
|
+
- 会话历史(整理会话带了该关系的路由时生成话题快照:`compress` / `session-new` / `manual`,以及关系整理链 `relation-idle`、定时检查拉起的关系级 profile / forget;该关系没有入站记录、拿不到路由时没有会话历史,只能凭 note 本身判断)
|
|
160
168
|
- 现有的 `MEMORY.md` 索引(查重用)
|
|
161
169
|
|
|
162
170
|
**`launchConsolidation()` 在拉起整理会话之前会把 `pending/` 整体 rename 到 `processing/`**,相当于加锁声明认领。整理过程中主会话新写的 note 落在 `pending/`,不会被这次整理误伤,也不会被误删。
|
|
@@ -186,7 +194,11 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
186
194
|
- 往 `ops.jsonl` 追加一行 `summary`(created / updated / archived / errors 计数)。
|
|
187
195
|
- 导出整理会话历史到 `history.jsonl`。
|
|
188
196
|
|
|
189
|
-
|
|
197
|
+
整理会话里的 `create` / `update` / `archive` 只写文件、追加 `ops.jsonl`,**不重建索引**。收尾时按 `ops.jsonl` 里出现过的层逐层 `rebuildIndex`(`collectAffectedScopes`),失败回撤之后也重建一次,把索引对齐到磁盘现状。只有 `ec memory demote` 会在写完后即时重建源层与目标层。
|
|
198
|
+
|
|
199
|
+
**失败 / 中断的回撤**:按 `ops.jsonl` 倒序撤掉成功的写操作(create 删文件并还原被归档的旧文件;archive 从 `archive/` 移回;update 恢复 tags、`updatedAt`、mtime),每一步都过完整性台账。撤掉的如果是遗忘日志里记过的操作,同一份日志会补一行「撤销…」(来源 `rollback:<批次目录名>`)。
|
|
200
|
+
|
|
201
|
+
> daemon 中途退出时收尾不会执行,这批日志就没有对应的「撤销」行。下一轮遗忘看到同一批记忆时照常按内容重新判断,日志只如实记录发生过什么,不做自动对账。
|
|
190
202
|
|
|
191
203
|
上一批的 `processing/` 还在时(会话未结束,或 daemon 中途重启丢了收尾),新一轮 notes 整理不迁移 `pending/`,避免两批混在一起。
|
|
192
204
|
|
|
@@ -234,9 +246,21 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
234
246
|
├── processing/ # 整理中快照
|
|
235
247
|
├── consolidated/ # 正式记忆(已登记完整性台账),文件名即 <slug>.md
|
|
236
248
|
└── archive/
|
|
237
|
-
|
|
249
|
+
├── consolidated/ # 归档的正式记忆
|
|
250
|
+
├── notes/ # 整理完成的 pending 原件
|
|
251
|
+
└── FORGET-LOG.md # 遗忘日志(审计记录,不是记忆,不进索引)
|
|
238
252
|
```
|
|
239
253
|
|
|
254
|
+
**遗忘日志** `archive/FORGET-LOG.md`:遗忘机制每动一条记忆,就在该记忆所在层追加一行,记时间、动作、记忆、理由、来源。只追加,不随整理批次目录清理。
|
|
255
|
+
|
|
256
|
+
| 动作 | 何时写 | 来源列 |
|
|
257
|
+
|---|---|---|
|
|
258
|
+
| `续期` / `归档` / `合并归档→<新slug>` | forget 会话的 `update --touch` / `archive` / `create --replaces` | 批次目录名 |
|
|
259
|
+
| `撤销续期` / `撤销归档` / `撤销合并` | forget 会话失败,回撤上面的操作 | `rollback:<批次目录名>` |
|
|
260
|
+
| `手动归档` / `恢复` | `/memory archive` / `/memory restore` | `slash:<发起人 AID>` |
|
|
261
|
+
|
|
262
|
+
其他模式 `--replaces` 产生的归档、长期记忆的推迟审查都不写。整理会话读不到这份日志,每次审查按记忆内容重新判断。
|
|
263
|
+
|
|
240
264
|
**索引**:每个作用域一份,上限 `memory.indexMaxBytes`(默认 5KB)。重建时**逐份过完整性台账**:被带外修改的先恢复到最后登记的版本再进索引,被改动且无法恢复的跳过、不移动文件。筛选顺序:
|
|
241
265
|
|
|
242
266
|
1. `important`、`urgent`、`profile` 必进,**永不淘汰**
|
|
@@ -254,7 +278,7 @@ daemon 按整理会话的模式校验 `--scope`:
|
|
|
254
278
|
|
|
255
279
|
没进索引的文件仍留在磁盘上,可以搜到;只有 `archive` 才让它下线。
|
|
256
280
|
|
|
257
|
-
**整理批次**:`$EVOLCORE_HOME/memory/consolidation-batches/`,每次整理建一个批次目录,命名为 `YYYYMMDDTHHmmss-<selfAid>-<mode>/`,目录内含 `context.md`(任务书)、`ops.jsonl`(操作流水)、`threads
|
|
281
|
+
**整理批次**:`$EVOLCORE_HOME/memory/consolidation-batches/`,每次整理建一个批次目录,命名为 `YYYYMMDDTHHmmss-<selfAid>-<mode>/`,目录内含 `context.md`(任务书)、`ops.jsonl`(操作流水)、`threads/`(话题快照)。每次拉起整理时程序只保留最新的 10 个批次目录(所有 agent、所有模式共用这 10 个名额),更早的整个删掉。遗忘日志不在批次目录里,不受清理影响。详细结构见 `memory-consolidation-batches.md`。
|
|
258
282
|
|
|
259
283
|
---
|
|
260
284
|
|
|
@@ -73,7 +73,7 @@ ec memory consolidate [--mode <notes|generalize|promote|profile|forget>]
|
|
|
73
73
|
| `generalize` | 关系级 → agent 级 | 对端说「不管跟谁聊你都要记得这个」 |
|
|
74
74
|
| `promote` | 关系级 → owner 级 | owner 说「让我所有 Agent 都记住这个」 |
|
|
75
75
|
| `profile` | 生成/重建当前对端画像 | owner 说「重新生成一下画像」 |
|
|
76
|
-
| `forget` | 评估超期记忆续期或归档 |
|
|
76
|
+
| `forget` | 评估超期记忆续期或归档 | 一般不手动:关系层、agent 层、owner 层都由定时检查发起 |
|
|
77
77
|
|
|
78
78
|
**命令是异步的**:`launchConsolidation()` 在拿到整理会话的 base agent 会话 ID 后命令即退出,不等整理会话完成。输出示例:
|
|
79
79
|
|
|
@@ -122,6 +122,10 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
122
122
|
}
|
|
123
123
|
```
|
|
124
124
|
|
|
125
|
+
`/model` 与 `/effort` 的更新只写当前 Agent 的 Agent 级配置(`baseagents.<baseagent>.model` / `effort`),
|
|
126
|
+
只有当前 Agent 的 owner / admin 可以执行;`args.scope` 被忽略,没有关系级模型。关系菜单不再提供模型与推理强度项,
|
|
127
|
+
对应设置项为 Agent 菜单的 `model.agent` / `effort.agent`。查询返回 Agent 级配置经角色约束后的值;Agent 级未配置时 `model` 为 `null`。
|
|
128
|
+
|
|
125
129
|
`name="session"` 且 `args.resource="loop"` 时,`value` 必须是 JSON boolean:
|
|
126
130
|
`true` 开启当前可信主话题或话题的一次闲置触发,`false` 关闭;开启时可在
|
|
127
131
|
`args.idleSeconds` 指定 30–86400 的整数,省略时使用 300 秒。目标由当前关系和可信
|
|
@@ -1,54 +1,57 @@
|
|
|
1
1
|
# ec model - 模型管理命令集
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
查看或设置 agent 使用的模型与推理强度。模型参数只在 Agent 级配置:`agents/<aid>/config.json` 的 `baseagents.<baseagent>.model` / `effort`。关系级配置和 `agents/defaults.json` 都不承载模型参数;Agent 级未设置模型时,该 Agent 没有模型可用,收到消息会回复“未配置模型”提示,不回落任何默认模型。
|
|
4
|
+
|
|
5
|
+
`ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
|
|
4
6
|
|
|
5
7
|
## 命令
|
|
6
8
|
|
|
7
9
|
```bash
|
|
8
|
-
#
|
|
10
|
+
# 列出可用模型并显示当前 Agent 级模型
|
|
9
11
|
ec model list [--self <aid>] [--peer <peer>] [--role <role>]
|
|
10
12
|
|
|
11
|
-
#
|
|
13
|
+
# 显示 Agent 级模型(经角色约束)、推理强度和配置来源
|
|
12
14
|
ec model current [--self <aid>] [--peer <peer>] [--role <role>]
|
|
13
15
|
|
|
14
16
|
# 查看单个模型详情
|
|
15
17
|
ec model info <model-id> [--self <aid>]
|
|
16
18
|
|
|
17
|
-
#
|
|
18
|
-
ec model use <model-id> --self <aid> [--
|
|
19
|
+
# 设置 Agent 级模型,可同时设置推理强度
|
|
20
|
+
ec model use <model-id> --self <aid> [--effort <level>]
|
|
19
21
|
|
|
20
|
-
#
|
|
21
|
-
ec model effort <level> --self <aid>
|
|
22
|
+
# 设置 Agent 级推理强度:low | medium | high | xhigh | max | auto
|
|
23
|
+
ec model effort <level> --self <aid>
|
|
22
24
|
|
|
23
|
-
#
|
|
24
|
-
ec model reset --self <aid>
|
|
25
|
+
# 清除 Agent 级模型和推理强度;清除后该 Agent 无模型可用
|
|
26
|
+
ec model reset --self <aid>
|
|
25
27
|
|
|
26
|
-
#
|
|
28
|
+
# 诊断网关连通性、模型目录和 Agent 级模型可用性
|
|
27
29
|
ec model check [--self <aid>]
|
|
28
30
|
```
|
|
29
31
|
|
|
30
32
|
## 作用域
|
|
31
33
|
|
|
32
|
-
| 参数 |
|
|
33
|
-
|
|
34
|
-
| 无 | 只读 catalog
|
|
35
|
-
| `--self <aid>` |
|
|
36
|
-
| `--self <aid> --role <role>` |
|
|
37
|
-
| `--self <aid> --peer <peer>` |
|
|
34
|
+
| 参数 | 用途 | 配置位置 |
|
|
35
|
+
|------|------|----------|
|
|
36
|
+
| 无 | 只读 catalog | 不允许写入 |
|
|
37
|
+
| `--self <aid>` | Agent 级读写 | `agents/<aid>/config.json` |
|
|
38
|
+
| `--self <aid> --role <role>` | 按角色策略预览有效模型 | 只读;角色策略由角色策略编辑器管理 |
|
|
39
|
+
| `--self <aid> --peer <peer>` | 按该对端的关系角色预览有效模型 | 只读;`use` / `effort` / `reset` 带 `--peer` 直接拒绝(`MODEL_AGENT_ONLY`) |
|
|
38
40
|
|
|
39
|
-
|
|
41
|
+
角色策略只约束 Agent 级模型(模型白名单、固定模型),不提供模型:Agent 级未设置模型时,角色策略不会补出一个模型。`--peer` 使用 `channelType#channelId`;裸 AID 按 `aun#<aid>` 处理。
|
|
40
42
|
|
|
41
|
-
在 EvolCore 托管会话中,所有 `ec model` 子命令都通过 daemon 的 `ec ctl` 路径作用于已认证的当前会话,不能指定 `--self`、`--peer` 或 `--role
|
|
43
|
+
在 EvolCore 托管会话中,所有 `ec model` 子命令都通过 daemon 的 `ec ctl` 路径作用于已认证的当前会话,不能指定 `--self`、`--peer` 或 `--role`;上表的显式参数只用于宿主终端。需要读取或修改持久化模型配置时,使用 `ec config`,由 daemon 按实际角色和目标范围鉴权。本机终端不具备隐式当前会话语义。
|
|
42
44
|
|
|
43
45
|
帮助查询不选择目标或执行操作,`ec model list --self <aid> --help` 等形式仍可查看帮助。
|
|
44
46
|
|
|
45
47
|
## 输出与权限
|
|
46
48
|
|
|
47
49
|
- 所有子命令支持 `--format json`。
|
|
48
|
-
-
|
|
50
|
+
- 从聊天菜单、slash 命令或 agent 工具调用时,命令会在执行前经过 operation 鉴权。
|
|
51
|
+
- `use`、`effort`、`reset` 只能写 Agent 级,且只有当前 Agent 的 owner / admin(或 DaemonOwner)可以执行;这是代码级上限,角色文件授予 `model.*` 也不能让其他角色写入。member、visitor 只能查看。
|
|
49
52
|
- 本地终端直接运行时不伪造远端角色。显式传入 `--role` 可检查该角色的模型可见性和有效模型。
|
|
50
53
|
- `use`、`effort`、`reset` 不直接修改角色策略;传入 role 写作用域会返回 `ROLE_POLICY_MANAGED`。
|
|
51
|
-
- `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API 探测。
|
|
54
|
+
- `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API 探测。Agent 级未配置模型时,“配置模型”一步标记为失败。
|
|
52
55
|
|
|
53
56
|
## 模型参数与执行窗口
|
|
54
57
|
|
|
@@ -80,18 +80,15 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
80
80
|
|
|
81
81
|
托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
ec contact add <target-aid> --self <self-aid>
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
该命令在托管会话中会创建/更新联系人申请并给 Owner 发送审核卡片;`blocked` 目标必须先执行:
|
|
83
|
+
托管会话主动执行 `ec msg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
|
|
84
|
+
`declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
|
|
90
85
|
|
|
91
86
|
```bash
|
|
92
87
|
ec contact unblock <target-aid> --self <self-aid>
|
|
93
88
|
```
|
|
94
89
|
|
|
90
|
+
`ec group send` 走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
|
|
91
|
+
|
|
95
92
|
非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
|
|
96
93
|
|
|
97
94
|
在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member` 默认只允许回复当前对端;要联系当前对端以外的对象,必须通过话题路由:先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用 `ec msg send '<text>' --thread <threadId> --check-every <时长>` 发送;from/to 由话题推断,无需手写。不带 `--thread` 直接改目标会被拒绝。`--check-every` 到期后,系统会向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 在自己的上下文里决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功 JSON 回执(含 `message_id`/`status`)不得声称已发送。
|
|
@@ -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
|
-
#
|
|
1
|
+
# agent.md 名片规范
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
|
10
|
-
|
|
|
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
|
-
##
|
|
46
|
+
## EvolCore 单边约束(与协议无关)
|
|
13
47
|
|
|
14
|
-
|
|
15
|
-
|
|
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 类型 |
|
|
@@ -3,9 +3,13 @@ import os from 'os';
|
|
|
3
3
|
import path from 'path';
|
|
4
4
|
import crypto from 'crypto';
|
|
5
5
|
import { fileURLToPath } from 'url';
|
|
6
|
+
import { createRequire } from 'node:module';
|
|
6
7
|
import Ajv from 'ajv';
|
|
7
8
|
|
|
8
9
|
const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
|
|
10
|
+
const requireCore = createRequire(import.meta.url);
|
|
11
|
+
// Use the same pure policy as the daemon. Published packages always include dist.
|
|
12
|
+
const { resolveAunTargetKind, verifiedPeerType } = requireCore('../../dist/aun/group/identity.js');
|
|
9
13
|
const SCHEMA_DIR = path.resolve(SCRIPT_DIR, '..', 'schemas');
|
|
10
14
|
const AGENT_LOCK_NAME = '.contact-book-mutation.lock';
|
|
11
15
|
const RECEIPT_NAME = 'contact-book-v2-relation-role-authority.json';
|
|
@@ -44,14 +48,6 @@ function isValidAid(name) {
|
|
|
44
48
|
return labels.length >= 3 && labels.every(label => /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(label));
|
|
45
49
|
}
|
|
46
50
|
|
|
47
|
-
function isExplicitGroupId(value) {
|
|
48
|
-
const id = String(value || '').trim();
|
|
49
|
-
return (id.startsWith('group.') && id.includes('/'))
|
|
50
|
-
|| /^\d+\.[a-z0-9.-]+$/i.test(id)
|
|
51
|
-
|| /^grp_[a-z0-9_-]+$/i.test(id)
|
|
52
|
-
|| /^g-[a-z0-9_-]+(?:[.@][a-z0-9.-]+)?$/i.test(id);
|
|
53
|
-
}
|
|
54
|
-
|
|
55
51
|
function readJson(file) {
|
|
56
52
|
const text = fs.readFileSync(file, 'utf8');
|
|
57
53
|
return { value: JSON.parse(text), text };
|
|
@@ -395,18 +391,37 @@ function planAgentMigration(home, aid, validators, changes, summary, backupRoles
|
|
|
395
391
|
if (!isRecord(rawContacts)) throw new Error(`${contactFile}: contacts must be an object`);
|
|
396
392
|
const contacts = {};
|
|
397
393
|
const aliasOwners = new Map();
|
|
394
|
+
const resolvePeerKind = (peerAid, subjectType) => {
|
|
395
|
+
const peerKey = canonicalPeerKey('aun', peerAid);
|
|
396
|
+
const identityFile = path.join(relationsDir, peerKey, 'peer-identity.json');
|
|
397
|
+
const identity = fs.existsSync(identityFile) ? readJson(identityFile).value : undefined;
|
|
398
|
+
return resolveAunTargetKind({
|
|
399
|
+
targetKind: relations.get(peerKey)?.value.targetKind,
|
|
400
|
+
routeKind: subjectType === 'group' ? 'group' : subjectType === 'principal' ? 'private' : undefined,
|
|
401
|
+
verifiedType: verifiedPeerType(peerAid, identity),
|
|
402
|
+
});
|
|
403
|
+
};
|
|
398
404
|
|
|
399
405
|
for (const [primaryId, rawEntry] of Object.entries(rawContacts)) {
|
|
400
406
|
if (!isValidAid(primaryId)) throw new Error(`${contactFile}: invalid contact primary AID ${JSON.stringify(primaryId)}`);
|
|
401
407
|
if (!isRecord(rawEntry)) throw new Error(`${contactFile}: contact ${primaryId} must be an object`);
|
|
402
408
|
const unknown = Object.keys(rawEntry).filter(key => !CONTACT_KEYS.has(key));
|
|
403
409
|
if (unknown.length) throw new Error(`${contactFile}: contact ${primaryId} has unsupported fields ${unknown.join(', ')}`);
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
throw new Error(`${contactFile}: contact ${primaryId} has invalid subjectType ${JSON.stringify(subjectType)}`);
|
|
410
|
+
if (rawEntry.subjectType !== undefined && rawEntry.subjectType !== 'principal' && rawEntry.subjectType !== 'group') {
|
|
411
|
+
throw new Error(`${contactFile}: contact ${primaryId} has invalid subjectType ${JSON.stringify(rawEntry.subjectType)}`);
|
|
407
412
|
}
|
|
413
|
+
const kind = resolvePeerKind(primaryId, rawEntry.subjectType);
|
|
414
|
+
if (kind.reason !== 'missing' && kind.kind === 'unknown') {
|
|
415
|
+
throw new Error(`${contactFile}: contact ${primaryId} type is unknown (${kind.reason}); explicit type evidence is required`);
|
|
416
|
+
}
|
|
417
|
+
if (kind.kind === 'unknown' && rawEntry.role !== undefined) {
|
|
418
|
+
throw new Error(`${contactFile}: contact ${primaryId} has a role but its type is unknown; explicit type evidence is required`);
|
|
419
|
+
}
|
|
420
|
+
const subjectType = kind.kind === 'group' ? 'group' : kind.kind === 'private' ? 'principal' : undefined;
|
|
421
|
+
if (kind.kind === 'private') ensureRelation('aun', primaryId, 'private');
|
|
408
422
|
const contactRole = roleValue(rawEntry.role, roleIds, contactFile, `contact ${primaryId} role`);
|
|
409
423
|
if (contactRole) {
|
|
424
|
+
if (!subjectType) throw new Error(`${contactFile}: contact ${primaryId} role has no type evidence`);
|
|
410
425
|
const targetKind = subjectType === 'group' ? 'group' : 'private';
|
|
411
426
|
const relation = ensureRelation('aun', primaryId, targetKind);
|
|
412
427
|
if (relation.value.role === undefined) {
|
|
@@ -467,6 +482,10 @@ function planAgentMigration(home, aid, validators, changes, summary, backupRoles
|
|
|
467
482
|
const admin = String(rawAdmin || '').trim();
|
|
468
483
|
if (!isValidAid(admin)) throw new Error(`${agentFile}: invalid admin AID ${JSON.stringify(rawAdmin)}`);
|
|
469
484
|
if (owners.has(admin)) continue;
|
|
485
|
+
const kind = resolvePeerKind(admin);
|
|
486
|
+
if (kind.kind !== 'private') {
|
|
487
|
+
throw new Error(`${agentFile}: admin ${admin} requires private type evidence (${kind.reason}); roles do not establish peer type`);
|
|
488
|
+
}
|
|
470
489
|
const relation = ensureRelation('aun', admin, 'private');
|
|
471
490
|
if (relation.value.role !== 'admin') summary.adminsMigrated += 1;
|
|
472
491
|
relation.value.role = 'admin';
|
|
@@ -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`
|
|
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 渠道保持现有规则。
|
package/kits/schemas/_meta.json
CHANGED
|
@@ -4,16 +4,31 @@
|
|
|
4
4
|
"currentVersion": 1
|
|
5
5
|
},
|
|
6
6
|
"daemon": {
|
|
7
|
-
"currentVersion":
|
|
7
|
+
"currentVersion": 9
|
|
8
8
|
},
|
|
9
9
|
"defaults": {
|
|
10
|
-
"currentVersion": 5
|
|
10
|
+
"currentVersion": 5,
|
|
11
|
+
"history": []
|
|
11
12
|
},
|
|
12
13
|
"agent-config": {
|
|
13
|
-
"currentVersion":
|
|
14
|
+
"currentVersion": 16,
|
|
15
|
+
"history": [
|
|
16
|
+
{
|
|
17
|
+
"version": 16,
|
|
18
|
+
"date": "2026-10-27",
|
|
19
|
+
"description": "合并模型与 Provider 配置调整,并增加 Owner 通讯录和 Owner Agent 名录的入站联系开关;旧配置直接迁移到 v16"
|
|
20
|
+
}
|
|
21
|
+
]
|
|
14
22
|
},
|
|
15
23
|
"relation-config": {
|
|
16
|
-
"currentVersion":
|
|
24
|
+
"currentVersion": 11,
|
|
25
|
+
"history": [
|
|
26
|
+
{
|
|
27
|
+
"version": 11,
|
|
28
|
+
"date": "2026-10-27",
|
|
29
|
+
"description": "删除 baseagents/active_baseagent/model/models;关系级不承载模型参数;新增 sessionFullAccess,跨 EC session 保留主会话 /fa 开关"
|
|
30
|
+
}
|
|
31
|
+
]
|
|
17
32
|
},
|
|
18
33
|
"contact-book": {
|
|
19
34
|
"currentVersion": 3
|
|
@@ -29,12 +44,24 @@
|
|
|
29
44
|
}
|
|
30
45
|
},
|
|
31
46
|
"history": [
|
|
47
|
+
{
|
|
48
|
+
"schema": "agent-config",
|
|
49
|
+
"version": 16,
|
|
50
|
+
"date": "2026-10-27",
|
|
51
|
+
"description": "合并模型与 Provider 配置调整,增加 Owner 名录入站联系开关;旧配置直接迁移到 v16,保留既有 access 配置"
|
|
52
|
+
},
|
|
32
53
|
{
|
|
33
54
|
"schema": "providers",
|
|
34
55
|
"version": 1,
|
|
35
56
|
"date": "2026-10-20",
|
|
36
57
|
"description": "global providers managed by ConfigManager"
|
|
37
58
|
},
|
|
59
|
+
{
|
|
60
|
+
"schema": "daemon",
|
|
61
|
+
"version": 9,
|
|
62
|
+
"date": "2026-10-29",
|
|
63
|
+
"description": "add managed service runtime and health monitoring configuration for ServiceProxy"
|
|
64
|
+
},
|
|
38
65
|
{
|
|
39
66
|
"schema": "daemon",
|
|
40
67
|
"version": 8,
|
|
@@ -298,6 +325,12 @@
|
|
|
298
325
|
"version": 10,
|
|
299
326
|
"date": "2026-10-03",
|
|
300
327
|
"description": "[已撤销] add relation-level memory.verifySignature gate (AND-merged with agent level)"
|
|
328
|
+
},
|
|
329
|
+
{
|
|
330
|
+
"schema": "relation-config",
|
|
331
|
+
"version": 11,
|
|
332
|
+
"date": "2026-10-27",
|
|
333
|
+
"description": "remove relation-level model parameters (baseagents/active_baseagent/model/models); models are Agent-level only; persist main-session fullaccess controls independently of EC session replacement"
|
|
301
334
|
}
|
|
302
335
|
]
|
|
303
336
|
}
|
|
@@ -618,11 +618,16 @@
|
|
|
618
618
|
},
|
|
619
619
|
"idleHours": {
|
|
620
620
|
"type": "number",
|
|
621
|
-
"description": "
|
|
621
|
+
"description": "关系空闲时长(小时):一个关系最后一次活动(入站、写 note)后这么久没有新活动,触发该关系的整理链,只跑候选攒够 minBatchItems 的步骤。默认 1。"
|
|
622
622
|
},
|
|
623
623
|
"maxUnconsolidatedHours": {
|
|
624
624
|
"type": "number",
|
|
625
|
-
"description": "
|
|
625
|
+
"description": "关系兜底整理时长(小时):一个关系最早一次未整理的活动满这么久,即使仍在聊也触发整理链,有 1 条候选就跑。默认 8。"
|
|
626
|
+
},
|
|
627
|
+
"minBatchItems": {
|
|
628
|
+
"type": "number",
|
|
629
|
+
"minimum": 1,
|
|
630
|
+
"description": "空闲到期时一步至少攒够多少条候选才跑(note 条数 / to-generalize 条数 / to-promote 条数),不够的留给兜底。默认 3。"
|
|
626
631
|
},
|
|
627
632
|
"checkIntervalHours": {
|
|
628
633
|
"type": "number",
|
|
@@ -630,7 +635,7 @@
|
|
|
630
635
|
},
|
|
631
636
|
"backlogHours": {
|
|
632
637
|
"type": "number",
|
|
633
|
-
"description": "pending
|
|
638
|
+
"description": "已废弃,不再生效(pending 由关系空闲 / 兜底计时覆盖)。保留只为旧配置文件仍能通过校验。"
|
|
634
639
|
},
|
|
635
640
|
"indexMaxBytes": {
|
|
636
641
|
"type": "number",
|