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
|
@@ -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,60 +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
|
-
array.forEach((item, index) => validateSchemaValue(schema.items, item, `${path}[${index}]`));
|
|
297
|
-
}
|
|
298
|
-
else if (type === 'string') {
|
|
299
|
-
const length = [...value].length;
|
|
300
|
-
if (typeof schema.minLength === 'number' && length < schema.minLength)
|
|
301
|
-
fail(`example string is too short`, 'contract_invalid', path);
|
|
302
|
-
if (typeof schema.maxLength === 'number' && length > schema.maxLength)
|
|
303
|
-
fail(`example string is too long`, 'contract_invalid', path);
|
|
304
|
-
}
|
|
305
|
-
else if (type === 'integer') {
|
|
306
|
-
if (typeof schema.minimum === 'number' && value < schema.minimum)
|
|
307
|
-
fail(`example is below minimum`, 'contract_invalid', path);
|
|
308
|
-
if (typeof schema.maximum === 'number' && value > schema.maximum)
|
|
309
|
-
fail(`example is above maximum`, 'contract_invalid', path);
|
|
310
|
-
}
|
|
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);
|
|
311
349
|
}
|
|
312
350
|
function canonicalJson(value) {
|
|
313
351
|
if (value === null || typeof value === 'string' || typeof value === 'boolean')
|
|
@@ -330,16 +368,25 @@ export function canonicalizeAbilityJson(value) {
|
|
|
330
368
|
export function sha256Hex(value) {
|
|
331
369
|
return createHash('sha256').update(value, 'utf8').digest('hex');
|
|
332
370
|
}
|
|
333
|
-
/**
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
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') {
|
|
338
382
|
const snapshot = requiredRecord(value, 'release');
|
|
339
|
-
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)) {
|
|
340
387
|
fail('invalid release snapshot', 'contract_invalid');
|
|
341
388
|
}
|
|
342
|
-
const definition = parseAbilityDefinition(snapshot.definition, expected);
|
|
389
|
+
const definition = parseAbilityDefinition(snapshot.definition, expected, profile);
|
|
343
390
|
const usage = requiredRecord(snapshot.usage, 'usage');
|
|
344
391
|
if (usage.schema !== ABILITY_USAGE_SCHEMA || usage.path !== definition.path || usage.definition_id !== definition.definition_id
|
|
345
392
|
|| !Array.isArray(usage.examples) || usage.examples.length === 0
|
|
@@ -349,15 +396,18 @@ export function parseAbilityRelease(value, expected) {
|
|
|
349
396
|
fail('release usage does not match definition', 'contract_invalid', 'usage');
|
|
350
397
|
}
|
|
351
398
|
for (const [index, example] of usage.examples.entries()) {
|
|
352
|
-
validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params
|
|
399
|
+
validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`, profile);
|
|
353
400
|
}
|
|
354
401
|
const releaseId = validateReleaseId(snapshot.release_id);
|
|
355
|
-
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);
|
|
356
406
|
if (releaseId !== calculated)
|
|
357
407
|
fail('release_id does not match snapshot content', 'contract_invalid', 'release_id');
|
|
358
408
|
return {
|
|
359
|
-
schema:
|
|
360
|
-
release_id: releaseId, definition, usage,
|
|
409
|
+
schema: snapshot.schema, plugin_version: snapshot.plugin_version,
|
|
410
|
+
release_id: releaseId, definition, usage, ...(authorization ? { authorization } : {}),
|
|
361
411
|
};
|
|
362
412
|
}
|
|
363
413
|
export function parseAbilityIndex(value, expectedPublisher) {
|
|
@@ -8,6 +8,7 @@ export function parseAbilityArgv(argv, context = {}) {
|
|
|
8
8
|
abilityAssert(Array.isArray(argv) && argv[0] === 'ability', 'ARGUMENT_INVALID', 'Expected ability command');
|
|
9
9
|
const [, operation, ...args] = argv;
|
|
10
10
|
abilityAssert(Object.hasOwn(ABILITY_COMMANDS, operation), 'ACTION_UNSUPPORTED', 'Unknown ability command');
|
|
11
|
+
abilityAssert(operation !== 'remote', 'ACTION_UNSUPPORTED', 'Remote commands require the managed ability.remote.op endpoint');
|
|
11
12
|
const { values, positional } = parseAbilityOptions(args, ABILITY_COMMANDS[operation]);
|
|
12
13
|
let input = {};
|
|
13
14
|
if (values.file) {
|
|
@@ -6,6 +6,17 @@ import { resolveRoot } from '../paths.js';
|
|
|
6
6
|
import { templateError } from './types.js';
|
|
7
7
|
export const TEMPLATE_JOB_ID = /^job_[a-f0-9-]{36}$/;
|
|
8
8
|
export const TEMPLATE_PREVIEW_ID = /^preview_[a-f0-9-]{36}$/;
|
|
9
|
+
export function compareTemplateVersions(left, right) {
|
|
10
|
+
const version = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/;
|
|
11
|
+
if (!version.test(left) || !version.test(right))
|
|
12
|
+
throw templateError('VERSION_MISSING', 'Three numeric author member version components required');
|
|
13
|
+
const a = left.split('.').map(BigInt);
|
|
14
|
+
const b = right.split('.').map(BigInt);
|
|
15
|
+
for (let i = 0; i < 3; i++)
|
|
16
|
+
if (a[i] !== b[i])
|
|
17
|
+
return a[i] > b[i] ? 1 : -1;
|
|
18
|
+
return 0;
|
|
19
|
+
}
|
|
9
20
|
export function templateFingerprint(value) {
|
|
10
21
|
return createHash('sha256').update(JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
|
|
11
22
|
? Object.fromEntries(Object.keys(item).sort().map(key => [key, item[key]])) : item)).digest('hex');
|
|
@@ -31,6 +42,20 @@ export function writeTemplateState(file, value) {
|
|
|
31
42
|
}
|
|
32
43
|
}
|
|
33
44
|
}
|
|
45
|
+
/** Copy the transport receipt before outbox retirement; acceptance never marks the App notification read. */
|
|
46
|
+
export function recordTemplateNoticeReceipt(root, noticeId, ownerAid, messageId, outboxId) {
|
|
47
|
+
if (!/^notice_[a-f0-9]{64}$/.test(noticeId))
|
|
48
|
+
throw templateError('INVALID_ARGUMENT', 'Invalid update notice receipt');
|
|
49
|
+
const jobs = new TemplateJobs(root);
|
|
50
|
+
const file = path.join(jobs.directory, 'notifications', noticeId + '.json');
|
|
51
|
+
jobs.assertStatePath(file);
|
|
52
|
+
if (!fs.existsSync(file))
|
|
53
|
+
return;
|
|
54
|
+
const notice = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
55
|
+
if (notice.ownerAid !== ownerAid || notice.noticeId !== noticeId)
|
|
56
|
+
throw templateError('NOT_ALLOWED', 'Notice receipt route differs');
|
|
57
|
+
writeTemplateState(file, { ...notice, delivery: 'accepted', status: 'transport-accepted', messageId, outboxId });
|
|
58
|
+
}
|
|
34
59
|
export class TemplateJobs {
|
|
35
60
|
root;
|
|
36
61
|
directory;
|
|
@@ -68,8 +93,9 @@ export class TemplateJobs {
|
|
|
68
93
|
throw templateError('CONFLICT', 'Template job revision changed', { jobId: job.jobId });
|
|
69
94
|
}
|
|
70
95
|
if (!current.committed && job.committed && (current.status !== 'running' || !current.activating
|
|
71
|
-
|| job.status !== 'succeeded' || !Object.
|
|
72
|
-
|| 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)))) {
|
|
73
99
|
throw templateError('CONFLICT', 'Only the current prepared deployment can commit');
|
|
74
100
|
}
|
|
75
101
|
}
|
|
@@ -86,6 +112,14 @@ export class TemplateJobs {
|
|
|
86
112
|
return this.read(JSON.parse(fs.readFileSync(requestFile, 'utf8')).jobId);
|
|
87
113
|
return this.list().find(job => job.actor === actor && job.requestId === requestId);
|
|
88
114
|
}
|
|
115
|
+
requestMatches(actor, requestId, action, args) {
|
|
116
|
+
const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
|
|
117
|
+
const fingerprint = templateFingerprint({ action, args });
|
|
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;
|
|
122
|
+
}
|
|
89
123
|
bindRequest(actor, requestId, action, args, jobId) {
|
|
90
124
|
const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
|
|
91
125
|
const fingerprint = templateFingerprint({ action, args });
|
|
@@ -151,6 +185,48 @@ export class TemplateJobs {
|
|
|
151
185
|
for (const { aid, file } of files)
|
|
152
186
|
writeTemplateState(file, { aid, jobId: job.jobId });
|
|
153
187
|
}
|
|
188
|
+
installationFile(aid) {
|
|
189
|
+
if (!/^[a-z0-9][a-z0-9_-]*(\.[a-z0-9-]+)+$/.test(aid))
|
|
190
|
+
throw templateError('INVALID_ARGUMENT', 'Invalid target AID');
|
|
191
|
+
const file = path.join(this.root, 'agents', aid, 'template.lock.json');
|
|
192
|
+
this.assertStatePath(file);
|
|
193
|
+
return file;
|
|
194
|
+
}
|
|
195
|
+
/** A staged lock never exposes its candidate as an installed version before commit. */
|
|
196
|
+
installation(aid) {
|
|
197
|
+
const file = this.installationFile(aid);
|
|
198
|
+
if (!fs.existsSync(file))
|
|
199
|
+
return null;
|
|
200
|
+
const lock = JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
201
|
+
if (lock.schemaVersion !== 2)
|
|
202
|
+
return null;
|
|
203
|
+
const value = lock.pending && this.read(lock.pending.jobId).committed === true
|
|
204
|
+
? lock.pending.installation : lock.installation;
|
|
205
|
+
if (!value)
|
|
206
|
+
return null;
|
|
207
|
+
if (value.targetAid !== aid || !value.source || !value.baseline
|
|
208
|
+
|| value.committedJobId && (this.read(value.committedJobId).committed !== true
|
|
209
|
+
|| !Object.values(this.read(value.committedJobId).members).some(member => member.aid === aid))) {
|
|
210
|
+
throw templateError('RECOVERY_REQUIRED', 'Installed template provenance is invalid');
|
|
211
|
+
}
|
|
212
|
+
return value;
|
|
213
|
+
}
|
|
214
|
+
/** Fixed paths below the runtime root cannot traverse links or non-directory ancestors. */
|
|
215
|
+
assertStatePath(file) {
|
|
216
|
+
const root = path.resolve(this.root);
|
|
217
|
+
const target = path.resolve(file);
|
|
218
|
+
const relative = path.relative(root, target);
|
|
219
|
+
if (relative.startsWith('..' + path.sep) || relative === '..' || path.isAbsolute(relative))
|
|
220
|
+
throw templateError('UNSAFE_TEMPLATE_PATH', 'Template state leaves the runtime root');
|
|
221
|
+
let current = root;
|
|
222
|
+
for (const segment of ['', ...relative.split(path.sep)]) {
|
|
223
|
+
current = segment ? path.join(current, segment) : current;
|
|
224
|
+
const stat = fs.lstatSync(current, { throwIfNoEntry: false });
|
|
225
|
+
if (stat?.isSymbolicLink() || stat && current !== target && !stat.isDirectory()) {
|
|
226
|
+
throw templateError('UNSAFE_TEMPLATE_PATH', 'Template paths must use ordinary directories and files');
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
}
|
|
154
230
|
}
|
|
155
231
|
/** Durable installation associations are checked before ordinary task dispatch. */
|
|
156
232
|
export function templateInstallationGate(aid, expectedJobId, root = resolveRoot()) {
|
|
@@ -174,7 +250,7 @@ export function templateInstallationGate(aid, expectedJobId, root = resolveRoot(
|
|
|
174
250
|
}
|
|
175
251
|
}
|
|
176
252
|
const job = new TemplateJobs(root).read(link.jobId);
|
|
177
|
-
if (job.action
|
|
253
|
+
if (!['deploy', 'upgrade'].includes(job.action) || !Object.values(job.members).some(member => member.aid === aid))
|
|
178
254
|
throw new Error('Invalid member');
|
|
179
255
|
return { jobId: job.jobId, blocked: job.committed !== true && job.checkpoint.restored !== true,
|
|
180
256
|
activating: job.status === 'running' && job.activating === true, executing: job.status === 'running' };
|