evolcore 0.0.49 → 0.0.51
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 +103 -3
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +64 -57
- package/dist/ability/caller/authorization.js +21 -0
- package/dist/ability/caller/command.js +173 -0
- package/dist/ability/caller/contract.js +117 -0
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +183 -0
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +519 -0
- package/dist/ability/command-contract.js +5 -0
- package/dist/ability/daemon.js +5 -1
- package/dist/ability/interop-v1.js +156 -106
- package/dist/ability/management.js +1 -0
- package/dist/agent-template/jobs.js +79 -3
- package/dist/agent-template/runtime.js +459 -47
- package/dist/agent-template/service.js +1242 -198
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -2
- package/dist/agents/claude/availability.js +94 -0
- package/dist/agents/claude/capability-provider.js +154 -0
- package/dist/agents/claude/index.js +145 -0
- package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
- package/dist/agents/claude/session-file-adapter.js +246 -0
- package/dist/agents/codex/app-server-client.js +90 -10
- package/dist/agents/codex/availability.js +164 -0
- package/dist/agents/codex/capability-provider.js +138 -0
- package/dist/agents/codex/cli.js +38 -0
- package/dist/agents/codex/index.js +345 -0
- package/dist/agents/codex/mcp-elicitation.js +135 -0
- package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
- package/dist/agents/codex/session-file-adapter.js +834 -0
- package/dist/agents/dsh/availability.js +28 -0
- package/dist/agents/dsh/capability-provider.js +56 -0
- package/dist/agents/dsh/desktop-locations.ps1 +66 -0
- package/dist/agents/dsh/desktop-probe.cjs +37 -0
- package/dist/agents/dsh/index.js +98 -0
- package/dist/agents/dsh/installation.js +400 -0
- package/dist/agents/dsh/resources.js +755 -0
- package/dist/agents/dsh/runner.js +1183 -0
- package/dist/agents/dsh/runtime/README.md +243 -0
- package/dist/agents/dsh/runtime/authorization.js +23 -0
- package/dist/agents/dsh/runtime/bridge.js +837 -0
- package/dist/agents/dsh/runtime/config.js +271 -0
- package/dist/agents/dsh/runtime/entry.js +229 -0
- package/dist/agents/dsh/runtime/session-inspector.js +340 -0
- package/dist/agents/dsh/runtime/tool-policy.js +49 -0
- package/dist/agents/dsh/session-file-adapter.js +145 -0
- package/dist/agents/ecagent/index.js +215 -0
- package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
- package/dist/agents/ecagent/session-file-adapter.js +134 -0
- package/dist/agents/gemini/index.js +96 -0
- package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
- package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/control-aid.js +52 -32
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +7 -37
- package/dist/aun/group/operations.js +6 -0
- package/dist/aun/menu/client.js +1 -1
- package/dist/aun/msg/history.js +1 -1
- package/dist/aun/msg/managed-operation.js +93 -21
- package/dist/aun/msg/mention-schema.js +1 -1
- package/dist/aun/msg/p2p.js +32 -4
- package/dist/aun/msg/upload.js +126 -3
- package/dist/aun/service-proxy.js +1 -1
- package/dist/aun/storage/index.js +242 -0
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +698 -213
- package/dist/channels/daemon.js +3 -2
- package/dist/channels/dingtalk.js +1 -1
- package/dist/channels/feishu.js +9 -9
- package/dist/channels/qqbot.js +1 -1
- package/dist/channels/wechat.js +2 -2
- package/dist/channels/wecom.js +1 -1
- package/dist/claude-gateway/agent-registration.js +389 -0
- package/dist/claude-gateway/binding.js +96 -0
- package/dist/claude-gateway/inbox.js +138 -0
- package/dist/claude-gateway/index.js +125 -0
- package/dist/claude-gateway/listing.js +330 -0
- package/dist/claude-gateway/router.js +328 -0
- package/dist/claude-gateway/sessions.js +128 -0
- package/dist/claude-gateway/terminal.js +250 -0
- package/dist/claude-gateway/transcript.js +272 -0
- package/dist/claude-gateway/types.js +14 -0
- package/dist/cli/ability-command.js +45 -0
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +21 -2
- package/dist/cli/agent-create.js +197 -56
- package/dist/cli/agent-template.js +400 -27
- package/dist/cli/agent.js +105 -11
- package/dist/cli/aun-commands.js +237 -123
- package/dist/cli/bench.js +5 -2
- package/dist/cli/config.js +22 -6
- package/dist/cli/daemon-commands.js +283 -109
- package/dist/cli/data-command.js +1 -1
- package/dist/cli/debug-mode.js +9 -0
- package/dist/cli/directory.js +1 -2
- package/dist/cli/ecmsg-gateway.js +64 -26
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +45 -12
- package/dist/cli/init.js +161 -90
- package/dist/cli/managed-command-guard.js +3 -0
- package/dist/cli/menu-client.js +32 -7
- package/dist/cli/model.js +1 -1
- package/dist/cli/pay-command.js +30 -0
- package/dist/cli/provider-command.js +6 -2
- package/dist/cli/restart-monitor.js +4 -4
- package/dist/cli/services-command.js +35 -10
- package/dist/cli/skill-command.js +4 -4
- package/dist/cli/task-context.js +24 -14
- package/dist/cli/team-workspace-command.js +50 -52
- package/dist/cli/thread-command.js +81 -14
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/access-policy.js +16 -3
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +26 -13
- package/dist/config/config-manager.js +113 -52
- package/dist/config/config-operation-service.js +22 -1
- package/dist/config/gateway-config.js +29 -44
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -19
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +3 -9
- package/dist/config/provider-identity-migration.js +24 -105
- package/dist/config/provider-ipc-service.js +13 -3
- package/dist/config/provider-local-sync.js +4 -1
- package/dist/config/provider-menu-request.js +21 -3
- package/dist/config/provider-templates.js +1 -1
- package/dist/config/providers-config.js +138 -31
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +109 -118
- package/dist/config/resolved-config-op.js +1 -42
- package/dist/config/schema-migration.js +254 -15
- package/dist/config/schema-registry.js +53 -8
- package/dist/config-store.js +1343 -63
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
- package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
- package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
- package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +15 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +20 -2
- package/dist/core/auth/operation-catalog.js +80 -8
- package/dist/core/baseagent/baseagent-availability.js +197 -0
- package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
- package/dist/core/baseagent/baseagent-config-shared.js +56 -0
- package/dist/core/baseagent/baseagent-identity.js +68 -0
- package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
- package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
- package/dist/core/baseagent/baseagent.js +157 -0
- package/dist/{agents → core/baseagent}/runner-types.js +36 -4
- package/dist/core/capability/capability-manager.js +91 -33
- package/dist/core/capability/providers/claude-capability-provider.js +2 -154
- package/dist/core/capability/providers/codex-capability-provider.js +2 -136
- package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
- package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
- package/dist/core/command/agent-control.js +80 -17
- package/dist/core/command/agent-template-menu.js +23 -10
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- package/dist/core/command/cli-intent-parser.js +15 -0
- package/dist/core/command/command-handler.js +127 -57
- package/dist/core/command/context-policy-menu.js +122 -0
- package/dist/core/command/data-root-resolver.js +157 -20
- package/dist/core/command/memory-slash.js +6 -6
- package/dist/core/command/menu-catalog.js +95 -19
- package/dist/core/command/menu-file-path.js +70 -0
- package/dist/core/command/menu-handler.js +392 -93
- package/dist/core/command/menu-protocol.js +47 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- package/dist/core/command/private-mention-menu.js +71 -0
- package/dist/core/command/provider-menu.js +7 -11
- package/dist/core/command/role-menu.js +1 -1
- package/dist/core/command/skill-slash.js +17 -5
- package/dist/core/command/slash-gate.js +2 -4
- package/dist/core/command/slash-handler.js +143 -121
- package/dist/core/command/team-workspace-bootstrap.js +2 -1
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +16 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
- package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
- package/dist/core/file-integrity/store.js +1 -1
- package/dist/core/handoff/ipc-registration.js +3 -3
- package/dist/core/handoff/runtime.js +2 -2
- package/dist/{agents → core/inference}/request-identity.js +2 -2
- package/dist/core/inference/text-inference.js +4 -4
- package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
- package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
- package/dist/core/initialization/service.js +57 -9
- package/dist/core/invoke/executors/media.js +1 -1
- package/dist/core/invoke/executors/text.js +1 -1
- package/dist/core/memory/consolidation-context.js +3 -2
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +39 -68
- package/dist/core/memory/memory-admin.js +6 -6
- package/dist/core/memory/memory-writer.js +1 -1
- package/dist/core/memory/relation-idle-monitor.js +1 -1
- package/dist/core/message/aun-ipc-sender.js +204 -88
- package/dist/core/message/aun-request-registry.js +44 -5
- package/dist/core/message/auto-mention-gate.js +1 -1
- package/dist/core/message/contact-admission.js +1 -1
- package/dist/core/message/im-renderer.js +19 -0
- package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
- package/dist/core/message/items-formatter.js +5 -5
- package/dist/core/message/message-admission.js +1 -1
- package/dist/core/message/message-bridge.js +239 -59
- package/dist/core/message/message-log.js +8 -0
- package/dist/core/message/message-queue.js +88 -7
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +16 -5
- package/dist/core/message/response-engine.js +351 -152
- package/dist/core/message/send-options.js +44 -7
- package/dist/core/message/send-routing.js +55 -115
- package/dist/core/message/stream-idle-monitor.js +1 -1
- package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
- package/dist/core/model/catalog-service.js +29 -8
- package/dist/core/model/model-capabilities.js +88 -0
- package/dist/core/model/model-catalog.js +18 -7
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +107 -101
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
- package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
- package/dist/core/permission/approval-gateway.js +9 -18
- package/dist/core/permission/ec-command-parser.js +242 -82
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +120 -9
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/services-path-acl.js +9 -2
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/permission/tool-policy.js +21 -9
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
- package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
- package/dist/core/{background-session → session/background}/types.js +1 -1
- package/dist/core/session/session-file-health.js +2 -272
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +76 -12
- package/dist/core/session/session-mapper.js +16 -0
- package/dist/core/session/session-terminal.js +185 -0
- package/dist/core/session/session-title.js +8 -11
- package/dist/core/{system-session → session/system}/memory.js +43 -9
- package/dist/core/{system-session → session/system}/registry.js +1 -1
- package/dist/core/{system-session → session/system}/types.js +1 -1
- package/dist/core/skill/index-generator.js +3 -3
- package/dist/core/skill/switch-resolver.js +3 -0
- package/dist/core/task/task-activity-store.js +112 -0
- package/dist/core/task/task-recovery-service.js +2 -2
- package/dist/core/thread/command-parser.js +4 -1
- package/dist/core/thread/ipc-operation.js +6 -4
- package/dist/core/thread/thread-operation.js +27 -11
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +307 -58
- package/dist/core/thread/topic-id.js +52 -2
- package/dist/core/thread/types.js +15 -1
- package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
- package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
- package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
- package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
- package/dist/directory/{owner-directory-search.js → search.js} +50 -2
- package/dist/directory/{owner-directory-store.js → store.js} +2 -2
- package/dist/eck/kit-renderer.js +3 -2
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +12 -10
- package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
- package/dist/ecweb/dsh-native-service.js +413 -0
- package/dist/ecweb/providers-service.js +5 -3
- package/dist/ecweb/runtime/lifecycle.js +1 -1
- package/dist/ecweb/runtime/supervisor.js +1 -1
- package/dist/event-center/center-config.js +2 -2
- package/dist/event-center/dispatcher.js +1 -1
- package/dist/event-center/ipc-operation.js +12 -3
- package/dist/event-center/pack-loader.js +2 -2
- package/dist/event-center/registry.js +6 -6
- package/dist/event-center/runtime.js +2 -2
- package/dist/index.js +181 -77
- package/dist/ipc.js +161 -12
- package/dist/outputs/authorization.js +27 -0
- package/dist/outputs/events.js +10 -1
- package/dist/outputs/panel-cards.js +960 -0
- package/dist/paths.js +60 -1
- package/dist/pay/command.js +38 -0
- package/dist/pay/protocol.js +136 -0
- package/dist/pay/runtime.js +196 -0
- package/dist/pay/service.js +384 -0
- package/dist/pay/store.js +81 -0
- package/dist/response-system/engines/v1/proactive-flow.js +30 -3
- package/dist/services/dispatcher.js +25 -7
- package/dist/services/host/main.js +397 -0
- package/dist/services/host/protocol.js +125 -0
- package/dist/services/host/resident.js +347 -0
- package/dist/services/host-client.js +398 -0
- package/dist/services/host-deploy.js +180 -0
- package/dist/services/host-launch.js +117 -0
- package/dist/services/host-recycle.js +208 -0
- package/dist/services/host-runtime.js +841 -0
- package/dist/services/idempotency.js +44 -86
- package/dist/services/index-generator.js +4 -3
- package/dist/services/index.js +258 -36
- package/dist/services/ipc-operation.js +503 -78
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +541 -100
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +136 -5
- package/dist/stats/context-usage.js +110 -0
- package/dist/stats/model-resolver.js +103 -17
- package/dist/stats/query.js +5 -0
- package/dist/trigger/application-service.js +9 -6
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -166
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +35 -13
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +77 -232
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- package/dist/utils/aid-bind.js +3 -0
- package/dist/utils/atomic-write.js +88 -1
- package/dist/utils/cross-platform.js +4 -42
- package/dist/utils/error-dict.json +22 -1
- package/dist/utils/error-utils.js +193 -6
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +74 -1
- package/dist/utils/logger.js +5 -3
- package/dist/utils/media-cache.js +284 -42
- package/dist/utils/restart-safety.js +14 -1
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/system-memory.js +113 -25
- package/dist/utils/systemd-lifecycle.js +154 -0
- package/dist/utils/welcome.js +64 -20
- package/dist/utils/windows-shell-trust.js +7 -3
- package/ecagent/README.md +35 -0
- package/ecagent/dist/agent-loop.js +80 -30
- package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
- package/ecagent/dist/harness/env/nodejs.js +49 -20
- package/ecagent/dist/harness/messages.js +3 -2
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/ecagent/dist/runtime/types.d.ts +2 -0
- package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
- package/ecagent/dist/runtime/utils/validation.js +42 -0
- package/ecagent/dist/types.d.ts +2 -0
- 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/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +13 -9
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +133 -11
- package/kits/docs/evolcore/aid.md +39 -6
- package/kits/docs/evolcore/config.md +95 -1
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/ec-capabilities.md +7 -10
- package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
- package/kits/docs/evolcore/event.md +1 -1
- package/kits/docs/evolcore/fs.md +49 -3
- package/kits/docs/evolcore/group.md +5 -4
- package/kits/docs/evolcore/memory-consolidation.md +1 -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 +31 -2
- package/kits/docs/evolcore/model.md +12 -1
- package/kits/docs/evolcore/msg.md +96 -36
- package/kits/docs/evolcore/pay.md +22 -0
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +29 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- package/kits/docs/evolcore/services.md +46 -18
- package/kits/docs/evolcore/skill.md +17 -1
- package/kits/docs/evolcore/stats.md +5 -0
- package/kits/docs/evolcore/storage.md +22 -0
- package/kits/docs/evolcore/thread-chain.md +20 -9
- package/kits/docs/evolcore/tool-authorization.md +14 -0
- package/kits/docs/evolcore/trigger.md +89 -13
- package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
- package/kits/docs/venues/feishu-group.md +3 -2
- package/kits/docs/venues/feishu-private.md +3 -2
- package/kits/rules/01-overview.md +11 -32
- package/kits/rules/02-navigation.md +20 -6
- package/kits/rules/06-channel.md +20 -4
- package/kits/schemas/_meta.json +42 -5
- 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 +974 -0
- package/kits/schemas/agent-config.schema.24.json +986 -0
- package/kits/schemas/agent-config.schema.25.json +986 -0
- package/kits/schemas/daemon.schema.10.json +373 -0
- package/kits/schemas/daemon.schema.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -0
- package/kits/schemas/daemon.schema.9.json +12 -0
- package/kits/schemas/defaults.schema.7.json +472 -0
- package/kits/schemas/defaults.schema.8.json +484 -0
- package/kits/schemas/providers.schema.1.json +1 -1
- package/kits/schemas/providers.schema.2.json +1 -1
- package/kits/schemas/providers.schema.3.json +26 -4
- package/kits/schemas/relation-config.schema.13.json +289 -0
- package/kits/skills/.switches.json +17 -1
- package/kits/skills/ability/SKILL.md +395 -33
- package/kits/skills/ability/STRUCTURE.md +338 -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 +80 -37
- package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
- package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
- package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
- package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
- package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
- package/kits/skills/agent-output-cards/examples/surface.html +8 -0
- package/kits/skills/agent-template-project/SKILL.md +51 -0
- package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
- package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
- package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
- package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
- package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -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 +5 -5
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +223 -0
- package/kits/skills/ec-provider/SKILL.md +6 -6
- package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
- package/kits/skills/ec-service-call/SKILL.md +138 -0
- package/kits/skills/ec-service-pack/SKILL.md +277 -0
- package/kits/skills/ec-skill/SKILL.md +25 -9
- package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
- package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
- package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
- package/kits/skills/ec-trigger/SKILL.md +3 -3
- package/kits/skills/personal-assistant/SKILL.md +22 -22
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
- package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
- package/kits/skills/thread-ops/SKILL.md +19 -9
- package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
- package/kits/skills/wechat-article-reader/SKILL.md +2 -2
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/workflow.md +46 -0
- package/kits/templates/system-fragments/channel.md +13 -4
- package/kits/templates/system-fragments/commands.md +5 -4
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +15 -9
- package/kits/templates/system-fragments/session.md +2 -2
- package/kits/templates/system-fragments/thread.md +30 -127
- package/kits/templates/system-fragments/venue.md +16 -0
- package/package.json +7 -7
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +99 -39
- package/scripts/agent-template/overlay.mjs +126 -2
- package/scripts/agent-template/shared/common.mjs +49 -5
- package/scripts/agent-template/shared/plan.mjs +4 -2
- package/scripts/agent-template/shared/service-packs.mjs +104 -0
- package/scripts/agent-template/shared/team-schema.json +468 -39
- package/scripts/agent-template/shared/template-contract.mjs +93 -51
- package/scripts/agent-template/shared/template-package.mjs +225 -44
- package/scripts/agent-template/shared/template-runtime.mjs +137 -15
- package/scripts/agent-template/shared/template.mjs +31 -8
- package/scripts/agent-template/team-pack.mjs +528 -56
- package/scripts/agent-template/team-preview.mjs +102 -9
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -152
- package/dist/agents/baseagent.js +0 -750
- package/dist/agents/codex/catalog.js +0 -80
- package/dist/agents/ecagent-plugin-lazy.js +0 -41
- package/dist/agents/tool-time-context.js +0 -55
- package/dist/core/legacy-rename.js +0 -41
- package/dist/core/plugin-lifecycle.js +0 -137
- package/dist/core/rate-window.js +0 -53
- package/dist/core/runner-reload-transaction.js +0 -60
- package/dist/core/runtime-lock.js +0 -90
- package/dist/core/soul.js +0 -66
- package/dist/core/system-session/grants.js +0 -40
- package/dist/directory/owner-directory-agentmd-sync.js +0 -89
- package/dist/directory/owner-directory-request-operation.js +0 -79
- package/dist/directory/owner-directory-text.js +0 -60
- 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/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
- /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
- /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
- /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
- /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
- /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
- /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
- /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
- /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
- /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
- /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
- /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ec-service-call
|
|
3
|
+
description: >-
|
|
4
|
+
调用对端 Agent 提供的 services.* 服务并拿到结果。用户说"问问 XX 那边能不能…""调一下 XX 的
|
|
5
|
+
服务""对端有什么服务/接口""这个 data 该塞什么""服务调用超时/NO_RESULT/NOT_AUTHORIZED/
|
|
6
|
+
收不到结果"时使用。不适用于本机建服务包(用 ec-service-pack)、到点执行(用 ec-trigger)、
|
|
7
|
+
广播(用事件中心),也不适用于本机 HTTP 服务与 AUN 代理(用 ec-proxy)。
|
|
8
|
+
license: MIT
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# EC 服务调用:发现、调用、判失败
|
|
12
|
+
|
|
13
|
+
服务调用是**点对点 RPC**:要结果、会丢、不补投。跟普通消息最大的区别是**对端离线时
|
|
14
|
+
请求到 TTL 就消失**,重连也拉不到。
|
|
15
|
+
|
|
16
|
+
## 一、先发现,再调用
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
ec services describe --aid <对端AID> # 对方有什么
|
|
20
|
+
ec services describe --aid <对端AID> --type <type> # 单个服务的细节
|
|
21
|
+
ec services schema --aid <对端AID> --type <type> # 请求 schema
|
|
22
|
+
ec services call --aid <对端AID> --type <type> --data '<json>' # 调用
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
`describe` 的产出里最该看的是 `handlers[].name` / `handlers[].description`——
|
|
26
|
+
**`pack.json` 不声明入参结构,`data` 契约只写在这里**。没有 description 就只能靠 type 名猜。
|
|
27
|
+
|
|
28
|
+
还有第三种读物:`services.skill`,返回一段可直接读的用法说明(对端 Agent 视角写的)。
|
|
29
|
+
用 `describe --aid <对端AID> --type <type>` 拿不到信息时值得一问。
|
|
30
|
+
|
|
31
|
+
## 二、参数:谁是目标,谁是发送方
|
|
32
|
+
|
|
33
|
+
`--aid` 在 `ec services` 家族里**一律指被调用/被操作的那个 agent**(与 `status --aid`、
|
|
34
|
+
`pack add --aid` 一致)。对端调用另有一个 `--as` 指定**发送身份**:
|
|
35
|
+
|
|
36
|
+
| 参数 | 含义 | 缺省 |
|
|
37
|
+
| --- | --- | --- |
|
|
38
|
+
| `--aid` | **被调用方**(对端 AID) | 必填 |
|
|
39
|
+
| `--type` | 服务 type | 必填(`--service` 是历史别名) |
|
|
40
|
+
| `--as` | **发送身份**:本机以哪个 agent 的 AUN 通道发出 | 托管会话取会话身份;宿主终端回落到 daemon AID |
|
|
41
|
+
|
|
42
|
+
**托管会话里不用写 `--as`**——daemon 从会话身份推出。宿主终端没有会话身份,会回落到
|
|
43
|
+
daemon 自己的 AID;而 daemon AID 通常**没有 AUN 通道**,于是报
|
|
44
|
+
`NOT_CONFIGURED: no AUN channel is connected for <daemonAid>`,这时补 `--as <有通道的AID>`
|
|
45
|
+
即可。指定了但那个 AID 没有通道,也是同一个错。
|
|
46
|
+
|
|
47
|
+
> 不能调自己:`--aid` 指向本端 AID 会直接被拒(`cannot call self`),
|
|
48
|
+
> 因为入站侧没有分支会应答自调用,等下去只会得到像对端故障的 `NO_RESULT`。
|
|
49
|
+
|
|
50
|
+
## 三、调用的三个必知语义
|
|
51
|
+
|
|
52
|
+
**1. 默认等 12 秒,超时不重试。**
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
ec services call --aid alice.agentid.cn --type services.order.create --data '{"sku":"A-1","qty":2}'
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
| 选项 | 作用 |
|
|
59
|
+
|---|---|
|
|
60
|
+
| `--timeout 5` | 自定等待时长(秒;也接受 `30s` / `2m`) |
|
|
61
|
+
| `--encrypted` | 加密调用,回复也加密 |
|
|
62
|
+
|
|
63
|
+
退出码:`0` 成功;`1` 失败(业务失败或传输失败);**`2` = `NO_RESULT`,可能已执行**。
|
|
64
|
+
脚本跑完但报业务失败(`ok:false`)时也是 `1`,所以 `cmd && next` 不会被骗过去。
|
|
65
|
+
|
|
66
|
+
**2. 请求只活一个调用窗口。** TTL 由你的等待时长推导,到期即从网关消失。
|
|
67
|
+
所以「对端不在线」和「对端不服务」在你的视角上是同一种结果:超时。
|
|
68
|
+
|
|
69
|
+
**3. 超时后不要直接重发。** 用**同一个 `request_id`** 重试在结果缓存有效期内不重跑脚本;
|
|
70
|
+
默认保留 15 秒,更长调用窗口延至截止后 3 秒,缓存过期后重发可能重新执行。CLI 每次调用都会自动生成新的
|
|
71
|
+
`request_id`——**要利用幂等必须由能自定 `request_id` 的调用方(SDK / 脚本)来发**,
|
|
72
|
+
`ec services call` 做不到。
|
|
73
|
+
|
|
74
|
+
## 四、结果长什么样
|
|
75
|
+
|
|
76
|
+
同 AID 通道自测时,外层是 daemon 的请求记录,`response` 才是对端原文:
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"request_id": "req_…",
|
|
81
|
+
"state": "completed",
|
|
82
|
+
"message_id": "…",
|
|
83
|
+
"target": "<目标AID>",
|
|
84
|
+
"response": {
|
|
85
|
+
"type": "services.order.create.result",
|
|
86
|
+
"request_id": "req_…",
|
|
87
|
+
"ok": true,
|
|
88
|
+
"data": { "order_id": "O-1" }
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
- **回复 type 固定是「请求 type + `.result`」**,不会变成别的。
|
|
94
|
+
- 业务失败:同 type、`ok:false`、`error.code` + `error.message`。
|
|
95
|
+
- `data` 是**纯调用方正文**,不含 `chatmode` / `client_signature` / `thread_id` / `topicName`
|
|
96
|
+
——服务调用没有话题概念。
|
|
97
|
+
- **`data` 里禁止出现 `type`**:那是信封字段,决定请求路由到哪个处理器。写了会被拒
|
|
98
|
+
(`INVALID_ARGV`),不是被忽略——旧的静默行为会把请求投给另一个 type,而调用方
|
|
99
|
+
拿到一个看起来合理的回包。业务字段叫 `type` 的,改用 `aid_type` / `service_type` 之类。
|
|
100
|
+
|
|
101
|
+
## 五、失败码怎么读
|
|
102
|
+
|
|
103
|
+
| 码 | 含义 | 该怎么办 |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| `NO_RESULT` | 没等到结果(退出码 2) | **可能已执行**。别直接重发,先确认对方状态 |
|
|
106
|
+
| `NOT_AUTHORIZED` | 你不是对方的联系人(或不在 `rules.allow`) | 走 `ec directory request` 找对方 Owner,别反复调 |
|
|
107
|
+
| `UNKNOWN_TYPE` | 对方没有这个 type(包 `unmatched: reject` 时才回) | 重新 `describe` 看准确 type |
|
|
108
|
+
| `RATE_LIMITED` | 超限,看 `retry_after` | 等够秒数再调 |
|
|
109
|
+
| `TIMEOUT` | 对方脚本超时(是**对方的**超时,不是你等待超时) | 对方脚本太慢,不是网络问题 |
|
|
110
|
+
| `HANDLER_PROTOCOL` | 脚本末行不是合法 JSON | 对方脚本 bug |
|
|
111
|
+
| `SCRIPT_OUTPUT_LIMIT` | 对方脚本输出超 1 MiB 被杀 | 同上 |
|
|
112
|
+
| `NOT_CONFIGURED` | 本端没有 AUN 通道 | 补 `--aid <调用方AID>` |
|
|
113
|
+
| `INVALID_ARGV` | 参数问题,含 `cannot call self` | 看错误原文 |
|
|
114
|
+
|
|
115
|
+
**未准入时「有没有回包」不是判断服务是否存在的依据**:未准入来源永远得到同一条与请求
|
|
116
|
+
内容无关的拒绝,且 24 小时只回一次,之后静默。所以**别用反复调用探测对端有什么**——
|
|
117
|
+
用 `describe`(它对未准入只给空壳清单,也不暴露细节)。
|
|
118
|
+
|
|
119
|
+
被拉黑(`deny`)的回包与「未准入」**完全相同**,这是故意的:否则两者可区分,
|
|
120
|
+
就成了探测信道。
|
|
121
|
+
|
|
122
|
+
## 六、什么时候该怀疑"不是服务的问题"
|
|
123
|
+
|
|
124
|
+
| 现象 | 先查 |
|
|
125
|
+
|---|---|
|
|
126
|
+
| 一直 `NO_RESULT` | 对端是否在线;`--aid` 给的调用方有没有通道 |
|
|
127
|
+
| `NOT_CONFIGURED` | `--aid` 是否指到了没有 AUN 通道的 host AID |
|
|
128
|
+
| `cannot call self` | 目标和 `--aid` 是不是同一个 AID |
|
|
129
|
+
| 对端说"没收到" | 你是 volatile 发的,对方离线期间不会补投——不是消息丢了,是设计如此 |
|
|
130
|
+
| 对方有 `services.*` 但调不通 | 对方的 `enabled` 总闸、以及你的 AID 在不在它 `rules` 里 |
|
|
131
|
+
|
|
132
|
+
## 七、不要做的事
|
|
133
|
+
|
|
134
|
+
1. **不要对没有幂等的操作做"超时重发"**。超时后结果未知,重发可能执行两次。
|
|
135
|
+
2. **不要用服务调用做广播**。点对点,一次一个对端;广播用事件中心。
|
|
136
|
+
3. **不要指望回复带话题**。要关联上下文自己记 `request_id`。
|
|
137
|
+
4. **不要拿"没回包"当探测手段**。未准入与拉黑的回包被刻意做成不可区分。
|
|
138
|
+
5. **不要反复调被拒的服务**。它会静默,你的重试不会有更多信息。
|
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ec-service-pack
|
|
3
|
+
description: >-
|
|
4
|
+
给本 Agent 建服务包(pack.json + 处理脚本),让对端能调用并经你回结果。用户说"给某个
|
|
5
|
+
服务做个接口""对外提供 XX 服务""让对端调到我的 XX 能力""建个服务包/pack.json""帮我把这段
|
|
6
|
+
逻辑暴露成 services.* ""服务包为什么没生效/skipped/invalid/调不通"时使用。不适用于到点
|
|
7
|
+
执行(用 ec-trigger)、广播通知(用 event-center)、常驻本地进程与 AUN 代理(用
|
|
8
|
+
ec-proxy),也不适用于调用别人的服务(用 ec-service-call)。
|
|
9
|
+
license: MIT
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# EC 服务包:建、装、验
|
|
13
|
+
|
|
14
|
+
**本 skill 只讲怎么把本 Agent 变成一个可被调用的服务节点。** 字段级约束看
|
|
15
|
+
`$KITS_DOCS/evolcore/services.md` 与 `docs/services/schema/pack.schema.json`;
|
|
16
|
+
参数看 `ec services --help`。
|
|
17
|
+
|
|
18
|
+
**建错九成是下面四件事之一**:`requires` 与名片不匹配、`listen.type` 与对端发的字符串
|
|
19
|
+
不一致、`reply.allowed` 没开、新包没有被 reload 上。
|
|
20
|
+
|
|
21
|
+
## 〇、先判断该不该做成服务
|
|
22
|
+
|
|
23
|
+
| 用户要的 | 用什么 |
|
|
24
|
+
|---|---|
|
|
25
|
+
| 对端发消息 → 我跑确定性逻辑 → **回结果** | **服务(本 skill)** |
|
|
26
|
+
| 到点执行(每天 9 点、每 30 分钟) | `ec-trigger` 技能 |
|
|
27
|
+
| 我主动广播给很多人 | `ec events`(事件中心),不是服务 |
|
|
28
|
+
| 本机起一个长期跑的 HTTP 服务并对外代理 | `ec-proxy` 技能 |
|
|
29
|
+
|
|
30
|
+
一句话:**服务是点对点调用,有应答,且会丢**(volatile,超时即失败,不补投)。
|
|
31
|
+
|
|
32
|
+
## 一、目录与硬约束
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
$AGENT_DIR/services/
|
|
36
|
+
├── services-config.json # 总闸 + 限流 + 准入规则 + host 段
|
|
37
|
+
└── <包名>/
|
|
38
|
+
├── pack.json
|
|
39
|
+
├── scripts/<处理脚本>
|
|
40
|
+
├── ledger.jsonl # daemon 写
|
|
41
|
+
└── logs/ # daemon 写
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
- 包名用小写横线英文(`order`、`inventory`),**目录名才是身份**,`pack.json` 的 `name` 只是展示名。
|
|
45
|
+
- `services/` 是 **L 类受保护路径**:托管会话里 `Write` / `cp` 直接写会被拒。
|
|
46
|
+
**正确做法是写到工作区,再 `pack add` 让 daemon 代写。**
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# ① 在工作区写源目录
|
|
50
|
+
<工作区>/packs/hello/{pack.json,scripts/*.mjs}
|
|
51
|
+
# ② 装(daemon 代写进 agents/<aid>/services/)
|
|
52
|
+
ec services pack add hello --from <工作区>/packs/hello --aid "$SELF"
|
|
53
|
+
# ③ 验
|
|
54
|
+
ec services status --aid "$SELF" && ec services types --aid "$SELF"
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- **没有覆盖安装**:已存在时报 `PACK_ALREADY_EXISTS`,先 `pack remove` 再装。
|
|
58
|
+
- `pack enable|disable <包>` 改的是 `pack.json` 的 `enabled`(单包开关),
|
|
59
|
+
与 AID 级总闸 `ec services enable|disable` 是两个层级,别混。
|
|
60
|
+
|
|
61
|
+
## 二、`pack.json` 最小形态
|
|
62
|
+
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"v": 1,
|
|
66
|
+
"name": "订单受理",
|
|
67
|
+
"description": "订单受理相关的全部服务",
|
|
68
|
+
"requires": { "type": ["services", "agent"], "exttype": "order" },
|
|
69
|
+
"listen": [
|
|
70
|
+
{
|
|
71
|
+
"type": "services.order.create",
|
|
72
|
+
"handler": {
|
|
73
|
+
"script": "scripts/on-create.mjs",
|
|
74
|
+
"runtime": "node",
|
|
75
|
+
"timeoutMs": 15000,
|
|
76
|
+
"name": "下单",
|
|
77
|
+
"description": "创建订单。data: {sku, qty},返回 order_id"
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
],
|
|
81
|
+
"reply": { "allowed": true }
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
| 字段 | 要点 |
|
|
86
|
+
|---|---|
|
|
87
|
+
| `requires` | **必填**,匹配的是**本机名片**(`type`/`exttype`),不是消息。不匹配 = 包 `skipped`,不是报错 |
|
|
88
|
+
| `listen[].type` | 必须是 `services[.<段>.<段>]`,末段可写 `*`;末段不能是 `result` |
|
|
89
|
+
| `handler.script` | 必须在 `scripts/` 下,禁绝对路径、`..`、反斜杠、符号链接 |
|
|
90
|
+
| `handler.runtime` | `node` / `python` / `bash` / `powershell`;省略按扩展名推断 |
|
|
91
|
+
| `handler.timeoutMs` | **缺省 10000**,范围 [1000, 300000]。**默认值刻意短于调用方 12 秒的等待期** |
|
|
92
|
+
| `handler.name`/`description` | 可选但**强烈建议**:这是 `data` 契约的唯一声明渠道,对端靠 `describe`/`skill` 读到才知道该塞什么 |
|
|
93
|
+
| `handler.mode` | `spawn`(默认)/ `resident`。**默认别用 resident**,见第七节 |
|
|
94
|
+
| `reply.allowed` | **缺省 false**。不开就只有执行记录,调用方永远收不到结果 |
|
|
95
|
+
|
|
96
|
+
`requires` 怎么写:
|
|
97
|
+
|
|
98
|
+
| 写法 | 含义 |
|
|
99
|
+
|---|---|
|
|
100
|
+
| `{"type":"services","exttype":"order"}` | 只在名片 `type=services`+`exttype=order` 时生效 |
|
|
101
|
+
| `{"type":["services","agent"],"exttype":"order"}` | services 和 agent 都生效 |
|
|
102
|
+
| `{"type":"*","exttype":"*"}` | 完全放开 |
|
|
103
|
+
|
|
104
|
+
**兼职是推荐做法**:不用为提供服务另开一个 AID,名片保持 `type=agent` 即可。
|
|
105
|
+
|
|
106
|
+
## 三、脚本契约(这是最容易写错的地方)
|
|
107
|
+
|
|
108
|
+
脚本**从 stdin 读一个 JSON 到 EOF**,**最后一行 stdout 输出一个 JSON**。
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
let raw = '';
|
|
112
|
+
process.stdin.setEncoding('utf8');
|
|
113
|
+
process.stdin.on('data', c => { raw += c; });
|
|
114
|
+
process.stdin.on('end', () => {
|
|
115
|
+
const { message } = JSON.parse(raw);
|
|
116
|
+
// message.data 是调用方正文;message.from 是调用方 AID;message.type 是 type
|
|
117
|
+
console.log(JSON.stringify({
|
|
118
|
+
outcome: 'success',
|
|
119
|
+
data: { order_id: 'O-1', sku: message.data.sku },
|
|
120
|
+
}));
|
|
121
|
+
});
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
输入形状:
|
|
125
|
+
|
|
126
|
+
```json
|
|
127
|
+
{
|
|
128
|
+
"v": 1,
|
|
129
|
+
"service": { "name": "订单受理", "dir": "…/services/order" },
|
|
130
|
+
"message": {
|
|
131
|
+
"type": "services.order.create",
|
|
132
|
+
"requestId": "01J…",
|
|
133
|
+
"from": "alice.agentid.cn",
|
|
134
|
+
"receivedAt": 1794115720000,
|
|
135
|
+
"encrypted": false,
|
|
136
|
+
"data": { "sku": "A-1" }
|
|
137
|
+
},
|
|
138
|
+
"agent": { "aid": "self.agentid.cn", "dir": "…", "type": "services", "exttype": "order" },
|
|
139
|
+
"paths": { "ledger": "…/ledger.jsonl", "logs": "…/logs" }
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
输出三选一(**最后一行**):
|
|
144
|
+
|
|
145
|
+
```json
|
|
146
|
+
{"outcome":"success","data":{...}}
|
|
147
|
+
{"outcome":"error","error":{"code":"OUT_OF_STOCK","message":"库存不足"}}
|
|
148
|
+
{"outcome":"noop"}
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
必须知道的几条:
|
|
152
|
+
|
|
153
|
+
- **没有 `threadId`/`topicName`/`chatmode`**——服务调用不是聊天。
|
|
154
|
+
- `paths` 只是定位信息,**脚本读写不了**(沙箱对服务目录 EPERM)。要留痕就写 stdout。
|
|
155
|
+
- **不要自己发回复**。输出 `outcome`,daemon 按 `<请求type>.result` 派生并发。
|
|
156
|
+
- 回复 `type` 自动派生:`services.order.create` → `services.order.create.result`。
|
|
157
|
+
- **输出上限 stdout+stderr 合计 1 MiB,超出直接杀掉进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断。
|
|
158
|
+
- 脚本能读到的环境变量:`EC_SELF_AID` / `EC_SELF_TYPE` / `EC_SELF_EXTTYPE` / `EC_PACK_DIR` /
|
|
159
|
+
`EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` / `EC_ENCRYPTED`。
|
|
160
|
+
其余凭据类变量与全部 `EVOLCORE_*` 已被清理。
|
|
161
|
+
|
|
162
|
+
**Windows 沙箱**:`runtime` 必须是原生可执行文件(`node` → `node.exe`),脚本扩展名不受限
|
|
163
|
+
(`.mjs`/`.js`/`.cjs` 都行)。沙箱依赖 `@openai/codex`,没装时返回 `SCRIPT_SANDBOX_UNAVAILABLE`(126)。
|
|
164
|
+
|
|
165
|
+
## 四、装完必须验的四项
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
ec services status --aid "$SELF" # packs[].status 必须是 active
|
|
169
|
+
ec services types --aid "$SELF" # 出现你声明的 type
|
|
170
|
+
ec services doctor --aid "$SELF" # 无 error
|
|
171
|
+
ec services pack list --aid "$SELF"
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
| 状态 | 含义 |
|
|
175
|
+
|---|---|
|
|
176
|
+
| `active` | 正常 |
|
|
177
|
+
| `skipped` | `requires` 与本机名片不匹配。**合法状态,不是错误**——所以拷包给别人是安全的 |
|
|
178
|
+
| `invalid` | 配置错误,`doctor` 会说明哪一条 |
|
|
179
|
+
| `disabled` | `pack.json` 的 `enabled=false` |
|
|
180
|
+
|
|
181
|
+
**自测怎么做**:`ec services call` **禁止调本机自身 AID**(`cannot call self`),所以不能
|
|
182
|
+
"自己调自己"来验证。验证靠两种:
|
|
183
|
+
|
|
184
|
+
1. **别的方法**:`ec services types` 里有你的 type、`doctor` 无错、装包后 `status=active`;
|
|
185
|
+
2. **真调**:让另一个有 AUN 通道的 Agent 调你,或由对端会话发起。
|
|
186
|
+
|
|
187
|
+
> 别把「`ec services call` 报 `cannot call self`」当成服务坏了——那是前置拒绝。
|
|
188
|
+
|
|
189
|
+
## 五、回复、准入与限流
|
|
190
|
+
|
|
191
|
+
- **回复由 daemon 代发**,加密态跟随来信,不带话题信息,自动带 `request_id` 与 `replyToMessageId`。
|
|
192
|
+
- 服务调用**认联系人配置**,准入判定在包匹配**之前**:未准入的调用不会触达包、不会起脚本沙箱。
|
|
193
|
+
陌生来源第一次收到一条与请求内容无关的 `NOT_AUTHORIZED`,24 小时内只回一次,之后静默。
|
|
194
|
+
**不会自动给你建联系人申请**。
|
|
195
|
+
- 内置查询按「返回体里有没有内部结构」分级:`ping` 全开;`list`/`describe`(不带 service)
|
|
196
|
+
降级空壳;带 service 的统一拒绝。
|
|
197
|
+
- 限流按来源 AID 独立计:业务 `50/分、1000/时`,内置 `20/分、200/时`,超限 `RATE_LIMITED` + `retry_after`。
|
|
198
|
+
|
|
199
|
+
要放开给特定对端,按 type 加规则(写在 `services-config.json`,用命令改):
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
ec services rules show # 看全部
|
|
203
|
+
ec services rules add services.order.create buyer.agentid.cn
|
|
204
|
+
ec services rules add services.order.create spam.agentid.cn --deny
|
|
205
|
+
ec services rules remove services.order.create spam.agentid.cn --deny
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
`deny` 命中即拒且**优先于** `allow` 与联系人集合;同一个 AID 不能同时写在两边(校验期报错)。
|
|
209
|
+
**内置保留字不接受 rules**(`ping`/`list`/`describe`/`schema`/`skill`),写这类键直接报错。
|
|
210
|
+
|
|
211
|
+
## 六、改完怎么生效
|
|
212
|
+
|
|
213
|
+
**没有自动热重载**(没有 `fs.watch`):改 `pack.json` 或脚本后必须显式重载,否则无声无息地
|
|
214
|
+
还是旧行为,日志里也看不出异常。
|
|
215
|
+
|
|
216
|
+
```bash
|
|
217
|
+
# 改了包内容(services/ 下不能直接改,改工作区源目录后重装)
|
|
218
|
+
ec services pack remove hello --aid "$SELF"
|
|
219
|
+
ec services pack add hello --from <工作区>/packs/hello --aid "$SELF"
|
|
220
|
+
|
|
221
|
+
# 只确认状态
|
|
222
|
+
ec services reload --aid "$SELF" # 全量重扫,不接受包名
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
`pack add` / `pack remove` 内部已经 reload,**不需要**再单独 `reload`。
|
|
226
|
+
|
|
227
|
+
## 七、常驻形态(`mode: "resident"`):默认别用
|
|
228
|
+
|
|
229
|
+
一次性 spawn 每次约 80ms 是 node 自己的启动开销。常驻形态让一个进程服务多次调用,稳态降到
|
|
230
|
+
IPC 往返量级。但代价是:
|
|
231
|
+
|
|
232
|
+
- **进程有状态、内存全局共享**:一个调用的脏数据会被下一个调用看见。
|
|
233
|
+
- **不能扩容**,不能跨宿主迁移。
|
|
234
|
+
- 脚本必须按**另一套契约**写:先发 `{t:'ready'}`、每行带原样 `callId`、上下文从帧里读、
|
|
235
|
+
日志一律走 stderr、**没有退出码**。
|
|
236
|
+
- **正文在 `service.data`**(一次性契约是 `message.data`)——照抄旧脚本会静默拿到 `undefined`。
|
|
237
|
+
- 粒度是「包 + 脚本」:同包不同脚本各一个进程,同脚本共享。临时文件用 `callDir`(每调用一个),
|
|
238
|
+
缓存用 `workDir`(进程级,不要清空)。帧字段与超时参数见 `$KITS_DOCS/evolcore/services.md` 指向的 `usage.md` §八·五。
|
|
239
|
+
- `host.enabled` 不是 `true` 时(`ec services host enable` 打开,daemonOwner + fullaccess)
|
|
240
|
+
**降级为每次调用起一个进程**:结果一样,没有稳态收益,`doctor` 会给 warn。
|
|
241
|
+
|
|
242
|
+
有内存累积、需要并行、或者脚本是现成的一次性写法,就留在默认形态。
|
|
243
|
+
|
|
244
|
+
## 八、排查
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
ec services status # 包状态:active / skipped / invalid / disabled
|
|
248
|
+
ec services types # 本机可接的全部 services.*
|
|
249
|
+
ec services doctor <包名> # requires、保留字遮蔽、脚本、路径、ACL
|
|
250
|
+
ec services ledger <包名> --tail 20 # 生命周期台账
|
|
251
|
+
ec services tail <包名> # 消息日志(含 handled 的 exit / cmd / ms / outcome)
|
|
252
|
+
ec services repair-acl # 历史包的 NTFS ACL 收口(幂等,仅 Windows)
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
| 症状 | 先看 |
|
|
256
|
+
|---|---|
|
|
257
|
+
| 包不生效 | `status` 里是不是 `skipped`;`requires` 与本机名片对不对(`ec aid agentmd get <自己>`) |
|
|
258
|
+
| 对端调不通 | 你的 `exttype`;`services-config.json` 的 `enabled` 总闸 |
|
|
259
|
+
| 脚本没跑 | `listen.type` 与对端发的字符串是否**完全一致**(含大小写);`filter` 是不是筛掉了 |
|
|
260
|
+
| 脚本跑了但失败 | `logs/` 里 `handled` 的 `exit`、`cmd`、`outcome` |
|
|
261
|
+
| 收不到回复 | `reply.allowed` 是不是 `false`(缺省就是) |
|
|
262
|
+
| `RATE_LIMITED` | 超限,看 `retry_after` |
|
|
263
|
+
| `SCRIPT_OUTPUT_LIMIT` | 输出超过 1 MiB,进程被杀(不是截断) |
|
|
264
|
+
| `logs/` 里有 `sandbox_absent` | 沙箱降级成无沙箱执行了,脚本能读到本不该读的文件 |
|
|
265
|
+
|
|
266
|
+
## 九、不要做的事
|
|
267
|
+
|
|
268
|
+
1. **不要在脚本里自己发回复**——输出 `outcome` 让 daemon 发,否则话题、加密态、
|
|
269
|
+
`request_id` 都会错。
|
|
270
|
+
2. **不要用 `services` 承载不能重复的操作却不做幂等**。daemon 按 `(from, request_id)`
|
|
271
|
+
只去重 15 秒,更晚的重试会重新执行;真正的幂等键要由脚本按业务字段保证。
|
|
272
|
+
3. **不要在一个包里给同一个 `type` 写两条 `listen`**。同包重复直接判 invalid。
|
|
273
|
+
4. **不要在两个包里写同一个 `type`**。两个包都会 invalid,谁先跑没有确定答案。
|
|
274
|
+
5. **不要把 `exttype` 设成保留字还指望能接**。`exttype=list` 时 `services.list` 被内置抢走,
|
|
275
|
+
但 `services.list.create` 仍路由到你的包(保留字只占两段形式)。
|
|
276
|
+
6. **不要指望服务调用带话题**。它不是聊天,没有 `threadId`。
|
|
277
|
+
7. **不要在 `services/` 目录里直接写文件**。L 类路径,走 `pack add`。
|
|
@@ -91,10 +91,22 @@ EC 的技能系统:**一组可加载的能力单元**,每个技能是一个
|
|
|
91
91
|
`disable` 之后,或手改了 `.switches.json`、SKILL.md 的 description,都要再执行一次
|
|
92
92
|
`refresh <当前 AID>` 让 daemon 重建索引,否则模型看到的仍是旧列表。
|
|
93
93
|
|
|
94
|
-
###
|
|
94
|
+
### 路径:技能目录写成 `{{skillDir}}`
|
|
95
95
|
|
|
96
|
-
EC 不会把 cwd 设到技能目录,所以 `SKILL.md`
|
|
97
|
-
|
|
96
|
+
EC 不会把 cwd 设到技能目录,所以 `SKILL.md` 里的脚本路径必须是绝对路径。
|
|
97
|
+
技能目录要引用的地方,一律写成 `{{skillDir}}`,`ec skill load` 输出时替换成本机绝对路径
|
|
98
|
+
(统一正斜杠,Windows 直接可用):
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
node "{{skillDir}}/scripts/foo.mjs"
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
正文因此不含任何本机路径,换机器、换用户名、改安装位置都不用改。旧写法 `<技能目录>` 同样处理;
|
|
105
|
+
占位符后面不跟路径分隔符时原样保留,所以正文里可以正常提到它。直接 `Read` / `cat` 读到的是
|
|
106
|
+
未渲染的占位符——要执行就用加载输出,或照页脚的 `skillDir:` 自己替换。
|
|
107
|
+
|
|
108
|
+
**不要用 `$EVOLCORE_HOME` 拼**——内置技能根是安装目录下的 `kits/skills`;`$EVOLCORE_HOME` 是运行时
|
|
109
|
+
数据根(local 级技能在 `$EVOLCORE_HOME/skills`),装在内置级时两边不是一个目录。
|
|
98
110
|
|
|
99
111
|
配套硬要求:**脚本内部要用自身位置定位资源**,不能依赖 cwd:
|
|
100
112
|
|
|
@@ -131,12 +143,14 @@ description: >- # 最关键:写清做什么 + 触发场景 +
|
|
|
131
143
|
正文建议结构:**目标 → 步骤(编号、祈使句)→ 输出契约 → 边界情况 → 参考资料指引**。
|
|
132
144
|
超过 500 行就把细节挪到 `references/`。
|
|
133
145
|
|
|
146
|
+
正文里引用脚本时,技能目录按上面「路径」那节写:用 `{{skillDir}}`,不要写死本机绝对路径。
|
|
147
|
+
|
|
134
148
|
## 工具
|
|
135
149
|
|
|
136
150
|
脚本自定位,**执行时必须写完整绝对路径**(不要依赖 cwd):
|
|
137
151
|
|
|
138
152
|
```bash
|
|
139
|
-
node "
|
|
153
|
+
node "{{skillDir}}/scripts/cli.mjs" <子命令>
|
|
140
154
|
```
|
|
141
155
|
|
|
142
156
|
| 子命令 | 作用 |
|
|
@@ -155,7 +169,7 @@ node "<技能目录>/scripts/cli.mjs" <子命令>
|
|
|
155
169
|
改动技能后执行一次 `refresh`,`<aid>` 填当前 Agent 自己的 AID(上下文里的 `selfAid`):
|
|
156
170
|
|
|
157
171
|
```bash
|
|
158
|
-
node "
|
|
172
|
+
node "{{skillDir}}/scripts/cli.mjs" refresh <selfAid>
|
|
159
173
|
```
|
|
160
174
|
|
|
161
175
|
### 常见任务
|
|
@@ -163,7 +177,7 @@ node "<技能目录>/scripts/cli.mjs" refresh <selfAid>
|
|
|
163
177
|
**新建一个技能**:
|
|
164
178
|
|
|
165
179
|
```bash
|
|
166
|
-
node "
|
|
180
|
+
node "{{skillDir}}/scripts/cli.mjs" create my-analyzer --desc "分析日志并汇总。当用户要求分析日志时使用。"
|
|
167
181
|
```
|
|
168
182
|
|
|
169
183
|
生成后**必须补全 description**——它是技能被选中的唯一依据。
|
|
@@ -175,7 +189,7 @@ node "<技能目录>/scripts/cli.mjs" create my-analyzer --desc "分析日志并
|
|
|
175
189
|
就等于禁用,技能不进索引、不会被模型选中。确认要用之后显式启用:
|
|
176
190
|
|
|
177
191
|
```bash
|
|
178
|
-
node "
|
|
192
|
+
node "{{skillDir}}/scripts/cli.mjs" enable <name>
|
|
179
193
|
```
|
|
180
194
|
|
|
181
195
|
需要装完即启用时加 `--enable`(此时才写入 `{"enabled": true}`):
|
|
@@ -197,14 +211,16 @@ node "<技能目录>/scripts/cli.mjs" enable <name>
|
|
|
197
211
|
| 情形 | 结果 |
|
|
198
212
|
|------|------|
|
|
199
213
|
| 群聊里(**含 owner 本人**) | 一律拒绝 |
|
|
200
|
-
| 私聊 + Agent 级写(`--level agent`,默认) | 需本 Agent 的 **owner** |
|
|
201
|
-
| 私聊 + 本机级写(`install` / `remove` / `create` / `--level local`) | 需 **
|
|
214
|
+
| 私聊 + Agent 级写(`--level agent`,默认) | 需本 Agent 的 **owner 或 admin** |
|
|
215
|
+
| 私聊 + 本机级写(`install` / `remove` / `create` / `--level local`) | 需 Control AID 当前 Ownership 协议共识确认的 **DaemonOwner** |
|
|
202
216
|
| 宿主终端直连(无会话上下文) | 放行 |
|
|
203
217
|
|
|
204
218
|
**在群里被拒时不要重试、不要换参数绕过**:这是设计使然——技能开关是 agent 自身配置,
|
|
205
219
|
不该被群里的对话推动。直接把结论告诉对方,请其私聊提出或由管理员在终端执行。
|
|
206
220
|
|
|
207
221
|
本机级目录是**整机所有 agent 共享**的,所以装/删/建和本机级开关同档,都要 daemonowner。
|
|
222
|
+
CLI 和直接运行技能脚本均通过 daemon 验证任务委托及写入权限;不读取旧 `daemon.json.owners` 授权。
|
|
223
|
+
只读任务禁止写入;协议归属不可核验时拒绝本机级写入。daemon 验证的本轮 fullaccess 授权按其权限执行。
|
|
208
224
|
|
|
209
225
|
只读子命令(`list` / `info` / `where` / `validate`)不受限制。
|
|
210
226
|
|
|
@@ -15,7 +15,7 @@ const USAGE = `用法: ec skill <command> [options]
|
|
|
15
15
|
ec skill —— EC 技能管理
|
|
16
16
|
|
|
17
17
|
ec skill load <name> [--source builtin|local] [--with-frontmatter]
|
|
18
|
-
加载技能正文(输出 SKILL.md 内容 + skillDir
|
|
18
|
+
加载技能正文(输出 SKILL.md 内容 + skillDir + 字符数)
|
|
19
19
|
ec skill path <name> [--json] 查看技能 SKILL.md 完整路径(含状态和时间戳)
|
|
20
20
|
ec skill list [--all] [--filter '<kw1,kw2>']... [--page <n>] [--limit <n>] [--json]
|
|
21
21
|
列出技能(默认仅启用;--all 全部;--filter 匹配名称+描述,组内逗号分隔为 OR,多组之间为 AND;超过 limit 条自动分页)
|
|
@@ -33,7 +33,7 @@ ec skill —— EC 技能管理
|
|
|
33
33
|
ec skill refresh <aid> [--json] 重建该 Agent 的技能索引(经 daemon)
|
|
34
34
|
|
|
35
35
|
说明:
|
|
36
|
-
- 加载技能用 load,输出正文末尾附带 skillDir
|
|
36
|
+
- 加载技能用 load,输出正文末尾附带 skillDir 绝对路径与正文字符数 chars,脚本路径以 skillDir 为根
|
|
37
37
|
- 安装目标只能是本机级(Agent 级只放开关,不放 SKILL.md)
|
|
38
38
|
- create / install 装完默认禁用,确认后再用 enable 启用(--enable 可一步到位)
|
|
39
39
|
- 内置级(随包发布)不可写、不可删
|
|
@@ -127,23 +127,23 @@ async function main() {
|
|
|
127
127
|
return 0;
|
|
128
128
|
|
|
129
129
|
case 'create':
|
|
130
|
-
emit(S.cmdCreate(positional[0], { desc: flags.desc || '', force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
|
|
130
|
+
emit(await S.cmdCreate(positional[0], { desc: flags.desc || '', force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson, argv }));
|
|
131
131
|
return 0;
|
|
132
132
|
|
|
133
133
|
case 'install':
|
|
134
|
-
emit(S.cmdInstall(positional[0], { force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson }));
|
|
134
|
+
emit(await S.cmdInstall(positional[0], { force: Boolean(flags.force), enable: Boolean(flags.enable), json: asJson, argv }));
|
|
135
135
|
return 0;
|
|
136
136
|
|
|
137
137
|
case 'remove':
|
|
138
|
-
emit(S.cmdRemove(positional[0], { json: asJson }));
|
|
138
|
+
emit(await S.cmdRemove(positional[0], { json: asJson, argv }));
|
|
139
139
|
return 0;
|
|
140
140
|
|
|
141
141
|
case 'enable':
|
|
142
|
-
emit(S.cmdEnableDisable(positional[0], true, { level: flags.level || 'agent', json: asJson }));
|
|
142
|
+
emit(await S.cmdEnableDisable(positional[0], true, { level: flags.level || 'agent', json: asJson, argv }));
|
|
143
143
|
return 0;
|
|
144
144
|
|
|
145
145
|
case 'disable':
|
|
146
|
-
emit(S.cmdEnableDisable(positional[0], false, { level: flags.level || 'agent', json: asJson }));
|
|
146
|
+
emit(await S.cmdEnableDisable(positional[0], false, { level: flags.level || 'agent', json: asJson, argv }));
|
|
147
147
|
return 0;
|
|
148
148
|
|
|
149
149
|
case 'validate': {
|