evolcore 0.0.50 → 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 +39 -2
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +65 -63
- package/dist/ability/caller/command.js +24 -15
- package/dist/ability/caller/contract.js +24 -9
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +32 -7
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +202 -63
- package/dist/ability/interop-v1.js +156 -113
- package/dist/agent-template/jobs.js +14 -110
- package/dist/agent-template/runtime.js +331 -193
- package/dist/agent-template/service.js +1029 -1104
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -3
- 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} +74 -158
- 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} +648 -382
- 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 +55 -10
- package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +1 -1
- 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/p2p.js +6 -6
- 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 +180 -43
- 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/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
- package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
- package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
- package/dist/cli/ability-command.js +8 -5
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +1 -1
- package/dist/cli/agent-create.js +123 -42
- package/dist/cli/agent-template.js +400 -29
- package/dist/cli/agent.js +14 -11
- package/dist/cli/aun-commands.js +167 -111
- package/dist/cli/daemon-commands.js +38 -8
- 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 +55 -19
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +25 -11
- package/dist/cli/init.js +124 -29
- package/dist/cli/managed-command-guard.js +2 -0
- package/dist/cli/model.js +1 -1
- package/dist/cli/restart-monitor.js +2 -2
- package/dist/cli/services-command.js +24 -1
- 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 +3 -2
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +10 -6
- package/dist/config/config-manager.js +33 -12
- package/dist/config/gateway-config.js +21 -37
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -3
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +2 -2
- 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 +39 -15
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +74 -99
- package/dist/config/schema-migration.js +177 -11
- package/dist/config/schema-registry.js +1 -1
- package/dist/config-store.js +38 -50
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -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} +102 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +1 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +7 -4
- package/dist/core/auth/operation-catalog.js +34 -5
- 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} +62 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
- 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 +79 -30
- 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} +18 -18
- package/dist/core/command/agent-control.js +60 -15
- package/dist/core/command/agent-template-menu.js +21 -9
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- 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 +80 -20
- package/dist/core/command/menu-handler.js +305 -25
- package/dist/core/command/menu-protocol.js +42 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- 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 +127 -96
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +10 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
- 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 +1 -1
- 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 +54 -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 +1 -1
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +4 -4
- 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 +114 -75
- package/dist/core/message/aun-request-registry.js +13 -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} +4 -4
- 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 +135 -54
- package/dist/core/message/message-queue.js +83 -4
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +1 -1
- package/dist/core/message/response-engine.js +347 -163
- package/dist/core/message/send-options.js +9 -6
- package/dist/core/message/send-routing.js +45 -109
- 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 +14 -3
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +95 -15
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -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 +70 -34
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +56 -0
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
- 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 +29 -2
- 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 +1 -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/ipc-operation.js +2 -2
- package/dist/core/thread/thread-operation.js +2 -1
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +14 -4
- 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 +1 -1
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +9 -3
- 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 +1 -1
- 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 +71 -42
- package/dist/ipc.js +103 -10
- 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 +12 -0
- package/dist/pay/command.js +1 -1
- package/dist/pay/runtime.js +18 -10
- package/dist/response-system/engines/v1/proactive-flow.js +1 -1
- package/dist/services/dispatcher.js +2 -2
- package/dist/services/host/main.js +10 -1
- package/dist/services/host/protocol.js +9 -2
- package/dist/services/host/resident.js +37 -0
- package/dist/services/host-client.js +12 -0
- package/dist/services/host-recycle.js +8 -3
- package/dist/services/host-runtime.js +54 -15
- package/dist/services/index.js +83 -19
- package/dist/services/ipc-operation.js +303 -38
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +34 -25
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +28 -2
- 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 +3 -2
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -176
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +14 -2
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +57 -243
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- 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 +1 -1
- package/dist/utils/logger.js +3 -1
- package/dist/utils/media-cache.js +99 -4
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/welcome.js +64 -20
- 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 +1 -1
- package/kits/docs/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +10 -7
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +100 -13
- package/kits/docs/evolcore/aid.md +19 -3
- package/kits/docs/evolcore/config.md +94 -0
- 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 +3 -3
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +24 -2
- package/kits/docs/evolcore/model.md +9 -1
- package/kits/docs/evolcore/msg.md +30 -28
- package/kits/docs/evolcore/pay.md +8 -20
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +8 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- 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 +19 -10
- package/kits/docs/evolcore/tool-authorization.md +4 -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/02-navigation.md +20 -13
- package/kits/rules/06-channel.md +18 -2
- package/kits/schemas/_meta.json +8 -4
- package/kits/schemas/agent-config.schema.23.json +19 -3
- 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.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -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 +8 -2
- package/kits/skills/.switches.json +4 -0
- package/kits/skills/ability/SKILL.md +194 -27
- package/kits/skills/ability/STRUCTURE.md +5 -0
- package/kits/skills/agent-output-cards/SKILL.md +90 -54
- 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 +3 -3
- package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +163 -41
- package/kits/skills/ec-provider/SKILL.md +5 -5
- package/kits/skills/ec-service-call/SKILL.md +3 -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 +2 -2
- 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/system-fragments/commands.md +1 -1
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +14 -9
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +10 -5
- package/package.json +6 -5
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +81 -35
- package/scripts/agent-template/overlay.mjs +110 -4
- package/scripts/agent-template/shared/common.mjs +36 -4
- 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 +467 -54
- package/scripts/agent-template/shared/template-contract.mjs +70 -68
- package/scripts/agent-template/shared/template-package.mjs +153 -36
- package/scripts/agent-template/shared/template-runtime.mjs +76 -64
- package/scripts/agent-template/shared/template.mjs +11 -46
- package/scripts/agent-template/team-pack.mjs +451 -35
- package/scripts/agent-template/team-preview.mjs +75 -226
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -176
- package/dist/agents/baseagent-capability-adapter.js +0 -102
- package/dist/agents/baseagent-plugin-loader.js +0 -145
- package/dist/agents/baseagent.js +0 -816
- 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/skills/ec-pay/references/pay-cli.md +0 -110
- /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
- /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
- /package/dist/{agents/claude-gateway → claude-gateway}/types.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
|
@@ -1,12 +1,19 @@
|
|
|
1
1
|
import { randomUUID, createHash } from 'node:crypto';
|
|
2
2
|
import { AbilityStore } from '../store.js';
|
|
3
|
-
import { isJsonObject, validateAbilityResult, canonicalizeAbilityJson } from '../interop-v1.js';
|
|
4
|
-
import { isAidWideDeviceStatusQuery } from '../../aun/ability-device-routing.js';
|
|
3
|
+
import { AbilityProtocolError, isJsonObject, validateAbilityResult, canonicalizeAbilityJson } from '../interop-v1.js';
|
|
5
4
|
import { durationSeconds, remoteAssert, RemoteError, REMOTE_CLI_VERSION } from './command.js';
|
|
6
|
-
import { boundedJson, parseCapability, parseRemoteIndex, sameProviderPath, validateValue, parseRemoteContract } from './contract.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';
|
|
7
8
|
const digest = (value) => createHash('sha256').update(canonicalizeAbilityJson(value)).digest('hex');
|
|
8
9
|
const requestKey = (context, request) => digest([context.callerAid, request]);
|
|
9
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
|
+
}
|
|
10
17
|
function sameScope(value, context) {
|
|
11
18
|
return value.callerAid === context.callerAid && value.sessionId === context.sessionId
|
|
12
19
|
&& value.peerKey === context.peerKey && value.threadId === context.threadId;
|
|
@@ -15,22 +22,26 @@ function response(data, ok = true, code) {
|
|
|
15
22
|
return { schema_version: REMOTE_CLI_VERSION, ok, ...(code ? { code } : {}), data };
|
|
16
23
|
}
|
|
17
24
|
export function remoteFailure(error) {
|
|
18
|
-
|
|
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';
|
|
19
29
|
const data = error instanceof RemoteError ? error.data : undefined;
|
|
20
30
|
const denied = ['NOT_ALLOWED', 'NO_PERMISSION', 'ROLE_ACCESS_DENIED', 'SCOPE_MISMATCH', 'DELEGATION_REQUIRED', 'INVALID_DELEGATION'].includes(code);
|
|
21
31
|
return { schema_version: REMOTE_CLI_VERSION, ok: false,
|
|
22
32
|
code,
|
|
23
|
-
error: error instanceof RemoteError ? error.message : 'Remote Ability operation failed',
|
|
33
|
+
error: error instanceof RemoteError ? error.message : protocol ? protocol.message : 'Remote Ability operation failed',
|
|
24
34
|
...(data ? { data } : {}),
|
|
25
|
-
...(
|
|
35
|
+
...(['PARAMS_INVALID', 'AUTHORIZATION_REQUIRED', 'CREDENTIAL_INVALID'].includes(code) ? { stage: 'validation', sent: false } : {}),
|
|
26
36
|
...(denied ? { next_action: { action: 'stop', reason: 'Permission denied; report the reason. Do not retry through another identity or transport.', resend_allowed: false } }
|
|
27
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.' } }
|
|
28
|
-
:
|
|
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 } } : {}) };
|
|
29
40
|
}
|
|
30
41
|
export function remoteExitCode(result) {
|
|
31
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;
|
|
32
43
|
}
|
|
33
|
-
/**
|
|
44
|
+
/** Discovery and plans are daemon-owned; credentials remain with the calling Agent. */
|
|
34
45
|
export class AbilityCallerService {
|
|
35
46
|
now;
|
|
36
47
|
store;
|
|
@@ -39,7 +50,7 @@ export class AbilityCallerService {
|
|
|
39
50
|
this.store = new AbilityStore(root);
|
|
40
51
|
}
|
|
41
52
|
close() { this.store.close(); }
|
|
42
|
-
async execute(command, context, transport, params = {}) {
|
|
53
|
+
async execute(command, context, transport, params = {}, credential) {
|
|
43
54
|
if (command.action === 'result') {
|
|
44
55
|
const call = this.store.get('call', requestKey(context, command.requestId));
|
|
45
56
|
remoteAssert(call && sameScope(call, context), 'REQUEST_NOT_FOUND', 'Request is not available in this session and topic');
|
|
@@ -48,15 +59,18 @@ export class AbilityCallerService {
|
|
|
48
59
|
if (command.action === 'call' && command.options.plan) {
|
|
49
60
|
const plan = this.store.get('plan', command.options.plan);
|
|
50
61
|
remoteAssert(plan && sameScope(plan, context), 'PLAN_NOT_FOUND', 'Plan is not available in this session and topic');
|
|
51
|
-
return this.dispatch(plan, context, transport);
|
|
62
|
+
return this.dispatch(plan, context, transport, credential);
|
|
52
63
|
}
|
|
53
64
|
const provider = command.provider;
|
|
54
65
|
await transport.authorize(provider, 'read');
|
|
55
66
|
if (command.action === 'discover')
|
|
56
|
-
return this.discover(command, context, transport);
|
|
67
|
+
return this.discover(command, context, transport, credential);
|
|
57
68
|
const snapshot = await this.discovery(command, context, transport);
|
|
58
69
|
if (command.action === 'list') {
|
|
59
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;
|
|
60
74
|
if (command.options.usage && snapshot.skillRef)
|
|
61
75
|
data.usage = { untrusted: true, reference: snapshot.skillRef,
|
|
62
76
|
content: await this.readUsage(snapshot, snapshot.skillRef, transport) };
|
|
@@ -75,52 +89,82 @@ export class AbilityCallerService {
|
|
|
75
89
|
...snapshot.capabilities.filter(row => row.path === selected.path && row.definition_id === selected.definition_id)]);
|
|
76
90
|
const { definition } = contract;
|
|
77
91
|
if (command.action === 'info') {
|
|
78
|
-
const view = this.discoveryView(snapshot, command.path, command.options);
|
|
79
|
-
if (!command.options.full)
|
|
92
|
+
const view = this.discoveryView(snapshot, command.path, command.options, false);
|
|
93
|
+
if (!command.options.full)
|
|
80
94
|
delete view.capabilities;
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
const
|
|
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,
|
|
84
103
|
devices: this.candidates(snapshot, command.path),
|
|
85
|
-
detail_ref: selected.detail_ref, ...(contract.release ? { release: contract.release } : {})
|
|
104
|
+
detail_ref: selected.detail_ref, ...(contract.release ? { release: contract.release } : {}),
|
|
105
|
+
...(contract.authorization ? { authorization: contract.authorization } : {}) };
|
|
86
106
|
if (command.options.usage) {
|
|
87
107
|
const reference = selected.usage_ref ?? snapshot.skillRef;
|
|
88
108
|
if (contract.usage)
|
|
89
109
|
data.usage = { untrusted: true, reference: selected.detail_ref, content: contract.usage };
|
|
90
110
|
else if (reference)
|
|
91
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
|
+
}
|
|
92
120
|
}
|
|
93
121
|
return response(data);
|
|
94
122
|
}
|
|
95
123
|
remoteAssert(isJsonObject(params), 'PARAMS_INVALID', 'Business params must be a JSON object');
|
|
96
124
|
validateValue(definition.params_schema, params, 'PARAMS_INVALID');
|
|
97
|
-
const aidWide = isAidWideDeviceStatusQuery({ type: 'ability', role: 'call', ability_path: command.path, params });
|
|
98
125
|
const candidates = selected.devices ?? [];
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
remoteAssert(candidates.length === 1, 'DEVICE_SELECTION_REQUIRED', 'Choose a device with --device-id', { devices: this.candidates(snapshot, command.path) });
|
|
108
|
-
deviceId = candidates[0];
|
|
109
|
-
}
|
|
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) });
|
|
110
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.
|
|
111
137
|
const timeout = durationSeconds(command.options.timeout ?? '60s');
|
|
112
138
|
const ttl = durationSeconds(command.options.ttl ?? String(timeout));
|
|
113
139
|
const operationId = command.options['operation-id'] ?? `op-${randomUUID()}`;
|
|
114
140
|
const plan = { ...context, id: `plan-${randomUUID()}`, provider, path: command.path, definition, deviceId,
|
|
115
|
-
params, timeout, ttl, operationId,
|
|
141
|
+
params, timeout, ttl, operationId, authorization: contract.authorization,
|
|
142
|
+
discoveryId: snapshot.id, expiresAt: Math.min(this.now() + 300_000, snapshot.expiresAt),
|
|
116
143
|
fingerprint: digest([provider, deviceId ?? null, command.path, definition.definition_id, params, ttl, timeout, false]) };
|
|
117
144
|
if (command.options['dry-run']) {
|
|
118
145
|
this.store.put('plan', plan.id, context.callerAid, plan);
|
|
119
146
|
return { ...response({ plan_id: plan.id, provider_aid: provider, ability_path: plan.path, definition_id: definition.definition_id,
|
|
120
147
|
device_id: deviceId, params, timeout_seconds: timeout, ttl_seconds: ttl, operation_id: operationId,
|
|
121
|
-
selection_source: snapshot.source, expires_at: plan.expiresAt, require_confirm: definition.require_confirm, auth_required: definition.auth_required
|
|
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 };
|
|
122
150
|
}
|
|
123
|
-
return this.dispatch(plan, context, transport);
|
|
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 });
|
|
124
168
|
}
|
|
125
169
|
ownedDiscovery(id, context, provider) {
|
|
126
170
|
const found = this.store.get('discovery', id);
|
|
@@ -129,18 +173,25 @@ export class AbilityCallerService {
|
|
|
129
173
|
return found;
|
|
130
174
|
}
|
|
131
175
|
async discovery(command, context, transport) {
|
|
176
|
+
const provider = command.provider;
|
|
132
177
|
if (command.options.discovery)
|
|
133
|
-
return this.ownedDiscovery(command.options.discovery, context,
|
|
178
|
+
return this.ownedDiscovery(command.options.discovery, context, provider);
|
|
179
|
+
const currentKey = discoveryCurrentKey(context, provider);
|
|
134
180
|
if (!command.options.refresh) {
|
|
135
|
-
const
|
|
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())
|
|
136
186
|
.sort((a, b) => (b.source === 'online' ? 1 : 0) - (a.source === 'online' ? 1 : 0) || b.fetchedAt - a.fetchedAt)[0];
|
|
137
187
|
if (cached)
|
|
138
188
|
return cached;
|
|
139
189
|
}
|
|
140
|
-
const index = await this.readIndex(
|
|
141
|
-
const snapshot = { ...context, id: `discovery-${randomUUID()}`, provider
|
|
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,
|
|
142
192
|
capabilities: index.capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
|
|
143
193
|
this.store.put('discovery', snapshot.id, context.callerAid, snapshot);
|
|
194
|
+
this.store.put('discovery-current', currentKey, context.callerAid, { id: snapshot.id });
|
|
144
195
|
return snapshot;
|
|
145
196
|
}
|
|
146
197
|
async readUsage(snapshot, reference, transport) {
|
|
@@ -178,12 +229,12 @@ export class AbilityCallerService {
|
|
|
178
229
|
device_id: device, definition_id: row.definition_id, release_id: row.release_id, observed_at: snapshot.fetchedAt, evidence_source: snapshot.source,
|
|
179
230
|
})));
|
|
180
231
|
}
|
|
181
|
-
discoveryView(snapshot, abilityPath, options = {}) {
|
|
232
|
+
discoveryView(snapshot, abilityPath, options = {}, hoistAuthorization = true) {
|
|
182
233
|
const { capabilities: _capabilities, indexRef, ...directory } = snapshot.directory ?? {};
|
|
183
234
|
const directoryFields = directory;
|
|
184
235
|
const full = !!options.full;
|
|
185
|
-
const metadata = full ? directory : Object.fromEntries(['schema', 'publisher', 'compatibility_schema', 'catalog_revision', 'updated_at', 'skill_ref']
|
|
186
|
-
.filter(key =>
|
|
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]]));
|
|
187
238
|
const search = options.search?.toLowerCase();
|
|
188
239
|
const merged = new Map();
|
|
189
240
|
for (const row of snapshot.capabilities) {
|
|
@@ -194,25 +245,45 @@ export class AbilityCallerService {
|
|
|
194
245
|
}
|
|
195
246
|
const rows = [...merged.values()].filter(row => (!abilityPath || row.path === abilityPath)
|
|
196
247
|
&& (!search || [row.path, row.name, row.summary, row.description].some(value => typeof value === 'string' && value.toLowerCase().includes(search))));
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
const
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
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
|
+
}));
|
|
208
278
|
return { subject_aid: snapshot.provider, provider_aid: snapshot.provider, discovery_id: snapshot.id, source: snapshot.source,
|
|
209
279
|
...(snapshot.directory ? { directory: metadata, ...(indexRef ? { index_ref: indexRef } : {}) } : {}),
|
|
210
280
|
fetched_at: snapshot.fetchedAt, expires_at: snapshot.expiresAt, stale: snapshot.expiresAt <= this.now(),
|
|
211
281
|
view: full ? 'full' : 'compact',
|
|
212
|
-
|
|
282
|
+
...(common ? { authorization: common.value } : {}),
|
|
283
|
+
total: capabilities.length,
|
|
213
284
|
capabilities };
|
|
214
285
|
}
|
|
215
|
-
async discover(command, context, transport) {
|
|
286
|
+
async discover(command, context, transport, credential) {
|
|
216
287
|
const provider = command.provider;
|
|
217
288
|
let index = { capabilities: [] };
|
|
218
289
|
try {
|
|
@@ -222,15 +293,25 @@ export class AbilityCallerService {
|
|
|
222
293
|
if (!['OBJECT_NOT_FOUND', 'NOT_FOUND', 'ENOENT', 'FS_NOT_FOUND'].includes(error.code ?? ''))
|
|
223
294
|
throw error;
|
|
224
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');
|
|
225
305
|
await transport.authorize(provider, 'send');
|
|
226
306
|
const window = durationSeconds(command.options.window ?? '5s', 30);
|
|
227
307
|
const requestId = `c-${randomUUID()}`, operationId = `op-${randomUUID()}`;
|
|
228
|
-
const call = { ...context, provider, path: 'protocol/discover', requestId, operationId,
|
|
308
|
+
const call = { ...context, provider, path: 'protocol/discover', requestId, operationId, deviceId,
|
|
229
309
|
fingerprint: digest([provider, 'protocol/discover', operationId]), sent: null, createdAt: this.now(), discoveryIndex: index };
|
|
230
310
|
this.store.put('call', requestKey(context, requestId), context.callerAid, call);
|
|
231
311
|
try {
|
|
232
312
|
const sent = await transport.send(provider, { type: 'ability', role: 'call', call_id: requestId, operation_id: operationId,
|
|
233
|
-
ability_path: 'protocol/discover', params: { spec_version: 'aid-ability/2', window_seconds: window },
|
|
313
|
+
ability_path: 'protocol/discover', params: { spec_version: 'aid-ability/2', window_seconds: window },
|
|
314
|
+
...(credential ? { credential } : {}), ttl: window, async: false }, deviceId, window * 1000);
|
|
234
315
|
call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
|
|
235
316
|
if (!sent.ok)
|
|
236
317
|
call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Discovery transport failed') };
|
|
@@ -256,14 +337,22 @@ export class AbilityCallerService {
|
|
|
256
337
|
const capabilities = [];
|
|
257
338
|
const devices = new Set();
|
|
258
339
|
let invalid = 0;
|
|
259
|
-
|
|
340
|
+
const responses = record?.responses ?? (record?.responsePayload ? [{ responsePayload: record.responsePayload, responseDeviceId: record.responseDeviceId }] : []);
|
|
341
|
+
for (const item of responses) {
|
|
260
342
|
try {
|
|
261
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
|
+
}
|
|
262
349
|
remoteAssert(result.role === 'result' && result.ok === true && isJsonObject(result.result), 'RESULT_INVALID', 'Invalid discovery result');
|
|
263
350
|
const body = result.result;
|
|
264
|
-
remoteAssert(isJsonObject(body.protocol) && body.protocol.spec_version === 'aid-ability/2' && Array.isArray(body.capabilities)
|
|
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');
|
|
265
353
|
boundedJson(body);
|
|
266
|
-
const
|
|
354
|
+
const responseDeviceId = item.responseDeviceId;
|
|
355
|
+
const rows = body.capabilities.map(row => parseCapability(row, call.provider, [responseDeviceId]));
|
|
267
356
|
capabilities.push(...rows);
|
|
268
357
|
devices.add(item.responseDeviceId);
|
|
269
358
|
}
|
|
@@ -277,16 +366,18 @@ export class AbilityCallerService {
|
|
|
277
366
|
source: 'online', fetchedAt: observedAt, expiresAt: observedAt + 60_000, capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
|
|
278
367
|
if (devices.size && closed) {
|
|
279
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 });
|
|
280
371
|
call.discoveryId = snapshot.id;
|
|
281
372
|
this.store.put('call', requestKey(context, call.requestId), context.callerAid, call);
|
|
282
373
|
}
|
|
283
374
|
const data = { ...this.discoveryView(snapshot, abilityPath, options), request_id: call.requestId, devices: [...devices], window_closed: closed,
|
|
284
|
-
response_count:
|
|
375
|
+
response_count: responses.length, invalid_response_count: invalid, coverage: 'responding_devices_only' };
|
|
285
376
|
const code = invalid ? 'PARTIAL_RESULT' : devices.size && closed ? undefined : call.error?.code ?? (!devices.size ? 'NO_DISCOVERY_RESPONSE' : 'RESULT_PENDING');
|
|
286
377
|
return { ...response(data, !code, code), sent: call.sent,
|
|
287
378
|
...(code ? { next_action: { command: `ec ability remote result ${call.requestId}`, resend_allowed: false } } : {}) };
|
|
288
379
|
}
|
|
289
|
-
async dispatch(plan, context, transport) {
|
|
380
|
+
async dispatch(plan, context, transport, credential) {
|
|
290
381
|
await transport.authorize(plan.provider, 'send');
|
|
291
382
|
const key = operationKey(context, plan.provider, plan.operationId);
|
|
292
383
|
const existing = this.store.get('operation', key);
|
|
@@ -297,7 +388,12 @@ export class AbilityCallerService {
|
|
|
297
388
|
}
|
|
298
389
|
remoteAssert(plan.expiresAt > this.now(), 'PLAN_EXPIRED', 'Call plan or discovery evidence expired');
|
|
299
390
|
this.ownedDiscovery(plan.discoveryId, context, plan.provider);
|
|
391
|
+
this.checkAuthorization(plan.authorization, !!credential, plan.deviceId, plan.path, plan.provider, plan.definition.definition_id);
|
|
300
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 } : {}),
|
|
301
397
|
requestId: `c-${randomUUID()}`, operationId: plan.operationId, fingerprint: plan.fingerprint, sent: null, createdAt: this.now() };
|
|
302
398
|
// Claim before the first await/send. A crash at any later point leaves an
|
|
303
399
|
// unknown receipt which is queried, never automatically dispatched again.
|
|
@@ -308,7 +404,8 @@ export class AbilityCallerService {
|
|
|
308
404
|
});
|
|
309
405
|
try {
|
|
310
406
|
const sent = await transport.send(call.provider, { type: 'ability', role: 'call', call_id: call.requestId, operation_id: call.operationId,
|
|
311
|
-
ability_path: call.path, definition_id: plan.definition.definition_id, params: plan.params,
|
|
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);
|
|
312
409
|
call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
|
|
313
410
|
if (!sent.ok)
|
|
314
411
|
call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Transport failed') };
|
|
@@ -333,7 +430,7 @@ export class AbilityCallerService {
|
|
|
333
430
|
if (call.path === 'protocol/discover')
|
|
334
431
|
return this.discoveryResult(call, record, context);
|
|
335
432
|
const data = { provider_aid: call.provider, ability_path: call.path, definition_id: call.definition?.definition_id,
|
|
336
|
-
device_id: call.deviceId, call_id: call.requestId, operation_id: call.operationId, request_id: call.requestId,
|
|
433
|
+
device_id: call.deviceId ?? record?.responseDeviceId, call_id: call.requestId, operation_id: call.operationId, request_id: call.requestId,
|
|
337
434
|
transport_state: record?.state ?? 'unknown', execution_state: 'unknown', business_ok: null,
|
|
338
435
|
result_validated: false, ack_received: !!record?.ackMessageId, result: null,
|
|
339
436
|
may_have_executed: call.sent !== false };
|
|
@@ -351,8 +448,50 @@ export class AbilityCallerService {
|
|
|
351
448
|
remoteAssert(result.role === 'result', 'RESULT_INVALID', 'ACK is not a final result');
|
|
352
449
|
if (result.ok)
|
|
353
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
|
+
}
|
|
354
490
|
return { execution_state: result.execution_state, business_ok: result.ok, result_validated: true,
|
|
355
|
-
result: result.ok ? result.result : null,
|
|
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 }) };
|
|
356
495
|
};
|
|
357
496
|
try {
|
|
358
497
|
if (record.responseMode === 'all_devices') {
|
|
@@ -368,7 +507,7 @@ export class AbilityCallerService {
|
|
|
368
507
|
return { ...response({ ...data, results, collection_state: 'window_closed', coverage: 'responding_devices_only', business_ok: ok,
|
|
369
508
|
result_validated: results.length > 0 && results.every(item => item.result_validated) }, ok, ok ? undefined : 'PARTIAL_RESULT'), sent: call.sent };
|
|
370
509
|
}
|
|
371
|
-
remoteAssert(record.responseDeviceId === call.deviceId, 'RESULT_INVALID', 'Result did not originate from the selected device');
|
|
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');
|
|
372
511
|
const result = validate(record.responsePayload);
|
|
373
512
|
const code = result.business_ok ? undefined : result.execution_state === 'unknown' ? 'EXECUTION_UNKNOWN' : 'BUSINESS_FAILED';
|
|
374
513
|
return { ...response({ ...data, ...result }, result.business_ok, code), sent: call.sent };
|