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,519 @@
|
|
|
1
|
+
import { randomUUID, createHash } from 'node:crypto';
|
|
2
|
+
import { AbilityStore } from '../store.js';
|
|
3
|
+
import { AbilityProtocolError, isJsonObject, validateAbilityResult, canonicalizeAbilityJson } from '../interop-v1.js';
|
|
4
|
+
import { durationSeconds, remoteAssert, RemoteError, REMOTE_CLI_VERSION } from './command.js';
|
|
5
|
+
import { boundedJson, parseCapability, parseRemoteIndex, sameProviderPath, validateValue, validateAuthorization, parseRemoteContract } from './contract.js';
|
|
6
|
+
import { approvedCredentialTargets, credentialTargetsFromParams, saveCredentialForTarget } from './credential-files.js';
|
|
7
|
+
import { compactSchema, viewParamsSchema } from './schema-view.js';
|
|
8
|
+
const digest = (value) => createHash('sha256').update(canonicalizeAbilityJson(value)).digest('hex');
|
|
9
|
+
const requestKey = (context, request) => digest([context.callerAid, request]);
|
|
10
|
+
const operationKey = (context, provider, operation) => digest([context.callerAid, provider, operation]);
|
|
11
|
+
const applicationKey = (context, provider, applicationId) => digest([context.callerAid, provider, applicationId]);
|
|
12
|
+
function discoveryCurrentKey(context, provider) {
|
|
13
|
+
const { callerAid, sessionId, peerKey, threadId } = context;
|
|
14
|
+
// Omit the main topic's undefined thread ID without changing existing topic keys.
|
|
15
|
+
return digest([{ callerAid, sessionId, peerKey, ...(threadId === undefined ? {} : { threadId }) }, provider]);
|
|
16
|
+
}
|
|
17
|
+
function sameScope(value, context) {
|
|
18
|
+
return value.callerAid === context.callerAid && value.sessionId === context.sessionId
|
|
19
|
+
&& value.peerKey === context.peerKey && value.threadId === context.threadId;
|
|
20
|
+
}
|
|
21
|
+
function response(data, ok = true, code) {
|
|
22
|
+
return { schema_version: REMOTE_CLI_VERSION, ok, ...(code ? { code } : {}), data };
|
|
23
|
+
}
|
|
24
|
+
export function remoteFailure(error) {
|
|
25
|
+
// Ability contract/schema violations carry their own code; anything else is
|
|
26
|
+
// reported as an unexpected caller failure rather than silently swallowed.
|
|
27
|
+
const protocol = error instanceof AbilityProtocolError ? error : undefined;
|
|
28
|
+
const code = error instanceof RemoteError ? error.code : protocol ? protocol.code.toUpperCase() : 'REMOTE_ABILITY_FAILED';
|
|
29
|
+
const data = error instanceof RemoteError ? error.data : undefined;
|
|
30
|
+
const denied = ['NOT_ALLOWED', 'NO_PERMISSION', 'ROLE_ACCESS_DENIED', 'SCOPE_MISMATCH', 'DELEGATION_REQUIRED', 'INVALID_DELEGATION'].includes(code);
|
|
31
|
+
return { schema_version: REMOTE_CLI_VERSION, ok: false,
|
|
32
|
+
code,
|
|
33
|
+
error: error instanceof RemoteError ? error.message : protocol ? protocol.message : 'Remote Ability operation failed',
|
|
34
|
+
...(data ? { data } : {}),
|
|
35
|
+
...(['PARAMS_INVALID', 'AUTHORIZATION_REQUIRED', 'CREDENTIAL_INVALID'].includes(code) ? { stage: 'validation', sent: false } : {}),
|
|
36
|
+
...(denied ? { next_action: { action: 'stop', reason: 'Permission denied; report the reason. Do not retry through another identity or transport.', resend_allowed: false } }
|
|
37
|
+
: code === 'PARAMS_INVALID' ? { next_action: { action: 'correct_params', reason: 'Use this capability’s current params_schema and allowed values. Read remote info only if the contract is missing; no request was sent.' } }
|
|
38
|
+
: code === 'AUTHORIZATION_REQUIRED' ? { next_action: { action: 'obtain_credential', command: data?.next_command, authorization: data?.authorization, resend_allowed: false } }
|
|
39
|
+
: data?.usage ? { next_action: { usage: data.usage } } : {}) };
|
|
40
|
+
}
|
|
41
|
+
export function remoteExitCode(result) {
|
|
42
|
+
return result.ok ? 0 : ['RESULT_PENDING', 'EXECUTION_UNKNOWN', 'NO_DISCOVERY_RESPONSE', 'DEVICE_SELECTION_REQUIRED', 'CONTRACT_SELECTION_REQUIRED', 'DISCOVERY_REQUIRED'].includes(result.code ?? '') ? 2 : 1;
|
|
43
|
+
}
|
|
44
|
+
/** Discovery and plans are daemon-owned; credentials remain with the calling Agent. */
|
|
45
|
+
export class AbilityCallerService {
|
|
46
|
+
now;
|
|
47
|
+
store;
|
|
48
|
+
constructor(root, now = Date.now) {
|
|
49
|
+
this.now = now;
|
|
50
|
+
this.store = new AbilityStore(root);
|
|
51
|
+
}
|
|
52
|
+
close() { this.store.close(); }
|
|
53
|
+
async execute(command, context, transport, params = {}, credential) {
|
|
54
|
+
if (command.action === 'result') {
|
|
55
|
+
const call = this.store.get('call', requestKey(context, command.requestId));
|
|
56
|
+
remoteAssert(call && sameScope(call, context), 'REQUEST_NOT_FOUND', 'Request is not available in this session and topic');
|
|
57
|
+
return this.query(call, context, transport, command.options.wait ? durationSeconds(command.options.wait, 60) * 1000 : undefined);
|
|
58
|
+
}
|
|
59
|
+
if (command.action === 'call' && command.options.plan) {
|
|
60
|
+
const plan = this.store.get('plan', command.options.plan);
|
|
61
|
+
remoteAssert(plan && sameScope(plan, context), 'PLAN_NOT_FOUND', 'Plan is not available in this session and topic');
|
|
62
|
+
return this.dispatch(plan, context, transport, credential);
|
|
63
|
+
}
|
|
64
|
+
const provider = command.provider;
|
|
65
|
+
await transport.authorize(provider, 'read');
|
|
66
|
+
if (command.action === 'discover')
|
|
67
|
+
return this.discover(command, context, transport, credential);
|
|
68
|
+
const snapshot = await this.discovery(command, context, transport);
|
|
69
|
+
if (command.action === 'list') {
|
|
70
|
+
const data = this.discoveryView(snapshot, command.path, command.options);
|
|
71
|
+
data.guide_available = !!snapshot.skillRef;
|
|
72
|
+
if (snapshot.skillRef)
|
|
73
|
+
data.skill_ref = snapshot.skillRef;
|
|
74
|
+
if (command.options.usage && snapshot.skillRef)
|
|
75
|
+
data.usage = { untrusted: true, reference: snapshot.skillRef,
|
|
76
|
+
content: await this.readUsage(snapshot, snapshot.skillRef, transport) };
|
|
77
|
+
return response(data);
|
|
78
|
+
}
|
|
79
|
+
if (command.action === 'devices')
|
|
80
|
+
return response({ provider_aid: provider, discovery_id: snapshot.id, ability_path: command.path,
|
|
81
|
+
devices: this.candidates(snapshot, command.path) });
|
|
82
|
+
const selected = this.selectCapability(snapshot, command.path, command.options['definition-id']);
|
|
83
|
+
const raw = await transport.read(provider, sameProviderPath(selected.detail_ref, provider));
|
|
84
|
+
const indexMatches = snapshot.indexCapabilities.filter(row => row.path === selected.path && row.definition_id === selected.definition_id);
|
|
85
|
+
if (snapshot.source === 'online' && snapshot.indexCapabilities.some(row => row.path === selected.path) && !indexMatches.length) {
|
|
86
|
+
throw new RemoteError('CONTRACT_CHANGED', 'L1 and online discovery disagree; refresh discovery');
|
|
87
|
+
}
|
|
88
|
+
const contract = parseRemoteContract(raw, selected, [...indexMatches,
|
|
89
|
+
...snapshot.capabilities.filter(row => row.path === selected.path && row.definition_id === selected.definition_id)]);
|
|
90
|
+
const { definition } = contract;
|
|
91
|
+
if (command.action === 'info') {
|
|
92
|
+
const view = this.discoveryView(snapshot, command.path, command.options, false);
|
|
93
|
+
if (!command.options.full)
|
|
94
|
+
delete view.capabilities;
|
|
95
|
+
const { params_schema, result_schema, ...definitionMeta } = definition;
|
|
96
|
+
const schemas = command.options.schema ?? 'both';
|
|
97
|
+
const paramsView = schemas !== 'result' || command.options.action ? viewParamsSchema(params_schema, command.options.action) : undefined;
|
|
98
|
+
const data = { ...view,
|
|
99
|
+
definition: { ...definitionMeta, ...(schemas !== 'result' ? { params_schema: paramsView.schema } : {}),
|
|
100
|
+
...(schemas !== 'params' ? { result_schema: compactSchema(result_schema) } : {}) },
|
|
101
|
+
...(paramsView?.action !== undefined ? { action: paramsView.action } : {}),
|
|
102
|
+
definition_id: definition.definition_id,
|
|
103
|
+
devices: this.candidates(snapshot, command.path),
|
|
104
|
+
detail_ref: selected.detail_ref, ...(contract.release ? { release: contract.release } : {}),
|
|
105
|
+
...(contract.authorization ? { authorization: contract.authorization } : {}) };
|
|
106
|
+
if (command.options.usage) {
|
|
107
|
+
const reference = selected.usage_ref ?? snapshot.skillRef;
|
|
108
|
+
if (contract.usage)
|
|
109
|
+
data.usage = { untrusted: true, reference: selected.detail_ref, content: contract.usage };
|
|
110
|
+
else if (reference)
|
|
111
|
+
data.usage = { untrusted: true, reference, content: await this.readUsage(snapshot, reference, transport) };
|
|
112
|
+
if (data.usage) {
|
|
113
|
+
const references = [...new Set([selected.usage_ref, snapshot.skillRef])]
|
|
114
|
+
.filter((ref) => !!ref && ref !== data.usage.reference);
|
|
115
|
+
if (references.length)
|
|
116
|
+
data.usage.additional_documents = await Promise.all(references.map(async (ref) => ({
|
|
117
|
+
untrusted: true, reference: ref, content: await this.readUsage(snapshot, ref, transport),
|
|
118
|
+
})));
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return response(data);
|
|
122
|
+
}
|
|
123
|
+
remoteAssert(isJsonObject(params), 'PARAMS_INVALID', 'Business params must be a JSON object');
|
|
124
|
+
validateValue(definition.params_schema, params, 'PARAMS_INVALID');
|
|
125
|
+
const candidates = selected.devices ?? [];
|
|
126
|
+
const deviceId = command.options['device-id'];
|
|
127
|
+
this.checkAuthorization(contract.authorization, !!credential, deviceId, command.path, provider, definition.definition_id);
|
|
128
|
+
// Omitting --device-id is a broadcast, not an error: the Provider routes the
|
|
129
|
+
// call to its online devices and the first terminal reply finishes the call.
|
|
130
|
+
// A named device must still come from this Provider's discovery evidence —
|
|
131
|
+
// otherwise it is a guess about someone else's routing.
|
|
132
|
+
if (deviceId) {
|
|
133
|
+
remoteAssert(candidates.includes(deviceId), 'DEVICE_NOT_DISCOVERED', 'Selected device does not publish this capability', { provider_aid: provider, ability_path: command.path, devices: this.candidates(snapshot, command.path) });
|
|
134
|
+
}
|
|
135
|
+
// Omitting --device-id needs no device evidence: the index may not list
|
|
136
|
+
// devices at all, and the Provider is the one that knows which are online.
|
|
137
|
+
const timeout = durationSeconds(command.options.timeout ?? '60s');
|
|
138
|
+
const ttl = durationSeconds(command.options.ttl ?? String(timeout));
|
|
139
|
+
const operationId = command.options['operation-id'] ?? `op-${randomUUID()}`;
|
|
140
|
+
const plan = { ...context, id: `plan-${randomUUID()}`, provider, path: command.path, definition, deviceId,
|
|
141
|
+
params, timeout, ttl, operationId, authorization: contract.authorization,
|
|
142
|
+
discoveryId: snapshot.id, expiresAt: Math.min(this.now() + 300_000, snapshot.expiresAt),
|
|
143
|
+
fingerprint: digest([provider, deviceId ?? null, command.path, definition.definition_id, params, ttl, timeout, false]) };
|
|
144
|
+
if (command.options['dry-run']) {
|
|
145
|
+
this.store.put('plan', plan.id, context.callerAid, plan);
|
|
146
|
+
return { ...response({ plan_id: plan.id, provider_aid: provider, ability_path: plan.path, definition_id: definition.definition_id,
|
|
147
|
+
device_id: deviceId, params, timeout_seconds: timeout, ttl_seconds: ttl, operation_id: operationId,
|
|
148
|
+
selection_source: snapshot.source, expires_at: plan.expiresAt, require_confirm: definition.require_confirm, auth_required: definition.auth_required,
|
|
149
|
+
...(contract.authorization ? { authorization: contract.authorization } : {}) }), sent: false };
|
|
150
|
+
}
|
|
151
|
+
return this.dispatch(plan, context, transport, credential);
|
|
152
|
+
}
|
|
153
|
+
checkAuthorization(authorization, hasCredential, deviceId, abilityPath, provider, definitionId) {
|
|
154
|
+
if (hasCredential)
|
|
155
|
+
remoteAssert(deviceId, 'DEVICE_SELECTION_REQUIRED', 'A credential must be sent to one explicit Provider device');
|
|
156
|
+
if (!authorization)
|
|
157
|
+
return; // Existing v1 Providers keep their original flow.
|
|
158
|
+
validateAuthorization(authorization);
|
|
159
|
+
if (authorization.mode === 'bootstrap') {
|
|
160
|
+
remoteAssert(authorization.application_path === abilityPath, 'CONTRACT_INVALID', 'Bootstrap must identify its own authorization entry');
|
|
161
|
+
remoteAssert(!definitionId || authorization.application_definition_id === definitionId, 'CONTRACT_INVALID', 'Bootstrap definition does not match its authorization declaration');
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
remoteAssert(authorization.credential_location === 'payload.credential' && authorization.encrypted === true, 'PROFILE_UNSUPPORTED', 'Unsupported credential transport profile');
|
|
165
|
+
remoteAssert(hasCredential, 'AUTHORIZATION_REQUIRED', 'Obtain a credential from the published authorization entry before calling', { provider_aid: provider, ability_path: abilityPath, authorization,
|
|
166
|
+
next_command: `ec ability remote info ${provider} ${authorization.application_path} --usage` });
|
|
167
|
+
remoteAssert(deviceId, 'DEVICE_SELECTION_REQUIRED', 'Credential calls require one explicit device from the Provider directory', { provider_aid: provider, ability_path: abilityPath, authorization });
|
|
168
|
+
}
|
|
169
|
+
ownedDiscovery(id, context, provider) {
|
|
170
|
+
const found = this.store.get('discovery', id);
|
|
171
|
+
remoteAssert(found && sameScope(found, context) && found.provider === provider, 'DISCOVERY_NOT_FOUND', 'Discovery is not available for this Provider, session and topic');
|
|
172
|
+
remoteAssert(found.expiresAt > this.now(), 'DISCOVERY_REQUIRED', 'Discovery evidence expired; refresh it');
|
|
173
|
+
return found;
|
|
174
|
+
}
|
|
175
|
+
async discovery(command, context, transport) {
|
|
176
|
+
const provider = command.provider;
|
|
177
|
+
if (command.options.discovery)
|
|
178
|
+
return this.ownedDiscovery(command.options.discovery, context, provider);
|
|
179
|
+
const currentKey = discoveryCurrentKey(context, provider);
|
|
180
|
+
if (!command.options.refresh) {
|
|
181
|
+
const current = this.store.get('discovery-current', currentKey);
|
|
182
|
+
const latest = current && this.store.get('discovery', current.id);
|
|
183
|
+
if (latest && sameScope(latest, context) && latest.provider === provider && latest.expiresAt > this.now())
|
|
184
|
+
return latest;
|
|
185
|
+
const cached = this.store.list('discovery', context.callerAid).filter(item => sameScope(item, context) && item.provider === provider && item.expiresAt > this.now())
|
|
186
|
+
.sort((a, b) => (b.source === 'online' ? 1 : 0) - (a.source === 'online' ? 1 : 0) || b.fetchedAt - a.fetchedAt)[0];
|
|
187
|
+
if (cached)
|
|
188
|
+
return cached;
|
|
189
|
+
}
|
|
190
|
+
const index = await this.readIndex(provider, transport);
|
|
191
|
+
const snapshot = { ...context, id: `discovery-${randomUUID()}`, provider, source: 'index', fetchedAt: this.now(), expiresAt: this.now() + 300_000,
|
|
192
|
+
capabilities: index.capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
|
|
193
|
+
this.store.put('discovery', snapshot.id, context.callerAid, snapshot);
|
|
194
|
+
this.store.put('discovery-current', currentKey, context.callerAid, { id: snapshot.id });
|
|
195
|
+
return snapshot;
|
|
196
|
+
}
|
|
197
|
+
async readUsage(snapshot, reference, transport) {
|
|
198
|
+
const key = digest([snapshot.id, reference]);
|
|
199
|
+
const cached = this.store.get('usage', key);
|
|
200
|
+
if (cached)
|
|
201
|
+
return cached.content;
|
|
202
|
+
const content = await transport.read(snapshot.provider, sameProviderPath(reference, snapshot.provider));
|
|
203
|
+
this.store.put('usage', key, snapshot.callerAid, { content });
|
|
204
|
+
return content;
|
|
205
|
+
}
|
|
206
|
+
async readIndex(provider, transport) {
|
|
207
|
+
let value;
|
|
208
|
+
let pathname = '/.well-known/ability/index.json';
|
|
209
|
+
try {
|
|
210
|
+
value = await transport.read(provider, pathname);
|
|
211
|
+
}
|
|
212
|
+
catch (error) {
|
|
213
|
+
const code = error.code;
|
|
214
|
+
if (!['OBJECT_NOT_FOUND', 'NOT_FOUND', 'ENOENT', 'FS_NOT_FOUND'].includes(code ?? ''))
|
|
215
|
+
throw error;
|
|
216
|
+
pathname = '/ability/index.json';
|
|
217
|
+
value = await transport.read(provider, pathname);
|
|
218
|
+
}
|
|
219
|
+
return { ...parseRemoteIndex(value, provider), indexRef: `${provider}:${pathname}` };
|
|
220
|
+
}
|
|
221
|
+
selectCapability(snapshot, abilityPath, definitionId) {
|
|
222
|
+
const rows = snapshot.capabilities.filter(row => row.path === abilityPath && (!definitionId || row.definition_id === definitionId));
|
|
223
|
+
remoteAssert(rows.length, 'ABILITY_NOT_FOUND', 'Exact ability path/definition is absent from discovery');
|
|
224
|
+
remoteAssert(new Set(rows.map(row => `${row.definition_id}:${row.release_id}:${row.detail_ref}`)).size === 1, 'CONTRACT_SELECTION_REQUIRED', 'Choose an exact definition with --definition-id', { candidates: rows });
|
|
225
|
+
return { ...rows[0], devices: [...new Set(rows.flatMap(row => row.devices ?? []))] };
|
|
226
|
+
}
|
|
227
|
+
candidates(snapshot, abilityPath) {
|
|
228
|
+
return snapshot.capabilities.filter(row => row.path === abilityPath).flatMap(row => (row.devices ?? []).map(device => ({
|
|
229
|
+
device_id: device, definition_id: row.definition_id, release_id: row.release_id, observed_at: snapshot.fetchedAt, evidence_source: snapshot.source,
|
|
230
|
+
})));
|
|
231
|
+
}
|
|
232
|
+
discoveryView(snapshot, abilityPath, options = {}, hoistAuthorization = true) {
|
|
233
|
+
const { capabilities: _capabilities, indexRef, ...directory } = snapshot.directory ?? {};
|
|
234
|
+
const directoryFields = directory;
|
|
235
|
+
const full = !!options.full;
|
|
236
|
+
const metadata = full ? directory : Object.fromEntries(['schema', 'publisher', 'compatibility_schema', 'catalog_revision', 'updated_at', 'skill_ref', 'authorization', 'protocol_authorization']
|
|
237
|
+
.filter(key => directoryFields[key] !== undefined).map(key => [key, directoryFields[key]]));
|
|
238
|
+
const search = options.search?.toLowerCase();
|
|
239
|
+
const merged = new Map();
|
|
240
|
+
for (const row of snapshot.capabilities) {
|
|
241
|
+
const { devices, ...declaration } = row;
|
|
242
|
+
const key = JSON.stringify(declaration);
|
|
243
|
+
const previous = merged.get(key);
|
|
244
|
+
merged.set(key, { ...row, devices: [...new Set([...(previous?.devices ?? []), ...(devices ?? [])])] });
|
|
245
|
+
}
|
|
246
|
+
const rows = [...merged.values()].filter(row => (!abilityPath || row.path === abilityPath)
|
|
247
|
+
&& (!search || [row.path, row.name, row.summary, row.description].some(value => typeof value === 'string' && value.toLowerCase().includes(search))));
|
|
248
|
+
// Hoist the most frequent repeated block across the snapshot, so filters
|
|
249
|
+
// do not change the meaning of authorization_variant.
|
|
250
|
+
const authorizations = new Map();
|
|
251
|
+
for (const row of hoistAuthorization ? merged.values() : []) {
|
|
252
|
+
if (!isJsonObject(row.authorization))
|
|
253
|
+
continue;
|
|
254
|
+
const key = canonicalizeAbilityJson(row.authorization);
|
|
255
|
+
const entry = authorizations.get(key);
|
|
256
|
+
if (entry)
|
|
257
|
+
entry.count++;
|
|
258
|
+
else
|
|
259
|
+
authorizations.set(key, { value: row.authorization, count: 1 });
|
|
260
|
+
}
|
|
261
|
+
let common;
|
|
262
|
+
for (const entry of authorizations.values())
|
|
263
|
+
if (entry.count > (common?.count ?? 1))
|
|
264
|
+
common = entry;
|
|
265
|
+
const commonKey = common ? canonicalizeAbilityJson(common.value) : undefined;
|
|
266
|
+
const capabilities = rows.map(({ authorization, ...row }) => ({
|
|
267
|
+
...(full ? row : {
|
|
268
|
+
path: row.path, definition_id: row.definition_id,
|
|
269
|
+
...(typeof row.name === 'string' ? { name: row.name.slice(0, 80) } : {}),
|
|
270
|
+
...(typeof row.summary === 'string' || typeof row.description === 'string' ? { summary: String(row.summary ?? row.description).slice(0, 160) } : {}),
|
|
271
|
+
device_count: row.devices?.length ?? 0,
|
|
272
|
+
...(options.devices ? { devices: row.devices } : {}),
|
|
273
|
+
}),
|
|
274
|
+
...(authorization !== undefined && commonKey === canonicalizeAbilityJson(authorization)
|
|
275
|
+
? { authorization_variant: 'shared' }
|
|
276
|
+
: authorization !== undefined ? { authorization } : {}),
|
|
277
|
+
}));
|
|
278
|
+
return { subject_aid: snapshot.provider, provider_aid: snapshot.provider, discovery_id: snapshot.id, source: snapshot.source,
|
|
279
|
+
...(snapshot.directory ? { directory: metadata, ...(indexRef ? { index_ref: indexRef } : {}) } : {}),
|
|
280
|
+
fetched_at: snapshot.fetchedAt, expires_at: snapshot.expiresAt, stale: snapshot.expiresAt <= this.now(),
|
|
281
|
+
view: full ? 'full' : 'compact',
|
|
282
|
+
...(common ? { authorization: common.value } : {}),
|
|
283
|
+
total: capabilities.length,
|
|
284
|
+
capabilities };
|
|
285
|
+
}
|
|
286
|
+
async discover(command, context, transport, credential) {
|
|
287
|
+
const provider = command.provider;
|
|
288
|
+
let index = { capabilities: [] };
|
|
289
|
+
try {
|
|
290
|
+
index = await this.readIndex(provider, transport);
|
|
291
|
+
}
|
|
292
|
+
catch (error) {
|
|
293
|
+
if (!['OBJECT_NOT_FOUND', 'NOT_FOUND', 'ENOENT', 'FS_NOT_FOUND'].includes(error.code ?? ''))
|
|
294
|
+
throw error;
|
|
295
|
+
}
|
|
296
|
+
const protocol = isJsonObject(index.protocol_authorization) ? index.protocol_authorization : undefined;
|
|
297
|
+
const authorization = protocol && isJsonObject(protocol.authorization) ? protocol.authorization : undefined;
|
|
298
|
+
if (index.protocol_authorization !== undefined)
|
|
299
|
+
remoteAssert(protocol?.path === 'protocol/discover'
|
|
300
|
+
&& typeof protocol.definition_id === 'string' && authorization, 'CONTRACT_INVALID', 'Invalid protocol authorization declaration');
|
|
301
|
+
const deviceId = command.options['device-id'];
|
|
302
|
+
this.checkAuthorization(authorization, !!credential, deviceId, 'protocol/discover', provider);
|
|
303
|
+
if (deviceId)
|
|
304
|
+
remoteAssert(index.capabilities.some(row => row.devices?.includes(deviceId)), 'DEVICE_NOT_DISCOVERED', 'Selected device is absent from the Provider directory');
|
|
305
|
+
await transport.authorize(provider, 'send');
|
|
306
|
+
const window = durationSeconds(command.options.window ?? '5s', 30);
|
|
307
|
+
const requestId = `c-${randomUUID()}`, operationId = `op-${randomUUID()}`;
|
|
308
|
+
const call = { ...context, provider, path: 'protocol/discover', requestId, operationId, deviceId,
|
|
309
|
+
fingerprint: digest([provider, 'protocol/discover', operationId]), sent: null, createdAt: this.now(), discoveryIndex: index };
|
|
310
|
+
this.store.put('call', requestKey(context, requestId), context.callerAid, call);
|
|
311
|
+
try {
|
|
312
|
+
const sent = await transport.send(provider, { type: 'ability', role: 'call', call_id: requestId, operation_id: operationId,
|
|
313
|
+
ability_path: 'protocol/discover', params: { spec_version: 'aid-ability/2', window_seconds: window },
|
|
314
|
+
...(credential ? { credential } : {}), ttl: window, async: false }, deviceId, window * 1000);
|
|
315
|
+
call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
|
|
316
|
+
if (!sent.ok)
|
|
317
|
+
call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Discovery transport failed') };
|
|
318
|
+
}
|
|
319
|
+
catch {
|
|
320
|
+
call.error = { code: 'EXECUTION_UNKNOWN', message: 'Discovery transport result is unknown' };
|
|
321
|
+
}
|
|
322
|
+
this.store.put('call', requestKey(context, requestId), context.callerAid, call);
|
|
323
|
+
const record = await transport.get(requestId);
|
|
324
|
+
return this.discoveryResult(call, record, context, index, command.path, command.options);
|
|
325
|
+
}
|
|
326
|
+
discoveryResult(call, record, context, index = call.discoveryIndex ?? { capabilities: [] }, abilityPath, options = {}) {
|
|
327
|
+
if (record)
|
|
328
|
+
remoteAssert(record.selfAid === context.callerAid && record.targetAid === call.provider && record.origin?.sessionId === context.sessionId
|
|
329
|
+
&& record.origin?.peerKey === context.peerKey && record.origin?.threadId === context.threadId, 'REQUEST_NOT_FOUND', 'Request origin mismatch');
|
|
330
|
+
if (record?.outboundMessageId || record?.responseMessageId || record?.responses?.length)
|
|
331
|
+
call.sent = true;
|
|
332
|
+
if (call.discoveryId) {
|
|
333
|
+
const original = this.store.get('discovery', call.discoveryId);
|
|
334
|
+
if (original)
|
|
335
|
+
index = original.directory ?? { capabilities: original.indexCapabilities, skill_ref: original.skillRef };
|
|
336
|
+
}
|
|
337
|
+
const capabilities = [];
|
|
338
|
+
const devices = new Set();
|
|
339
|
+
let invalid = 0;
|
|
340
|
+
const responses = record?.responses ?? (record?.responsePayload ? [{ responsePayload: record.responsePayload, responseDeviceId: record.responseDeviceId }] : []);
|
|
341
|
+
for (const item of responses) {
|
|
342
|
+
try {
|
|
343
|
+
const result = validateAbilityResult(item.responsePayload, { callId: call.requestId, operationId: call.operationId, abilityPath: call.path });
|
|
344
|
+
if (result.role === 'result' && result.ok === false && record?.targetDeviceId === item.responseDeviceId) {
|
|
345
|
+
return { ...response({ provider_aid: call.provider, request_id: call.requestId, device_id: item.responseDeviceId,
|
|
346
|
+
execution_state: result.execution_state, business_ok: false, result_validated: true,
|
|
347
|
+
provider_error: result.error }, false, 'BUSINESS_FAILED'), sent: call.sent };
|
|
348
|
+
}
|
|
349
|
+
remoteAssert(result.role === 'result' && result.ok === true && isJsonObject(result.result), 'RESULT_INVALID', 'Invalid discovery result');
|
|
350
|
+
const body = result.result;
|
|
351
|
+
remoteAssert(isJsonObject(body.protocol) && body.protocol.spec_version === 'aid-ability/2' && Array.isArray(body.capabilities)
|
|
352
|
+
&& item.responseDeviceId && (!call.deviceId || call.deviceId === item.responseDeviceId), 'RESULT_INVALID', 'Unsupported discovery profile or wrong device');
|
|
353
|
+
boundedJson(body);
|
|
354
|
+
const responseDeviceId = item.responseDeviceId;
|
|
355
|
+
const rows = body.capabilities.map(row => parseCapability(row, call.provider, [responseDeviceId]));
|
|
356
|
+
capabilities.push(...rows);
|
|
357
|
+
devices.add(item.responseDeviceId);
|
|
358
|
+
}
|
|
359
|
+
catch {
|
|
360
|
+
invalid++;
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
const closed = record?.state === 'completed';
|
|
364
|
+
const observedAt = record?.deadlineAt ?? call.createdAt;
|
|
365
|
+
const snapshot = { ...context, id: call.discoveryId ?? `discovery-${randomUUID()}`, provider: call.provider,
|
|
366
|
+
source: 'online', fetchedAt: observedAt, expiresAt: observedAt + 60_000, capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
|
|
367
|
+
if (devices.size && closed) {
|
|
368
|
+
this.store.put('discovery', snapshot.id, context.callerAid, snapshot);
|
|
369
|
+
if (!call.discoveryId)
|
|
370
|
+
this.store.put('discovery-current', discoveryCurrentKey(context, call.provider), context.callerAid, { id: snapshot.id });
|
|
371
|
+
call.discoveryId = snapshot.id;
|
|
372
|
+
this.store.put('call', requestKey(context, call.requestId), context.callerAid, call);
|
|
373
|
+
}
|
|
374
|
+
const data = { ...this.discoveryView(snapshot, abilityPath, options), request_id: call.requestId, devices: [...devices], window_closed: closed,
|
|
375
|
+
response_count: responses.length, invalid_response_count: invalid, coverage: 'responding_devices_only' };
|
|
376
|
+
const code = invalid ? 'PARTIAL_RESULT' : devices.size && closed ? undefined : call.error?.code ?? (!devices.size ? 'NO_DISCOVERY_RESPONSE' : 'RESULT_PENDING');
|
|
377
|
+
return { ...response(data, !code, code), sent: call.sent,
|
|
378
|
+
...(code ? { next_action: { command: `ec ability remote result ${call.requestId}`, resend_allowed: false } } : {}) };
|
|
379
|
+
}
|
|
380
|
+
async dispatch(plan, context, transport, credential) {
|
|
381
|
+
await transport.authorize(plan.provider, 'send');
|
|
382
|
+
const key = operationKey(context, plan.provider, plan.operationId);
|
|
383
|
+
const existing = this.store.get('operation', key);
|
|
384
|
+
if (existing) {
|
|
385
|
+
remoteAssert(sameScope(existing, context), 'OPERATION_ID_CONFLICT', 'Operation ID is already bound to another origin');
|
|
386
|
+
remoteAssert(existing.fingerprint === plan.fingerprint, 'OPERATION_ID_CONFLICT', 'Operation ID is already bound to different parameters');
|
|
387
|
+
return this.query(existing, context, transport);
|
|
388
|
+
}
|
|
389
|
+
remoteAssert(plan.expiresAt > this.now(), 'PLAN_EXPIRED', 'Call plan or discovery evidence expired');
|
|
390
|
+
this.ownedDiscovery(plan.discoveryId, context, plan.provider);
|
|
391
|
+
this.checkAuthorization(plan.authorization, !!credential, plan.deviceId, plan.path, plan.provider, plan.definition.definition_id);
|
|
392
|
+
const call = { ...context, provider: plan.provider, path: plan.path, definition: plan.definition, deviceId: plan.deviceId,
|
|
393
|
+
...(plan.authorization?.mode === 'bootstrap' && plan.authorization.application_path === plan.path
|
|
394
|
+
&& plan.authorization.application_definition_id === plan.definition.definition_id ? { credentialIssuer: true } : {}),
|
|
395
|
+
credentialTargets: credentialTargetsFromParams(plan.params),
|
|
396
|
+
...(typeof plan.params.application_id === 'string' ? { applicationId: plan.params.application_id } : {}),
|
|
397
|
+
requestId: `c-${randomUUID()}`, operationId: plan.operationId, fingerprint: plan.fingerprint, sent: null, createdAt: this.now() };
|
|
398
|
+
// Claim before the first await/send. A crash at any later point leaves an
|
|
399
|
+
// unknown receipt which is queried, never automatically dispatched again.
|
|
400
|
+
this.store.transaction(() => {
|
|
401
|
+
remoteAssert(!this.store.get('operation', key), 'OPERATION_ID_CONFLICT', 'Operation was concurrently claimed');
|
|
402
|
+
this.store.put('operation', key, context.callerAid, call);
|
|
403
|
+
this.store.put('call', requestKey(context, call.requestId), context.callerAid, call);
|
|
404
|
+
});
|
|
405
|
+
try {
|
|
406
|
+
const sent = await transport.send(call.provider, { type: 'ability', role: 'call', call_id: call.requestId, operation_id: call.operationId,
|
|
407
|
+
ability_path: call.path, definition_id: plan.definition.definition_id, params: plan.params,
|
|
408
|
+
...(credential ? { credential } : {}), ttl: plan.ttl, async: false }, call.deviceId, plan.timeout * 1000);
|
|
409
|
+
call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
|
|
410
|
+
if (!sent.ok)
|
|
411
|
+
call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Transport failed') };
|
|
412
|
+
}
|
|
413
|
+
catch {
|
|
414
|
+
call.error = { code: 'EXECUTION_UNKNOWN', message: 'Transport result is unknown; query the original request' };
|
|
415
|
+
}
|
|
416
|
+
this.store.transaction(() => {
|
|
417
|
+
this.store.put('operation', key, context.callerAid, call);
|
|
418
|
+
this.store.put('call', requestKey(context, call.requestId), context.callerAid, call);
|
|
419
|
+
});
|
|
420
|
+
return this.query(call, context, transport);
|
|
421
|
+
}
|
|
422
|
+
async query(call, context, transport, waitMs) {
|
|
423
|
+
await transport.authorize(call.provider, 'history');
|
|
424
|
+
const record = await transport.get(call.requestId, waitMs);
|
|
425
|
+
if (record)
|
|
426
|
+
remoteAssert(record.selfAid === context.callerAid && record.targetAid === call.provider && record.origin?.sessionId === context.sessionId
|
|
427
|
+
&& record.origin?.peerKey === context.peerKey && record.origin?.threadId === context.threadId, 'REQUEST_NOT_FOUND', 'Request origin mismatch');
|
|
428
|
+
if (record?.outboundMessageId || record?.responseMessageId || record?.responses?.length)
|
|
429
|
+
call.sent = true;
|
|
430
|
+
if (call.path === 'protocol/discover')
|
|
431
|
+
return this.discoveryResult(call, record, context);
|
|
432
|
+
const data = { provider_aid: call.provider, ability_path: call.path, definition_id: call.definition?.definition_id,
|
|
433
|
+
device_id: call.deviceId ?? record?.responseDeviceId, call_id: call.requestId, operation_id: call.operationId, request_id: call.requestId,
|
|
434
|
+
transport_state: record?.state ?? 'unknown', execution_state: 'unknown', business_ok: null,
|
|
435
|
+
result_validated: false, ack_received: !!record?.ackMessageId, result: null,
|
|
436
|
+
may_have_executed: call.sent !== false };
|
|
437
|
+
const pending = (code, error) => ({ ...response(data, false, code), sent: call.sent, ...(error ? { error } : {}),
|
|
438
|
+
next_action: { command: `ec ability remote result ${call.requestId} --wait 30s`, resend_allowed: false } });
|
|
439
|
+
if (call.sent === false && call.error && record?.state !== 'completed') {
|
|
440
|
+
return { ...remoteFailure(new RemoteError(call.error.code, call.error.message)), data, sent: false, stage: 'send',
|
|
441
|
+
next_action: { action: 'stop', resend_allowed: false } };
|
|
442
|
+
}
|
|
443
|
+
if (record?.state !== 'completed')
|
|
444
|
+
return pending(call.error?.code ?? (record?.state === 'failed' ? 'TRANSPORT_FAILED' : record?.state === 'unknown' || !record ? 'EXECUTION_UNKNOWN' : 'RESULT_PENDING'), call.error?.message);
|
|
445
|
+
const validate = (payload) => {
|
|
446
|
+
remoteAssert(call.definition, 'RESULT_INVALID', 'Original contract is unavailable');
|
|
447
|
+
const result = validateAbilityResult(payload, { callId: call.requestId, operationId: call.operationId, abilityPath: call.path, definitionId: call.definition.definition_id });
|
|
448
|
+
remoteAssert(result.role === 'result', 'RESULT_INVALID', 'ACK is not a final result');
|
|
449
|
+
if (result.ok)
|
|
450
|
+
validateValue(call.definition.result_schema, result.result, 'RESULT_INVALID');
|
|
451
|
+
const credentialFiles = [];
|
|
452
|
+
const credentialErrors = [];
|
|
453
|
+
let approvedTargetsForApplication;
|
|
454
|
+
if (result.ok && isJsonObject(result.result)) {
|
|
455
|
+
const applicationId = typeof result.result.application_id === 'string' ? result.result.application_id : call.applicationId;
|
|
456
|
+
if (applicationId)
|
|
457
|
+
call.applicationId = applicationId;
|
|
458
|
+
const key = applicationId ? applicationKey(context, call.provider, applicationId) : undefined;
|
|
459
|
+
const previousTargets = key ? this.store.get('credential-application-requested', key) : undefined;
|
|
460
|
+
const targets = call.credentialTargets?.length ? call.credentialTargets : previousTargets ?? [];
|
|
461
|
+
if (key && targets.length && call.credentialTargets?.length)
|
|
462
|
+
this.store.put('credential-application-requested', key, context.callerAid, targets);
|
|
463
|
+
const approved = approvedCredentialTargets(result.result, targets, applicationId);
|
|
464
|
+
if (approved !== undefined) {
|
|
465
|
+
approvedTargetsForApplication = approved;
|
|
466
|
+
if (key)
|
|
467
|
+
this.store.put('credential-application', key, context.callerAid, approved);
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
if (result.ok && call.credentialIssuer && isJsonObject(result.result)
|
|
471
|
+
&& result.result.storage_policy !== 'operation_only' && isJsonObject(result.result.credential)) {
|
|
472
|
+
const targets = approvedTargetsForApplication ?? (call.applicationId
|
|
473
|
+
? this.store.get('credential-application', applicationKey(context, call.provider, call.applicationId)) ?? [] : []);
|
|
474
|
+
const savedPaths = new Set();
|
|
475
|
+
for (const target of targets) {
|
|
476
|
+
try {
|
|
477
|
+
const file = saveCredentialForTarget(context.callerAid, call.provider, target, result.result.credential);
|
|
478
|
+
if (savedPaths.has(file))
|
|
479
|
+
continue;
|
|
480
|
+
savedPaths.add(file);
|
|
481
|
+
credentialFiles.push({ ability_path: target.abilityPath, definition_id: target.definitionId, device_id: target.deviceId,
|
|
482
|
+
file });
|
|
483
|
+
}
|
|
484
|
+
catch {
|
|
485
|
+
credentialErrors.push({ ability_path: target.abilityPath, definition_id: target.definitionId, device_id: target.deviceId,
|
|
486
|
+
error: 'CREDENTIAL_FILE_WRITE_FAILED' });
|
|
487
|
+
}
|
|
488
|
+
}
|
|
489
|
+
}
|
|
490
|
+
return { execution_state: result.execution_state, business_ok: result.ok, result_validated: true,
|
|
491
|
+
result: result.ok ? result.result : null,
|
|
492
|
+
...(credentialFiles.length ? { credential_files: credentialFiles } : {}),
|
|
493
|
+
...(credentialErrors.length ? { credential_file_errors: credentialErrors } : {}),
|
|
494
|
+
...(result.ok ? {} : { provider_error: result.error }) };
|
|
495
|
+
};
|
|
496
|
+
try {
|
|
497
|
+
if (record.responseMode === 'all_devices') {
|
|
498
|
+
const results = (record.responses ?? []).map(item => {
|
|
499
|
+
try {
|
|
500
|
+
return { device_id: item.responseDeviceId, ...validate(item.responsePayload) };
|
|
501
|
+
}
|
|
502
|
+
catch {
|
|
503
|
+
return { device_id: item.responseDeviceId, business_ok: false, result_validated: false, code: 'RESULT_INVALID' };
|
|
504
|
+
}
|
|
505
|
+
});
|
|
506
|
+
const ok = results.length > 0 && results.every(item => item.business_ok === true && item.result_validated);
|
|
507
|
+
return { ...response({ ...data, results, collection_state: 'window_closed', coverage: 'responding_devices_only', business_ok: ok,
|
|
508
|
+
result_validated: results.length > 0 && results.every(item => item.result_validated) }, ok, ok ? undefined : 'PARTIAL_RESULT'), sent: call.sent };
|
|
509
|
+
}
|
|
510
|
+
remoteAssert(record.responseDeviceId && (!call.deviceId || record.responseDeviceId === call.deviceId), 'RESULT_INVALID', 'Result did not originate from the selected device or has no authenticated device identity');
|
|
511
|
+
const result = validate(record.responsePayload);
|
|
512
|
+
const code = result.business_ok ? undefined : result.execution_state === 'unknown' ? 'EXECUTION_UNKNOWN' : 'BUSINESS_FAILED';
|
|
513
|
+
return { ...response({ ...data, ...result }, result.business_ok, code), sent: call.sent };
|
|
514
|
+
}
|
|
515
|
+
catch (error) {
|
|
516
|
+
return pending('RESULT_INVALID', error instanceof Error ? error.message : 'Invalid result');
|
|
517
|
+
}
|
|
518
|
+
}
|
|
519
|
+
}
|
|
@@ -2,8 +2,10 @@ import { abilityAssert } from './types.js';
|
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import path from 'node:path';
|
|
4
4
|
import { getPackageRoot } from '../paths.js';
|
|
5
|
+
import { REMOTE_CLI_VERSION, REMOTE_COMMANDS, remoteCommandSchema } from './caller/command.js';
|
|
5
6
|
export const ABILITY_COMMAND_VERSION = 'evolcore.ability-cli/v1';
|
|
6
7
|
export const ABILITY_COMMANDS = {
|
|
8
|
+
remote: { description: '远端 AUN 能力发现、契约、设备、调用与结果查询;见 remote --help' },
|
|
7
9
|
capabilities: { description: '查询 daemon 实际支持的命令' },
|
|
8
10
|
schema: { description: '查询命令或 manifest/project JSON Schema', positional: 'required' },
|
|
9
11
|
targets: { description: '列出有权读取的 Agent/host AID' },
|
|
@@ -62,11 +64,14 @@ export function parseAbilityOptions(args, command) {
|
|
|
62
64
|
}
|
|
63
65
|
export function abilityCapabilities() {
|
|
64
66
|
return { schemaVersion: ABILITY_COMMAND_VERSION, commands: ABILITY_COMMANDS, development: ABILITY_DEV_COMMANDS,
|
|
67
|
+
remote: { schemaVersion: REMOTE_CLI_VERSION, commands: REMOTE_COMMANDS, managedAunSessionRequired: true, automaticRetry: false, asynchronousSubmission: false },
|
|
65
68
|
features: { selfSelection: true, localArchive: true, runtimeDefaultCommands: true, buildAdapters: ['java', 'go', 'rust', 'command'], environmentAutoInstall: false,
|
|
66
69
|
ownerSelfManagementPolicy: false, separateCodeApprovalQueue: false, isolatedDevTest: false, persistedLogs: false },
|
|
67
70
|
output: { success: '{ok:true,data}', failure: '{ok:false,status,code,error}', jobSubmissionIsCompletion: false } };
|
|
68
71
|
}
|
|
69
72
|
export function abilityCommandSchema(operation) {
|
|
73
|
+
if (operation.startsWith('remote.'))
|
|
74
|
+
return remoteCommandSchema(operation.slice('remote.'.length));
|
|
70
75
|
if (operation === 'manifest' || operation === 'project') {
|
|
71
76
|
const filename = operation === 'manifest' ? 'ability-plugin.schema.1.json' : 'ability-project.schema.1.json';
|
|
72
77
|
return { schemaVersion: ABILITY_COMMAND_VERSION, operation, input: JSON.parse(fs.readFileSync(path.join(getPackageRoot(), 'kits/schemas', filename), 'utf8')) };
|
package/dist/ability/daemon.js
CHANGED
|
@@ -9,6 +9,7 @@ import { createDelegationAuthorizer } from '../core/auth/delegation-authorizatio
|
|
|
9
9
|
import { AUNChannel } from '../channels/aun.js';
|
|
10
10
|
import { logger } from '../utils/logger.js';
|
|
11
11
|
import { resolveEffective } from '../config/config-manager.js';
|
|
12
|
+
import { createRemoteAbilityExecutor } from './caller/daemon.js';
|
|
12
13
|
export function registerAbilityPlatform(root, deps) {
|
|
13
14
|
const delegated = createDelegationAuthorizer(deps);
|
|
14
15
|
const channels = () => [deps.getControlChannel?.(), ...deps.channelInstances.map(item => item.channel)].filter((item) => item instanceof AUNChannel);
|
|
@@ -77,7 +78,10 @@ export function registerAbilityPlatform(root, deps) {
|
|
|
77
78
|
await channel.publishAbilityDocuments(documents, expectedIndexes);
|
|
78
79
|
},
|
|
79
80
|
});
|
|
81
|
+
const remote = createRemoteAbilityExecutor(root, deps, channels);
|
|
80
82
|
deps.ipcServer.setAbilityExecutor(async (command) => {
|
|
83
|
+
if (command.type === 'ability.remote.op')
|
|
84
|
+
return remote.execute(command);
|
|
81
85
|
try {
|
|
82
86
|
let actor;
|
|
83
87
|
let context = { authentication: 'ecweb' };
|
|
@@ -133,5 +137,5 @@ export function registerAbilityPlatform(root, deps) {
|
|
|
133
137
|
const recovery = service.recover().catch(() => logger.warn('[ability] Recovery incomplete; inspect AID plugin state'));
|
|
134
138
|
const timer = setInterval(reconcilePublication, 30000);
|
|
135
139
|
timer.unref();
|
|
136
|
-
return { async close() { closing = true; clearInterval(timer); removeProvider(); await recovery; await reconcile; await service.close(); } };
|
|
140
|
+
return { async close() { closing = true; clearInterval(timer); removeProvider(); await recovery; await reconcile; await service.close(); remote.close(); } };
|
|
137
141
|
}
|