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,4 +1,5 @@
|
|
|
1
1
|
import { createHash } from 'node:crypto';
|
|
2
|
+
import Ajv from 'ajv';
|
|
2
3
|
/** The wire profile currently implemented by EvolApp's ability host. */
|
|
3
4
|
export const ABILITY_SPEC_VERSION = 'aid-ability/2';
|
|
4
5
|
export const ABILITY_INDEX_SCHEMA = 'aun.ability.index.v1';
|
|
@@ -8,14 +9,17 @@ const PATH_RE = /^[a-z][a-z0-9_-]*(\/[a-z][a-z0-9_-]*)+$/;
|
|
|
8
9
|
const DEFINITION_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
|
|
9
10
|
const RELEASE_ID_RE = /^[a-f0-9]{64}$/;
|
|
10
11
|
const SEMVER_RE = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/;
|
|
11
|
-
|
|
12
|
-
// `checkSchemaProfile`. Keeping the allow-list here prevents Core from
|
|
13
|
-
// accepting a definition which the Flutter host would reject at registration.
|
|
14
|
-
const SCHEMA_KEYWORDS = new Set([
|
|
12
|
+
const LOCAL_SCHEMA_KEYWORDS = new Set([
|
|
15
13
|
'type', 'properties', 'required', 'additionalProperties', 'items', 'enum',
|
|
16
|
-
'const', 'minimum', 'maximum', 'minLength', 'maxLength', '
|
|
17
|
-
'maxItems', 'description', 'default', 'untrusted_text',
|
|
14
|
+
'const', 'minimum', 'maximum', 'minLength', 'maxLength', 'pattern',
|
|
15
|
+
'minItems', 'maxItems', 'description', 'default', 'untrusted_text',
|
|
18
16
|
]);
|
|
17
|
+
// The schema profile Core can validate locally. It is enforced only when
|
|
18
|
+
// publishing a local plugin (`profile: 'strict'`). Reading a Provider's
|
|
19
|
+
// contract must never reject it for using a keyword this build doesn't know:
|
|
20
|
+
// the Provider owns its schema, and the caller has no vote over it.
|
|
21
|
+
const schemaValidator = new Ajv({ allErrors: true, strict: false, useDefaults: false, coerceTypes: false,
|
|
22
|
+
removeAdditional: false, addUsedSchema: false });
|
|
19
23
|
const TRANSPORT_FIELDS = new Set([
|
|
20
24
|
'device_id', 'slot_id', 'runtime_ref', 'target_runtime_ref',
|
|
21
25
|
'sender_slot_id', 'to_device_id',
|
|
@@ -188,46 +192,95 @@ function validateEffects(value) {
|
|
|
188
192
|
fail('duplicate effects', 'contract_invalid', 'effects');
|
|
189
193
|
return effects;
|
|
190
194
|
}
|
|
191
|
-
function validateSchemaProfile(value, path = 'schema') {
|
|
195
|
+
function validateSchemaProfile(value, path = 'schema', profile = 'strict') {
|
|
192
196
|
const schema = requiredRecord(value, path);
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
197
|
+
try {
|
|
198
|
+
const inspect = (node, nodePath) => {
|
|
199
|
+
if (Array.isArray(node)) {
|
|
200
|
+
node.forEach((child, index) => inspect(child, `${nodePath}[${index}]`));
|
|
201
|
+
return;
|
|
202
|
+
}
|
|
203
|
+
if (!isJsonObject(node))
|
|
204
|
+
return;
|
|
205
|
+
if (profile === 'strict') {
|
|
206
|
+
if (Object.keys(node).some(key => !LOCAL_SCHEMA_KEYWORDS.has(key))) {
|
|
207
|
+
fail('unsupported schema keyword', 'contract_invalid', nodePath);
|
|
208
|
+
}
|
|
209
|
+
if (typeof node.type !== 'string' || !['object', 'array', 'string', 'integer', 'boolean', 'null'].includes(node.type)) {
|
|
210
|
+
fail('unsupported schema type', 'contract_invalid', `${nodePath}.type`);
|
|
211
|
+
}
|
|
212
|
+
if (node.additionalProperties !== undefined && typeof node.additionalProperties !== 'boolean') {
|
|
213
|
+
fail('additionalProperties must be boolean', 'contract_invalid', `${nodePath}.additionalProperties`);
|
|
214
|
+
}
|
|
215
|
+
if (node.properties !== undefined && !isJsonObject(node.properties))
|
|
216
|
+
fail('properties must be an object', 'contract_invalid', `${nodePath}.properties`);
|
|
217
|
+
if (node.required !== undefined && (!Array.isArray(node.required) || node.required.some(item => typeof item !== 'string'))) {
|
|
218
|
+
fail('required must be an array of strings', 'contract_invalid', `${nodePath}.required`);
|
|
219
|
+
}
|
|
220
|
+
for (const key of ['enum', 'required'])
|
|
221
|
+
if (node[key] !== undefined && !Array.isArray(node[key])) {
|
|
222
|
+
fail(`${key} must be an array`, 'contract_invalid', `${nodePath}.${key}`);
|
|
223
|
+
}
|
|
224
|
+
for (const key of ['minimum', 'maximum', 'minLength', 'maxLength', 'minItems', 'maxItems']) {
|
|
225
|
+
if (node[key] !== undefined && (typeof node[key] !== 'number' || !Number.isSafeInteger(node[key]))) {
|
|
226
|
+
fail(`${key} must be an integer`, 'contract_invalid', `${nodePath}.${key}`);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
if (node.items !== undefined && !isJsonObject(node.items))
|
|
230
|
+
fail('items must be a schema object', 'contract_invalid', `${nodePath}.items`);
|
|
231
|
+
}
|
|
232
|
+
if (node.$schema !== undefined && node.$schema !== 'http://json-schema.org/draft-07/schema#') {
|
|
233
|
+
fail('Only JSON Schema Draft-07 is supported', 'contract_invalid', `${nodePath}.$schema`);
|
|
234
|
+
}
|
|
235
|
+
if (node.$ref !== undefined && (typeof node.$ref !== 'string' || !(node.$ref === '#' || node.$ref.startsWith('#/')))) {
|
|
236
|
+
fail('Only local JSON Schema references are supported', 'contract_invalid', `${nodePath}.$ref`);
|
|
237
|
+
}
|
|
238
|
+
if (profile === 'strict' && node.pattern !== undefined
|
|
239
|
+
&& (node.type !== 'string' || typeof node.pattern !== 'string')) {
|
|
240
|
+
fail('pattern requires a string type', 'contract_invalid', `${nodePath}.pattern`);
|
|
241
|
+
}
|
|
242
|
+
if (typeof node.pattern === 'string') {
|
|
243
|
+
try {
|
|
244
|
+
new RegExp(node.pattern, 'u');
|
|
245
|
+
}
|
|
246
|
+
catch {
|
|
247
|
+
fail('invalid pattern', 'contract_invalid', `${nodePath}.pattern`);
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
for (const key of ['properties', 'patternProperties', 'definitions']) {
|
|
251
|
+
if (isJsonObject(node[key]))
|
|
252
|
+
for (const [name, child] of Object.entries(node[key]))
|
|
253
|
+
inspect(child, `${nodePath}.${key}.${name}`);
|
|
254
|
+
}
|
|
255
|
+
for (const key of ['items', 'additionalProperties', 'propertyNames', 'contains', 'not', 'if', 'then', 'else']) {
|
|
256
|
+
if (isJsonObject(node[key]) || Array.isArray(node[key]))
|
|
257
|
+
inspect(node[key], `${nodePath}.${key}`);
|
|
258
|
+
}
|
|
259
|
+
for (const key of ['allOf', 'anyOf', 'oneOf'])
|
|
260
|
+
if (Array.isArray(node[key]))
|
|
261
|
+
inspect(node[key], `${nodePath}.${key}`);
|
|
262
|
+
if (isJsonObject(node.dependencies))
|
|
263
|
+
for (const [name, child] of Object.entries(node.dependencies)) {
|
|
264
|
+
if (isJsonObject(child))
|
|
265
|
+
inspect(child, `${nodePath}.dependencies.${name}`);
|
|
266
|
+
}
|
|
267
|
+
};
|
|
268
|
+
inspect(schema, path);
|
|
269
|
+
if (profile === 'strict' && !schemaValidator.validateSchema(schema)) {
|
|
270
|
+
const error = schemaValidator.errors?.[0];
|
|
271
|
+
fail(error?.message ?? 'invalid JSON Schema', 'contract_invalid', `${path}${error?.instancePath ?? ''}`);
|
|
218
272
|
}
|
|
273
|
+
schemaValidator.compile(schema);
|
|
219
274
|
}
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
275
|
+
catch (error) {
|
|
276
|
+
if (error instanceof AbilityProtocolError)
|
|
277
|
+
throw error;
|
|
278
|
+
fail(error instanceof Error ? error.message : 'invalid JSON Schema', 'contract_invalid', path);
|
|
224
279
|
}
|
|
225
|
-
if (schema.items !== undefined)
|
|
226
|
-
validateSchemaProfile(schema.items, `${path}.items`);
|
|
227
280
|
return schema;
|
|
228
281
|
}
|
|
229
282
|
/** Validate an EvolApp definition object read from the public L3 path. */
|
|
230
|
-
export function parseAbilityDefinition(value, expected) {
|
|
283
|
+
export function parseAbilityDefinition(value, expected, profile = 'strict') {
|
|
231
284
|
const d = requiredRecord(value, 'definition');
|
|
232
285
|
const path = requiredPath(d.path, 'path');
|
|
233
286
|
if (path.startsWith('protocol/'))
|
|
@@ -245,8 +298,8 @@ export function parseAbilityDefinition(value, expected) {
|
|
|
245
298
|
const retention = requiredInteger(d.dedupe_retention_seconds, 'dedupe_retention_seconds');
|
|
246
299
|
if (retention < 1)
|
|
247
300
|
fail('invalid dedupe retention', 'contract_invalid', 'dedupe_retention_seconds');
|
|
248
|
-
const paramsSchema = validateSchemaProfile(d.params_schema, 'params_schema');
|
|
249
|
-
const resultSchema = validateSchemaProfile(d.result_schema, 'result_schema');
|
|
301
|
+
const paramsSchema = validateSchemaProfile(d.params_schema, 'params_schema', profile);
|
|
302
|
+
const resultSchema = validateSchemaProfile(d.result_schema, 'result_schema', profile);
|
|
250
303
|
return {
|
|
251
304
|
...d, path, definition_id: definitionId, params_schema: paramsSchema,
|
|
252
305
|
result_schema: resultSchema, effects, require_confirm: true,
|
|
@@ -254,67 +307,45 @@ export function parseAbilityDefinition(value, expected) {
|
|
|
254
307
|
aggregation: 'none', dedupe_retention_seconds: retention,
|
|
255
308
|
};
|
|
256
309
|
}
|
|
257
|
-
function
|
|
258
|
-
const
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
fail(`example array is too long`, 'contract_invalid', path);
|
|
297
|
-
if (isJsonObject(schema.items))
|
|
298
|
-
array.forEach((item, index) => validateSchemaValue(schema.items, item, `${path}[${index}]`));
|
|
299
|
-
}
|
|
300
|
-
else if (type === 'string') {
|
|
301
|
-
const length = [...value].length;
|
|
302
|
-
if (typeof schema.minLength === 'number' && length < schema.minLength)
|
|
303
|
-
fail(`example string is too short`, 'contract_invalid', path);
|
|
304
|
-
if (typeof schema.maxLength === 'number' && length > schema.maxLength)
|
|
305
|
-
fail(`example string is too long`, 'contract_invalid', path);
|
|
306
|
-
}
|
|
307
|
-
else if (type === 'integer') {
|
|
308
|
-
if (typeof schema.minimum === 'number' && value < schema.minimum)
|
|
309
|
-
fail(`example is below minimum`, 'contract_invalid', path);
|
|
310
|
-
if (typeof schema.maximum === 'number' && value > schema.maximum)
|
|
311
|
-
fail(`example is above maximum`, 'contract_invalid', path);
|
|
312
|
-
}
|
|
313
|
-
}
|
|
314
|
-
/** Shared Caller-side value validation using the supported wire Schema profile. */
|
|
315
|
-
export function validateAbilityValue(schema, value) {
|
|
316
|
-
validateSchemaProfile(schema);
|
|
317
|
-
validateSchemaValue(schema, value, 'value');
|
|
310
|
+
function schemaErrorPath(errors) {
|
|
311
|
+
const error = errors?.[0];
|
|
312
|
+
if (!error)
|
|
313
|
+
return undefined;
|
|
314
|
+
const pointer = `${error.instancePath || ''}${error.params && 'missingProperty' in error.params ? `/${String(error.params.missingProperty)}` : ''}`;
|
|
315
|
+
const fields = pointer.split('/').slice(1).map(part => part.replace(/~1/g, '/').replace(/~0/g, '~'));
|
|
316
|
+
return fields.length ? `value.${fields.join('.')}` : undefined;
|
|
317
|
+
}
|
|
318
|
+
function schemaAtError(schema, error) {
|
|
319
|
+
if (!error?.schemaPath?.startsWith('#/'))
|
|
320
|
+
return undefined;
|
|
321
|
+
let current = schema;
|
|
322
|
+
for (const part of error.schemaPath.slice(2).split('/').slice(0, -1)) {
|
|
323
|
+
const token = part.replace(/~1/g, '/').replace(/~0/g, '~');
|
|
324
|
+
current = Array.isArray(current) ? current[Number(token)] : current?.[token];
|
|
325
|
+
}
|
|
326
|
+
return current && typeof current === 'object' ? current : undefined;
|
|
327
|
+
}
|
|
328
|
+
function validateSchemaValue(schema, value, path, profile = 'strict') {
|
|
329
|
+
validateSchemaProfile(schema, path, profile);
|
|
330
|
+
const validate = schemaValidator.compile(schema);
|
|
331
|
+
if (!validate(value)) {
|
|
332
|
+
const error = validate.errors?.[0];
|
|
333
|
+
const errorSchema = schemaAtError(schema, error);
|
|
334
|
+
const expected = errorSchema?.const !== undefined ? JSON.stringify(errorSchema.const)
|
|
335
|
+
: Array.isArray(errorSchema?.enum) ? JSON.stringify(errorSchema.enum) : undefined;
|
|
336
|
+
const detail = expected ? `must be one of ${expected}` : error?.message ?? 'does not match the contract';
|
|
337
|
+
fail(`Value ${schemaErrorPath(validate.errors) ?? path} ${detail}`, 'contract_invalid', schemaErrorPath(validate.errors) ?? path);
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
/**
|
|
341
|
+
* Best-effort local check of a value against a Provider's schema. It reports
|
|
342
|
+
* what this build can interpret; anything it cannot interpret is skipped, and
|
|
343
|
+
* the Provider remains the authority. A false pass costs one round trip; a
|
|
344
|
+
* false reject would refuse a call the Provider would have accepted.
|
|
345
|
+
*/
|
|
346
|
+
export function validateAbilityValue(schema, value, profile = 'lenient') {
|
|
347
|
+
validateSchemaProfile(schema, 'schema', profile);
|
|
348
|
+
validateSchemaValue(schema, value, 'value', profile);
|
|
318
349
|
}
|
|
319
350
|
function canonicalJson(value) {
|
|
320
351
|
if (value === null || typeof value === 'string' || typeof value === 'boolean')
|
|
@@ -337,16 +368,25 @@ export function canonicalizeAbilityJson(value) {
|
|
|
337
368
|
export function sha256Hex(value) {
|
|
338
369
|
return createHash('sha256').update(value, 'utf8').digest('hex');
|
|
339
370
|
}
|
|
340
|
-
/**
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
371
|
+
/**
|
|
372
|
+
* Match AbilityRelease.id from EvolApp (SHA-256 over canonical release content).
|
|
373
|
+
* EvolApp includes the release-level `authorization` block in the digest when it
|
|
374
|
+
* is present; older releases without it digest plugin_version/definition/usage only.
|
|
375
|
+
*/
|
|
376
|
+
export function abilityReleaseId(pluginVersion, definition, usage, authorization) {
|
|
377
|
+
return sha256Hex(canonicalJson(authorization === undefined
|
|
378
|
+
? { plugin_version: pluginVersion, definition, usage }
|
|
379
|
+
: { authorization, plugin_version: pluginVersion, definition, usage }));
|
|
380
|
+
}
|
|
381
|
+
export function parseAbilityRelease(value, expected, profile = 'strict') {
|
|
345
382
|
const snapshot = requiredRecord(value, 'release');
|
|
346
|
-
if (snapshot.schema !== ABILITY_RELEASE_SCHEMA
|
|
383
|
+
if (snapshot.schema !== ABILITY_RELEASE_SCHEMA && snapshot.schema !== 'aun.ability.release.v2') {
|
|
384
|
+
fail('unsupported release schema', 'contract_invalid', 'schema');
|
|
385
|
+
}
|
|
386
|
+
if (typeof snapshot.plugin_version !== 'string' || !SEMVER_RE.test(snapshot.plugin_version)) {
|
|
347
387
|
fail('invalid release snapshot', 'contract_invalid');
|
|
348
388
|
}
|
|
349
|
-
const definition = parseAbilityDefinition(snapshot.definition, expected);
|
|
389
|
+
const definition = parseAbilityDefinition(snapshot.definition, expected, profile);
|
|
350
390
|
const usage = requiredRecord(snapshot.usage, 'usage');
|
|
351
391
|
if (usage.schema !== ABILITY_USAGE_SCHEMA || usage.path !== definition.path || usage.definition_id !== definition.definition_id
|
|
352
392
|
|| !Array.isArray(usage.examples) || usage.examples.length === 0
|
|
@@ -356,15 +396,18 @@ export function parseAbilityRelease(value, expected) {
|
|
|
356
396
|
fail('release usage does not match definition', 'contract_invalid', 'usage');
|
|
357
397
|
}
|
|
358
398
|
for (const [index, example] of usage.examples.entries()) {
|
|
359
|
-
validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params
|
|
399
|
+
validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`, profile);
|
|
360
400
|
}
|
|
361
401
|
const releaseId = validateReleaseId(snapshot.release_id);
|
|
362
|
-
const
|
|
402
|
+
const authorization = snapshot.authorization === undefined ? undefined : requiredRecord(snapshot.authorization, 'authorization');
|
|
403
|
+
if (snapshot.schema === 'aun.ability.release.v2' && !authorization)
|
|
404
|
+
fail('v2 release requires authorization', 'contract_invalid', 'authorization');
|
|
405
|
+
const calculated = abilityReleaseId(snapshot.plugin_version, definition, usage, authorization);
|
|
363
406
|
if (releaseId !== calculated)
|
|
364
407
|
fail('release_id does not match snapshot content', 'contract_invalid', 'release_id');
|
|
365
408
|
return {
|
|
366
|
-
schema:
|
|
367
|
-
release_id: releaseId, definition, usage,
|
|
409
|
+
schema: snapshot.schema, plugin_version: snapshot.plugin_version,
|
|
410
|
+
release_id: releaseId, definition, usage, ...(authorization ? { authorization } : {}),
|
|
368
411
|
};
|
|
369
412
|
}
|
|
370
413
|
export function parseAbilityIndex(value, expectedPublisher) {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import { createHash, randomUUID } from 'node:crypto';
|
|
4
|
-
import { atomicWriteJson
|
|
4
|
+
import { atomicWriteJson } from '../utils/atomic-write.js';
|
|
5
5
|
import { resolveRoot } from '../paths.js';
|
|
6
6
|
import { templateError } from './types.js';
|
|
7
7
|
export const TEMPLATE_JOB_ID = /^job_[a-f0-9-]{36}$/;
|
|
@@ -48,7 +48,7 @@ export function recordTemplateNoticeReceipt(root, noticeId, ownerAid, messageId,
|
|
|
48
48
|
throw templateError('INVALID_ARGUMENT', 'Invalid update notice receipt');
|
|
49
49
|
const jobs = new TemplateJobs(root);
|
|
50
50
|
const file = path.join(jobs.directory, 'notifications', noticeId + '.json');
|
|
51
|
-
jobs.
|
|
51
|
+
jobs.assertStatePath(file);
|
|
52
52
|
if (!fs.existsSync(file))
|
|
53
53
|
return;
|
|
54
54
|
const notice = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
@@ -93,8 +93,9 @@ export class TemplateJobs {
|
|
|
93
93
|
throw templateError('CONFLICT', 'Template job revision changed', { jobId: job.jobId });
|
|
94
94
|
}
|
|
95
95
|
if (!current.committed && job.committed && (current.status !== 'running' || !current.activating
|
|
96
|
-
|| job.status !== 'succeeded' || !Object.
|
|
97
|
-
|| job.checkpoint.installMode === 'overwrite' && job.checkpoint.runtimeInactive === true
|
|
96
|
+
|| job.status !== 'succeeded' || !Object.entries(job.members).every(([key, member]) => member.runtimeReady
|
|
97
|
+
|| job.checkpoint.installMode === 'overwrite' && job.checkpoint.runtimeInactive === true
|
|
98
|
+
|| job.checkpoint.modelUnavailable?.includes(key)))) {
|
|
98
99
|
throw templateError('CONFLICT', 'Only the current prepared deployment can commit');
|
|
99
100
|
}
|
|
100
101
|
}
|
|
@@ -114,8 +115,10 @@ export class TemplateJobs {
|
|
|
114
115
|
requestMatches(actor, requestId, action, args) {
|
|
115
116
|
const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
|
|
116
117
|
const fingerprint = templateFingerprint({ action, args });
|
|
117
|
-
|
|
118
|
-
|
|
118
|
+
if (fs.existsSync(file))
|
|
119
|
+
return JSON.parse(fs.readFileSync(file, 'utf8')).fingerprint === fingerprint;
|
|
120
|
+
const original = this.original(actor, requestId);
|
|
121
|
+
return original?.fingerprint === fingerprint;
|
|
119
122
|
}
|
|
120
123
|
bindRequest(actor, requestId, action, args, jobId) {
|
|
121
124
|
const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
|
|
@@ -186,7 +189,7 @@ export class TemplateJobs {
|
|
|
186
189
|
if (!/^[a-z0-9][a-z0-9_-]*(\.[a-z0-9-]+)+$/.test(aid))
|
|
187
190
|
throw templateError('INVALID_ARGUMENT', 'Invalid target AID');
|
|
188
191
|
const file = path.join(this.root, 'agents', aid, 'template.lock.json');
|
|
189
|
-
this.
|
|
192
|
+
this.assertStatePath(file);
|
|
190
193
|
return file;
|
|
191
194
|
}
|
|
192
195
|
/** A staged lock never exposes its candidate as an installed version before commit. */
|
|
@@ -208,121 +211,22 @@ export class TemplateJobs {
|
|
|
208
211
|
}
|
|
209
212
|
return value;
|
|
210
213
|
}
|
|
211
|
-
/** The slot reservation and request/job link share a cross-process admission lock. */
|
|
212
|
-
withTeams(run) {
|
|
213
|
-
this.assertTeamPath(path.join(this.directory, 'teams', 'state.lock'));
|
|
214
|
-
return withFileLock(path.join(this.directory, 'teams', 'state.lock'), run);
|
|
215
|
-
}
|
|
216
|
-
teamFile(id) {
|
|
217
|
-
if (!/^team_[a-f0-9]{64}$/.test(id))
|
|
218
|
-
throw templateError('INVALID_ARGUMENT', 'Invalid instanceId');
|
|
219
|
-
const file = path.join(this.directory, 'teams', id, 'instance.json');
|
|
220
|
-
this.assertTeamPath(file);
|
|
221
|
-
return file;
|
|
222
|
-
}
|
|
223
|
-
listTeams() {
|
|
224
|
-
const directory = path.join(this.directory, 'teams');
|
|
225
|
-
if (!fs.existsSync(directory))
|
|
226
|
-
return [];
|
|
227
|
-
return fs.readdirSync(directory, { withFileTypes: true }).filter(entry => /^team_[a-f0-9]{64}$/.test(entry.name))
|
|
228
|
-
.map(entry => {
|
|
229
|
-
this.assertTeamPath(path.join(directory, entry.name, 'instance.json'));
|
|
230
|
-
return this.readTeam(entry.name);
|
|
231
|
-
});
|
|
232
|
-
}
|
|
233
214
|
/** Fixed paths below the runtime root cannot traverse links or non-directory ancestors. */
|
|
234
|
-
|
|
215
|
+
assertStatePath(file) {
|
|
235
216
|
const root = path.resolve(this.root);
|
|
236
217
|
const target = path.resolve(file);
|
|
237
218
|
const relative = path.relative(root, target);
|
|
238
219
|
if (relative.startsWith('..' + path.sep) || relative === '..' || path.isAbsolute(relative))
|
|
239
|
-
throw templateError('
|
|
220
|
+
throw templateError('UNSAFE_TEMPLATE_PATH', 'Template state leaves the runtime root');
|
|
240
221
|
let current = root;
|
|
241
222
|
for (const segment of ['', ...relative.split(path.sep)]) {
|
|
242
223
|
current = segment ? path.join(current, segment) : current;
|
|
243
224
|
const stat = fs.lstatSync(current, { throwIfNoEntry: false });
|
|
244
225
|
if (stat?.isSymbolicLink() || stat && current !== target && !stat.isDirectory()) {
|
|
245
|
-
throw templateError('
|
|
226
|
+
throw templateError('UNSAFE_TEMPLATE_PATH', 'Template paths must use ordinary directories and files');
|
|
246
227
|
}
|
|
247
228
|
}
|
|
248
229
|
}
|
|
249
|
-
definitionFiles() {
|
|
250
|
-
const directory = path.join(this.directory, 'team-definitions');
|
|
251
|
-
this.assertTeamPath(directory);
|
|
252
|
-
if (!fs.existsSync(directory))
|
|
253
|
-
return [];
|
|
254
|
-
if (!fs.lstatSync(directory).isDirectory())
|
|
255
|
-
throw templateError('UNSAFE_DEFINITION_PATH', 'Team definitions must be a directory');
|
|
256
|
-
const files = fs.readdirSync(directory).filter(name => name.endsWith('.json')).sort();
|
|
257
|
-
if (files.length > 1000)
|
|
258
|
-
throw templateError('INVALID_ARGUMENT', 'Too many Team definitions');
|
|
259
|
-
return files;
|
|
260
|
-
}
|
|
261
|
-
readDefinition(file) {
|
|
262
|
-
if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.json$/.test(file))
|
|
263
|
-
throw templateError('UNSAFE_DEFINITION_PATH', 'Invalid Team definition filename');
|
|
264
|
-
const target = path.join(this.directory, 'team-definitions', file);
|
|
265
|
-
this.assertTeamPath(target);
|
|
266
|
-
const before = fs.lstatSync(target);
|
|
267
|
-
if (!before.isFile() || before.nlink !== 1 || before.size > 1024 * 1024)
|
|
268
|
-
throw templateError('UNSAFE_DEFINITION_PATH', 'A bounded ordinary Team definition file is required');
|
|
269
|
-
if (process.platform !== 'win32' && (before.mode & 0o077) !== 0)
|
|
270
|
-
throw templateError('UNSAFE_DEFINITION_PERMISSIONS', 'Team definition must be private (0600)');
|
|
271
|
-
const handle = fs.openSync(target, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
|
|
272
|
-
try {
|
|
273
|
-
const opened = fs.fstatSync(handle);
|
|
274
|
-
if (before.ino !== opened.ino || before.dev !== opened.dev)
|
|
275
|
-
throw templateError('SOURCE_CHANGED', 'Team definition changed while opening');
|
|
276
|
-
const content = fs.readFileSync(handle, 'utf8');
|
|
277
|
-
const after = fs.fstatSync(handle);
|
|
278
|
-
this.assertTeamPath(target);
|
|
279
|
-
const present = fs.lstatSync(target);
|
|
280
|
-
if (after.size !== before.size || after.mtimeMs !== before.mtimeMs || after.ctimeMs !== before.ctimeMs
|
|
281
|
-
|| present.ino !== after.ino || present.dev !== after.dev)
|
|
282
|
-
throw templateError('SOURCE_CHANGED', 'Team definition changed while reading');
|
|
283
|
-
return JSON.parse(content);
|
|
284
|
-
}
|
|
285
|
-
finally {
|
|
286
|
-
fs.closeSync(handle);
|
|
287
|
-
}
|
|
288
|
-
}
|
|
289
|
-
readTeam(id) {
|
|
290
|
-
const file = this.teamFile(id);
|
|
291
|
-
if (!fs.existsSync(file))
|
|
292
|
-
throw templateError('NOT_FOUND', 'Team instance not found');
|
|
293
|
-
const value = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
294
|
-
if (value.version !== 1 || value.instanceId !== id || !Array.isArray(value.members)
|
|
295
|
-
|| !/^sha256:[a-f0-9]{64}$/.test(value.revision))
|
|
296
|
-
throw templateError('RECOVERY_REQUIRED', 'Invalid team instance');
|
|
297
|
-
return value;
|
|
298
|
-
}
|
|
299
|
-
saveTeam(team, expectedRevision) {
|
|
300
|
-
const file = this.teamFile(team.instanceId);
|
|
301
|
-
if (fs.existsSync(file) && this.readTeam(team.instanceId).revision !== expectedRevision) {
|
|
302
|
-
throw templateError('CONFLICT', 'Team revision changed');
|
|
303
|
-
}
|
|
304
|
-
const { revision: _revision, ...content } = team;
|
|
305
|
-
team.updatedAt = Date.now();
|
|
306
|
-
team.revision = 'sha256:' + templateFingerprint({ ...content, updatedAt: team.updatedAt });
|
|
307
|
-
writeTemplateState(file, team);
|
|
308
|
-
}
|
|
309
|
-
installFile(id) {
|
|
310
|
-
if (!/^member_install_[a-f0-9-]{36}$/.test(id))
|
|
311
|
-
throw templateError('INVALID_ARGUMENT', 'Invalid memberInstallId');
|
|
312
|
-
return path.join(this.directory, 'member-installs', id + '.json');
|
|
313
|
-
}
|
|
314
|
-
readMemberInstall(actor, id) {
|
|
315
|
-
const file = this.installFile(id);
|
|
316
|
-
if (!fs.existsSync(file))
|
|
317
|
-
throw templateError('NOT_FOUND', 'Member installation not found');
|
|
318
|
-
const value = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
319
|
-
if (value.memberInstallId !== id || value.actor !== actor)
|
|
320
|
-
throw templateError('NOT_FOUND', 'Member installation not found');
|
|
321
|
-
return value;
|
|
322
|
-
}
|
|
323
|
-
saveMemberInstall(value) {
|
|
324
|
-
writeTemplateState(this.installFile(value.memberInstallId), value);
|
|
325
|
-
}
|
|
326
230
|
}
|
|
327
231
|
/** Durable installation associations are checked before ordinary task dispatch. */
|
|
328
232
|
export function templateInstallationGate(aid, expectedJobId, root = resolveRoot()) {
|
|
@@ -346,7 +250,7 @@ export function templateInstallationGate(aid, expectedJobId, root = resolveRoot(
|
|
|
346
250
|
}
|
|
347
251
|
}
|
|
348
252
|
const job = new TemplateJobs(root).read(link.jobId);
|
|
349
|
-
if (job.action
|
|
253
|
+
if (!['deploy', 'upgrade'].includes(job.action) || !Object.values(job.members).some(member => member.aid === aid))
|
|
350
254
|
throw new Error('Invalid member');
|
|
351
255
|
return { jobId: job.jobId, blocked: job.committed !== true && job.checkpoint.restored !== true,
|
|
352
256
|
activating: job.status === 'running' && job.activating === true, executing: job.status === 'running' };
|