evolcore 0.0.48 → 0.0.50
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 +97 -0
- package/bin/ecmsg.js +9 -4
- package/dist/ability/caller/authorization.js +21 -0
- package/dist/ability/caller/command.js +164 -0
- package/dist/ability/caller/contract.js +102 -0
- package/dist/ability/caller/daemon.js +158 -0
- package/dist/ability/caller/service.js +380 -0
- package/dist/ability/command-contract.js +5 -0
- package/dist/ability/daemon.js +5 -1
- package/dist/ability/interop-v1.js +10 -3
- package/dist/ability/management.js +1 -0
- package/dist/agent-template/jobs.js +173 -1
- package/dist/agent-template/runtime.js +285 -8
- package/dist/agent-template/service.js +1159 -40
- package/dist/agent-template/types.js +2 -1
- package/dist/agents/baseagent-availability.js +27 -3
- package/dist/agents/baseagent-capability-adapter.js +102 -0
- package/dist/agents/baseagent-plugin-descriptor.js +274 -0
- package/dist/agents/baseagent-plugin-loader.js +145 -0
- package/dist/agents/baseagent.js +68 -2
- package/dist/agents/claude-gateway/agent-registration.js +389 -0
- package/dist/agents/claude-gateway/binding.js +96 -0
- package/dist/agents/claude-gateway/inbox.js +138 -0
- package/dist/agents/claude-gateway/index.js +125 -0
- package/dist/agents/claude-gateway/listing.js +330 -0
- package/dist/agents/claude-gateway/router.js +328 -0
- package/dist/agents/claude-gateway/sessions.js +128 -0
- package/dist/agents/claude-gateway/terminal.js +250 -0
- package/dist/agents/claude-gateway/transcript.js +272 -0
- package/dist/agents/claude-gateway/types.js +14 -0
- package/dist/agents/claude-runner.js +6 -10
- package/dist/agents/codex-runner.js +9 -2
- package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
- package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
- package/dist/agents/gemini/index.js +51 -0
- package/dist/aun/aid/control-aid.js +52 -32
- package/dist/aun/group/invite-service.js +6 -36
- package/dist/aun/group/operations.js +6 -0
- package/dist/aun/msg/mention-schema.js +1 -1
- package/dist/aun/msg/p2p.js +31 -2
- package/dist/aun/msg/upload.js +126 -3
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +1175 -457
- package/dist/cli/ability-command.js +42 -0
- package/dist/cli/agent-command.js +20 -1
- package/dist/cli/agent-create.js +78 -18
- package/dist/cli/agent-template.js +5 -3
- package/dist/cli/agent.js +91 -0
- package/dist/cli/aun-commands.js +92 -34
- package/dist/cli/bench.js +5 -2
- package/dist/cli/config.js +22 -6
- package/dist/cli/daemon-commands.js +245 -101
- package/dist/cli/directory.js +6 -1
- package/dist/cli/ecmsg-gateway.js +11 -9
- package/dist/cli/index.js +30 -5
- package/dist/cli/init.js +39 -63
- package/dist/cli/managed-command-guard.js +3 -0
- package/dist/cli/menu-client.js +32 -7
- package/dist/cli/model.js +20 -5
- package/dist/cli/pay-command.js +30 -0
- package/dist/cli/provider-command.js +6 -2
- package/dist/cli/quota.js +89 -0
- package/dist/cli/restart-monitor.js +2 -2
- package/dist/cli/role.js +1 -0
- package/dist/cli/services-command.js +12 -9
- package/dist/cli/team-workspace-command.js +56 -2
- package/dist/cli/thread-command.js +78 -12
- package/dist/config/access-policy.js +16 -3
- package/dist/config/config-field-policy.js +88 -9
- package/dist/config/config-manager.js +97 -47
- package/dist/config/config-operation-service.js +22 -1
- package/dist/config/gateway-config.js +9 -8
- package/dist/config/owner-config.js +0 -16
- package/dist/config/peer-role-resolver.js +1 -7
- package/dist/config/providers-config.js +107 -20
- package/dist/config/providers-management.js +45 -21
- package/dist/config/resolved-config-op.js +4 -44
- package/dist/config/schema-migration.js +78 -5
- package/dist/config/schema-registry.js +52 -7
- package/dist/config-store.js +1309 -17
- package/dist/core/agent-application-service.js +220 -1
- package/dist/core/agent-ipc-registration.js +19 -2
- package/dist/core/agent-reload-coordinator.js +5 -0
- package/dist/core/agent-runtime.js +198 -54
- package/dist/core/auth/agent-delegation.js +14 -0
- package/dist/core/auth/delegation-authorization.js +33 -26
- package/dist/core/auth/operation-authorizer.js +16 -1
- package/dist/core/auth/operation-catalog.js +59 -7
- package/dist/core/baseagent-loader.js +30 -3
- package/dist/core/capability/capability-manager.js +16 -7
- package/dist/core/channel-runtime.js +4 -2
- package/dist/core/command/agent-control.js +20 -2
- package/dist/core/command/agent-template-menu.js +4 -3
- package/dist/core/command/cli-intent-parser.js +28 -0
- package/dist/core/command/command-handler.js +45 -2
- package/dist/core/command/menu-catalog.js +20 -4
- package/dist/core/command/menu-file-path.js +70 -0
- package/dist/core/command/menu-handler.js +97 -73
- package/dist/core/command/menu-protocol.js +29 -0
- package/dist/core/command/menu-query-batch.js +2 -2
- package/dist/core/command/private-mention-menu.js +71 -0
- package/dist/core/command/remote-shell.js +565 -0
- package/dist/core/command/slash-handler.js +17 -26
- package/dist/core/command/team-workspace-bootstrap.js +2 -1
- package/dist/core/command/topic-slash.js +7 -1
- package/dist/core/daemon-bootstrap.js +0 -4
- package/dist/core/daemon-control.js +58 -1
- package/dist/core/daemon-lifecycle.js +29 -7
- package/dist/core/evolagent-registry.js +18 -9
- package/dist/core/handoff/runtime.js +1 -1
- package/dist/core/host-snapshot.js +8 -3
- package/dist/core/initialization/service.js +3 -0
- package/dist/core/interaction-router.js +130 -0
- package/dist/core/ipc-registration.js +5 -0
- package/dist/core/memory/consolidation-context.js +2 -1
- package/dist/core/memory/consolidation.js +35 -64
- package/dist/core/message/aun-ipc-sender.js +213 -74
- package/dist/core/message/aun-request-registry.js +31 -0
- package/dist/core/message/contact-admission.js +91 -6
- package/dist/core/message/contact-pending-inbound.js +113 -0
- package/dist/core/message/contact-thread-approval.js +212 -0
- package/dist/core/message/im-renderer.js +40 -1
- package/dist/core/message/message-admission.js +5 -39
- package/dist/core/message/message-bridge.js +197 -45
- package/dist/core/message/message-log.js +32 -0
- package/dist/core/message/message-queue.js +102 -18
- package/dist/core/message/peer-mode.js +15 -4
- package/dist/core/message/response-engine.js +174 -26
- package/dist/core/message/send-options.js +37 -3
- package/dist/core/message/send-routing.js +11 -7
- package/dist/core/model/config-scope.js +6 -14
- package/dist/core/model/model-catalog.js +5 -5
- package/dist/core/model/model-diagnostics.js +19 -0
- package/dist/core/model/model-fallback.js +13 -2
- package/dist/core/ownership/owner-resolver.js +12 -86
- package/dist/core/pack-auth.js +7 -0
- package/dist/core/pack-install.js +1 -1
- package/dist/core/permission/ec-command-parser.js +288 -77
- package/dist/core/permission/protected-paths.js +64 -9
- package/dist/core/permission/services-path-acl.js +458 -0
- package/dist/core/permission/tool-policy.js +26 -10
- package/dist/core/relation/peer-identity.js +13 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
- package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
- package/dist/core/session/session-manager.js +47 -10
- package/dist/core/session/session-mapper.js +16 -0
- package/dist/core/skill/index-generator.js +2 -3
- package/dist/core/skill/switch-resolver.js +3 -0
- package/dist/core/task/task-recovery-service.js +1 -0
- package/dist/core/thread/command-parser.js +4 -1
- package/dist/core/thread/ipc-operation.js +4 -2
- package/dist/core/thread/thread-operation.js +25 -10
- package/dist/core/thread/thread-service.js +294 -55
- package/dist/core/thread/topic-id.js +67 -2
- package/dist/core/thread/types.js +15 -1
- package/dist/directory/owner-directory-admission.js +11 -8
- package/dist/directory/owner-directory-cache.js +19 -0
- package/dist/directory/owner-directory-markdown.js +1 -1
- package/dist/directory/owner-directory-policy.js +5 -30
- package/dist/directory/owner-directory-request-operation.js +5 -2
- package/dist/eck/kit-renderer.js +3 -2
- package/dist/eck/message-renderer.js +28 -5
- package/dist/ecweb/basic-settings-service.js +5 -9
- package/dist/ecweb/providers-service.js +4 -2
- package/dist/ecweb/runtime/supervisor.js +36 -8
- package/dist/event-center/center-config.js +9 -5
- package/dist/event-center/dispatcher.js +10 -1
- package/dist/event-center/ipc-operation.js +19 -0
- package/dist/event-center/registry.js +20 -5
- package/dist/event-center/runtime.js +10 -7
- package/dist/index.js +120 -41
- package/dist/ipc.js +83 -3
- package/dist/outputs/authorization.js +16 -0
- package/dist/outputs/cards.js +336 -0
- package/dist/outputs/events.js +3 -2
- package/dist/outputs/protocol.js +1 -0
- package/dist/outputs/service.js +2 -15
- package/dist/paths.js +48 -1
- package/dist/pay/command.js +38 -0
- package/dist/pay/protocol.js +136 -0
- package/dist/pay/runtime.js +188 -0
- package/dist/pay/service.js +384 -0
- package/dist/pay/store.js +81 -0
- package/dist/response-system/engines/v1/proactive-flow.js +29 -2
- package/dist/services/dispatcher.js +23 -5
- package/dist/services/host/main.js +388 -0
- package/dist/services/host/protocol.js +118 -0
- package/dist/services/host/resident.js +310 -0
- package/dist/services/host-client.js +386 -0
- package/dist/services/host-deploy.js +180 -0
- package/dist/services/host-launch.js +117 -0
- package/dist/services/host-recycle.js +203 -0
- package/dist/services/host-runtime.js +802 -0
- package/dist/services/idempotency.js +44 -86
- package/dist/services/index-generator.js +4 -3
- package/dist/services/index.js +204 -22
- package/dist/services/ipc-operation.js +288 -44
- package/dist/services/pack-manager.js +1 -0
- package/dist/services/script-runner.js +515 -83
- package/dist/services/service-payload.js +13 -7
- package/dist/services/validation.js +109 -4
- package/dist/stats/budget.js +1 -1
- package/dist/stats/model-resolver.js +2 -2
- package/dist/stats/quota-query.js +95 -0
- package/dist/trigger/application-service.js +6 -4
- package/dist/trigger/local-files.js +19 -9
- package/dist/trigger/scheduler.js +22 -12
- package/dist/trigger/script-sandbox.js +51 -8
- package/dist/utils/aid-bind.js +3 -0
- package/dist/utils/atomic-write.js +22 -8
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +173 -1
- package/dist/utils/logger.js +2 -2
- package/dist/utils/media-cache.js +190 -43
- package/dist/utils/npm-ops.js +43 -8
- package/dist/utils/restart-safety.js +14 -1
- package/dist/utils/system-memory.js +113 -25
- package/dist/utils/systemd-lifecycle.js +154 -0
- package/dist/utils/windows-shell-trust.js +7 -3
- package/dist/workbench/service.js +1 -1
- package/kits/docs/INDEX.md +3 -2
- package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/evolcore/INDEX.md +9 -6
- package/kits/docs/evolcore/agent.md +36 -1
- package/kits/docs/evolcore/aid.md +45 -3
- package/kits/docs/evolcore/config.md +5 -2
- package/kits/docs/evolcore/directory.md +8 -9
- package/kits/docs/evolcore/group.md +2 -1
- package/kits/docs/evolcore/memory-tags.md +2 -0
- package/kits/docs/evolcore/menu-client.md +3 -3
- package/kits/docs/evolcore/menu-protocol.md +7 -0
- package/kits/docs/evolcore/model.md +3 -0
- package/kits/docs/evolcore/msg.md +77 -10
- package/kits/docs/evolcore/pay.md +34 -0
- package/kits/docs/evolcore/provider.md +22 -1
- package/kits/docs/evolcore/quota.md +54 -0
- package/kits/docs/evolcore/role.md +3 -0
- package/kits/docs/evolcore/services.md +46 -18
- package/kits/docs/evolcore/stats.md +2 -0
- package/kits/docs/evolcore/thread-chain.md +2 -0
- package/kits/docs/evolcore/tool-authorization.md +10 -0
- package/kits/docs/evolcore/trigger.md +2 -0
- package/kits/rules/01-overview.md +11 -32
- package/kits/rules/02-navigation.md +7 -0
- package/kits/rules/06-channel.md +3 -3
- package/kits/schemas/_meta.json +38 -5
- package/kits/schemas/agent-config.schema.20.json +24 -0
- package/kits/schemas/agent-config.schema.21.json +974 -0
- package/kits/schemas/agent-config.schema.22.json +977 -0
- package/kits/schemas/agent-config.schema.23.json +958 -0
- package/kits/schemas/daemon.schema.10.json +373 -0
- package/kits/schemas/daemon.schema.9.json +12 -0
- package/kits/schemas/defaults.schema.7.json +472 -0
- package/kits/schemas/providers.schema.3.json +18 -2
- package/kits/schemas/relation-config.schema.13.json +289 -0
- package/kits/skills/.switches.json +17 -1
- package/kits/skills/ability/SKILL.md +229 -34
- package/kits/skills/ability/STRUCTURE.md +333 -0
- package/kits/skills/ability/references/cli.md +208 -0
- package/kits/skills/ability/references/development.md +107 -37
- package/kits/skills/ability/references/management.md +106 -46
- package/kits/skills/ability/references/runtime-protocol.md +65 -63
- package/kits/skills/agent-output-cards/SKILL.md +64 -0
- package/kits/skills/ec-group/SKILL.md +8 -6
- package/kits/skills/ec-group/TASK.md +186 -0
- package/kits/skills/ec-group/WORKLOG.md +180 -0
- package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
- package/kits/skills/ec-pay/SKILL.md +101 -0
- package/kits/skills/ec-pay/references/pay-cli.md +110 -0
- package/kits/skills/ec-provider/SKILL.md +58 -9
- package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
- package/kits/skills/ec-service-call/SKILL.md +135 -0
- package/kits/skills/ec-service-pack/SKILL.md +277 -0
- package/kits/skills/ec-trigger/SKILL.md +1 -1
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/workflow.md +46 -0
- package/kits/templates/roles/visitor.json +1 -0
- package/kits/templates/system-fragments/channel.md +13 -4
- package/kits/templates/system-fragments/commands.md +5 -3
- package/kits/templates/system-fragments/directory-contacts.md +3 -4
- package/kits/templates/system-fragments/reply.md +1 -0
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +27 -128
- package/kits/templates/system-fragments/venue.md +27 -0
- package/package.json +4 -5
- package/scripts/agent-template/inspect.mjs +79 -29
- package/scripts/agent-template/overlay.mjs +20 -2
- package/scripts/agent-template/shared/common.mjs +24 -6
- package/scripts/agent-template/shared/team-schema.json +23 -5
- package/scripts/agent-template/shared/template-contract.mjs +107 -17
- package/scripts/agent-template/shared/template-package.mjs +254 -29
- package/scripts/agent-template/shared/template-runtime.mjs +145 -2
- package/scripts/agent-template/shared/template.mjs +67 -9
- package/scripts/agent-template/team-pack.mjs +132 -41
- package/scripts/agent-template/team-preview.mjs +249 -5
- package/kits/docs/aun/ABILITY_CALLING.md +0 -280
- package/kits/docs/evolcore/ability.md +0 -185
- package/kits/skills/ability/references/calling.md +0 -56
- package/kits/skills/ability/references/contract-checklist.md +0 -37
- package/kits/skills/ability/references/recovery.md +0 -27
- /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
|
@@ -183,7 +183,10 @@ ConfigManager 只合并上述物理层并返回物理来源。角色策略不进
|
|
|
183
183
|
|
|
184
184
|
- `provider` 指 `~/.evolcore/providers.json` 里的服务商 id。网关连接信息(`baseUrl`、`apiKey`、
|
|
185
185
|
`headers`、`queryParams`)只存在于 providers.json,Agent 级不再承载,也不做 `${VAR}` 展开。
|
|
186
|
-
- `fallback`
|
|
186
|
+
- `fallback` 降级链最多 3 项,每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
|
|
187
|
+
Agent 级用 `ec config set baseagents.<baseagent>.fallback '<JSON 数组>' --self <aid>` 写入,空数组表示清除;
|
|
188
|
+
defaults 级仍只允许手工编辑 `agents/defaults.json`。写入成功不代表一定降级:候选模型不在目录、
|
|
189
|
+
不在角色允许范围、或 `effort` 不在该模型声明的强度列表里都会被过滤,`ec model check` 会打印被打回的条目。
|
|
187
190
|
- relation 层不承载 `baseagents`、`active_baseagent`、`model`、`models` 或 `Services`;这些字段在关系层会被剥离。
|
|
188
191
|
- `Services.<用途>`(如 `Services.decision`)也在 defaults 提供全局默认,Agent 可逐字段覆盖。
|
|
189
192
|
- Agent 和 defaults 均未设置模型时,Claude/Codex 回落到本机 CLI 配置;再缺省时使用 runner 的内置默认模型。推理强度按同一层级逐字段回落。
|
|
@@ -304,7 +307,7 @@ Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会
|
|
|
304
307
|
- **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。经 daemon 验证的 fullaccess 任务可绕过托管 CLI 顶层白名单和 H-Class 文件入口限制,但当前会话承载的 EvolCore 生命周期保护、参数校验和文件完整性校验仍生效。
|
|
305
308
|
- **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
|
|
306
309
|
- **基座 skill 总开关**:`baseagentSkills` 默认关闭,设为 `true` 统一开放;仅 Agent 级、仅 owner 可写(`ec config set`,Menu 协议经 `name=cli action=exec` 传同一 argv,ECWeb 编辑 Agent 抽屉),对所有基座统一生效(Claude 的 Skill 工具、Codex 的 skills);关闭时 `/capability` 的 skill 策略不可修改。它不影响 EC 技能,EC 技能用 `ec skill enable/disable` 管理
|
|
307
|
-
- **仅人可写**:channels /
|
|
310
|
+
- **仅人可写**:channels / admins / 凭证 / aid / enabled / projects / aun
|
|
308
311
|
- Agent 托管环境写仅人字段被拒
|
|
309
312
|
|
|
310
313
|
**操作权限**:
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
触发词:联系人/通讯录/名录/找人的 AID/这个人是谁/内外联系人/拉黑名单/记备注。
|
|
7
7
|
|
|
8
8
|
它不是联系人管理入口:谁能联系这个 Agent、名录里有哪些人,由 Owner 在 Evol App 里决定,
|
|
9
|
-
Agent
|
|
9
|
+
Agent 侧可以查询或向目标发送好友邀请,不能直接增删 Owner 名录条目。普通消息出站不需要先入录。
|
|
10
10
|
|
|
11
11
|
## 命令面
|
|
12
12
|
|
|
@@ -34,20 +34,19 @@ ec directory request <target-aid> [--note <申请说明>] [--format json]
|
|
|
34
34
|
|
|
35
35
|
## 申请加入 Owner 名录
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
需要显式申请与目标建立联系人关系时,执行:
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
40
|
ec directory request evolapplwj.agentid.cn --note "三藏希望了解项目接下来的工作重点"
|
|
41
41
|
```
|
|
42
42
|
|
|
43
|
-
`request` 自动确定本端 Agent
|
|
44
|
-
|
|
45
|
-
Evol App 中处理该申请,并把目标加入联系人名录、允许本 Agent 访问对应的联系人范围。
|
|
46
|
-
申请不会给目标发送消息,也不会修改本地名录、准入开关或自动重发原消息。
|
|
43
|
+
`request` 自动确定本端 Agent,向目标 AID 发送加密 `friend.invite.v1`,申请说明最多 500 字符。
|
|
44
|
+
目标根据其准入策略决定,或转交它的 Owner 审批。邀请不修改本地名录或自动重发此前的出站消息。
|
|
47
45
|
|
|
48
46
|
成功返回 `action: request`、`targetAid`、`status: sent` 和 `message_id`,
|
|
49
|
-
|
|
50
|
-
|
|
47
|
+
仅表示邀请已发送,不表示审批完成。普通消息出站可直接发送。
|
|
48
|
+
本端收到未准入的纯文本时,Core 收存原文并向自己的 Owner 申请;永久许可在名录成功应用后、
|
|
49
|
+
临时许可在落盘后自动恢复原消息,保留原发件人和话题。待收有效期 3 天,旧版只有摘要的隔离记录不能补恢复。
|
|
51
50
|
|
|
52
51
|
## list — 列举与关键词过滤
|
|
53
52
|
|
|
@@ -300,7 +299,7 @@ PA Team 里,该组为空、不渲染;Owner 手动把某人移出团队清单
|
|
|
300
299
|
|---|---|---|
|
|
301
300
|
| `list` / `info` / `refresh` / `blocked`(含旧名 `find` / `show`) | `ec.directory.query` | 只读 |
|
|
302
301
|
| `block` / `unblock` | `ec.directory.block` | 仅修改当前 Agent 的本地黑名单;按 Agent Owner + bypass 授权 |
|
|
303
|
-
| `request` | `ec.directory.request` |
|
|
302
|
+
| `request` | `ec.directory.request` | 向目标发送加密好友邀请;按 Agent Owner + bypass 授权 |
|
|
304
303
|
|
|
305
304
|
托管会话里 CLI 不直接读盘,携带 task delegation token 调 daemon `directory.op`;
|
|
306
305
|
缺 token、token 伪造或跨会话时失败关闭。显式 `--self` 必须等于当前任务所属 Agent。
|
|
@@ -22,6 +22,8 @@ ecmsg send --file <path> [--as <type>] [--text '<说明>']
|
|
|
22
22
|
|
|
23
23
|
# 自定义 payload
|
|
24
24
|
ecmsg send --payload '<json>'
|
|
25
|
+
# 注意:--payload-file 只支持私聊发送,群会话里会报「--payload-file is supported for
|
|
26
|
+
# private msg sends only」。群里要发复杂 JSON,用私聊发给对本项目有权限的 agent,或改用 --payload。
|
|
25
27
|
|
|
26
28
|
# 查询本地群历史(只读,不调用 Gateway,不推进 group pull/ack 游标)
|
|
27
29
|
ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format json]
|
|
@@ -48,7 +50,6 @@ ecmsg send '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
|
|
|
48
50
|
|
|
49
51
|
发送选项还包括:
|
|
50
52
|
|
|
51
|
-
- `--no-encrypt`:强制明文,优先于 `--encrypt`
|
|
52
53
|
- `--thread <id>`:指定话题 ID
|
|
53
54
|
- `--content-type <mime>`:覆盖文件 MIME
|
|
54
55
|
- `--transcript <text>`:语音转写,仅 `--as voice`
|
|
@@ -11,21 +11,21 @@
|
|
|
11
11
|
ec menu-client request <from-aid> <daemon-aid> \
|
|
12
12
|
--request-file "$TMPDIR/menu-request.json" \
|
|
13
13
|
--timeout 15s \
|
|
14
|
-
--encrypt \
|
|
14
|
+
--encrypt yes \
|
|
15
15
|
--format json
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
- `--request-file` 与 `--request-json` 二选一,内容是**现有 Menu request**(结构见 `menu-protocol.md §三`);缺少 `id` 时自动生成 UUID。
|
|
19
19
|
- 请求与响应的 `ttl`、volatile 游标、`to_device_id` 定向回复等传输细节由 CLI 与 daemon 自动处理,调用方无需关心。
|
|
20
20
|
- 请求声明 `message_class=control`,发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`;接收端共用 SDK 标准事件,不按类别分设业务处理器。
|
|
21
|
-
- `--encrypt
|
|
21
|
+
- `--encrypt yes|no|auto` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。必须带取值,裸写是参数错误。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
|
|
22
22
|
- 独立终端默认 slot 是 `evolcore-menu-client`;`--app <slot>` 可覆盖,但会切换消费游标,调用方须自行串行化。托管模式使用 daemon 的现有连接和 ACK 路径。
|
|
23
23
|
- `menu.query` / `menu.options` 等待响应超时时自动重发一次相同 request id;写操作不自动重试。
|
|
24
24
|
- 默认收到 `menu.response` 即返回,作业受理响应中的 `jobId` 不代表作业完成。升级或模板作业可加 `--wait` 等待终态,`--timeout` 分别限制初始响应和受理后的终态等待。终态字段合并到响应 `data`,保留原响应 `id`;作业失败/取消退出码为 1。超时错误保留 `jobId`,可用已有作业查询接口恢复状态,客户端不重新执行 action。
|
|
25
25
|
|
|
26
26
|
## 鉴权入口
|
|
27
27
|
|
|
28
|
-
-
|
|
28
|
+
- 默认授权是对发送 AID 的 ownership 协议 Owner 校验(控制 AID 的协议共识,不再读 `daemon.json`)。
|
|
29
29
|
- `--remote-token <token>` 使用 daemon 签发的远程访问 token,权限与 daemon-owner 一致。CLI 审计日志不会记录 token 明文。
|
|
30
30
|
- `--ecweb-token <token>` 是 `--remote-token` 的兼容别名。
|
|
31
31
|
- `system/paircode` 例外:仅接受加密的 daemon-owner 请求,已有 remote token 不能换取新配对码。
|
|
@@ -26,6 +26,13 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
|
|
|
26
26
|
|
|
27
27
|
响应 `data.kind="menu.query_batch"`,`data.items` 按输入顺序逐项给出 `itemId/name/ok/data` 或 `itemId/name/ok/error`。`agent` 项可共用其 `fullaccessStatus`、`config.baseagent`、`safeConfig.baseagentSkills`,不必重复请求。Control AID / ECWeb 还需顶层 `agent` 指定目标;members 在这些入口返回该项权限错误。已有 `view="values"` 的 entryId 查询保持不变。
|
|
28
28
|
|
|
29
|
+
私聊提及模式使用专用 `name="private-mention-mode"`,支持 `menu.query/options/update`。
|
|
30
|
+
查询返回 `mode`(`disabled` 或 `mention-only`)、`override`、`source`、`revision`;缺省为 `disabled`。
|
|
31
|
+
混合批量查询可加入 `{ "itemId": "privateMentionMode", "name": "private-mention-mode" }`;
|
|
32
|
+
Agent Catalog 的 `privateMentionMode.agent` 同时支持 `view="values"` 批量读取。
|
|
33
|
+
修改传 `value` 和 `args.expectedRevision`,仅 Agent Owner 可写,版本过期返回 `CONFLICT`。
|
|
34
|
+
配置仅作用于 Agent 级;不用 CLI,也不复用群聊的 `name="group"`。
|
|
35
|
+
|
|
29
36
|
---
|
|
30
37
|
|
|
31
38
|
## 一、传输层约定
|
|
@@ -22,6 +22,9 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
|
|
|
22
22
|
跳过主动压缩。手动 `/compact` 和基座自身的默认压缩仍可使用。
|
|
23
23
|
Claude 的 `--autocompact` 参数与返回给界面的压缩刻度使用同一份目录窗口计算;
|
|
24
24
|
没有接口窗口时不下发 EvolCore 估算的阈值。该逻辑修改需要宿主重新加载源码后生效。
|
|
25
|
+
Claude 所选模型的有效窗口达到 1,000,000 tokens 时,传给 SDK 的裸模型 ID 会补上 `[1m]`,
|
|
26
|
+
即使 Provider 同时列出了裸 ID 和 `[1m]` 变体;以所选条目的窗口为准。
|
|
27
|
+
显式选择的 `[1m]`、`[200k]` 后缀保持原样。普通查询与手动压缩共用此处理。
|
|
25
28
|
|
|
26
29
|
## 命令
|
|
27
30
|
|
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
# ec msg — 私聊消息命令
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询/WidgetCard/HTML 表单。
|
|
4
4
|
|
|
5
|
-
AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability
|
|
5
|
+
AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`),协议语义在该技能的 `SKILL.md` 里。本文维护消息命令参数和请求查询行为。
|
|
6
|
+
|
|
7
|
+
常规远端能力任务使用 `ec ability remote list/discover/info/devices/call/result`,命令见该技能的 `references/cli.md`;remote 复用本文的 delegated sender 与请求索引。以下原始消息参数用于通用消息和协议诊断,不作为 remote 权限拒绝后的替代路径。remote 的 call/result 会进一步按原契约核验业务结果,不能把底层 CLI ok 与业务成功混用。
|
|
6
8
|
|
|
7
9
|
## Agent 会话中的 Shell 调用边界
|
|
8
10
|
|
|
@@ -28,7 +30,9 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
|
|
|
28
30
|
|
|
29
31
|
`--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
|
|
30
32
|
|
|
31
|
-
**跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self
|
|
33
|
+
**跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self topicPeer=<话题对端>`。
|
|
34
|
+
|
|
35
|
+
**回执怎么核对**:自派的两个字段 `recipient=self` 与 `topicPeer=<话题对端>` 成对出现,`topicPeer` 一定是真实对端而不是本端。如果回执里只有 `to=<本端AID>(会话|传入)` 而没有 `recipient=self`,说明这个话题的对端被写成了本端自己——结构残缺,消息不会有人接收。这类话题建不出来(创建时即 `SELF_PEER_NOT_ALLOWED`),历史遗留的用 `ec thread delete <本端AID>/<threadId>` 清掉。
|
|
32
36
|
|
|
33
37
|
宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
|
|
34
38
|
|
|
@@ -55,9 +59,12 @@ ecmsg send '<text>' --encrypt yes
|
|
|
55
59
|
# 强制明文
|
|
56
60
|
ecmsg send '<text>' --encrypt no
|
|
57
61
|
|
|
58
|
-
# 文件:--as 可选 image|video|voice|file
|
|
62
|
+
# 文件:--as 可选 image|video|voice|file|widget_card(默认按扩展名推断为普通媒体或文件)
|
|
59
63
|
ecmsg send --file <path> [--as <type>] [--text '<说明>']
|
|
60
64
|
|
|
65
|
+
# WidgetCard:HTML 上传为 AUN Storage 附件,App 点击填写,以 widget_card_reply 返回 JSON
|
|
66
|
+
ecmsg send --file ./meeting.html --as widget_card --title '会议安排' --text '请补充会议需求'
|
|
67
|
+
|
|
61
68
|
# 链接卡片
|
|
62
69
|
ecmsg send --link <url> [--title '<title>'] [--description '<desc>']
|
|
63
70
|
|
|
@@ -75,7 +82,7 @@ ecmsg send '<text>' --return none
|
|
|
75
82
|
```
|
|
76
83
|
|
|
77
84
|
`--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊发送(`ecmsg send`),不能同时提供位置文本。
|
|
78
|
-
Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon
|
|
85
|
+
Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。文件必须是普通文件,上限 1 MiB,符号链接、硬链接和路径穿越一律拒绝。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
|
|
79
86
|
最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
|
|
80
87
|
在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
|
|
81
88
|
双引号前加一个反斜杠,例如 `--payload '{\"type\":\"query\"}'`。反斜杠只用于命令行参数传递,
|
|
@@ -88,10 +95,9 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
88
95
|
- `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
|
|
89
96
|
- `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
|
|
90
97
|
- `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
|
|
91
|
-
- `--text-from-file <path>` — 从文件读取文本(UTF-8
|
|
98
|
+
- `--text-from-file <path>` — 从文件读取文本(UTF-8),文件上限 1 MiB
|
|
92
99
|
- `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
|
|
93
|
-
- `--encrypt` —
|
|
94
|
-
- `--no-encrypt` — 强制明文发送,优先于 `--encrypt`
|
|
100
|
+
- `--encrypt yes|no|auto` — 加密三态:`yes` 强制端到端加密,`no` 强制明文,`auto`(默认)被对端消息触发时沿用该消息的加密状态、主动发起时明文;必须带取值,裸写是参数错误,不写该参数才是默认 `auto`
|
|
95
101
|
- `--thread <id>` — 指定话题 ID(多话题路由)
|
|
96
102
|
- `--content-type <mime>` — 显式覆盖 MIME(仅 `--file`)
|
|
97
103
|
- `--text <说>` — 附件说明文字(仅 `--file`)
|
|
@@ -109,6 +115,14 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
|
|
|
109
115
|
未指定 `--content-type` 时,附件 MIME 由 SDK 按实际字节识别、后缀回退,附件描述沿用上传后的类型。
|
|
110
116
|
`--as` 控制消息展示类型,与 MIME 独立。
|
|
111
117
|
|
|
118
|
+
`--as widget_card` 是 HTML 表单专用入口,要求托管 daemon 发送、UTF-8 `.html`/`.htm` 文件,原始 HTML 最大 1 MiB;不能与 `--return required`、设备定向或跨话题自派组合。普通 `.html` 文件未显式指定该类型时仍按 `file` 发送。`--title` 设置卡片标题,缺省使用文件名;`--text` 为摘要。`--as action_card` 不存在,简单按钮卡片仍使用现有交互接口或 `--payload`。
|
|
119
|
+
|
|
120
|
+
WidgetCard 复用标准附件上传、持久 outbox 和原卡片关联,上传时注入统一表单运行脚本。基础 HTML 只需一个 `<form>`,多表单页面用唯一的 `form[data-widget-form]` 指定入口;控件使用标准 `name`/`value`。数值输入自动转换,独立复选框转布尔值,多选转数组;可用 `data-widget-type="string|number|boolean|array"`、`data-widget-item-type="string|number"` 明确类型。文件选择暂不支持。`widget_card_reply.values` 为对象,最大 64 KiB,按原话题交给 Agent 继续处理;关闭浏览器不等于取消。
|
|
121
|
+
|
|
122
|
+
原生 EvolApp 需接入受控浏览器和 `EvolWidgetBridge.postMessage(json)`,返回发送结果的 Promise;Core 代码与 HTML 脚本就绪不代表 App 已完成集成。完整流程和桥接契约见仓库 `docs/widget-card-design.md`。
|
|
123
|
+
|
|
124
|
+
当 Agent 已经生成了要交付的报告、截图、补丁或其它文件时,应使用上面的 `--file` 发送标准附件消息,并用 `--text` 写简短说明;不要只把本地路径写进普通正文。普通正文里的路径仍表示“请在对端工作区读取”,由接收方按需通过 Menu 查询。
|
|
125
|
+
|
|
112
126
|
托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
|
|
113
127
|
|
|
114
128
|
托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
|
|
@@ -253,6 +267,50 @@ ec msg history <self-aid> <target-aid> \
|
|
|
253
267
|
|
|
254
268
|
`sessionId` 是 EvolCore 本地逻辑会话 ID,不是 Claude/Codex 等后端的会话 ID。
|
|
255
269
|
|
|
270
|
+
## 私聊提及模式
|
|
271
|
+
|
|
272
|
+
私聊的 `@` 处理策略由 Agent 级字段 `privateMentionMode` 控制,与群聊的 `mentionMode` 相互独立。
|
|
273
|
+
|
|
274
|
+
| 值 | 行为 |
|
|
275
|
+
|---|---|
|
|
276
|
+
| `disabled`(默认) | 所有私聊消息都进入模型回合 |
|
|
277
|
+
| `mention-only` | 只有被 `@` 的私聊消息进入模型回合 |
|
|
278
|
+
|
|
279
|
+
未被 `@` 的消息不会消失:仍然落在本地 `messages.jsonl`,带 `privateAttention: "filtered-mention-only"` 标记。
|
|
280
|
+
它们没有进入任何会话(无 `sessionId`),因此读取时必须带 `--session all`:
|
|
281
|
+
|
|
282
|
+
```bash
|
|
283
|
+
ec msg history <self-aid> <peer-aid> --session all
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
不带参数等价于 `--session latest`,只返回最近一次会话里的消息,读不到这些被过滤的记录。
|
|
287
|
+
开启该模式后,被 `@` 时才进入模型,模型需要了解前文就用上面的命令自己读历史。
|
|
288
|
+
|
|
289
|
+
```bash
|
|
290
|
+
# 开启(仅 Owner 可写)
|
|
291
|
+
ec config set privateMentionMode mention-only
|
|
292
|
+
|
|
293
|
+
# 关闭
|
|
294
|
+
ec config set privateMentionMode disabled
|
|
295
|
+
|
|
296
|
+
# 查看生效值
|
|
297
|
+
ec config get privateMentionMode
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
约束:
|
|
301
|
+
|
|
302
|
+
- **只能配置在 Agent 级**。写入关系级会被拒绝(`SCOPE_MISMATCH`),`--default` 同样拒绝。
|
|
303
|
+
- **只有 Owner 可以修改**。其他角色写入会得到 `can only be changed by an owner`。
|
|
304
|
+
- 取值只有 `disabled` 和 `mention-only`,没有 `auto`:私聊下没有「自动判断是否被提及」这回事,
|
|
305
|
+
未显式 `@` 就是不触发。
|
|
306
|
+
- 切换立即生效,不需要重启或新建会话。
|
|
307
|
+
|
|
308
|
+
判定只看**结构化 `mentions`**(`payload.mentions` 命中自己的 AID,或 `{scope:"all"}`),不扫正文。
|
|
309
|
+
客户端不发送结构化 `mentions` 时,`@` 不会被识别为提及。
|
|
310
|
+
|
|
311
|
+
以下消息不受该模式影响,仍按原路径处理:slash 命令、`menu.*` / `bind.*` / `observer.*` 等控制类 payload、
|
|
312
|
+
echo 探针、联系人待收补投。
|
|
313
|
+
|
|
256
314
|
## 共享选项
|
|
257
315
|
|
|
258
316
|
- `--format json` — 对支持结构化结果的子命令输出 JSON
|
|
@@ -264,8 +322,17 @@ ec msg history <self-aid> <target-aid> \
|
|
|
264
322
|
收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
|
|
265
323
|
|
|
266
324
|
加密策略:
|
|
267
|
-
- 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
|
|
268
|
-
-
|
|
325
|
+
- 对端发来密文消息时,回复也应使用 `--encrypt yes`(保持对话加密一致性)
|
|
326
|
+
- 对端发来明文消息时,用 `--encrypt no` 或省略参数(默认 `auto` 即明文回复)
|
|
269
327
|
- 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
|
|
270
328
|
|
|
271
329
|
`ecmsg send` 默认等价于 `--encrypt auto`:被对端消息触发时沿用该消息的加密状态,主动发起时明文。
|
|
330
|
+
|
|
331
|
+
## 联系人准入与待收恢复
|
|
332
|
+
|
|
333
|
+
AUN 普通消息出站无需联系人审批,不因目标未入录、联系人黑名单、范围排除或名录不可用
|
|
334
|
+
转成 Owner 申请;调用权限、资源访问、加密和传输规则仍生效。
|
|
335
|
+
|
|
336
|
+
入站继续执行联系人准入。可申请的纯文本先保存原文,Owner 永久授权在本地名录成功应用后、
|
|
337
|
+
临时许可在落盘后自动恢复原消息。恢复保留原发件人、话题与消息 ID,
|
|
338
|
+
持久入队后再由模型按正常队列执行;3 天待收期、30 分钟临时许可均不因重试续期。
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# ec pay — 网站订单付款
|
|
2
|
+
|
|
3
|
+
当前 Owner AUN 私聊托管会话中的标准扫码付款。底层复用 AUN 标准附件及可靠消息投递,
|
|
4
|
+
不建立独立 SDK 连接。遇到付款先加载 `ec-pay` 技能;字段全表、错误码与 Persistence
|
|
5
|
+
细节在技能内 `references/pay-cli.md`,此处不重复。
|
|
6
|
+
|
|
7
|
+
## 命令
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
ec pay request --spec-file "$TMPDIR/payment-request.json"
|
|
11
|
+
ec pay status <request-id>
|
|
12
|
+
ec pay verify <request-id>
|
|
13
|
+
ec pay refresh <request-id>
|
|
14
|
+
ec pay cancel <request-id>
|
|
15
|
+
ec pay update <request-id> --spec-file "$TMPDIR/payment-update.json"
|
|
16
|
+
ec pay complete <request-id> --event-id <event-id>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
全部输出 JSON,可显式 `--format json`。托管命令保留当前委托环境,不能指定 self、付款人、
|
|
20
|
+
另一话题或其它 AID。`request-id` = `pay_` + 32 位十六进制;`event-id` = `payjob_` + 32 位十六进制。
|
|
21
|
+
|
|
22
|
+
## 语义要点
|
|
23
|
+
|
|
24
|
+
- `status` 返回 `payment`、`state_version`、`card_message_id`、`delivery`、`pending_events`。
|
|
25
|
+
`sent` 表示已获传输消息 ID,`queued` 表示待可靠发送;**二者都不是已付款**。
|
|
26
|
+
- `verify` / `refresh` 只安排持久任务,命令返回不代表网站操作已完成。
|
|
27
|
+
- `update` 必须关联未完成事件及原订单核验;有效请求确认付款后安排一次 `continue` 事件,
|
|
28
|
+
后续步骤完成后再 `complete`。已取消 / 过期请求迟到确认付款时保留已付事实,不自动继续任务。
|
|
29
|
+
- `status` 用于读取状态,不代替原网站核验。
|
|
30
|
+
|
|
31
|
+
输入格式见 `ec skill load ec-pay` 的正文骨架;字段语义与上限见该技能 `references/pay-cli.md`。
|
|
32
|
+
|
|
33
|
+
App 对接见仓库 `docs/evo-app-pay-integration-v1.md`;Core 已提供对应命令与消息处理,
|
|
34
|
+
App 需另行实现并进行真实平台联调。
|
|
@@ -131,7 +131,21 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
|
|
|
131
131
|
|
|
132
132
|
apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
|
|
133
133
|
|
|
134
|
-
|
|
134
|
+
同一服务方的多把 Key 写进同一个 Provider 的 `apiKey` 数组,不必为每把 Key 另建 Provider:
|
|
135
|
+
|
|
136
|
+
~~~json
|
|
137
|
+
{
|
|
138
|
+
"name": "Example",
|
|
139
|
+
"domain": "api.example.com",
|
|
140
|
+
"common": {
|
|
141
|
+
"baseUrl": "https://api.example.com/v1",
|
|
142
|
+
"apiKey": ["$EXAMPLE_API_KEY", "$EXAMPLE_BACKUP_KEY"]
|
|
143
|
+
},
|
|
144
|
+
"services": { "text": {} }
|
|
145
|
+
}
|
|
146
|
+
~~~
|
|
147
|
+
|
|
148
|
+
Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。domain 由程序获取并保存,ECWeb 不提供独立输入或展示字段,JSON 预览也隐藏该内部字段。静态 `baseUrl` 自动提取 hostname;管理入口收到未带 domain 的环境变量地址时,从宿主进程环境解析 URL 并提取,配置中的 baseUrl 仍保留变量引用。变量缺失、为空或解析结果不是有效 HTTP(S) URL 时拒绝新建,已有 domain 的配置读取不依赖变量是否存在。配置文件仍可显式声明 domain,运行时实际地址必须与保存的身份匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
|
|
135
149
|
|
|
136
150
|
hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一为 URL hostname 使用的压缩、带方括号形式(如 `[::1]`);显式 domain 也接受不带方括号的 IPv6。端口仍属于连接地址,不参与身份计算;同一主机的不同协议或端口不能合并。DNS 身份与已有固定 ID 的生成规则保持不变。
|
|
137
151
|
|
|
@@ -154,6 +168,13 @@ Provider schema v3 增加 `services.<type>.catalogPath`、`apiKey`、`headers`
|
|
|
154
168
|
|
|
155
169
|
服务级 Key 未声明时继承 `common.apiKey`,声明后独立使用,支持整字段环境变量引用。
|
|
156
170
|
显式空 Key 不回退公共 Key,缺失/空环境变量直接报错。服务级 headers/queryParams 整组覆盖,
|
|
171
|
+
`apiKey` 可写单值或有序数组(Key 池):第 0 位是主力,`apiKeys` 解析结果按原顺序给出整池,
|
|
172
|
+
`apiKey` 仍是主力。第一版只存储不自动切换——备用 Key 存进去后仍由主力承担全部请求,
|
|
173
|
+
换用备用需要后续版本的故障切换。单元素数组按单值写回,老配置读写后字节不变。
|
|
174
|
+
池上限 16 把,重复 Key 与逐元素的环境变量语法会被拒绝;主力 Key 的环境变量未设置仍严格报错,
|
|
175
|
+
备用位的环境变量未设置只丢弃该位并记警告,避免一把过期备用拖垮可用主力。
|
|
176
|
+
`<redacted>` 按位保留,第 i 位的掩码还原旧池第 i 把,新增位置必须带真实 Key。
|
|
177
|
+
服务级 headers/queryParams 整组覆盖,
|
|
157
178
|
省略表示继承,`{}` 表示清空。独立 Key 与公共认证头/认证查询参数可能冲突时,要求显式覆盖对应组。
|
|
158
179
|
旧配置没有覆盖字段时保持原语义。导入导出、脱敏、模型目录与推理均使用目标服务的有效连接。
|
|
159
180
|
单服务带密钥导出只包含该服务的有效凭据;不带密钥导出移除公共和服务级 Key、headers、queryParams。
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# ec quota — 查询生效限额与余额
|
|
2
|
+
|
|
3
|
+
触发词:自身限额、对端限额、剩余额度、额度用了多少、是否超限。
|
|
4
|
+
|
|
5
|
+
`ec quota status` 查询具体使用者的实际余额;`ec role quota show <role>` 查看角色额度规则及
|
|
6
|
+
继承结果,`set/disable/inherit` 管理这些规则。两组命令共用现有预算计算和角色规则,分别提供
|
|
7
|
+
使用状态查询与策略管理入口。
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
# 托管会话:默认当前 Agent 与当前对端
|
|
11
|
+
ec quota status
|
|
12
|
+
ec quota status --format json
|
|
13
|
+
|
|
14
|
+
# Owner/Admin 可指定当前 Agent 的其他私聊关系
|
|
15
|
+
ec quota status --peer alice.agentid.cn --format json
|
|
16
|
+
ec quota status --peer 'feishu#ou_xxx' --format json
|
|
17
|
+
|
|
18
|
+
# 宿主终端:必须指定本机 Agent;不指定对端时只返回 Agent 预算
|
|
19
|
+
ec quota status --self bot.agentid.cn --format json
|
|
20
|
+
ec quota status --self bot.agentid.cn --peer alice.agentid.cn --format json
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
这是只读查询,通过 daemon 验证当前任务委托或宿主 control token。托管会话的 Owner/Admin 可查
|
|
24
|
+
当前 Agent 的其他对端;普通对端只能查当前关系,Agent 总用量和一般预算明细返回 `null`。
|
|
25
|
+
角色自定义的命令限制仍生效。跨 Agent 查询仅宿主终端或可信 fullaccess 任务可用;显式指定
|
|
26
|
+
另一个 Agent 时不沿用原 Agent 的当前对端,需同时指定 `--peer` 才查询该 Agent 的关系额度。
|
|
27
|
+
|
|
28
|
+
返回字段:
|
|
29
|
+
|
|
30
|
+
| 字段 | 内容 |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| `selfAid` | 查询的本机 Agent |
|
|
33
|
+
| `agent.visible` | 是否有权读取 Agent 总预算用量 |
|
|
34
|
+
| `agent.budget` | 日/月预算上限、已用、剩余、预警与硬限制状态 |
|
|
35
|
+
| `relation` | 无对端时为 `null`,否则包含对端、角色来源及限额 |
|
|
36
|
+
| `relation.budget` | 对该关系生效的一般预算,与运行时拦截使用同一计算函数 |
|
|
37
|
+
| `relation.budgetUsageScope` | 当前一般预算用量按 `agent` 汇总,不能当作对端独立用量 |
|
|
38
|
+
| `relation.roleQuota` | 角色额度的上限、已用、剩余、币种、计费口径、重置周期、范围及是否阻止执行 |
|
|
39
|
+
| `hard_blocked` | 任一生效预算或角色额度已阻止执行 |
|
|
40
|
+
|
|
41
|
+
一般预算使用 USD;角色额度使用自身的 `currency`,`cost_basis` 为 `gateway` 或 `official`。
|
|
42
|
+
两者分别返回,不跨币种相加。数值 `-1` 表示不限额。角色 `scope=subject` 表示每个对端独立
|
|
43
|
+
计算,`scope=role` 表示当前 Agent 内同角色共享额度。周期沿用 daemon 本地时区。
|
|
44
|
+
`owner/admin` 的角色额度返回 `enabled=false, reason=management_role`,一般预算仍独立生效。
|
|
45
|
+
关闭额度或无额度配置会返回对应 `reason`,不会把没有生效的限制误报为有限余额。
|
|
46
|
+
|
|
47
|
+
群聊默认按当前发言人及其在本群生效的关系角色计算额度。不能只指定另一个群的 AID 推断
|
|
48
|
+
发言人身份;要查询群内额度,应在该群的当前会话执行命令。
|
|
49
|
+
|
|
50
|
+
`--format json` 在失败时返回 `{ ok: false, code, error }`,退出码非零。
|
|
51
|
+
参数只支持 `status`、`--self`、`--peer`、`--format text|json` 和帮助;未知参数、重复参数、
|
|
52
|
+
缺少参数值均拒绝。修改角色额度继续使用 `ec role quota set|disable|inherit`。
|
|
53
|
+
|
|
54
|
+
新增命令的 daemon IPC 接口需要宿主重启后生效;仅 `ec agent reload` 不会重载源码。
|
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# 服务路由(`ec services`)
|
|
2
2
|
|
|
3
|
+
服务请求携带执行截止时间;排队或宿主准备期间到期的请求不再启动脚本。已经开始的
|
|
4
|
+
业务副作用不会因调用方超时而自动撤销,超时后仍须核对结果。默认结果去重窗口为 15 秒;
|
|
5
|
+
显式更长的调用窗口会将结果保留到截止时间后 3 秒,最长按 5 分钟调用窗口约束。
|
|
6
|
+
|
|
7
|
+
常驻和一次性脚本保持相同的 `noop` 与无沙箱审计语义。宿主按工程、权限模式及
|
|
8
|
+
owner+bypass 例外区分执行策略;切换策略时等待旧调用完成,不复用旧权限的宿主。
|
|
9
|
+
`ec services host enable --aid <aid>` 启用宿主;`host disable` 先排空在途调用再释放进程。
|
|
10
|
+
|
|
3
11
|
> 完整设计见仓库 `docs/services/`;Schema 见 `docs/services/schema/`。
|
|
4
12
|
|
|
5
13
|
Agent 怎么建服务包、写处理脚本、让对端调到你。
|
|
@@ -11,15 +19,15 @@ Agent 怎么建服务包、写处理脚本、让对端调到你。
|
|
|
11
19
|
| 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是服务 |
|
|
12
20
|
| 对端发消息给我,我跑确定性逻辑并**回结果** | **服务** |
|
|
13
21
|
| 我要主动通知别人 | 事件中心(`ec events`)或 `ecmsg` |
|
|
14
|
-
|
|
|
22
|
+
| 对端要当场拿到结果、拿不到就算了 | **服务**(走 volatile 消息,超时即失败) |
|
|
15
23
|
| 广播给很多人 | 事件中心,不是服务 |
|
|
16
24
|
|
|
17
25
|
一句话区分:**服务是点对点调用,事件是广播通知。**
|
|
18
26
|
|
|
19
27
|
| | 服务 `services/` | 事件 `events/` |
|
|
20
28
|
| --- | --- | --- |
|
|
21
|
-
| 传输 |
|
|
22
|
-
| 会丢吗 |
|
|
29
|
+
| 传输 | 点对点 volatile 消息(TTL = 调用窗口) | AUN pubsub(volatile) |
|
|
30
|
+
| 会丢吗 | 会——超时即失败,不补投 | 会 |
|
|
23
31
|
| 有应答吗 | 有,`.result` | 无 |
|
|
24
32
|
|
|
25
33
|
## 二、目录
|
|
@@ -41,9 +49,14 @@ $AGENT_DIR/services/
|
|
|
41
49
|
```bash
|
|
42
50
|
ec services pack add <包名> --from <源目录>
|
|
43
51
|
ec services pack remove <包名> [--purge]
|
|
52
|
+
ec services pack enable <包名>
|
|
53
|
+
ec services pack disable <包名>
|
|
44
54
|
ec services pack list
|
|
45
55
|
```
|
|
46
56
|
|
|
57
|
+
`pack enable` / `pack disable` 改的是 `pack.json` 里的 `enabled`(单包开关),
|
|
58
|
+
与 AID 级总闸 `ec services enable` / `disable` 是两个层级。
|
|
59
|
+
|
|
47
60
|
`services-config.json` 装好后基本不用改:
|
|
48
61
|
|
|
49
62
|
```json
|
|
@@ -104,11 +117,18 @@ ec aid agentmd set <本AID> exttype order
|
|
|
104
117
|
{
|
|
105
118
|
"v": 1,
|
|
106
119
|
"name": "订单受理",
|
|
120
|
+
"description": "订单受理相关的全部服务",
|
|
107
121
|
"requires": { "type": ["services", "agent"], "exttype": "order" },
|
|
108
122
|
"listen": [
|
|
109
123
|
{
|
|
110
124
|
"type": "services.order.create",
|
|
111
|
-
"handler": {
|
|
125
|
+
"handler": {
|
|
126
|
+
"script": "scripts/on-create.mjs",
|
|
127
|
+
"runtime": "node",
|
|
128
|
+
"timeoutMs": 15000,
|
|
129
|
+
"name": "下单",
|
|
130
|
+
"description": "创建订单。data: {sku, qty},返回 order_id"
|
|
131
|
+
}
|
|
112
132
|
}
|
|
113
133
|
],
|
|
114
134
|
"reply": { "allowed": true }
|
|
@@ -121,6 +141,12 @@ ec aid agentmd set <本AID> exttype order
|
|
|
121
141
|
- `listen[].type` 必须是 `services[.<段>[.<段>]]`,末段可写 `*`
|
|
122
142
|
- `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接
|
|
123
143
|
- `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断
|
|
144
|
+
- `handler.name`(≤24 字)/ `handler.description`(≤120 字)可选,**建议写**:
|
|
145
|
+
它们是 `data` 契约的唯一说明渠道,对端靠 `services.describe` 读到才知道该往 `data` 塞什么
|
|
146
|
+
- `handler.mode` ∈ `spawn`(默认)/ `resident`:后者是常驻子进程形态,需要按新契约写脚本
|
|
147
|
+
(先发 `{t:'ready'}`、每行带原样 `callId`、上下文从帧里读、日志走 stderr)。
|
|
148
|
+
**默认别用**。`host.enabled` 不是 `true` 时降级为每调用一个进程——结果一样,但没有稳态
|
|
149
|
+
收益,`ec services doctor` 会提醒。完整契约(帧字段、两个目录、超时参数)见 `usage.md` §八·五
|
|
124
150
|
- 同包内 `type` 重复 → 整包 invalid;跨包重复 → 两个包都 invalid
|
|
125
151
|
- 一个包校验失败只废这个包,其余照常
|
|
126
152
|
|
|
@@ -146,12 +172,12 @@ ec aid agentmd set <本AID> exttype order
|
|
|
146
172
|
## 七、怎么调别人
|
|
147
173
|
|
|
148
174
|
```bash
|
|
149
|
-
ec services describe <aid>
|
|
150
|
-
ec services schema <aid> <type>
|
|
151
|
-
ec services call <aid> <type> --data '<json>'
|
|
175
|
+
ec services describe --aid <aid> # 对方有什么
|
|
176
|
+
ec services schema --aid <aid> --type <type> # 参数结构
|
|
177
|
+
ec services call --aid <aid> --type <type> --data '<json>' # 发起调用
|
|
152
178
|
```
|
|
153
179
|
|
|
154
|
-
`call`
|
|
180
|
+
`call` 默认等结果,**12 秒**超时:
|
|
155
181
|
|
|
156
182
|
```json
|
|
157
183
|
{ "ok": true, "data": { "order_id": "O-1" } }
|
|
@@ -159,11 +185,10 @@ ec services call <aid> <type> --data '<json>' # 发起调用
|
|
|
159
185
|
|
|
160
186
|
| 选项 | 作用 |
|
|
161
187
|
| --- | --- |
|
|
162
|
-
| `--timeout
|
|
188
|
+
| `--timeout 5` | 自定等待时长;超时**不重试**,退出码 2 |
|
|
163
189
|
| `--encrypted` | 加密调用,回复也加密 |
|
|
164
|
-
| `--no-wait` | 只发不等 |
|
|
165
190
|
|
|
166
|
-
|
|
191
|
+
**超时后不要直接重发**。请求只活一个调用窗口,对端离线时到期即消失、不会补投;同一 `request_id` 默认保留结果 15 秒,显式更长窗口保留至截止后 3 秒。缓存过期后不再提供执行去重。
|
|
167
192
|
|
|
168
193
|
## 八、脚本契约
|
|
169
194
|
|
|
@@ -207,7 +232,7 @@ ec services call <aid> <type> --data '<json>' # 发起调用
|
|
|
207
232
|
|
|
208
233
|
| 项 | 值 |
|
|
209
234
|
| --- | --- |
|
|
210
|
-
| 超时 | 默认
|
|
235
|
+
| 超时 | 默认 10s,`timeoutMs` ∈ [1s, 300s]。默认值刻意短于调用方的 12 秒等待期 |
|
|
211
236
|
| 输出上限 | stdout+stderr 合计 1 MiB;**超出即终止进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断 |
|
|
212
237
|
| 环境变量 | `EC_SELF_AID` / `EC_SELF_TYPE` / `EC_SELF_EXTTYPE` / `EC_PACK_DIR` / `EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` / `EC_ENCRYPTED` |
|
|
213
238
|
| 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
|
|
@@ -240,8 +265,8 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
|
|
|
240
265
|
|
|
241
266
|
- 不带 `request_contact`、不带包名/type/脚本路径——回包不能变成探测手段;
|
|
242
267
|
- 无论目标 type 是否存在,回包完全一样(否则"有没有回包"就是枚举信道);
|
|
243
|
-
- 同一个来源 **24
|
|
244
|
-
的回复上限,换 AID 也放不大。
|
|
268
|
+
- 同一个来源 **24 小时内只回这一次**(这是拒绝回包的去重窗口,与调用侧 12 秒
|
|
269
|
+
无关),之后一律静默;全局另有 30 次/分、200 次/时 的回复上限,换 AID 也放不大。
|
|
245
270
|
|
|
246
271
|
**不会自动建联系人申请**,对方需自己 `ec directory request` 找你的 Owner。
|
|
247
272
|
|
|
@@ -321,6 +346,7 @@ ec services rules remove services.order.create spam.agentid.cn --deny
|
|
|
321
346
|
| **查看** | `status` `types` `ledger` `tail` `doctor` `reload` `rules show` `pack list` | member 及以上 | member 及以上 + 同 Owner |
|
|
322
347
|
| **管理** | `pack add` `pack remove` `pack enable` `pack disable` `rules add` `rules remove` | owner / admin | daemonOwner + fullaccess + 同 Owner |
|
|
323
348
|
| **总闸** | `enable` `disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
|
|
349
|
+
| **宿主** | `host enable` `host disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
|
|
324
350
|
| **调用** | `describe` `schema` `call` | 准入决定(本机不判权) | 准入决定(本机不判权) |
|
|
325
351
|
|
|
326
352
|
### 概念
|
|
@@ -391,10 +417,12 @@ OS 账户权限就是信任边界。托管会话则按上表判定。
|
|
|
391
417
|
## 十二、排查
|
|
392
418
|
|
|
393
419
|
```
|
|
394
|
-
ec services status # 包状态:active / skipped / invalid
|
|
395
|
-
ec services
|
|
420
|
+
ec services status # 包状态:active / skipped / invalid;含 host 段
|
|
421
|
+
ec services types # 本 AID 现在能接的全部 services.*
|
|
422
|
+
ec services doctor <包名> # requires、保留字遮蔽、脚本、路径、ACL
|
|
396
423
|
ec services ledger <包名> --tail 20
|
|
397
424
|
ec services tail <包名>
|
|
425
|
+
ec services repair-acl # 历史包的 NTFS ACL 收口(幂等,仅 Windows)
|
|
398
426
|
```
|
|
399
427
|
|
|
400
428
|
| 症状 | 先看 |
|
|
@@ -408,8 +436,8 @@ ec services tail <包名>
|
|
|
408
436
|
|
|
409
437
|
## 十三、不要做的事
|
|
410
438
|
|
|
411
|
-
1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)`
|
|
412
|
-
|
|
439
|
+
1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 默认去重 15 秒,更长请求按截止时间扩展;
|
|
440
|
+
超出窗口的重试会重新执行;真正的幂等键要由脚本按业务字段自己保证。
|
|
413
441
|
2. **不要在脚本里自己发回复**。输出 `outcome` 让 daemon 发,否则话题、加密态、
|
|
414
442
|
`request_id` 都会错。
|
|
415
443
|
3. **注意保留字只占两段形式**。`exttype` 设成 `list` 时 `services.list` 被内置抢走,
|
|
@@ -90,6 +90,8 @@ ec thread create <peer> --name '项目A' --status active
|
|
|
90
90
|
|
|
91
91
|
创建成功后返回 `threadId`,格式为 `thread-<ms>-<seq4>-<rand4>`(如 `thread-1791028341906-0000-136a`)。创建时会自动向对端发一条系统消息通知。
|
|
92
92
|
|
|
93
|
+
`<peer>` 不能是本端自己的 AID(含大小写差异与 `@` 前缀),否则报 `SELF_PEER_NOT_ALLOWED`。话题是两端结构,对端写成本端会得到「我↔我」的残缺话题:消息投得进去,但实际没有接收方。要给自己派活,请先以真实对端建话题,再用 `ecmsg send --thread <该话题> --to <本端AID>`。
|
|
94
|
+
|
|
93
95
|
### 修改话题
|
|
94
96
|
|
|
95
97
|
```bash
|