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
package/dist/services/index.js
CHANGED
|
@@ -5,25 +5,28 @@
|
|
|
5
5
|
* 应答(*.result)完全不经过这里——那是 AunRequestRegistry 的事,在消息层更早分支。
|
|
6
6
|
*/
|
|
7
7
|
import path from 'node:path';
|
|
8
|
+
import { agentProjectChangeGate } from '../config-store.js';
|
|
8
9
|
import { logger } from '../utils/logger.js';
|
|
9
10
|
import { matchFilter } from '../trigger/event-source.js';
|
|
10
11
|
import { ServiceDispatcher } from './dispatcher.js';
|
|
12
|
+
import { ServiceHostRuntime } from './host-runtime.js';
|
|
11
13
|
import { IdempotencyStore } from './idempotency.js';
|
|
12
14
|
import { readLocalSelfIdentity } from './identity.js';
|
|
13
15
|
import { writeServicesIndex } from './index-generator.js';
|
|
14
|
-
import { servicePackLedger as packLedger, routerLedger, ServiceLedger } from '../core/pack-ledger.js';
|
|
16
|
+
import { servicePackLedger as packLedger, routerLedger, ServiceLedger } from '../core/pack/pack-ledger.js';
|
|
15
17
|
import { scheduleServicesAclHarden } from '../core/permission/services-path-acl.js';
|
|
16
18
|
import { ServiceMessageLog } from './message-log.js';
|
|
17
19
|
import { buildPackState, loadPackDir, loadPacks } from './pack-manager.js';
|
|
18
|
-
import { DEFAULT_ROUTER_CONFIG, loadRouterConfig, RateLimiter } from './router.js';
|
|
19
|
-
import { RateWindow } from '../core/rate-window.js';
|
|
20
|
+
import { DEFAULT_ROUTER_CONFIG, loadRouterConfig, RateLimiter, RateWindow } from './router.js';
|
|
20
21
|
import { ServiceScriptRunner } from './script-runner.js';
|
|
21
22
|
import { buildErrorReply, buildSilentReply, buildSuccessReply, replyFromOutcome, isReservedServiceType, matchesListen, RESERVED_TYPES, } from './service-payload.js';
|
|
22
23
|
import { errorMessage } from './types.js';
|
|
24
|
+
import { DEFAULT_HANDLER_TIMEOUT_MS } from './validation.js';
|
|
23
25
|
import { isOutputType } from '../outputs/protocol.js';
|
|
24
26
|
import { outputRequestSchema, outputResponseSchema } from '../outputs/protocol.js';
|
|
25
27
|
import { OutputService } from '../outputs/service.js';
|
|
26
28
|
import { isOutputCardsType, outputCardsRequestSchema, outputCardsResponseSchema, OutputCardsService, OUTPUT_CARDS_TYPES } from '../outputs/cards.js';
|
|
29
|
+
import { isPanelCardsType, panelCardsRequestSchema, panelCardsResponseSchema, PanelCardsService, PANEL_CARDS_TYPES, panelCardsCatalog } from '../outputs/panel-cards.js';
|
|
27
30
|
import { DataRootError } from '../core/command/team-workspace-store.js';
|
|
28
31
|
import { isWorkbenchType, WORKBENCH_TYPES, workbenchRequestSchema, workbenchResponseSchema } from '../workbench/protocol.js';
|
|
29
32
|
import { WorkbenchService } from '../workbench/service.js';
|
|
@@ -47,6 +50,28 @@ const UNAUTHORIZED_NOTICE_MAX = 10_000;
|
|
|
47
50
|
* 但拿不到包名、服务 type、reply 策略这些内部结构。
|
|
48
51
|
*/
|
|
49
52
|
const UNAUTHORIZED_MINIMAL_BUILTIN = ['services.ping'];
|
|
53
|
+
/**
|
|
54
|
+
* 调度层拒收码:脚本**一秒都没执行**。
|
|
55
|
+
*
|
|
56
|
+
* 三个后果必须一致处理,漏一个就会把偶发故障放大成持续故障:
|
|
57
|
+
*
|
|
58
|
+
* 1. 不进 `handled` 日志(那是"脚本跑完了"的记录);
|
|
59
|
+
* 2. 进 `service.rejected` 台账(运维要看得出是调度层挡的);
|
|
60
|
+
* 3. **不进包内幂等缓存**——否则调用方 15 秒内重试会拿到缓存下来的失败。
|
|
61
|
+
*
|
|
62
|
+
* `SERVICES_HOST_*` 属于这一类:宿主启动中 / 重启中 / 降级 / 协议破坏,
|
|
63
|
+
* 被调用的脚本根本没被拉起。
|
|
64
|
+
*/
|
|
65
|
+
const SCHEDULER_REJECTION_CODES = new Set([
|
|
66
|
+
'SERVICE_DEADLINE_EXCEEDED',
|
|
67
|
+
'QUEUE_FULL',
|
|
68
|
+
'DISPATCHER_CLOSED',
|
|
69
|
+
'SERVICES_HOST_STARTING',
|
|
70
|
+
'SERVICES_HOST_RESTARTING',
|
|
71
|
+
'SERVICES_HOST_UNAVAILABLE',
|
|
72
|
+
'SERVICES_HOST_PROTOCOL',
|
|
73
|
+
]);
|
|
74
|
+
const templateMutationHolds = new Map();
|
|
50
75
|
export class ServiceRouter {
|
|
51
76
|
servicesDir;
|
|
52
77
|
deps;
|
|
@@ -64,9 +89,25 @@ export class ServiceRouter {
|
|
|
64
89
|
/** fromAid → 上次告知未准入的时间;窗口内重复调用静默。 */
|
|
65
90
|
unauthorizedNotified = new Map();
|
|
66
91
|
started = false;
|
|
92
|
+
activeRequests = 0;
|
|
93
|
+
mutationHolds = new Set();
|
|
94
|
+
pauseForMutation(token) {
|
|
95
|
+
if (this.activeRequests)
|
|
96
|
+
throw Object.assign(new Error('Agent service requests are active'), { code: 'AGENT_BUSY' });
|
|
97
|
+
this.mutationHolds.add(token);
|
|
98
|
+
return () => { this.mutationHolds.delete(token); };
|
|
99
|
+
}
|
|
100
|
+
assertMutationIdle() {
|
|
101
|
+
if (this.activeRequests || this.hostRuntime?.running) {
|
|
102
|
+
throw Object.assign(new Error('Agent service requests or service host are active'), { code: 'AGENT_BUSY' });
|
|
103
|
+
}
|
|
104
|
+
}
|
|
67
105
|
outputService;
|
|
68
106
|
outputCardsService;
|
|
107
|
+
panelCardsService;
|
|
69
108
|
workbenchService;
|
|
109
|
+
/** 常驻宿主运行时(总闸打开且被调用时才真正启动进程)。 */
|
|
110
|
+
hostRuntime;
|
|
70
111
|
constructor(servicesDir, deps, limits,
|
|
71
112
|
/**
|
|
72
113
|
* 只读快照模式:不写索引、不写台账。
|
|
@@ -85,8 +126,43 @@ export class ServiceRouter {
|
|
|
85
126
|
this.dispatcher = new ServiceDispatcher(this.scriptRunner, limits);
|
|
86
127
|
this.outputService = deps.outputService ?? new OutputService(deps.aid);
|
|
87
128
|
this.outputCardsService = new OutputCardsService(deps.aid);
|
|
129
|
+
this.panelCardsService = deps.panelCardsService ?? new PanelCardsService(deps.aid);
|
|
88
130
|
this.workbenchService = deps.workbenchService ?? new WorkbenchService(deps.aid, { offline: readonlySnapshot });
|
|
89
131
|
}
|
|
132
|
+
/**
|
|
133
|
+
* 按总闸决定是否把宿主运行时挂到 runner 上。
|
|
134
|
+
*
|
|
135
|
+
* 挂载语义是「下一次调用走宿主」,本次不启动进程——懒启动由宿主运行时自己保证。
|
|
136
|
+
* 关闸时把引用摘掉即可:已起的宿主由 `close()` 收掉,不在这里杀(可能有在途调用)。
|
|
137
|
+
*/
|
|
138
|
+
syncHostRuntime() {
|
|
139
|
+
const enabled = this.config.host?.enabled === true;
|
|
140
|
+
if (!enabled) {
|
|
141
|
+
this.scriptRunner.setHostRuntime(undefined);
|
|
142
|
+
// 摘引用之后宿主进程还活着,要等 1 小时空闲回收。关闸是显式运维动作,
|
|
143
|
+
// 结果应该是「现在就没了」——空闲时立刻收掉;有在途调用时保留进程,
|
|
144
|
+
// 交给调用结束后正常的空闲回收(不强杀在途调用)。
|
|
145
|
+
void this.hostRuntime?.retireIfIdle().catch(error => {
|
|
146
|
+
logger.warn(`[Services] host retire after disable failed: ${errorMessage(error)}`);
|
|
147
|
+
});
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
if (this.hostRuntime) {
|
|
151
|
+
this.hostRuntime.cancelRetirement();
|
|
152
|
+
this.scriptRunner.setHostRuntime(this.hostRuntime);
|
|
153
|
+
return;
|
|
154
|
+
}
|
|
155
|
+
this.hostRuntime = new ServiceHostRuntime({
|
|
156
|
+
aid: this.deps.aid,
|
|
157
|
+
identity: () => this.identity,
|
|
158
|
+
getProjectPath: this.deps.getProjectPath,
|
|
159
|
+
// 缺省时返回 undefined,由宿主运行时在启动阶段明确拒绝(不静默降级)。
|
|
160
|
+
getRuntimeRoot: this.deps.getRuntimeRoot ?? (() => undefined),
|
|
161
|
+
...(this.deps.permissionMode ? { permissionMode: this.deps.permissionMode } : {}),
|
|
162
|
+
...(this.deps.onHostLog ? { onHostLog: this.deps.onHostLog } : {}),
|
|
163
|
+
});
|
|
164
|
+
this.scriptRunner.setHostRuntime(this.hostRuntime);
|
|
165
|
+
}
|
|
90
166
|
/** 首次加载:读 services-config.json + 扫描包。identity 必须已就绪。重复调用只更新 identity。 */
|
|
91
167
|
ensureStarted(identity) {
|
|
92
168
|
this.identity = identity;
|
|
@@ -109,11 +185,17 @@ export class ServiceRouter {
|
|
|
109
185
|
this.config = router.config;
|
|
110
186
|
this.routerErrors = router.errors;
|
|
111
187
|
this.limiter.setConfig(router.config);
|
|
188
|
+
// 总闸变化要立刻反映到执行路径上:打开 → 下次调用懒启动宿主;
|
|
189
|
+
// 关闭 → 后续调用退回一次性路径(已起的宿主在 close 时收掉)。
|
|
190
|
+
this.syncHostRuntime();
|
|
112
191
|
// 顺带清理过期窗口:reload 是低频动作,够用了,不值得为此单开一个定时器。
|
|
113
192
|
this.limiter.prune();
|
|
114
193
|
this.unauthorizedWindow.prune();
|
|
115
194
|
const loaded = loadPacks(this.servicesDir);
|
|
116
195
|
this.packs = buildPackState(loaded.valid, loaded.invalid.map(item => ({ id: item.packId, errors: item.errors })), this.identity);
|
|
196
|
+
// 热重载:已运行的宿主若与当前代码不一致,请求滚动重启(走空闲窗口,不打断调用)。
|
|
197
|
+
// 必须在包集合更新之后、且用新集合判——否则"改了代码"这个判断拿到的是旧快照。
|
|
198
|
+
this.hostRuntime?.reconcile(this.packs.activePacks.map(pack => ({ id: pack.id, revision: pack.revision })));
|
|
117
199
|
// 索引与包集合同步重建;空集删除,交给 manifest 的 optional 判缺失。
|
|
118
200
|
// 只读快照不写:查询命令不该改变磁盘状态。
|
|
119
201
|
if (!this.readonlySnapshot) {
|
|
@@ -216,6 +298,22 @@ export class ServiceRouter {
|
|
|
216
298
|
* 调用方必须已判定 `classifyServicePayloadType(type) === 'request'`。
|
|
217
299
|
*/
|
|
218
300
|
async handleRequest(message, options = {}) {
|
|
301
|
+
if (this.mutationHolds.size || agentProjectChangeGate(this.deps.aid))
|
|
302
|
+
return options.admission === 'blocked' ? buildSilentReply(message.type, message.requestId)
|
|
303
|
+
: buildErrorReply(message.type, message.requestId, 'AGENT_BUSY', 'Agent project migration is in progress');
|
|
304
|
+
if (templateMutationHolds.get(this.deps.aid)?.size) {
|
|
305
|
+
return options.admission === 'blocked' ? buildSilentReply(message.type, message.requestId)
|
|
306
|
+
: buildErrorReply(message.type, message.requestId, 'AGENT_BUSY', 'Agent template collection is in progress');
|
|
307
|
+
}
|
|
308
|
+
this.activeRequests++;
|
|
309
|
+
try {
|
|
310
|
+
return await this.handleUnpausedRequest(message, options);
|
|
311
|
+
}
|
|
312
|
+
finally {
|
|
313
|
+
this.activeRequests--;
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
async handleUnpausedRequest(message, options) {
|
|
219
317
|
const type = message.type;
|
|
220
318
|
if (!this.config.enabled) {
|
|
221
319
|
logger.debug(`[Services] router disabled; dropped ${type} mid=${message.messageId}`);
|
|
@@ -226,25 +324,37 @@ export class ServiceRouter {
|
|
|
226
324
|
this.rejectLedger('BLOCKED', type, message);
|
|
227
325
|
return buildSilentReply(type, message.requestId);
|
|
228
326
|
}
|
|
229
|
-
|
|
230
|
-
|
|
327
|
+
const panelCards = isPanelCardsType(type);
|
|
328
|
+
if (isOutputType(type) || isOutputCardsType(type) || panelCards || isWorkbenchType(type)) {
|
|
329
|
+
const lacksContactAdmission = options.admission === 'not_authorized';
|
|
330
|
+
// Panel cards have their own protocol Owner gate. The contacts cache
|
|
331
|
+
// may lag a verified Owner or legitimately omit that relationship.
|
|
332
|
+
if (lacksContactAdmission && !panelCards)
|
|
231
333
|
return this.unauthorizedReply(type, message, 'business');
|
|
232
334
|
const rule = this.callRuleFor(type);
|
|
233
335
|
if (rule?.deny.includes(message.fromAid))
|
|
234
336
|
return this.unauthorizedReply(type, message, 'business');
|
|
235
337
|
const limit = this.limiter.consume('service', message.fromAid);
|
|
236
338
|
if (!limit.allow)
|
|
237
|
-
return
|
|
339
|
+
return lacksContactAdmission
|
|
340
|
+
? this.unauthorizedReply(type, message, 'business')
|
|
341
|
+
: buildErrorReply(type, message.requestId, 'RATE_LIMITED', 'Output query rate exceeded');
|
|
238
342
|
try {
|
|
239
343
|
const data = isWorkbenchType(type)
|
|
240
344
|
? await this.workbenchService.handle(message)
|
|
241
|
-
:
|
|
242
|
-
? await this.
|
|
243
|
-
:
|
|
345
|
+
: panelCards
|
|
346
|
+
? await this.panelCardsService.handle(message)
|
|
347
|
+
: isOutputCardsType(type)
|
|
348
|
+
? await this.outputCardsService.handle(message)
|
|
349
|
+
: await this.outputService.handle(message);
|
|
244
350
|
return buildSuccessReply(type, message.requestId, data);
|
|
245
351
|
}
|
|
246
352
|
catch (error) {
|
|
247
353
|
if (error instanceof DataRootError) {
|
|
354
|
+
if (panelCards && lacksContactAdmission &&
|
|
355
|
+
['OUTPUT_FORBIDDEN', 'PANEL_CARDS_FORBIDDEN'].includes(error.code)) {
|
|
356
|
+
return this.unauthorizedReply(type, message, 'business');
|
|
357
|
+
}
|
|
248
358
|
return buildErrorReply(type, message.requestId, error.code, error.message, error.data);
|
|
249
359
|
}
|
|
250
360
|
return buildErrorReply(type, message.requestId, isWorkbenchType(type) ? 'WORKBENCH_UNAVAILABLE' : 'OUTPUT_UNAVAILABLE', errorMessage(error));
|
|
@@ -303,7 +413,7 @@ export class ServiceRouter {
|
|
|
303
413
|
return buildErrorReply(type, message.requestId, 'REQUEST_IN_FLIGHT', 'the same request_id is still being processed');
|
|
304
414
|
}
|
|
305
415
|
try {
|
|
306
|
-
return await this.executeMatched(pack, handler, type, message, store);
|
|
416
|
+
return await this.executeMatched(pack, handler, type, message, store, options);
|
|
307
417
|
}
|
|
308
418
|
finally {
|
|
309
419
|
store.release(message.fromAid, message.requestId);
|
|
@@ -350,7 +460,7 @@ export class ServiceRouter {
|
|
|
350
460
|
return { services: [], builtin: [...UNAUTHORIZED_MINIMAL_BUILTIN] };
|
|
351
461
|
}
|
|
352
462
|
/** 已通过准入与幂等检查之后的主路径。拆出来只是为了给 reserve/release 留一个 finally。 */
|
|
353
|
-
async executeMatched(pack, handler, type, message, store) {
|
|
463
|
+
async executeMatched(pack, handler, type, message, store, options = {}) {
|
|
354
464
|
const limit = this.limiter.consume('service', message.fromAid);
|
|
355
465
|
if (!limit.allow) {
|
|
356
466
|
packLedger(pack).append({ action: 'service.rejected', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, code: 'RATE_LIMITED' });
|
|
@@ -366,10 +476,14 @@ export class ServiceRouter {
|
|
|
366
476
|
return buildSilentReply(type, message.requestId);
|
|
367
477
|
}
|
|
368
478
|
packLedger(pack).append({ action: 'service.invoked', packId: pack.id, type, from: message.fromAid, requestId: message.requestId });
|
|
369
|
-
const outcome = await this.dispatcher.run(pack, handler.handler, message);
|
|
370
|
-
// 没跑起来 ≠
|
|
479
|
+
const outcome = await this.dispatcher.run(pack, handler.handler, message, options.simulateRole ? { peerRole: options.simulateRole } : undefined);
|
|
480
|
+
// 没跑起来 ≠ 脚本失败:调度层拒收时脚本一秒都没执行。
|
|
371
481
|
// 混进 `handled` 会让"这个服务为什么老是 error"指向错误的方向。
|
|
372
|
-
|
|
482
|
+
//
|
|
483
|
+
// `SERVICES_HOST_*` 与 `QUEUE_FULL` 同类:宿主正在启动/重启/降级/协议破坏,
|
|
484
|
+
// **脚本根本没被拉起**。这类失败还不能进幂等缓存(见下方 `record` 的条件)——
|
|
485
|
+
// 记进去的话调用方 15 秒内重试会拿到缓存的失败,把一次偶发重启放大成持续故障。
|
|
486
|
+
const notRun = SCHEDULER_REJECTION_CODES.has(outcome.error?.code ?? '');
|
|
373
487
|
if (notRun) {
|
|
374
488
|
log.writeDropped(message, outcome.error.code.toLowerCase());
|
|
375
489
|
packLedger(pack).append({
|
|
@@ -399,9 +513,11 @@ export class ServiceRouter {
|
|
|
399
513
|
logger.warn(`[Services] ${pack.id} handler for ${type} ${outcome.outcome}: ${outcome.error?.code ?? ''} ${outcome.error?.message ?? ''}`);
|
|
400
514
|
}
|
|
401
515
|
const reply = replyFromOutcome(type, message.requestId, outcome);
|
|
402
|
-
//
|
|
403
|
-
|
|
404
|
-
|
|
516
|
+
// 成功与**脚本自身**的失败都记:同一 (from, request_id) 重试必须回同一结果,不能重跑脚本。
|
|
517
|
+
// 但调度层拒收不记——脚本没执行过,"上次结果"不存在;记下来会把偶发重启
|
|
518
|
+
// 变成 15 秒内必现的失败(调用方重试时命中缓存)。
|
|
519
|
+
if (reply.shouldSend && !notRun) {
|
|
520
|
+
store.record(message.fromAid, message.requestId, reply.payload, Date.now(), message.deadlineAt);
|
|
405
521
|
}
|
|
406
522
|
if (reply.shouldSend) {
|
|
407
523
|
packLedger(pack).append({ action: 'service.replied', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, ...(reply.payload.ok === false ? { result: 'failed' } : { result: 'ok' }) });
|
|
@@ -454,7 +570,13 @@ export class ServiceRouter {
|
|
|
454
570
|
outputAuthorized = true;
|
|
455
571
|
}
|
|
456
572
|
catch { /* no private capability disclosure */ }
|
|
457
|
-
|
|
573
|
+
let panelCardsAuthorized = false;
|
|
574
|
+
try {
|
|
575
|
+
await this.panelCardsService.authorize(message);
|
|
576
|
+
panelCardsAuthorized = true;
|
|
577
|
+
}
|
|
578
|
+
catch { /* private card capabilities */ }
|
|
579
|
+
const outputs = this.outputDescriptions(outputAuthorized, panelCardsAuthorized);
|
|
458
580
|
let workbenchAuthorized = false;
|
|
459
581
|
try {
|
|
460
582
|
await this.workbenchService.authorize(message);
|
|
@@ -466,6 +588,9 @@ export class ServiceRouter {
|
|
|
466
588
|
if (requestedService && (isOutputType(requestedService) || isOutputCardsType(requestedService)) && !outputAuthorized) {
|
|
467
589
|
return buildErrorReply(type, message.requestId, 'OUTPUT_FORBIDDEN', 'Current protocol Owner authorization is required');
|
|
468
590
|
}
|
|
591
|
+
if (requestedService && isPanelCardsType(requestedService) && !panelCardsAuthorized) {
|
|
592
|
+
return buildErrorReply(type, message.requestId, 'OUTPUT_FORBIDDEN', 'Current protocol Owner authorization is required');
|
|
593
|
+
}
|
|
469
594
|
if (requestedService && isWorkbenchType(requestedService) && !workbenchAuthorized) {
|
|
470
595
|
return buildErrorReply(type, message.requestId, 'WORKBENCH_FORBIDDEN', 'Current protocol Owner authorization is required');
|
|
471
596
|
}
|
|
@@ -480,7 +605,8 @@ export class ServiceRouter {
|
|
|
480
605
|
// 不带 service 时退化为清单:与 `ec services describe <aid>` 的语义一致。
|
|
481
606
|
if (!target)
|
|
482
607
|
return buildSuccessReply(type, message.requestId, { services: [...this.describeAll(), ...native], builtin: [...RESERVED_TYPES] });
|
|
483
|
-
const output = native.find(item => Array.isArray(item.
|
|
608
|
+
const output = native.find(item => Array.isArray(item.handlers)
|
|
609
|
+
&& item.handlers.some(entry => entry?.type === target));
|
|
484
610
|
if (output)
|
|
485
611
|
return buildSuccessReply(type, message.requestId, output);
|
|
486
612
|
const described = this.describeOne(target);
|
|
@@ -500,6 +626,10 @@ export class ServiceRouter {
|
|
|
500
626
|
return buildSuccessReply(type, message.requestId, {
|
|
501
627
|
type: target, schema: outputCardsRequestSchema(target), responseDataSchema: outputCardsResponseSchema(),
|
|
502
628
|
});
|
|
629
|
+
if (isPanelCardsType(target))
|
|
630
|
+
return buildSuccessReply(type, message.requestId, {
|
|
631
|
+
type: target, schema: panelCardsRequestSchema(target), responseDataSchema: panelCardsResponseSchema(),
|
|
632
|
+
});
|
|
503
633
|
if (isOutputType(target))
|
|
504
634
|
return buildSuccessReply(type, message.requestId, {
|
|
505
635
|
type: target, schema: outputRequestSchema(target), responseDataSchema: outputResponseSchema(),
|
|
@@ -519,6 +649,9 @@ export class ServiceRouter {
|
|
|
519
649
|
if (isOutputCardsType(target))
|
|
520
650
|
return buildSuccessReply(type, message.requestId, { type: target,
|
|
521
651
|
skill: 'Owner-authorized output card projection. Cards are declaration-only metadata linked to real files in this Agent output. Use services.outputs.cards.snapshot/list/detail/changes, follow nextCursor, and reset on INDEX_CHANGED. Never poll. Publish or remove cards with ec team cards after referenced files are complete.' });
|
|
652
|
+
if (isPanelCardsType(target))
|
|
653
|
+
return buildSuccessReply(type, message.requestId, { type: target, catalog: panelCardsCatalog,
|
|
654
|
+
skill: 'Owner-authorized Evol panel cards. Read services.skill for services.panel-cards.snapshot to load the catalog. Design complete HTML/CSS cards with body {type:html,resourceId:surface} and a declared HTML file resource under project .output/<selfAid>/ (max 256 KiB). Inline CSS/SVG/data images are supported; scripts/network/forms/native bridge are unavailable. Native components and read-only actions remain supported. Publish with ec team cards validate then publish; updates reuse the same id and remove only the card descriptor.' });
|
|
522
655
|
if (isOutputType(target))
|
|
523
656
|
return buildSuccessReply(type, message.requestId, { type: target,
|
|
524
657
|
skill: 'Read-only fixed Agent output. Requires encrypted AUN and current verified protocol Owner. Send protocolVersion:1 and the schema-defined data fields. Results are bounded; follow nextCursor and reset on INDEX_CHANGED. No periodic reads.' });
|
|
@@ -564,13 +697,45 @@ export class ServiceRouter {
|
|
|
564
697
|
return false;
|
|
565
698
|
}
|
|
566
699
|
}
|
|
700
|
+
/**
|
|
701
|
+
* 宿主运行时状态(运维观测用)。
|
|
702
|
+
*
|
|
703
|
+
* 未启用时返回 `{ enabled: false }`;启用但未启动时 `running: false`——
|
|
704
|
+
* 这两种要能区分:前者是闸门关着,后者是懒加载还没被调用过。
|
|
705
|
+
*/
|
|
706
|
+
hostStatus() {
|
|
707
|
+
const enabled = this.config.host?.enabled === true;
|
|
708
|
+
// 关闸后进程可能还在(有在途调用,等它们跑完再收):必须如实报出来,
|
|
709
|
+
// 否则 `{enabled:false}` 会让人以为进程已经没了。
|
|
710
|
+
if (!enabled) {
|
|
711
|
+
const running = this.hostRuntime?.running === true;
|
|
712
|
+
return running
|
|
713
|
+
? { enabled: false, running: true, draining: true }
|
|
714
|
+
: { enabled: false };
|
|
715
|
+
}
|
|
716
|
+
return {
|
|
717
|
+
enabled: true,
|
|
718
|
+
...(this.hostRuntime ? this.hostRuntime.status() : { running: false, started: false }),
|
|
719
|
+
};
|
|
720
|
+
}
|
|
567
721
|
/** services.list 的正文:每个 active 包及其全部 listen type。 */
|
|
568
722
|
describeAll() {
|
|
569
723
|
return this.packs.activePacks.map(pack => ({
|
|
570
724
|
pack: pack.id,
|
|
571
725
|
name: pack.name,
|
|
572
726
|
...(pack.description ? { description: pack.description } : {}),
|
|
573
|
-
|
|
727
|
+
/**
|
|
728
|
+
* 逐 handler 一条,`type` 与展示信息同属一个记录。
|
|
729
|
+
*
|
|
730
|
+
* 不用「`types: string[]` + 另一个带标注的数组」两个平行数组:同一 type 出现两处
|
|
731
|
+
* 必然漂移,消费方还得自己按下标对齐。`handlers` 与 `pack.json` 的 `listen[].handler`、
|
|
732
|
+
* 以及 `describeOne` 返回的 `handlers` 三处同名同义。
|
|
733
|
+
*/
|
|
734
|
+
handlers: pack.listen.map(entry => ({
|
|
735
|
+
type: entry.type,
|
|
736
|
+
...(entry.handler.name ? { name: entry.handler.name } : {}),
|
|
737
|
+
...(entry.handler.description ? { description: entry.handler.description } : {}),
|
|
738
|
+
})),
|
|
574
739
|
/** 精确 type;通配形式保留原样,调用方据此判断可发范围。 */
|
|
575
740
|
unmatched: pack.unmatched,
|
|
576
741
|
reply: pack.reply.allowed,
|
|
@@ -588,11 +753,17 @@ export class ServiceRouter {
|
|
|
588
753
|
type: target,
|
|
589
754
|
pack: pack.id,
|
|
590
755
|
name: pack.name,
|
|
591
|
-
|
|
756
|
+
/** handler 的说明优先于包说明:调用方问的是「这个 type」,不是「这个包」。 */
|
|
757
|
+
...(entry.handler.description
|
|
758
|
+
? { description: entry.handler.description }
|
|
759
|
+
: pack.description ? { description: pack.description } : {}),
|
|
760
|
+
...(entry.handler.name ? { handlerName: entry.handler.name } : {}),
|
|
761
|
+
...(entry.handler.inputSchema ? { inputSchema: entry.handler.inputSchema } : {}),
|
|
762
|
+
...(entry.handler.outputSchema ? { outputSchema: entry.handler.outputSchema } : {}),
|
|
592
763
|
listen: entry.type,
|
|
593
764
|
script: entry.handler.script,
|
|
594
765
|
...(entry.handler.runtime ? { runtime: entry.handler.runtime } : {}),
|
|
595
|
-
timeoutMs: entry.handler.timeoutMs ??
|
|
766
|
+
timeoutMs: entry.handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
|
|
596
767
|
...(entry.handler.args && entry.handler.args.length > 0 ? { args: entry.handler.args } : {}),
|
|
597
768
|
...(entry.filter ? { filter: entry.filter } : {}),
|
|
598
769
|
reply: pack.reply.allowed,
|
|
@@ -614,8 +785,12 @@ export class ServiceRouter {
|
|
|
614
785
|
listen: first.type,
|
|
615
786
|
script: first.handler.script,
|
|
616
787
|
...(first.handler.runtime ? { runtime: first.handler.runtime } : {}),
|
|
617
|
-
timeoutMs: first.handler.timeoutMs ??
|
|
618
|
-
|
|
788
|
+
timeoutMs: first.handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
|
|
789
|
+
handlers: pack.listen.map(entry => ({
|
|
790
|
+
type: entry.type,
|
|
791
|
+
...(entry.handler.name ? { name: entry.handler.name } : {}),
|
|
792
|
+
...(entry.handler.description ? { description: entry.handler.description } : {}),
|
|
793
|
+
})),
|
|
619
794
|
reply: pack.reply.allowed,
|
|
620
795
|
};
|
|
621
796
|
}
|
|
@@ -630,24 +805,42 @@ export class ServiceRouter {
|
|
|
630
805
|
*/
|
|
631
806
|
close() {
|
|
632
807
|
this.dispatcher.close();
|
|
808
|
+
void this.hostRuntime?.close();
|
|
633
809
|
void this.outputService.close();
|
|
634
810
|
this.outputCardsService.close();
|
|
811
|
+
this.panelCardsService.close();
|
|
635
812
|
this.workbenchService.close();
|
|
636
813
|
}
|
|
637
|
-
outputDescriptions() {
|
|
814
|
+
outputDescriptions(outputAuthorized, panelCardsAuthorized) {
|
|
815
|
+
const types = [
|
|
816
|
+
...(outputAuthorized ? ['services.outputs.snapshot', 'services.outputs.list', 'services.outputs.detail', 'services.outputs.changes', ...OUTPUT_CARDS_TYPES] : []),
|
|
817
|
+
...(panelCardsAuthorized ? PANEL_CARDS_TYPES : []),
|
|
818
|
+
];
|
|
819
|
+
if (!types.length)
|
|
820
|
+
return [];
|
|
638
821
|
return [{
|
|
639
822
|
pack: 'builtin.outputs', name: 'Agent output projection',
|
|
640
823
|
description: 'Owner-authorized read-only Agent output snapshots and changes',
|
|
641
|
-
|
|
824
|
+
handlers: toHandlerList(types),
|
|
642
825
|
unmatched: 'silent', reply: true,
|
|
643
826
|
}];
|
|
644
827
|
}
|
|
645
828
|
workbenchDescriptions() {
|
|
646
829
|
return [{ pack: 'builtin.workbench', name: 'Team workbench projection',
|
|
647
830
|
description: 'Owner-authorized current tasks, retained execution history and event-driven changes',
|
|
648
|
-
|
|
831
|
+
handlers: toHandlerList(WORKBENCH_TYPES), unmatched: 'silent', reply: true }];
|
|
649
832
|
}
|
|
650
833
|
}
|
|
834
|
+
/**
|
|
835
|
+
* type 字符串列表 → `handlers` 记录列表(内置服务用)。
|
|
836
|
+
*
|
|
837
|
+
* 内置服务没有可声明的 handler 元信息,所以每个条目只有 `type`。存在的意义是让
|
|
838
|
+
* `services.list` 返回的数组**形状统一**:包条目与内置条目都带 `handlers`,消费方
|
|
839
|
+
* 不需要按来源分支处理。
|
|
840
|
+
*/
|
|
841
|
+
function toHandlerList(types) {
|
|
842
|
+
return types.map(type => ({ type }));
|
|
843
|
+
}
|
|
651
844
|
function readStringField(payload, key) {
|
|
652
845
|
const data = payload.data;
|
|
653
846
|
const value = payload[key] ?? (data && typeof data === 'object' && !Array.isArray(data)
|
|
@@ -657,9 +850,12 @@ function readStringField(payload, key) {
|
|
|
657
850
|
/**
|
|
658
851
|
* 服务请求 payload 的 JSON Schema。
|
|
659
852
|
*
|
|
660
|
-
*
|
|
661
|
-
*
|
|
662
|
-
*
|
|
853
|
+
* 信封层(type / request_id)由框架定义;`data` 有两条来源:
|
|
854
|
+
* - 包作者在 `handler.inputSchema` 里声明了结构 → 原样放进 `data`;
|
|
855
|
+
* - 没声明 → `data` 保持开放对象,并明说"入参由脚本解释",避免调用方误以为有约束。
|
|
856
|
+
*
|
|
857
|
+
* 后者仍是最常见的情况,但至少现在有了一条**机器可读**的声明通道:调用方不必再从
|
|
858
|
+
* 一句中文描述里猜字段名。
|
|
663
859
|
*/
|
|
664
860
|
export function serviceRequestSchema(requestType, described) {
|
|
665
861
|
return {
|
|
@@ -672,7 +868,7 @@ export function serviceRequestSchema(requestType, described) {
|
|
|
672
868
|
type: 'string',
|
|
673
869
|
description: '调用方生成的关联 ID;缺失时 daemon 用 message_id 补齐',
|
|
674
870
|
},
|
|
675
|
-
data: {
|
|
871
|
+
data: described.inputSchema ?? {
|
|
676
872
|
type: 'object',
|
|
677
873
|
description: `入参由服务端脚本解释,无声明式约束(服务包 ${described.pack},脚本 ${described.script})`,
|
|
678
874
|
},
|
|
@@ -686,16 +882,27 @@ export function serviceRequestSchema(requestType, described) {
|
|
|
686
882
|
};
|
|
687
883
|
}
|
|
688
884
|
/** services.skill 的正文:一段可直接读的用法说明。 */
|
|
885
|
+
/**
|
|
886
|
+
* 压成单行:`skills` 的正文是给对端 Agent 读的 markdown,description 里若带换行会
|
|
887
|
+
* 破坏列表结构(作者可能写多行说明)。折叠连续空白并截断,不做语义处理。
|
|
888
|
+
*/
|
|
889
|
+
function singleLine(text, max = 120) {
|
|
890
|
+
const flat = text.replace(/\s+/g, ' ').trim();
|
|
891
|
+
return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
|
|
892
|
+
}
|
|
689
893
|
export function renderServiceSkill(selfAid, described) {
|
|
690
894
|
const lines = [];
|
|
691
|
-
|
|
895
|
+
const heading = described.handlerName
|
|
896
|
+
? `${described.name} / ${described.handlerName} — ${described.type}`
|
|
897
|
+
: `${described.name} — ${described.type}`;
|
|
898
|
+
lines.push(`# ${heading}`);
|
|
692
899
|
lines.push('');
|
|
693
900
|
if (described.description) {
|
|
694
901
|
lines.push(described.description);
|
|
695
902
|
lines.push('');
|
|
696
903
|
}
|
|
697
904
|
lines.push('调用方式:');
|
|
698
|
-
lines.push(` ec services call ${selfAid} ${described.type} --data '<json>'`);
|
|
905
|
+
lines.push(` ec services call --aid ${selfAid} --type ${described.type} --data '<json>'`);
|
|
699
906
|
lines.push('');
|
|
700
907
|
lines.push('要点:');
|
|
701
908
|
lines.push(` - 入参放在 data 里;具体字段由服务端脚本解释,无声明式约束。`);
|
|
@@ -703,17 +910,32 @@ export function renderServiceSkill(selfAid, described) {
|
|
|
703
910
|
lines.push(` - 回复 type 固定为 ${described.type}.result,正文是 {ok, data} 或 {ok, error:{code,message}}。`);
|
|
704
911
|
if (!described.reply)
|
|
705
912
|
lines.push(' - 该服务包未开启回复:调用方收不到结果,只会有执行记录。');
|
|
706
|
-
if (described.
|
|
913
|
+
if (described.handlers && described.handlers.length > 1) {
|
|
707
914
|
lines.push('');
|
|
708
915
|
lines.push('该包的其它 type:');
|
|
709
|
-
for (const
|
|
710
|
-
|
|
916
|
+
for (const entry of described.handlers) {
|
|
917
|
+
const title = entry.name ? `${entry.name} ` : '';
|
|
918
|
+
const note = entry.description ? ` — ${singleLine(entry.description)}` : '';
|
|
919
|
+
lines.push(` ${title}${entry.type}${note}`.replace(/\s+$/, ''));
|
|
920
|
+
}
|
|
711
921
|
}
|
|
712
922
|
lines.push('');
|
|
713
923
|
return lines.join('\n');
|
|
714
924
|
}
|
|
715
925
|
/** 进程内单例(每个 AID 一个,由 channels/aun.ts 持有)。 */
|
|
716
926
|
const routers = new Map();
|
|
927
|
+
/** Also fences routers created after collection acquired the source. */
|
|
928
|
+
export function pauseServiceRequests(aid, token) {
|
|
929
|
+
routers.get(aid)?.assertMutationIdle();
|
|
930
|
+
const holds = templateMutationHolds.get(aid) ?? new Set();
|
|
931
|
+
holds.add(token);
|
|
932
|
+
templateMutationHolds.set(aid, holds);
|
|
933
|
+
return () => {
|
|
934
|
+
holds.delete(token);
|
|
935
|
+
if (!holds.size)
|
|
936
|
+
templateMutationHolds.delete(aid);
|
|
937
|
+
};
|
|
938
|
+
}
|
|
717
939
|
export function getServiceRouter(aid, servicesDir, deps) {
|
|
718
940
|
let router = routers.get(aid);
|
|
719
941
|
if (!router) {
|