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,755 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { spawn } from 'node:child_process';
|
|
4
|
+
import { randomUUID, randomBytes } from 'node:crypto';
|
|
5
|
+
import { resolveRoot } from '../../paths.js';
|
|
6
|
+
import { getPackageRoot } from '../../paths.js';
|
|
7
|
+
import { assertOwnershipAuthorization } from '../../core/ownership/owner-resolver.js';
|
|
8
|
+
import { isValidAid } from '../../aun/aid/validation.js';
|
|
9
|
+
import { ownerResolver, refreshOwnershipForAuthorization } from '../../core/ownership/owner-resolver.js';
|
|
10
|
+
import { queryRecord, registerContent, verifyFile } from '../../core/file-integrity/store.js';
|
|
11
|
+
import { atomicReplaceJson, withFileLock } from '../../utils/atomic-write.js';
|
|
12
|
+
import { dshIdentity } from './installation.js';
|
|
13
|
+
import { selectDshNativeInstallation, revalidateDshNativeInstallation } from './installation.js';
|
|
14
|
+
async function inspectNativeSession(registration, projectPath, selection, signal) {
|
|
15
|
+
signal?.throwIfAborted();
|
|
16
|
+
const temporary = process.env.TMPDIR;
|
|
17
|
+
if (!temporary || !path.isAbsolute(temporary) || !fs.statSync(temporary).isDirectory())
|
|
18
|
+
throw new Error('DSH_SHARED_TEMP_INVALID');
|
|
19
|
+
const { installation, resource } = registration;
|
|
20
|
+
const env = {};
|
|
21
|
+
for (const [key, value] of Object.entries(process.env)) {
|
|
22
|
+
if (/^(PATH|PATHEXT|SYSTEMROOT|WINDIR|COMSPEC|USERPROFILE|HOME|HOMEDRIVE|HOMEPATH|APPDATA|LOCALAPPDATA)$/i.test(key))
|
|
23
|
+
env[key] = value;
|
|
24
|
+
}
|
|
25
|
+
Object.assign(env, { DSH_PACKAGE_PATH: installation.packagePath, DSH_HOME: resource.homePath,
|
|
26
|
+
TMPDIR: temporary, TEMP: temporary, TMP: temporary, DSH_TELEMETRY_DISABLED: '1' });
|
|
27
|
+
if (installation.kind === 'desktop')
|
|
28
|
+
env.ELECTRON_RUN_AS_NODE = '1';
|
|
29
|
+
const payload = JSON.stringify({ packagePath: installation.packagePath, homePath: resource.homePath,
|
|
30
|
+
profilePath: resource.profilePath, projectPath, ...selection });
|
|
31
|
+
const outcome = await new Promise((resolve, reject) => {
|
|
32
|
+
const child = spawn(installation.executablePath, ['--expose-internals',
|
|
33
|
+
path.join(getPackageRoot(), 'dist', 'agents', 'dsh', 'runtime', 'session-inspector.js')], { cwd: projectPath, env, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe', 'pipe'] });
|
|
34
|
+
let stdout = '';
|
|
35
|
+
let stdoutBytes = 0;
|
|
36
|
+
let failure;
|
|
37
|
+
const stop = (code) => { failure = code; child.kill(); };
|
|
38
|
+
const timer = setTimeout(() => stop('DSH_SESSION_INSPECTION_TIMEOUT'), 20000);
|
|
39
|
+
const onAbort = () => stop('DSH_SESSION_INSPECTION_CANCELLED');
|
|
40
|
+
signal?.addEventListener('abort', onAbort, { once: true });
|
|
41
|
+
if (signal?.aborted)
|
|
42
|
+
onAbort();
|
|
43
|
+
const cleanup = () => { clearTimeout(timer); signal?.removeEventListener('abort', onAbort); };
|
|
44
|
+
child.stdout.setEncoding('utf8');
|
|
45
|
+
child.stdout.on('data', chunk => {
|
|
46
|
+
const part = chunk.toString();
|
|
47
|
+
stdoutBytes += Buffer.byteLength(part);
|
|
48
|
+
stdout += part;
|
|
49
|
+
const maxBytes = selection.action === 'history-all' ? 128 * 1024 * 1024 : selection.action === 'history' ? 8 * 1024 * 1024
|
|
50
|
+
: ['list', 'profile', 'catalog'].includes(selection.action ?? '') ? 128 * 1024 : 16 * 1024;
|
|
51
|
+
if (stdoutBytes > maxBytes)
|
|
52
|
+
stop('DSH_SESSION_INSPECTION_INVALID');
|
|
53
|
+
});
|
|
54
|
+
child.stderr.resume();
|
|
55
|
+
child.once('error', () => { cleanup(); reject(new Error('DSH_SESSION_INSPECTION_FAILED')); });
|
|
56
|
+
child.once('close', code => { cleanup(); failure ? reject(new Error(failure)) : resolve({ output: stdout, code }); });
|
|
57
|
+
const pipe = child.stdio[3];
|
|
58
|
+
pipe.on('error', () => stop('DSH_SESSION_INSPECTION_FAILED'));
|
|
59
|
+
pipe.end(payload);
|
|
60
|
+
});
|
|
61
|
+
let result;
|
|
62
|
+
try {
|
|
63
|
+
result = JSON.parse(outcome.output);
|
|
64
|
+
}
|
|
65
|
+
catch {
|
|
66
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
67
|
+
}
|
|
68
|
+
if (result?.protocol !== 'evolcore-dsh-session-inspect/1')
|
|
69
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
70
|
+
if (typeof result.error === 'string' && /^DSH_[A-Z_]+$/.test(result.error))
|
|
71
|
+
throw new Error(result.error);
|
|
72
|
+
if (outcome.code !== 0)
|
|
73
|
+
throw new Error('DSH_SESSION_INSPECTION_FAILED');
|
|
74
|
+
return result;
|
|
75
|
+
}
|
|
76
|
+
export const dshNativeSessionInspector = {
|
|
77
|
+
async version(registration, nativeSessionId, projectPath, signal) {
|
|
78
|
+
const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'version' }, signal);
|
|
79
|
+
if (result.action !== 'version' || result.nativeSessionId !== nativeSessionId || result.projectPath !== projectPath
|
|
80
|
+
|| !/^[a-f0-9]{64}$/.test(result.version))
|
|
81
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
82
|
+
return result.version;
|
|
83
|
+
},
|
|
84
|
+
async historyAll(registration, nativeSessionId, projectPath, signal) {
|
|
85
|
+
const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'history-all', allowActive: true }, signal);
|
|
86
|
+
validateObservation(result, nativeSessionId, projectPath, true);
|
|
87
|
+
if (result.action !== 'history-all' || !/^[a-f0-9]{64}$/.test(result.version)
|
|
88
|
+
|| !Array.isArray(result.events) || result.events.length !== result.eventCount || result.events.length > 1000000
|
|
89
|
+
|| result.events.some((event, index) => !event || event.seq !== index || typeof event.type !== 'string'
|
|
90
|
+
|| !event.data || typeof event.data !== 'object' || Array.isArray(event.data)))
|
|
91
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
92
|
+
return { version: result.version, events: result.events };
|
|
93
|
+
},
|
|
94
|
+
async fork(registration, nativeSessionId, projectPath, childId, expectedFingerprint, anchor, signal) {
|
|
95
|
+
const result = await inspectNativeSession(registration, projectPath, { action: 'fork', nativeSessionId, childId, expectedFingerprint, anchor }, signal);
|
|
96
|
+
if (result.nativeSessionId !== childId || !/^[a-f0-9]{64}$/.test(result.fingerprint))
|
|
97
|
+
throw new Error('DSH_FORK_RESULT_INVALID');
|
|
98
|
+
return result;
|
|
99
|
+
},
|
|
100
|
+
async discardFork(registration, nativeSessionId, projectPath, expectedFingerprint) {
|
|
101
|
+
await inspectNativeSession(registration, projectPath, { action: 'discard-fork', nativeSessionId, expectedFingerprint });
|
|
102
|
+
},
|
|
103
|
+
async catalog(registration) {
|
|
104
|
+
const result = await inspectNativeSession(registration, registration.resource.homePath, { action: 'catalog' });
|
|
105
|
+
if (result.action !== 'catalog' || typeof result.defaultModel !== 'string'
|
|
106
|
+
|| !Array.isArray(result.models) || result.models.length > 1024
|
|
107
|
+
|| result.models.some((model) => typeof model?.id !== 'string' || !model.id
|
|
108
|
+
|| !Array.isArray(model.reasoningLevels) || model.reasoningLevels.some((level) => typeof level !== 'string'))) {
|
|
109
|
+
throw new Error('DSH_NATIVE_CATALOG_INVALID');
|
|
110
|
+
}
|
|
111
|
+
return { models: result.models, defaultModel: result.defaultModel,
|
|
112
|
+
revision: result.configurationRevision, source: 'native', freshness: 'fallback',
|
|
113
|
+
fetchedAt: new Date().toISOString(), diagnostics: [{ code: 'BUILTIN',
|
|
114
|
+
message: 'DSH installed adapter capabilities; account availability is checked when the task runs.' }] };
|
|
115
|
+
},
|
|
116
|
+
async profile(registration, projectPath = registration.resource.homePath) {
|
|
117
|
+
const result = await inspectNativeSession(registration, projectPath, { action: 'profile' });
|
|
118
|
+
if (result.action !== 'profile' || result.projectPath !== (process.platform === 'win32' ? projectPath.toLowerCase() : projectPath)
|
|
119
|
+
|| !/^[a-f0-9]{64}$/.test(result.configurationRevision)
|
|
120
|
+
|| !Array.isArray(result.plugins) || result.plugins.length > 512
|
|
121
|
+
|| result.plugins.some((item) => !item || typeof item.id !== 'string' || typeof item.name !== 'string' || typeof item.enabled !== 'boolean')
|
|
122
|
+
|| !Array.isArray(result.excluded) || result.excluded.length > 512 || result.excluded.some((item) => typeof item !== 'string')
|
|
123
|
+
|| !Array.isArray(result.mcpServers) || result.mcpServers.length > 64
|
|
124
|
+
|| result.mcpServers.some((item) => !item || typeof item.name !== 'string' || !/^[a-f0-9]{64}$/.test(item.fingerprint)
|
|
125
|
+
|| typeof item.configuredEnabled !== 'boolean' || typeof item.transport !== 'string'
|
|
126
|
+
|| !Number.isSafeInteger(item.argumentCount) || item.argumentCount < 0))
|
|
127
|
+
throw new Error('DSH_PROFILE_INSPECTION_INVALID');
|
|
128
|
+
return result;
|
|
129
|
+
},
|
|
130
|
+
async history(registration, nativeSessionId, projectPath, offset, signal, allowActive = false) {
|
|
131
|
+
if (!Number.isSafeInteger(offset) || offset < 0 || offset > 1000000)
|
|
132
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
133
|
+
const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'history', offset,
|
|
134
|
+
...(allowActive ? { allowActive: true } : {}) }, signal);
|
|
135
|
+
validateObservation(result, nativeSessionId, projectPath, allowActive);
|
|
136
|
+
if (result.action !== 'history' || result.offset !== offset || !Array.isArray(result.events)
|
|
137
|
+
|| result.events.length > Math.min(256, result.eventCount - offset)
|
|
138
|
+
|| (offset < result.eventCount && result.events.length === 0)
|
|
139
|
+
|| result.events.some((event, index) => !event || event.seq !== offset + index
|
|
140
|
+
|| typeof event.type !== 'string' || !event.data || typeof event.data !== 'object' || Array.isArray(event.data))) {
|
|
141
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
142
|
+
}
|
|
143
|
+
return result;
|
|
144
|
+
},
|
|
145
|
+
async list(registration, projectPath, offset = 0) {
|
|
146
|
+
if (!Number.isSafeInteger(offset) || offset < 0 || offset > 16384)
|
|
147
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
148
|
+
const result = await inspectNativeSession(registration, projectPath, { action: 'list', offset });
|
|
149
|
+
if (result.action !== 'list' || result.projectPath !== projectPath || !Array.isArray(result.sessions)
|
|
150
|
+
|| result.sessions.length > 20 || !(result.nextOffset === null || result.nextOffset === offset + 20)
|
|
151
|
+
|| result.sessions.some((item) => !item || item.projectPath !== projectPath
|
|
152
|
+
|| typeof item.nativeSessionId !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(item.nativeSessionId)
|
|
153
|
+
|| typeof item.preset !== 'string' || !item.preset || item.preset.length > 256)
|
|
154
|
+
|| new Set(result.sessions.map((item) => item.nativeSessionId)).size !== result.sessions.length) {
|
|
155
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
156
|
+
}
|
|
157
|
+
return result;
|
|
158
|
+
},
|
|
159
|
+
async inspect(registration, nativeSessionId, projectPath, allowActive = false, signal) {
|
|
160
|
+
const result = await inspectNativeSession(registration, projectPath, { nativeSessionId,
|
|
161
|
+
...(allowActive ? { allowActive: true } : {}) }, signal);
|
|
162
|
+
validateObservation(result, nativeSessionId, projectPath, allowActive);
|
|
163
|
+
return result;
|
|
164
|
+
},
|
|
165
|
+
};
|
|
166
|
+
function validateObservation(result, nativeSessionId, projectPath, allowActive = false) {
|
|
167
|
+
if (result.nativeSessionId !== nativeSessionId || result.projectPath !== projectPath
|
|
168
|
+
|| typeof result.preset !== 'string' || !result.preset || result.preset.length > 256
|
|
169
|
+
|| !Number.isSafeInteger(result.eventCount) || result.eventCount < 0
|
|
170
|
+
|| typeof result.storageRevision !== 'string' || result.storageRevision.length > 1024
|
|
171
|
+
|| !/^[a-f0-9]{64}$/.test(result.configurationRevision) || !/^[a-f0-9]{64}$/.test(result.fingerprint)
|
|
172
|
+
|| !(allowActive ? ['idle', 'empty', 'active'] : ['idle', 'empty']).includes(result.state))
|
|
173
|
+
throw new Error('DSH_SESSION_INSPECTION_INVALID');
|
|
174
|
+
}
|
|
175
|
+
function identityPath(file) {
|
|
176
|
+
return process.platform === 'win32' ? file.toLowerCase() : file;
|
|
177
|
+
}
|
|
178
|
+
function inspectPath(input, kind) {
|
|
179
|
+
if (process.platform === 'win32' && !/^[a-z]:[\\/]$/i.test(path.parse(input).root))
|
|
180
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: local drive paths are required');
|
|
181
|
+
if (!path.isAbsolute(input))
|
|
182
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: absolute paths are required');
|
|
183
|
+
const normalized = path.resolve(input);
|
|
184
|
+
let current = normalized;
|
|
185
|
+
while (true) {
|
|
186
|
+
const stat = fs.lstatSync(current);
|
|
187
|
+
if (stat.isSymbolicLink())
|
|
188
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: linked paths are not admitted');
|
|
189
|
+
const parent = path.dirname(current);
|
|
190
|
+
if (parent === current)
|
|
191
|
+
break;
|
|
192
|
+
current = parent;
|
|
193
|
+
}
|
|
194
|
+
const canonical = fs.realpathSync(normalized);
|
|
195
|
+
const stat = fs.statSync(canonical, { bigint: true });
|
|
196
|
+
if (kind === 'directory' ? !stat.isDirectory() : !stat.isFile())
|
|
197
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: incorrect path type');
|
|
198
|
+
return { path: canonical, identity: [stat.dev, stat.ino, stat.birthtimeNs].join(':') };
|
|
199
|
+
}
|
|
200
|
+
export function inspectDshNativeResource(installation, homePath, profilePath) {
|
|
201
|
+
if (!/^dsh-install-[a-f0-9]{64}$/.test(installation.installationId) || !/^[a-f0-9]{64}$/.test(installation.revision)) {
|
|
202
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: installation identity is invalid');
|
|
203
|
+
}
|
|
204
|
+
const home = inspectPath(homePath, 'directory');
|
|
205
|
+
const profile = inspectPath(profilePath, 'directory');
|
|
206
|
+
const profiles = path.join(home.path, 'profiles');
|
|
207
|
+
const relative = path.relative(profiles, profile.path);
|
|
208
|
+
if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
|
|
209
|
+
throw new Error('DSH_RESOURCE_PATH_INVALID: profile must be inside native Home/profiles');
|
|
210
|
+
}
|
|
211
|
+
const manifest = inspectPath(path.join(profile.path, 'package.json'), 'file');
|
|
212
|
+
if (fs.statSync(manifest.path).size > 256 * 1024)
|
|
213
|
+
throw new Error('DSH_RESOURCE_PROFILE_INVALID');
|
|
214
|
+
const bytes = fs.readFileSync(manifest.path);
|
|
215
|
+
let data;
|
|
216
|
+
try {
|
|
217
|
+
data = JSON.parse(bytes.toString('utf8'));
|
|
218
|
+
}
|
|
219
|
+
catch {
|
|
220
|
+
throw new Error('DSH_RESOURCE_PROFILE_INVALID: malformed profile manifest');
|
|
221
|
+
}
|
|
222
|
+
if (!data || !Array.isArray(data.dsh?.profile?.bundles)
|
|
223
|
+
|| !data.dsh.profile.bundles.includes('@deepseek-ai/dsh-base')
|
|
224
|
+
|| data.dsh.profile.bundles.some((bundle) => typeof bundle !== 'string')) {
|
|
225
|
+
throw new Error('DSH_RESOURCE_PROFILE_INVALID: expected a native base-backed profile');
|
|
226
|
+
}
|
|
227
|
+
const nativeResourceId = 'dsh-resource-' + dshIdentity([installation.installationId,
|
|
228
|
+
identityPath(home.path), identityPath(profile.path)]);
|
|
229
|
+
return Object.freeze({ nativeResourceId, installationId: installation.installationId,
|
|
230
|
+
installationRevision: installation.revision, homePath: home.path, profilePath: profile.path,
|
|
231
|
+
revision: dshIdentity([home.identity, profile.identity, manifest.identity, bytes.toString('base64')]) });
|
|
232
|
+
}
|
|
233
|
+
export function revalidateDshNativeResource(snapshot, installation) {
|
|
234
|
+
if (snapshot.installationId !== installation.installationId || snapshot.installationRevision !== installation.revision) {
|
|
235
|
+
throw new Error('DSH_RESOURCE_CHANGED: installation binding does not match');
|
|
236
|
+
}
|
|
237
|
+
const current = inspectDshNativeResource(installation, snapshot.homePath, snapshot.profilePath);
|
|
238
|
+
if (current.nativeResourceId !== snapshot.nativeResourceId || current.revision !== snapshot.revision) {
|
|
239
|
+
throw new Error('DSH_RESOURCE_CHANGED: resource paths or profile manifest changed');
|
|
240
|
+
}
|
|
241
|
+
return current;
|
|
242
|
+
}
|
|
243
|
+
// Daemon-local, never persisted. Restart invalidates every outstanding preview.
|
|
244
|
+
const sessionReceipts = new Map();
|
|
245
|
+
const SESSION_RECEIPT_TTL = 2 * 60 * 1000;
|
|
246
|
+
function fail(code) { throw new Error(code); }
|
|
247
|
+
function validSession(value) {
|
|
248
|
+
return typeof value === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(value);
|
|
249
|
+
}
|
|
250
|
+
function validRevision(value) {
|
|
251
|
+
return typeof value === 'string' && /^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(value);
|
|
252
|
+
}
|
|
253
|
+
function canonicalProject(value) {
|
|
254
|
+
if (typeof value !== 'string' || !path.isAbsolute(value))
|
|
255
|
+
fail('DSH_SHARED_PROJECT_INVALID');
|
|
256
|
+
noLinks(value);
|
|
257
|
+
const resolved = fs.realpathSync(value);
|
|
258
|
+
if (!fs.statSync(resolved).isDirectory())
|
|
259
|
+
fail('DSH_SHARED_PROJECT_INVALID');
|
|
260
|
+
return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
|
|
261
|
+
}
|
|
262
|
+
function object(value) {
|
|
263
|
+
return value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
264
|
+
}
|
|
265
|
+
function noLinks(file) {
|
|
266
|
+
let current = path.resolve(file);
|
|
267
|
+
while (true) {
|
|
268
|
+
try {
|
|
269
|
+
if (fs.lstatSync(current).isSymbolicLink())
|
|
270
|
+
fail('DSH_REGISTRY_LINK_INVALID');
|
|
271
|
+
}
|
|
272
|
+
catch (error) {
|
|
273
|
+
if (error.code !== 'ENOENT')
|
|
274
|
+
throw error;
|
|
275
|
+
}
|
|
276
|
+
const parent = path.dirname(current);
|
|
277
|
+
if (parent === current)
|
|
278
|
+
return;
|
|
279
|
+
current = parent;
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
function ownership(agentAid, principalId) {
|
|
283
|
+
const daemonAid = ownerResolver.getDaemonAid();
|
|
284
|
+
if (!daemonAid || !ownerResolver.isOwner(agentAid, principalId) || !ownerResolver.isOwner(daemonAid, principalId)) {
|
|
285
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED');
|
|
286
|
+
}
|
|
287
|
+
const agent = ownerResolver.snapshot(agentAid).consensus;
|
|
288
|
+
const daemon = ownerResolver.snapshot(daemonAid).consensus;
|
|
289
|
+
if (!agent || !daemon || !Number.isSafeInteger(agent.relation_version) || agent.relation_version < 1
|
|
290
|
+
|| !Number.isSafeInteger(daemon.relation_version) || daemon.relation_version < 1)
|
|
291
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED');
|
|
292
|
+
return { agentOwnershipVersion: agent.relation_version, daemonOwnershipVersion: daemon.relation_version };
|
|
293
|
+
}
|
|
294
|
+
async function authorize(subject, agentAid) {
|
|
295
|
+
if (!isValidAid(agentAid) || !subject.allowAccess || subject.chatType !== 'private' || subject.channelType !== 'aun'
|
|
296
|
+
|| subject.actorId !== subject.principalId || !subject.principalId || !isValidAid(subject.principalId)
|
|
297
|
+
|| subject.processRole !== 'daemon-owner' || !subject.isDaemonOwner
|
|
298
|
+
|| (!subject.ecwebManagement && subject.menuEncrypted !== true))
|
|
299
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED');
|
|
300
|
+
await refreshOwnershipForAuthorization(agentAid, { includeDaemon: true, allowTransient: false });
|
|
301
|
+
return { ownerAid: subject.principalId, ...ownership(agentAid, subject.principalId) };
|
|
302
|
+
}
|
|
303
|
+
function validateRecord(value) {
|
|
304
|
+
if (!object(value) || !isValidAid(value.agentAid) || !isValidAid(value.ownerAid)
|
|
305
|
+
|| (value.scope !== undefined && value.scope !== 'host')
|
|
306
|
+
|| !Number.isSafeInteger(value.agentOwnershipVersion) || value.agentOwnershipVersion < 1
|
|
307
|
+
|| !Number.isSafeInteger(value.daemonOwnershipVersion) || value.daemonOwnershipVersion < 1
|
|
308
|
+
|| !validRevision(value.revision)
|
|
309
|
+
|| !object(value.resource) || !object(value.installation)
|
|
310
|
+
|| value.mcpApprovals !== undefined && !validMcpApprovals(value.mcpApprovals))
|
|
311
|
+
return false;
|
|
312
|
+
const resource = value.resource;
|
|
313
|
+
const installation = value.installation;
|
|
314
|
+
return /^dsh-resource-[a-f0-9]{64}$/.test(resource.nativeResourceId)
|
|
315
|
+
&& /^dsh-install-[a-f0-9]{64}$/.test(resource.installationId)
|
|
316
|
+
&& /^[a-f0-9]{64}$/.test(resource.installationRevision) && /^[a-f0-9]{64}$/.test(resource.revision)
|
|
317
|
+
&& typeof resource.homePath === 'string' && path.isAbsolute(resource.homePath)
|
|
318
|
+
&& typeof resource.profilePath === 'string' && path.isAbsolute(resource.profilePath)
|
|
319
|
+
&& resource.installationId === installation.installationId && resource.installationRevision === installation.revision
|
|
320
|
+
&& ['desktop', 'cli'].includes(installation.kind) && typeof installation.packagePath === 'string'
|
|
321
|
+
&& path.isAbsolute(installation.packagePath) && typeof installation.executablePath === 'string'
|
|
322
|
+
&& path.isAbsolute(installation.executablePath);
|
|
323
|
+
}
|
|
324
|
+
function validMcpApprovals(value) {
|
|
325
|
+
return object(value) && Object.keys(value).length <= 64
|
|
326
|
+
&& Object.entries(value).every(([name, fingerprint]) => name.length > 0 && name.length <= 256
|
|
327
|
+
&& !['__proto__', 'prototype', 'constructor'].includes(name) && !/[\x00-\x1f]/.test(name)
|
|
328
|
+
&& typeof fingerprint === 'string' && /^[a-f0-9]{64}$/.test(fingerprint));
|
|
329
|
+
}
|
|
330
|
+
function validateSession(value) {
|
|
331
|
+
return object(value) && isValidAid(value.agentAid) && validSession(value.ecSessionId)
|
|
332
|
+
&& validSession(value.nativeSessionId) && typeof value.nativeResourceId === 'string'
|
|
333
|
+
&& /^dsh-resource-[a-f0-9]{64}$/.test(value.nativeResourceId)
|
|
334
|
+
&& validRevision(value.registrationRevision) && validRevision(value.revision)
|
|
335
|
+
&& typeof value.projectPath === 'string' && path.isAbsolute(value.projectPath);
|
|
336
|
+
}
|
|
337
|
+
export class DshNativeResourceRegistry {
|
|
338
|
+
validateEcSession;
|
|
339
|
+
constructor(validateEcSession) {
|
|
340
|
+
this.validateEcSession = validateEcSession;
|
|
341
|
+
}
|
|
342
|
+
async assertForkSource(agentAid, nativeId, projectPath, ecSessionId, subject) {
|
|
343
|
+
if (!subject.allowAccess || subject.selfAid !== agentAid || subject.role !== 'owner'
|
|
344
|
+
|| !subject.principalId || subject.actorId !== subject.principalId)
|
|
345
|
+
fail('DSH_FORK_AUTHORITY_REQUIRED');
|
|
346
|
+
await refreshOwnershipForAuthorization(agentAid, { allowTransient: false });
|
|
347
|
+
if (!ownerResolver.owners(agentAid).includes(subject.principalId))
|
|
348
|
+
fail('DSH_FORK_AUTHORITY_REQUIRED');
|
|
349
|
+
const binding = await this.findNativeSession(agentAid, nativeId, projectPath);
|
|
350
|
+
if (!binding || binding.ecSessionId !== ecSessionId)
|
|
351
|
+
fail('DSH_SESSION_BINDING_MISMATCH');
|
|
352
|
+
return binding;
|
|
353
|
+
}
|
|
354
|
+
/** Bind a fork only to the destination returned by the Host session manager, without a synthetic task lease. */
|
|
355
|
+
async commitFork(agentAid, source, projectPath, sourceEcId, subject, target, childId, anchor, signal) {
|
|
356
|
+
const parent = await this.assertForkSource(agentAid, source, projectPath, sourceEcId, subject);
|
|
357
|
+
if (!validSession(childId) || !validSession(target.id) || target.id === sourceEcId
|
|
358
|
+
|| target.sourceSessionId !== sourceEcId
|
|
359
|
+
|| target.selfAID !== agentAid || target.baseagent !== 'dsh' || target.agentSessionId !== childId
|
|
360
|
+
|| canonicalProject(target.projectPath) !== parent.projectPath || target.processingState)
|
|
361
|
+
fail('DSH_FORK_TARGET_INVALID');
|
|
362
|
+
const registration = await this.resolve(agentAid, parent.nativeResourceId, parent.registrationRevision);
|
|
363
|
+
const observation = await dshNativeSessionInspector.inspect(registration, source, parent.projectPath);
|
|
364
|
+
const verifySource = async () => {
|
|
365
|
+
const current = await this.assertForkSource(agentAid, source, projectPath, sourceEcId, subject);
|
|
366
|
+
if (current.revision !== parent.revision || current.nativeResourceId !== parent.nativeResourceId
|
|
367
|
+
|| current.registrationRevision !== parent.registrationRevision)
|
|
368
|
+
fail('DSH_SESSION_CHANGED');
|
|
369
|
+
};
|
|
370
|
+
const file = this.file();
|
|
371
|
+
await withFileLock(file + '.lock', async () => {
|
|
372
|
+
await verifySource();
|
|
373
|
+
const state = this.read();
|
|
374
|
+
if (state.sessions.some(item => item.agentAid === agentAid && item.ecSessionId === target.id
|
|
375
|
+
|| item.nativeResourceId === parent.nativeResourceId && item.nativeSessionId === childId))
|
|
376
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
377
|
+
if (state.sessions.length >= 4096)
|
|
378
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
379
|
+
const previous = structuredClone(state);
|
|
380
|
+
const child = await dshNativeSessionInspector.fork(registration, source, parent.projectPath, childId, observation.fingerprint, anchor, signal);
|
|
381
|
+
let published = false;
|
|
382
|
+
try {
|
|
383
|
+
await verifySource();
|
|
384
|
+
await this.resolve(agentAid, parent.nativeResourceId, parent.registrationRevision);
|
|
385
|
+
state.sessions.push({ ...parent, ecSessionId: target.id, nativeSessionId: childId, revision: randomUUID() });
|
|
386
|
+
state.revision = randomUUID();
|
|
387
|
+
const content = JSON.stringify(state, null, 2) + '\n';
|
|
388
|
+
if (Buffer.byteLength(content) > 1024 * 1024)
|
|
389
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
390
|
+
await atomicReplaceJson(file, state);
|
|
391
|
+
published = true;
|
|
392
|
+
registerContent(file, content, registration.ownerAid);
|
|
393
|
+
}
|
|
394
|
+
catch (error) {
|
|
395
|
+
if (published) {
|
|
396
|
+
try {
|
|
397
|
+
await atomicReplaceJson(file, previous);
|
|
398
|
+
registerContent(file, JSON.stringify(previous, null, 2) + '\n', registration.ownerAid);
|
|
399
|
+
}
|
|
400
|
+
catch (rollbackError) {
|
|
401
|
+
throw new AggregateError([error, rollbackError], 'DSH_FORK_ROLLBACK_FAILED');
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
// Only the newly created, unchanged child can be removed. Never remove an attached child.
|
|
405
|
+
if (!this.read().sessions.some(item => item.nativeResourceId === parent.nativeResourceId && item.nativeSessionId === childId)) {
|
|
406
|
+
await dshNativeSessionInspector.discardFork(registration, childId, parent.projectPath, child.fingerprint);
|
|
407
|
+
}
|
|
408
|
+
throw error;
|
|
409
|
+
}
|
|
410
|
+
});
|
|
411
|
+
}
|
|
412
|
+
async ecRevision(agentAid, ownerAid, sessionId, projectPath) {
|
|
413
|
+
if (!this.validateEcSession)
|
|
414
|
+
fail('DSH_EC_SESSION_UNAVAILABLE');
|
|
415
|
+
return this.validateEcSession(agentAid, ownerAid, sessionId, projectPath);
|
|
416
|
+
}
|
|
417
|
+
file() { return path.join(resolveRoot(), 'data', 'dsh', 'native-resources.json'); }
|
|
418
|
+
read() {
|
|
419
|
+
const file = this.file();
|
|
420
|
+
noLinks(file);
|
|
421
|
+
if (!fs.existsSync(file)) {
|
|
422
|
+
if (queryRecord(file))
|
|
423
|
+
fail('DSH_REGISTRY_INTEGRITY_INVALID');
|
|
424
|
+
return { version: 1, revision: 'uninitialized', resources: [], sessions: [] };
|
|
425
|
+
}
|
|
426
|
+
if (!fs.statSync(file).isFile() || fs.statSync(file).size > 1024 * 1024)
|
|
427
|
+
fail('DSH_REGISTRY_INVALID');
|
|
428
|
+
const verified = verifyFile(file, { requireRegistered: true, restoreOnFail: false });
|
|
429
|
+
if (verified.status !== 'verified' || !verified.bytes)
|
|
430
|
+
fail('DSH_REGISTRY_INTEGRITY_INVALID');
|
|
431
|
+
let state;
|
|
432
|
+
try {
|
|
433
|
+
state = JSON.parse(verified.bytes.toString('utf8'));
|
|
434
|
+
}
|
|
435
|
+
catch {
|
|
436
|
+
fail('DSH_REGISTRY_INVALID');
|
|
437
|
+
}
|
|
438
|
+
if (!object(state) || state.version !== 1 || typeof state.revision !== 'string'
|
|
439
|
+
|| !validRevision(state.revision) || !Array.isArray(state.resources) || state.resources.length > 128
|
|
440
|
+
|| !state.resources.every(validateRecord))
|
|
441
|
+
fail('DSH_REGISTRY_INVALID');
|
|
442
|
+
state.sessions ??= [];
|
|
443
|
+
if (!Array.isArray(state.sessions) || state.sessions.length > 4096 || !state.sessions.every(validateSession))
|
|
444
|
+
fail('DSH_REGISTRY_INVALID');
|
|
445
|
+
const keys = state.resources.map(record => `${record.agentAid}/${record.resource.nativeResourceId}${record.scope === 'host' ? '/' + record.revision : ''}`);
|
|
446
|
+
if (new Set(keys).size !== keys.length)
|
|
447
|
+
fail('DSH_REGISTRY_INVALID');
|
|
448
|
+
const sessionKeys = state.sessions.map(binding => `${binding.agentAid}/${binding.ecSessionId}`);
|
|
449
|
+
const nativeKeys = state.sessions.map(binding => `${binding.nativeResourceId}/${binding.nativeSessionId}`);
|
|
450
|
+
if (new Set(sessionKeys).size !== sessionKeys.length || new Set(nativeKeys).size !== nativeKeys.length)
|
|
451
|
+
fail('DSH_REGISTRY_INVALID');
|
|
452
|
+
return state;
|
|
453
|
+
}
|
|
454
|
+
async preview(subject, agentAid, input) {
|
|
455
|
+
await authorize(subject, agentAid);
|
|
456
|
+
const installation = await selectDshNativeInstallation(input.installationId);
|
|
457
|
+
const resource = inspectDshNativeResource(installation, input.homePath, input.profilePath);
|
|
458
|
+
await authorize(subject, agentAid);
|
|
459
|
+
return { installation, resource, registryRevision: this.read().revision };
|
|
460
|
+
}
|
|
461
|
+
async register(subject, agentAid, input) {
|
|
462
|
+
await authorize(subject, agentAid);
|
|
463
|
+
if (input.scope === 'host' && agentAid !== ownerResolver.getDaemonAid())
|
|
464
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED');
|
|
465
|
+
if (input.sharingConsent !== 'native-resources')
|
|
466
|
+
fail('DSH_RESOURCE_CONSENT_REQUIRED');
|
|
467
|
+
const installation = await selectDshNativeInstallation(input.installation.installationId);
|
|
468
|
+
if (installation.revision !== input.installation.revision)
|
|
469
|
+
fail('DSH_INSTALLATION_CHANGED');
|
|
470
|
+
const resource = revalidateDshNativeResource(input.resource, installation);
|
|
471
|
+
return this.mutate(subject, agentAid, input.expectedRegistryRevision, (state, authority) => {
|
|
472
|
+
const next = { agentAid, ...authority, installation, resource, revision: randomUUID(),
|
|
473
|
+
...(input.scope === 'host' ? { scope: 'host' } : {}) };
|
|
474
|
+
// Keep prior host grants pinned for existing bindings. Changing the host
|
|
475
|
+
// default must not silently rebind already-authorized conversations.
|
|
476
|
+
if (input.scope !== 'host')
|
|
477
|
+
state.resources = state.resources.filter(record => record.agentAid !== agentAid
|
|
478
|
+
|| record.resource.nativeResourceId !== resource.nativeResourceId);
|
|
479
|
+
if (state.resources.length >= 128)
|
|
480
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
481
|
+
state.resources.push(next);
|
|
482
|
+
return structuredClone(next);
|
|
483
|
+
});
|
|
484
|
+
}
|
|
485
|
+
async revoke(subject, agentAid, nativeResourceId, expectedRegistryRevision) {
|
|
486
|
+
await this.mutate(subject, agentAid, expectedRegistryRevision, state => {
|
|
487
|
+
state.resources = state.resources.filter(record => record.agentAid !== agentAid
|
|
488
|
+
|| record.resource.nativeResourceId !== nativeResourceId);
|
|
489
|
+
});
|
|
490
|
+
}
|
|
491
|
+
async inspect(subject, agentAid) {
|
|
492
|
+
const authority = await authorize(subject, agentAid);
|
|
493
|
+
const state = this.read();
|
|
494
|
+
return { revision: state.revision, resources: structuredClone(state.resources.filter(record => record.agentAid === agentAid
|
|
495
|
+
|| record.scope === 'host' && record.agentAid === ownerResolver.getDaemonAid() && record.ownerAid === authority.ownerAid)) };
|
|
496
|
+
}
|
|
497
|
+
async profile(subject, agentAid, nativeResourceId, registrationRevision) {
|
|
498
|
+
await authorize(subject, agentAid);
|
|
499
|
+
const registration = await this.resolve(agentAid, nativeResourceId, registrationRevision);
|
|
500
|
+
const profile = await dshNativeSessionInspector.profile(registration);
|
|
501
|
+
await authorize(subject, agentAid);
|
|
502
|
+
const current = await this.resolve(agentAid, nativeResourceId, registrationRevision);
|
|
503
|
+
return { ...profile, mcpServers: profile.mcpServers.map(server => ({ ...server,
|
|
504
|
+
enabled: server.configuredEnabled && current.mcpApprovals?.[server.name] === server.fingerprint })),
|
|
505
|
+
registryRevision: this.read().revision };
|
|
506
|
+
}
|
|
507
|
+
async setMcpApprovals(subject, agentAid, input) {
|
|
508
|
+
if (input.sharingConsent !== 'native-mcp-startup' || !validMcpApprovals(input.approvals))
|
|
509
|
+
fail('DSH_MCP_CONSENT_REQUIRED');
|
|
510
|
+
const observation = await this.profile(subject, agentAid, input.nativeResourceId, input.registrationRevision);
|
|
511
|
+
if (Object.entries(input.approvals).some(([name, fingerprint]) => !observation.mcpServers.some(server => server.name === name && server.fingerprint === fingerprint && server.configuredEnabled)))
|
|
512
|
+
fail('DSH_MCP_CONFIGURATION_CHANGED');
|
|
513
|
+
await this.mutate(subject, agentAid, input.expectedRegistryRevision, state => {
|
|
514
|
+
const registration = state.resources.find(entry => entry.agentAid === agentAid
|
|
515
|
+
&& entry.resource.nativeResourceId === input.nativeResourceId && entry.revision === input.registrationRevision);
|
|
516
|
+
if (!registration)
|
|
517
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED'); // Host grants are managed only from the host.
|
|
518
|
+
registration.mcpApprovals = { ...input.approvals };
|
|
519
|
+
});
|
|
520
|
+
}
|
|
521
|
+
async discoverSessions(subject, agentAid, input) {
|
|
522
|
+
await authorize(subject, agentAid);
|
|
523
|
+
const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
524
|
+
const result = await dshNativeSessionInspector.list(registration, canonicalProject(input.projectPath), input.offset ?? 0);
|
|
525
|
+
await authorize(subject, agentAid);
|
|
526
|
+
await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
527
|
+
return result;
|
|
528
|
+
}
|
|
529
|
+
async previewSession(subject, agentAid, input) {
|
|
530
|
+
const authority = await authorize(subject, agentAid);
|
|
531
|
+
if (!validSession(input.ecSessionId) || !validSession(input.nativeSessionId))
|
|
532
|
+
fail('DSH_SESSION_BINDING_INVALID');
|
|
533
|
+
const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
534
|
+
const projectPath = canonicalProject(input.projectPath);
|
|
535
|
+
const ecRevision = await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath);
|
|
536
|
+
const observation = await dshNativeSessionInspector.inspect(registration, input.nativeSessionId, projectPath);
|
|
537
|
+
await authorize(subject, agentAid);
|
|
538
|
+
await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
539
|
+
if (await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath) !== ecRevision)
|
|
540
|
+
fail('DSH_EC_SESSION_CHANGED');
|
|
541
|
+
const state = this.read();
|
|
542
|
+
if (state.sessions.some(binding => binding.agentAid === agentAid && binding.ecSessionId === input.ecSessionId
|
|
543
|
+
|| binding.nativeResourceId === input.nativeResourceId && binding.nativeSessionId === input.nativeSessionId))
|
|
544
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
545
|
+
for (const [key, value] of sessionReceipts)
|
|
546
|
+
if (value.expiresAt <= Date.now())
|
|
547
|
+
sessionReceipts.delete(key);
|
|
548
|
+
if (sessionReceipts.size >= 256)
|
|
549
|
+
fail('DSH_SESSION_PREVIEW_LIMIT');
|
|
550
|
+
const receipt = randomBytes(32).toString('hex');
|
|
551
|
+
const expiresAt = Date.now() + SESSION_RECEIPT_TTL;
|
|
552
|
+
sessionReceipts.set(receipt, { ownerAid: authority.ownerAid, agentAid, ecSessionId: input.ecSessionId,
|
|
553
|
+
nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
|
|
554
|
+
registryRevision: state.revision, observation: structuredClone(observation), ecRevision, expiresAt });
|
|
555
|
+
return { receipt, expiresAt, registryRevision: state.revision, session: structuredClone(observation) };
|
|
556
|
+
}
|
|
557
|
+
async bindSession(subject, agentAid, input) {
|
|
558
|
+
const authority = await authorize(subject, agentAid);
|
|
559
|
+
if (input.sharingConsent !== 'native-session')
|
|
560
|
+
fail('DSH_SESSION_CONSENT_REQUIRED');
|
|
561
|
+
if (!validSession(input.ecSessionId) || !validSession(input.nativeSessionId))
|
|
562
|
+
fail('DSH_SESSION_BINDING_INVALID');
|
|
563
|
+
const projectPath = canonicalProject(input.projectPath);
|
|
564
|
+
const receipt = sessionReceipts.get(input.receipt);
|
|
565
|
+
if (!receipt || receipt.ownerAid !== authority.ownerAid || receipt.agentAid !== agentAid
|
|
566
|
+
|| receipt.ecSessionId !== input.ecSessionId || receipt.nativeResourceId !== input.nativeResourceId
|
|
567
|
+
|| receipt.registrationRevision !== input.registrationRevision || receipt.registryRevision !== input.expectedRegistryRevision
|
|
568
|
+
|| receipt.observation.nativeSessionId !== input.nativeSessionId || receipt.observation.projectPath !== projectPath) {
|
|
569
|
+
fail('DSH_SESSION_RECEIPT_INVALID');
|
|
570
|
+
}
|
|
571
|
+
// Consume synchronously before awaiting: two concurrent submissions cannot reuse a receipt.
|
|
572
|
+
sessionReceipts.delete(input.receipt);
|
|
573
|
+
if (receipt.expiresAt <= Date.now())
|
|
574
|
+
fail('DSH_SESSION_RECEIPT_EXPIRED');
|
|
575
|
+
return this.mutate(subject, agentAid, input.expectedRegistryRevision, async (state) => {
|
|
576
|
+
const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
577
|
+
const observed = await dshNativeSessionInspector.inspect(registration, input.nativeSessionId, projectPath);
|
|
578
|
+
if (receipt.expiresAt <= Date.now())
|
|
579
|
+
fail('DSH_SESSION_RECEIPT_EXPIRED');
|
|
580
|
+
if (observed.fingerprint !== receipt.observation.fingerprint)
|
|
581
|
+
fail('DSH_SESSION_CHANGED');
|
|
582
|
+
await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
|
|
583
|
+
if (await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath) !== receipt.ecRevision)
|
|
584
|
+
fail('DSH_EC_SESSION_CHANGED');
|
|
585
|
+
if (!state.resources.some(record => (record.agentAid === agentAid || record.scope === 'host'
|
|
586
|
+
&& record.agentAid === ownerResolver.getDaemonAid() && record.ownerAid === authority.ownerAid) && record.resource.nativeResourceId === input.nativeResourceId
|
|
587
|
+
&& record.revision === input.registrationRevision))
|
|
588
|
+
fail('DSH_RESOURCE_NOT_REGISTERED');
|
|
589
|
+
const current = state.sessions.find(binding => binding.agentAid === agentAid && binding.ecSessionId === input.ecSessionId);
|
|
590
|
+
if (current)
|
|
591
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
592
|
+
if (state.sessions.some(binding => binding.nativeResourceId === input.nativeResourceId
|
|
593
|
+
&& binding.nativeSessionId === input.nativeSessionId))
|
|
594
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
595
|
+
if (state.sessions.length >= 4096)
|
|
596
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
597
|
+
const binding = { agentAid, ecSessionId: input.ecSessionId,
|
|
598
|
+
nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
|
|
599
|
+
nativeSessionId: input.nativeSessionId, projectPath, revision: randomUUID() };
|
|
600
|
+
state.sessions.push(binding);
|
|
601
|
+
return structuredClone(binding);
|
|
602
|
+
});
|
|
603
|
+
}
|
|
604
|
+
async revokeSession(subject, agentAid, ecSessionId, expectedRegistryRevision) {
|
|
605
|
+
await this.mutate(subject, agentAid, expectedRegistryRevision, state => {
|
|
606
|
+
state.sessions = state.sessions.filter(binding => binding.agentAid !== agentAid || binding.ecSessionId !== ecSessionId);
|
|
607
|
+
});
|
|
608
|
+
}
|
|
609
|
+
async inspectSessions(subject, agentAid) {
|
|
610
|
+
await authorize(subject, agentAid);
|
|
611
|
+
const state = this.read();
|
|
612
|
+
return { revision: state.revision, sessions: structuredClone(state.sessions.filter(binding => binding.agentAid === agentAid)) };
|
|
613
|
+
}
|
|
614
|
+
/** Enumerate candidates only; each Agent still requires inspectSessions authorization. */
|
|
615
|
+
async sessionAgentCandidates(subject) {
|
|
616
|
+
const daemonAid = ownerResolver.getDaemonAid();
|
|
617
|
+
if (!daemonAid)
|
|
618
|
+
fail('DSH_RESOURCE_OWNER_REQUIRED');
|
|
619
|
+
await authorize(subject, daemonAid);
|
|
620
|
+
return [...new Set(this.read().sessions.map(binding => binding.agentAid))];
|
|
621
|
+
}
|
|
622
|
+
async resolveSession(agentAid, ecSessionId, expectedRevision) {
|
|
623
|
+
const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
|
|
624
|
+
if (!binding || binding.revision !== expectedRevision)
|
|
625
|
+
fail('DSH_SESSION_NOT_BOUND');
|
|
626
|
+
await this.resolve(agentAid, binding.nativeResourceId, binding.registrationRevision);
|
|
627
|
+
if (canonicalProject(binding.projectPath) !== binding.projectPath)
|
|
628
|
+
fail('DSH_SHARED_PROJECT_INVALID');
|
|
629
|
+
const latest = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
|
|
630
|
+
if (!latest || latest.revision !== binding.revision)
|
|
631
|
+
fail('DSH_SESSION_NOT_BOUND');
|
|
632
|
+
return structuredClone(binding);
|
|
633
|
+
}
|
|
634
|
+
assertSessionUnbound(agentAid, ecSessionId) {
|
|
635
|
+
if (!isValidAid(agentAid) || !validSession(ecSessionId))
|
|
636
|
+
fail('DSH_SESSION_BINDING_INVALID');
|
|
637
|
+
if (this.read().sessions.some(binding => binding.agentAid === agentAid && binding.ecSessionId === ecSessionId)) {
|
|
638
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
639
|
+
}
|
|
640
|
+
}
|
|
641
|
+
async sessionForTask(agentAid, ecSessionId) {
|
|
642
|
+
const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
|
|
643
|
+
if (!binding)
|
|
644
|
+
fail('DSH_SESSION_NOT_BOUND');
|
|
645
|
+
return this.resolveSession(agentAid, ecSessionId, binding.revision);
|
|
646
|
+
}
|
|
647
|
+
async findNativeSession(agentAid, nativeSessionId, projectPath) {
|
|
648
|
+
if (!isValidAid(agentAid) || !validSession(nativeSessionId))
|
|
649
|
+
fail('DSH_SESSION_BINDING_INVALID');
|
|
650
|
+
const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.nativeSessionId === nativeSessionId);
|
|
651
|
+
if (!binding)
|
|
652
|
+
return undefined;
|
|
653
|
+
if (canonicalProject(projectPath) !== binding.projectPath)
|
|
654
|
+
fail('DSH_SESSION_PROJECT_MISMATCH');
|
|
655
|
+
return this.resolveSession(agentAid, binding.ecSessionId, binding.revision);
|
|
656
|
+
}
|
|
657
|
+
/** Internal creation receipt: callers must obtain the ID from this task's fixed owned child. */
|
|
658
|
+
async recordCreatedSession(input) {
|
|
659
|
+
const authorizeTask = async () => {
|
|
660
|
+
const { identity, permission } = input;
|
|
661
|
+
const check = () => {
|
|
662
|
+
if (permission.selfAid !== input.agentAid || !permission.turn || !permission.revalidateExecutionIdentity
|
|
663
|
+
|| ['sessionId', 'taskId', 'turnId', 'generation'].some(key => identity[key]
|
|
664
|
+
!== permission.turn[key]))
|
|
665
|
+
fail('DSH_SHARED_TASK_AUTHORITY_REQUIRED');
|
|
666
|
+
};
|
|
667
|
+
check();
|
|
668
|
+
await assertOwnershipAuthorization(permission);
|
|
669
|
+
check();
|
|
670
|
+
};
|
|
671
|
+
if (!validSession(input.identity.sessionId) || !validSession(input.nativeSessionId))
|
|
672
|
+
fail('DSH_SESSION_BINDING_INVALID');
|
|
673
|
+
await authorizeTask();
|
|
674
|
+
await this.resolve(input.agentAid, input.nativeResourceId, input.registrationRevision);
|
|
675
|
+
const projectPath = canonicalProject(input.projectPath);
|
|
676
|
+
const file = this.file();
|
|
677
|
+
noLinks(file);
|
|
678
|
+
return withFileLock(file + '.lock', async () => {
|
|
679
|
+
await authorizeTask();
|
|
680
|
+
const registration = await this.resolve(input.agentAid, input.nativeResourceId, input.registrationRevision);
|
|
681
|
+
const state = this.read();
|
|
682
|
+
if (state.sessions.some(binding => binding.agentAid === input.agentAid && binding.ecSessionId === input.identity.sessionId
|
|
683
|
+
|| binding.nativeResourceId === input.nativeResourceId && binding.nativeSessionId === input.nativeSessionId)) {
|
|
684
|
+
fail('DSH_SESSION_ALREADY_BOUND');
|
|
685
|
+
}
|
|
686
|
+
if (state.sessions.length >= 4096)
|
|
687
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
688
|
+
const binding = { agentAid: input.agentAid, ecSessionId: input.identity.sessionId,
|
|
689
|
+
nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
|
|
690
|
+
nativeSessionId: input.nativeSessionId, projectPath, revision: randomUUID() };
|
|
691
|
+
state.sessions.push(binding);
|
|
692
|
+
state.revision = randomUUID();
|
|
693
|
+
if (Buffer.byteLength(JSON.stringify(state, null, 2) + '\n') > 1024 * 1024)
|
|
694
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
695
|
+
await atomicReplaceJson(file, state);
|
|
696
|
+
registerContent(file, JSON.stringify(state, null, 2) + '\n', registration.ownerAid);
|
|
697
|
+
return structuredClone(binding);
|
|
698
|
+
});
|
|
699
|
+
}
|
|
700
|
+
async resolve(agentAid, nativeResourceId, expectedRevision) {
|
|
701
|
+
if (!isValidAid(agentAid) || !/^dsh-resource-[a-f0-9]{64}$/.test(nativeResourceId))
|
|
702
|
+
fail('DSH_RESOURCE_NOT_REGISTERED');
|
|
703
|
+
const eligible = (record) => record.resource.nativeResourceId === nativeResourceId
|
|
704
|
+
&& record.revision === expectedRevision && (record.agentAid === agentAid
|
|
705
|
+
|| record.scope === 'host' && record.agentAid === ownerResolver.getDaemonAid());
|
|
706
|
+
const current = this.read().resources.find(eligible);
|
|
707
|
+
if (!current || current.revision !== expectedRevision)
|
|
708
|
+
fail('DSH_RESOURCE_NOT_REGISTERED');
|
|
709
|
+
await refreshOwnershipForAuthorization(agentAid, { includeDaemon: true, allowTransient: false });
|
|
710
|
+
const authority = ownership(agentAid, current.ownerAid);
|
|
711
|
+
if (current.scope !== 'host' && authority.agentOwnershipVersion !== current.agentOwnershipVersion
|
|
712
|
+
|| authority.daemonOwnershipVersion !== current.daemonOwnershipVersion)
|
|
713
|
+
fail('DSH_RESOURCE_CONSENT_EXPIRED');
|
|
714
|
+
const installation = revalidateDshNativeInstallation(current.installation);
|
|
715
|
+
const resource = revalidateDshNativeResource(current.resource, installation);
|
|
716
|
+
const latest = this.read().resources.find(eligible);
|
|
717
|
+
if (!latest || latest.revision !== current.revision)
|
|
718
|
+
fail('DSH_RESOURCE_NOT_REGISTERED');
|
|
719
|
+
ownership(agentAid, current.ownerAid);
|
|
720
|
+
return structuredClone({ ...latest, agentAid, agentOwnershipVersion: authority.agentOwnershipVersion, installation, resource });
|
|
721
|
+
}
|
|
722
|
+
async mutate(subject, agentAid, expectedRevision, change) {
|
|
723
|
+
await authorize(subject, agentAid);
|
|
724
|
+
const file = this.file();
|
|
725
|
+
noLinks(file);
|
|
726
|
+
return withFileLock(file + '.lock', async () => {
|
|
727
|
+
noLinks(file);
|
|
728
|
+
const authority = await authorize(subject, agentAid);
|
|
729
|
+
const state = this.read();
|
|
730
|
+
if (state.revision !== expectedRevision)
|
|
731
|
+
fail('DSH_REGISTRY_REVISION_CONFLICT');
|
|
732
|
+
const result = await change(state, authority);
|
|
733
|
+
const latestAuthority = await authorize(subject, agentAid);
|
|
734
|
+
if (JSON.stringify(latestAuthority) !== JSON.stringify(authority))
|
|
735
|
+
fail('DSH_RESOURCE_CONSENT_EXPIRED');
|
|
736
|
+
if (this.read().revision !== expectedRevision)
|
|
737
|
+
fail('DSH_REGISTRY_REVISION_CONFLICT');
|
|
738
|
+
state.revision = randomUUID();
|
|
739
|
+
if (Buffer.byteLength(JSON.stringify(state, null, 2) + '\n') > 1024 * 1024)
|
|
740
|
+
fail('DSH_REGISTRY_LIMIT');
|
|
741
|
+
await atomicReplaceJson(file, state);
|
|
742
|
+
registerContent(file, JSON.stringify(state, null, 2) + '\n', authority.ownerAid);
|
|
743
|
+
return result;
|
|
744
|
+
});
|
|
745
|
+
}
|
|
746
|
+
}
|
|
747
|
+
/** Catalog reads use the same resource and ownership checks as execution. */
|
|
748
|
+
export async function getDshNativeCatalog(config, aid) {
|
|
749
|
+
const principal = aid ?? ownerResolver.getDaemonAid();
|
|
750
|
+
if (!principal || typeof config.nativeResourceId !== 'string' || typeof config.nativeRegistrationRevision !== 'string') {
|
|
751
|
+
throw new Error('DSH_RESOURCE_NOT_REGISTERED');
|
|
752
|
+
}
|
|
753
|
+
const registration = await new DshNativeResourceRegistry().resolve(principal, config.nativeResourceId, config.nativeRegistrationRevision);
|
|
754
|
+
return dshNativeSessionInspector.catalog(registration);
|
|
755
|
+
}
|