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,15 +1,15 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
3
|
import { fileURLToPath } from 'node:url';
|
|
4
|
-
import { createHash } from 'node:crypto';
|
|
5
4
|
import { readJson, jsonBytes, assert, sha256, walkFiles, inside, unpack, behaviorConfig, mergeObjects,
|
|
6
|
-
snapshot, BASEAGENTS, PROFILE_FIELDS, isRecord, regularPath, atomicBytes } from './shared/common.mjs';
|
|
5
|
+
snapshot, BASEAGENTS, PROFILE_FIELDS, isRecord, regularPath, atomicBytes, resourceDigest } from './shared/common.mjs';
|
|
7
6
|
import { loadTemplate, MANAGED_AGENT_FIELDS, templateDigest } from './shared/template.mjs';
|
|
8
7
|
import { loadEvolcore } from './shared/evolcore.mjs';
|
|
9
8
|
import { validateAgainstSchema, buildAgentTriggers, resolveProviderRefs } from './shared/plan.mjs';
|
|
10
9
|
import { excludedResource as excluded, isPortableEventPackFile, isPortableEventPackResource, readEventPacks, validateEventPack } from './shared/template-package.mjs';
|
|
11
10
|
import { normalizeTeam } from './shared/template-contract.mjs';
|
|
12
11
|
import { renderValue as renderTemplateValue, renderResource, bindTemplateProviders, teamMemberVariables, planMemberConfig, resolveMemberParameters } from './shared/template-runtime.mjs';
|
|
12
|
+
import { portableServiceFile, portableServiceResource, readServicePacks, validateServicePack } from './shared/service-packs.mjs';
|
|
13
13
|
|
|
14
14
|
export async function inspectAgent(options) {
|
|
15
15
|
const config = options.effectiveConfig ?? readJson(path.join(options.agentDir, 'config.json'));
|
|
@@ -27,8 +27,10 @@ export async function inspectAgent(options) {
|
|
|
27
27
|
activeBaseagent: config.active_baseagent,
|
|
28
28
|
baseagents: BASEAGENTS.filter(name => config.baseagents?.[name]).map(name => ({ name, currentModel: config.baseagents[name].model ?? null,
|
|
29
29
|
currentEffort: config.baseagents[name].effort ?? null, provider: config.baseagents[name].provider ?? null })),
|
|
30
|
+
services: readServicePacks(path.join(options.agentDir, 'services')).map(pack => ({ id: pack.id, name: pack.definition.name, enabled: pack.definition.enabled !== false })),
|
|
30
31
|
triggers, events: readEventPacks(path.join(options.agentDir, 'events')).map(pack => ({ id: pack.id, name: pack.definition.name, enabled: pack.definition.enabled !== false })), skills: options.skills ?? [],
|
|
31
|
-
project: { path: project, files:
|
|
32
|
+
project: { path: project, files: options.listProjectFiles !== false && fs.existsSync(project)
|
|
33
|
+
? fs.readdirSync(project).filter(f => !excluded(f)).sort() : [] } };
|
|
32
34
|
}
|
|
33
35
|
|
|
34
36
|
export async function inspectPackage(options) {
|
|
@@ -65,40 +67,49 @@ export async function inspectPackage(options) {
|
|
|
65
67
|
'INVALID_ARGUMENT', 'Matching template metadata and unique member keys required');
|
|
66
68
|
const schemaErrors = validateAgainstSchema(tpl.team, tpl.schema);
|
|
67
69
|
assert(!schemaErrors.length, 'INVALID_ARGUMENT', schemaErrors.join('; '));
|
|
70
|
+
const allKeys = tpl.actualKeys;
|
|
68
71
|
// Check the complete package before selecting member resources. No member may hide unsupported files.
|
|
69
72
|
for (const file of files) assert(file === 'team.json' || file === 'team.schema.json'
|
|
70
|
-
|| file.startsWith('.evolcore/skills/') ||
|
|
73
|
+
|| file.startsWith('.evolcore/skills/') || allKeys.some(key => file.startsWith('workspace/' + key + '/')
|
|
71
74
|
|| file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
|
|
72
75
|
|| file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
|
|
73
|
-
|| file.startsWith('agents/' + key + '/') && isPortableEventPackFile(file.slice(('agents/' + key + '/').length))),
|
|
76
|
+
|| file.startsWith('agents/' + key + '/') && (isPortableEventPackFile(file.slice(('agents/' + key + '/').length)) || portableServiceFile(file.slice(('agents/' + key + '/').length)))),
|
|
74
77
|
'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
|
|
78
|
+
assert(!options.sourceMemberKey || allKeys.includes(options.sourceMemberKey), 'INTEGRITY_FAILED', 'Original source member is absent');
|
|
79
|
+
const keys = options.sourceMemberKey ? [options.sourceMemberKey] : allKeys;
|
|
75
80
|
const platforms = tpl.team.host.platform;
|
|
76
81
|
if (platforms !== undefined) assert(Array.isArray(platforms) && platforms.length
|
|
77
|
-
&& platforms.every(p => ['linux', 'darwin', 'win32'].includes(p))
|
|
78
|
-
'INCOMPATIBLE', '
|
|
82
|
+
&& platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)),
|
|
83
|
+
'INCOMPATIBLE', 'Invalid template host.platform');
|
|
79
84
|
if (!options.targets) {
|
|
80
|
-
assert(
|
|
81
|
-
return inspectMember(options, { pkg, tpl, templateDir, files, key:
|
|
85
|
+
assert(keys.length === 1, 'INVALID_ARGUMENT', 'Provide targets mapping for every template member');
|
|
86
|
+
return inspectMember(options, { pkg, tpl, templateDir, files, key: keys[0] });
|
|
82
87
|
}
|
|
83
|
-
assert(isRecord(options.targets) &&
|
|
84
|
-
&&
|
|
85
|
-
const contexts =
|
|
88
|
+
assert(isRecord(options.targets) && keys.length === Object.keys(options.targets).length
|
|
89
|
+
&& keys.every(key => Object.hasOwn(options.targets, key)), 'INVALID_ARGUMENT', 'Map every template member exactly once');
|
|
90
|
+
const contexts = keys.map(key => options.targets[key]);
|
|
86
91
|
assert(contexts.every(c => isRecord(c) && typeof c.targetAid === 'string' && c.home === contexts[0].home)
|
|
87
92
|
&& new Set(contexts.map(c => c.targetAid)).size === contexts.length,
|
|
88
93
|
'INVALID_ARGUMENT', 'Members must map to distinct Agents on the same host');
|
|
89
|
-
assert(Object.keys(options.members ?? {}).every(key =>
|
|
90
|
-
const writes = new Map(); const members = []; const plans = [];
|
|
91
|
-
const memberVars = teamMemberVariables(Object.fromEntries(
|
|
92
|
-
{ aid: options.targets[key].targetAid, projectPath: options.targets[key].projectPath ?? options.targets[key].targetConfig?.projects?.defaultPath }])),
|
|
94
|
+
assert(Object.keys(options.members ?? {}).every(key => keys.includes(key)), 'INVALID_ARGUMENT', 'Unknown member selection');
|
|
95
|
+
const writes = new Map(); const members = []; const plans = []; const skillSnapshots = {};
|
|
96
|
+
const memberVars = teamMemberVariables({ ...Object.fromEntries(keys.map(key => [key,
|
|
97
|
+
{ aid: options.targets[key].targetAid, projectPath: options.targets[key].projectPath ?? options.targets[key].targetConfig?.projects?.defaultPath }])) },
|
|
93
98
|
contexts[0].ownerAid, contexts[0].hostAid);
|
|
94
|
-
for (const key of
|
|
99
|
+
for (const key of keys) {
|
|
95
100
|
const selection = options.members?.[key] ?? {};
|
|
96
101
|
const out = inside(options.out ?? path.dirname(root), 'members/' + key);
|
|
97
102
|
const data = await inspectMember({ ...options.targets[key], out, packageRoot: options.packageRoot, digest: options.digest,
|
|
98
|
-
pullId: options.pullId, planMode: options.planMode,
|
|
99
|
-
|
|
103
|
+
pullId: options.pullId, planMode: options.planMode, singleMember: !!options.sourceMemberKey, affectedAids: options.affectedAids,
|
|
104
|
+
memberVars: memberVars[key], selections: selection.providers ?? {}, externalAids: selection.externalAids ?? {},
|
|
105
|
+
skillResolutions: selection.skillResolutions ?? {} },
|
|
106
|
+
{ pkg, tpl, templateDir, key, files: files.filter(f => !f.startsWith('agents/') && !f.startsWith('workspace/')
|
|
100
107
|
|| f.startsWith('agents/' + key + '/') || f.startsWith('workspace/' + key + '/')) });
|
|
101
108
|
const plan = readJson(data.planFile);
|
|
109
|
+
for (const [dir, digest] of Object.entries(plan.skillSnapshots ?? {})) {
|
|
110
|
+
assert(!Object.hasOwn(skillSnapshots, dir) || skillSnapshots[dir] === digest, 'CONFLICT', 'Shared skill changed during preview');
|
|
111
|
+
skillSnapshots[dir] = digest;
|
|
112
|
+
}
|
|
102
113
|
for (const write of plan.writes) {
|
|
103
114
|
const previous = writes.get(write.path);
|
|
104
115
|
assert(!previous || JSON.stringify(previous) === JSON.stringify(write), 'CONFLICT', 'Members write different shared content: ' + write.path);
|
|
@@ -107,11 +118,12 @@ export async function inspectPackage(options) {
|
|
|
107
118
|
const { planFile: _planFile, ...preview } = data;
|
|
108
119
|
members.push({ key, targetAid: plan.targetAid, ...preview });
|
|
109
120
|
plans.push({ key, targetAid: plan.targetAid, projectPath: plan.projectPath, profile: plan.profile,
|
|
110
|
-
originalProfile: plan.originalProfile, profileVersion: plan.profileVersion, providers: plan.providers
|
|
121
|
+
originalProfile: plan.originalProfile, profileVersion: plan.profileVersion, providers: plan.providers,
|
|
122
|
+
managedConfig: plan.managedConfig, managedSkills: plan.managedSkills });
|
|
111
123
|
}
|
|
112
124
|
const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
|
|
113
125
|
atomicBytes(planFile, jsonBytes({ version: 1, home: contexts[0].home, templateDir,
|
|
114
|
-
templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans }));
|
|
126
|
+
templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans, skillSnapshots }));
|
|
115
127
|
return { pullId: options.pullId, template: members[0].template, compatible: true, incompatible: [],
|
|
116
128
|
members, externalAids: pkg.externalAids ?? [], planFile };
|
|
117
129
|
}
|
|
@@ -132,10 +144,10 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
132
144
|
|| file.startsWith('.evolcore/skills/') || file.startsWith('workspace/' + key + '/')
|
|
133
145
|
|| file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
|
|
134
146
|
|| file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
|
|
135
|
-
|| file.startsWith('agents/' + key + '/') && isPortableEventPackFile(file.slice(('agents/' + key + '/').length)),
|
|
147
|
+
|| file.startsWith('agents/' + key + '/') && (isPortableEventPackFile(file.slice(('agents/' + key + '/').length)) || portableServiceFile(file.slice(('agents/' + key + '/').length))),
|
|
136
148
|
'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
|
|
137
149
|
assert(isRecord(spec.config) && !MANAGED_AGENT_FIELDS.some(f => f in spec.config)
|
|
138
|
-
&& Object.keys(spec.config).every(f => ['chatmode', 'memory', 'active_baseagent', 'baseagents', 'version', 'update'].includes(f)),
|
|
150
|
+
&& Object.keys(spec.config).every(f => ['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version', 'update'].includes(f)),
|
|
139
151
|
'INVALID_ARGUMENT', 'Unsupported template configuration');
|
|
140
152
|
const packageRoot = options.packageRoot ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
|
|
141
153
|
const temp = process.env.TMPDIR;
|
|
@@ -146,13 +158,13 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
146
158
|
finally { /* Modules remain loaded; scratch is cleaned after validation below. */ }
|
|
147
159
|
try {
|
|
148
160
|
const { default: semver } = await import('semver');
|
|
149
|
-
assert(Array.isArray(pkg.compat?.platforms)
|
|
161
|
+
assert(Array.isArray(pkg.compat?.platforms)
|
|
150
162
|
&& semver.validRange(pkg.compat.evolcore)
|
|
151
163
|
&& (semver.satisfies(ec.version, pkg.compat.evolcore, { includePrerelease: true })
|
|
152
164
|
|| !pkg.compat.templateFeatures?.length && semver.satisfies(ec.version.replace(/-test\.\d+$/, ''), pkg.compat.evolcore, { includePrerelease: true }))
|
|
153
165
|
&& (pkg.compat.templateFeatures === undefined || Array.isArray(pkg.compat.templateFeatures)
|
|
154
|
-
&& pkg.compat.templateFeatures.every(feature => ['member-references-v1', 'event-packs-v1'].includes(feature))),
|
|
155
|
-
'INCOMPATIBLE', '
|
|
166
|
+
&& pkg.compat.templateFeatures.every(feature => ['member-references-v1', 'event-packs-v1', 'service-packs-v1'].includes(feature))),
|
|
167
|
+
'INCOMPATIBLE', 'EvolCore version or template features are incompatible', { incompatible: ['version/features'] });
|
|
156
168
|
const selections = options.selections ?? {};
|
|
157
169
|
for (const [name, block] of Object.entries(spec.config.baseagents ?? {})) {
|
|
158
170
|
assert(BASEAGENTS.includes(name) && isRecord(block) && Object.keys(block).every(f => ['provider', 'model', 'effort', 'params'].includes(f)),
|
|
@@ -169,7 +181,14 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
169
181
|
for (const field of ['version', 'update']) if (Object.hasOwn(parameters, field)) {
|
|
170
182
|
config[field] = structuredClone(parameters[field]);
|
|
171
183
|
}
|
|
172
|
-
|
|
184
|
+
if (options.planMode === 'overlay_existing' && Object.hasOwn(targets, 'update')) {
|
|
185
|
+
config.update = structuredClone(targets.update);
|
|
186
|
+
}
|
|
187
|
+
for (const [name, select] of Object.entries(selections)) {
|
|
188
|
+
if (select.provider === null) delete config.baseagents[name].provider;
|
|
189
|
+
if (select.model === null) delete config.baseagents[name].model;
|
|
190
|
+
if (select.effort === null) delete config.baseagents[name].effort;
|
|
191
|
+
}
|
|
173
192
|
const configErrors = ec.validate('Agent', config);
|
|
174
193
|
assert(!configErrors.length, 'INVALID_ARGUMENT', configErrors.join('; '));
|
|
175
194
|
const agentDir = path.join(options.home, 'agents', options.targetAid);
|
|
@@ -181,29 +200,46 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
181
200
|
publisherAid: pkg.publisher?.aid, digest: options.digest, installedAt: Date.now() }));
|
|
182
201
|
const render = (bytes, relative = '') => renderResource(bytes, vars, options.externalAids ?? {}, { json: relative.endsWith('.json') });
|
|
183
202
|
const preview = { profile: { fields: PROFILE_FIELDS.filter(f => spec.profile?.[f] !== undefined), preserve: ['aid', 'type', 'owner'] },
|
|
184
|
-
soul: { add: [], overwrite: [] }, triggers: { add: [], overwrite: [] }, events: { add: [], overwrite: [] }, skills: [], files: { add: 0, overwrite: 0 },
|
|
203
|
+
soul: { add: [], overwrite: [] }, triggers: { add: [], overwrite: [] }, events: { add: [], overwrite: [] }, services: { add: [], overwrite: [] }, skills: [], files: { add: 0, overwrite: 0 },
|
|
185
204
|
project: { path: project, changeDefault: false }, config: Object.keys(resolved) };
|
|
186
|
-
const skillMapping = {};
|
|
187
|
-
const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))]
|
|
205
|
+
const skillMapping = {}; const skillSnapshots = {};
|
|
206
|
+
const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))]
|
|
207
|
+
.filter(name => Object.hasOwn(spec.skills ?? {}, name));
|
|
208
|
+
assert(Object.keys(options.skillResolutions ?? {}).every(name => localNames.includes(name)), 'INVALID_ARGUMENT', 'Unknown skill resolution');
|
|
188
209
|
for (const name of localNames) {
|
|
189
210
|
const source = inside(path.join(templateDir, '.evolcore', 'skills'), name);
|
|
190
|
-
const
|
|
191
|
-
for (const p of walkFiles(source)) hash.update(p).update('\0').update(render(fs.readFileSync(inside(source, p)), p)).update('\0');
|
|
192
|
-
const desiredDigest = hash.digest('hex').slice(0, 12);
|
|
211
|
+
const desiredDigest = resourceDigest(source, render);
|
|
193
212
|
let destName = name;
|
|
194
213
|
const original = inside(path.join(options.home, 'skills'), name);
|
|
195
|
-
if (fs.existsSync(original) &&
|
|
214
|
+
if (!options.singleMember && fs.existsSync(original) && resourceDigest(original) !== desiredDigest) destName += '--' + pkg.id;
|
|
196
215
|
const dest = inside(path.join(options.home, 'skills'), destName);
|
|
197
|
-
|
|
216
|
+
const currentDigest = fs.existsSync(dest) ? resourceDigest(dest) : null;
|
|
217
|
+
skillSnapshots[dest] = currentDigest;
|
|
198
218
|
skillMapping[name] = destName;
|
|
199
|
-
|
|
219
|
+
if (currentDigest && currentDigest !== desiredDigest && !options.singleMember) {
|
|
220
|
+
// Single-Agent updates validate shared resources against their installation manifest.
|
|
221
|
+
const choice = options.skillResolutions?.[name];
|
|
222
|
+
const resolution = choice?.currentDigest === currentDigest && choice?.incomingDigest === desiredDigest
|
|
223
|
+
&& ['overwrite', 'skip'].includes(choice.action) ? choice.action : null;
|
|
224
|
+
preview.skills.push({ name, installAs: destName,
|
|
225
|
+
conflict: { currentDigest, incomingDigest: desiredDigest, resolution } });
|
|
226
|
+
if (resolution !== 'overwrite') continue;
|
|
227
|
+
const incoming = new Set(walkFiles(source));
|
|
228
|
+
for (const relative of walkFiles(dest)) if (!incoming.has(relative)) {
|
|
229
|
+
const target = inside(dest, relative);
|
|
230
|
+
writes.push({ path: target, remove: true, expected: snapshot(target) });
|
|
231
|
+
}
|
|
232
|
+
} else {
|
|
233
|
+
preview.skills.push({ name, installAs: destName });
|
|
234
|
+
if (currentDigest === desiredDigest) continue;
|
|
235
|
+
}
|
|
200
236
|
for (const p of walkFiles(source)) add(inside(dest, p), render(fs.readFileSync(inside(source, p)), p),
|
|
201
237
|
fs.statSync(inside(source, p)).mode & 0o111 ? 0o755 : 0o644);
|
|
202
238
|
}
|
|
203
239
|
const switchesFile = path.join(agentDir, 'skills', '.switches.json');
|
|
204
240
|
const switches = fs.existsSync(switchesFile) ? readJson(switchesFile) : {};
|
|
205
241
|
for (const [name, value] of Object.entries(spec.skills ?? {})) switches[skillMapping[name] ?? name] = { enabled: value.enabled === true };
|
|
206
|
-
add(switchesFile, jsonBytes(switches));
|
|
242
|
+
if (Object.keys(spec.skills ?? {}).length) add(switchesFile, jsonBytes(switches));
|
|
207
243
|
const eventPacks = readEventPacks(path.join(templateDir, 'agents', key, 'events'), { template: true });
|
|
208
244
|
for (const pack of eventPacks) {
|
|
209
245
|
const dir = inside(path.join(agentDir, 'events'), pack.id);
|
|
@@ -231,9 +267,30 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
231
267
|
add(center, jsonBytes({ v: 1, enabled: true, authMode: 'allowlist',
|
|
232
268
|
admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } }));
|
|
233
269
|
}
|
|
270
|
+
const servicePacks = readServicePacks(path.join(templateDir, 'agents', key, 'services'));
|
|
271
|
+
for (const pack of servicePacks) {
|
|
272
|
+
const dir = inside(path.join(agentDir, 'services'), pack.id);
|
|
273
|
+
const definition = renderValue(pack.definition);
|
|
274
|
+
definition.enabled = false;
|
|
275
|
+
validateServicePack(definition, pack.files, { location: 'services/' + pack.id });
|
|
276
|
+
add(path.join(dir, 'pack.json'), jsonBytes(definition));
|
|
277
|
+
preview.services[fs.existsSync(path.join(dir, 'pack.json')) ? 'overwrite' : 'add'].push(pack.id);
|
|
278
|
+
for (const relative of pack.files.filter(file => file !== 'pack.json')) {
|
|
279
|
+
add(inside(dir, relative), render(fs.readFileSync(inside(pack.dir, relative)), relative),
|
|
280
|
+
fs.statSync(inside(pack.dir, relative)).mode & 0o111 ? 0o755 : 0o644);
|
|
281
|
+
}
|
|
282
|
+
for (const relative of walkFiles(dir, file => !portableServiceResource(file))) {
|
|
283
|
+
if (!pack.files.includes(relative)) {
|
|
284
|
+
const target = inside(dir, relative);
|
|
285
|
+
writes.push({ path: target, remove: true, expected: snapshot(target) });
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
const archived = path.join(dir, '.archived');
|
|
289
|
+
if (fs.existsSync(archived)) writes.push({ path: archived, remove: true, expected: snapshot(archived) });
|
|
290
|
+
}
|
|
234
291
|
const failures = []; const allowedTriggerFiles = new Set();
|
|
235
292
|
const triggers = buildAgentTriggers({ templateRoot: templateDir, key, aid: options.targetAid, vars, ec,
|
|
236
|
-
rec: { check: (name, ok, detail) => { if (!ok) failures.push(name + ': ' +
|
|
293
|
+
rec: { check: (name, ok, detail) => { if (!ok) failures.push(name + ': ' + (typeof detail === 'string' ? detail : JSON.stringify(detail))); } } });
|
|
237
294
|
assert(!failures.length, 'INVALID_ARGUMENT', failures.join('; '));
|
|
238
295
|
const triggerNames = new Set();
|
|
239
296
|
for (const { id, definition } of triggers) {
|
|
@@ -271,7 +328,9 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
271
328
|
}
|
|
272
329
|
}
|
|
273
330
|
const plan = { version: 1, targetAid: options.targetAid, home: options.home, projectPath: project,
|
|
274
|
-
templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes,
|
|
331
|
+
templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes, skillSnapshots,
|
|
332
|
+
managedConfig: { ...resolveProviderRefs(resolved), ...parameters },
|
|
333
|
+
managedSkills: Object.fromEntries(Object.entries(spec.skills ?? {}).map(([name, value]) => [skillMapping[name] ?? name, { enabled: value.enabled === true }])),
|
|
275
334
|
profile: spec.profile,
|
|
276
335
|
originalProfile: options.profile, profileVersion: options.profileVersion, providers: refs };
|
|
277
336
|
const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
|
|
@@ -280,6 +339,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
|
|
|
280
339
|
compatible: true, incompatible: [], currentConfig: { baseagents: Object.entries((options.effectiveConfig ?? targets).baseagents ?? {}).map(([name, b]) => ({ name, ...b })),
|
|
281
340
|
soul: fs.existsSync(path.join(agentDir, 'personal', 'soul')) ? fs.readdirSync(path.join(agentDir, 'personal', 'soul')) : [],
|
|
282
341
|
triggers: fs.existsSync(path.join(agentDir, 'triggers')) ? fs.readdirSync(path.join(agentDir, 'triggers')) : [],
|
|
342
|
+
services: servicePacks.filter(pack => fs.existsSync(path.join(agentDir, 'services', pack.id, 'pack.json'))).map(pack => pack.id),
|
|
283
343
|
events: eventPacks.filter(pack => fs.existsSync(path.join(agentDir, 'events', pack.id, 'pack.json'))).map(pack => pack.id) },
|
|
284
344
|
providers: refs, preview, externalAids: pkg.externalAids ?? [], planFile };
|
|
285
345
|
} finally { fs.rmSync(scratch, { recursive: true, force: true }); }
|
|
@@ -1,17 +1,107 @@
|
|
|
1
1
|
import fs from 'node:fs';
|
|
2
2
|
import path from 'node:path';
|
|
3
|
-
import { assert, snapshot, equalSnapshot, readJson, jsonBytes, atomicBytes, regularPath } from './shared/common.mjs';
|
|
3
|
+
import { assert, snapshot, equalSnapshot, readJson, jsonBytes, atomicBytes, regularPath, sha256, resourceDigest } from './shared/common.mjs';
|
|
4
4
|
import { templateDigest } from './shared/template.mjs';
|
|
5
5
|
|
|
6
|
+
function desiredSnapshot(write) {
|
|
7
|
+
// Windows chmod implements the read-only flag, not POSIX group/execute bits.
|
|
8
|
+
return write.remove ? null : { sha256: sha256(Buffer.from(write.content, 'base64')),
|
|
9
|
+
mode: process.platform === 'win32' ? (write.mode & 0o200 ? 0o666 : 0o444) : write.mode };
|
|
10
|
+
}
|
|
11
|
+
|
|
6
12
|
export function verifyPlan(plan) {
|
|
7
13
|
assert(templateDigest(plan.templateDir) === plan.templateDigest, 'CONFLICT', 'Cached template changed');
|
|
14
|
+
for (const [dir, digest] of Object.entries(plan.skillSnapshots ?? {})) {
|
|
15
|
+
assert((fs.existsSync(dir) ? resourceDigest(dir) : null) === digest, 'CONFLICT', 'Shared skill changed: ' + dir);
|
|
16
|
+
}
|
|
17
|
+
for (const [file, expected] of Object.entries(plan.observed ?? {})) {
|
|
18
|
+
assert(equalSnapshot(snapshot(file), expected), 'CONFLICT', 'Observed target changed: ' + file);
|
|
19
|
+
}
|
|
8
20
|
for (const write of plan.writes) assert(equalSnapshot(snapshot(write.path), write.expected), 'CONFLICT', 'Target changed: ' + write.path);
|
|
9
21
|
}
|
|
10
22
|
|
|
23
|
+
function managedLocation(plan, file) {
|
|
24
|
+
const member = plan.members[0];
|
|
25
|
+
for (const [scope, root] of [['agent', path.join(plan.home, 'agents', member.targetAid)], ['workspace', member.projectPath], ['shared', path.join(plan.home, 'skills')]]) {
|
|
26
|
+
const relative = path.relative(root, file);
|
|
27
|
+
if (relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative)) return scope + '/' + relative.split(path.sep).join('/');
|
|
28
|
+
}
|
|
29
|
+
throw Object.assign(new Error('Unexpected installation resource'), { code: 'INVALID_ARGUMENT' });
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function stageInstallation(plan) {
|
|
33
|
+
if (!plan.commitInstallation) return;
|
|
34
|
+
const member = plan.members[0]; const agentDir = path.join(plan.home, 'agents', member.targetAid);
|
|
35
|
+
const configPath = path.join(agentDir, 'config.json');
|
|
36
|
+
const config = plan.writes.find(write => write.path === configPath);
|
|
37
|
+
const finalConfig = JSON.parse(Buffer.from(config.content, 'base64'));
|
|
38
|
+
finalConfig.version = plan.commitInstallation.release.version;
|
|
39
|
+
plan.finalConfig = { path: configPath, content: jsonBytes(finalConfig).toString('base64'), mode: config.mode };
|
|
40
|
+
const manifest = plan.writes.filter(write => !write.remove).map(write => {
|
|
41
|
+
const bytes = Buffer.from(write.path === configPath ? plan.finalConfig.content : write.content, 'base64');
|
|
42
|
+
return { path: managedLocation(plan, write.path), sha256: sha256(bytes), size: bytes.length, mode: write.mode,
|
|
43
|
+
...(write.path === path.join(agentDir, 'skills', '.switches.json') ? { skills: Object.keys(member.managedSkills ?? {}) } : {}) };
|
|
44
|
+
}).sort((a, b) => a.path.localeCompare(b.path));
|
|
45
|
+
const bytes = jsonBytes(manifest);
|
|
46
|
+
const installation = { ...plan.commitInstallation, manifestDigest: 'sha256:' + sha256(bytes) };
|
|
47
|
+
const lockPath = path.join(agentDir, 'template.lock.json');
|
|
48
|
+
let previous = null;
|
|
49
|
+
if (fs.existsSync(lockPath)) {
|
|
50
|
+
try { const old = readJson(lockPath); previous = old.schemaVersion === 2 ? old.installation : old.installation ?? old; } catch { /* Invalid old records are backed up without granting cleanup authority. */ }
|
|
51
|
+
}
|
|
52
|
+
for (const [file, content] of [[path.join(agentDir, 'template.manifest.json'), bytes],
|
|
53
|
+
[lockPath, jsonBytes({ schemaVersion: 2, installation: previous, pending: { jobId: installation.committedJobId, installation } })]]) {
|
|
54
|
+
plan.writes.push({ path: file, content: content.toString('base64'), mode: 0o600, expected: snapshot(file) });
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function finalizeInstallation(plan, backupDir) {
|
|
59
|
+
const file = path.join(backupDir, 'journal.json'); const journal = readJson(file);
|
|
60
|
+
assert(journal.applied && !journal.restored, 'INSTALL_BROKEN', 'Installation is not ready to commit');
|
|
61
|
+
const write = plan.finalConfig;
|
|
62
|
+
const entry = journal.entries.find(entry => entry.path === write.path);
|
|
63
|
+
const desired = { sha256: sha256(Buffer.from(write.content, 'base64')), mode: write.mode };
|
|
64
|
+
assert(entry && (equalSnapshot(snapshot(write.path), entry.desired) || equalSnapshot(snapshot(write.path), desired)), 'CONFLICT', 'Configuration changed before version commit');
|
|
65
|
+
entry.intermediate = [...(entry.intermediate ?? []), entry.desired]; entry.desired = desired;
|
|
66
|
+
atomicBytes(file, jsonBytes(journal), 0o600);
|
|
67
|
+
atomicBytes(write.path, Buffer.from(write.content, 'base64'), write.mode);
|
|
68
|
+
return { finalized: true };
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function cleanupUpgrade(plan, backupDir) {
|
|
72
|
+
const file = path.join(backupDir, 'journal.json'); const journal = readJson(file);
|
|
73
|
+
if (journal.cleanup) return journal.cleanup;
|
|
74
|
+
const old = plan.installationManifest;
|
|
75
|
+
const known = old?.previousValid ? new Map(old.oldFiles.map(entry => [entry.path, entry])) : null;
|
|
76
|
+
const retained = []; let cleaned = 0;
|
|
77
|
+
for (const entry of journal.entries.filter(entry => entry.existed)) {
|
|
78
|
+
const backup = path.join(backupDir, entry.backup);
|
|
79
|
+
if (!fs.existsSync(backup)) continue;
|
|
80
|
+
const relative = managedLocation(plan, entry.path); const expected = known?.get(relative);
|
|
81
|
+
const bytes = fs.readFileSync(backup);
|
|
82
|
+
if (expected && bytes.length === expected.size && sha256(bytes) === expected.sha256
|
|
83
|
+
&& (expected.mode === undefined || expected.mode === entry.mode)) {
|
|
84
|
+
fs.rmSync(backup); cleaned++;
|
|
85
|
+
} else retained.push({ path: entry.path, backup, reason: !known ? 'PREVIOUS_MANIFEST_UNAVAILABLE'
|
|
86
|
+
: !expected ? 'UNREGISTERED' : 'LOCALLY_MODIFIED' });
|
|
87
|
+
}
|
|
88
|
+
const cleanup = { backupDir, cleaned, retained, retainedAll: known === null };
|
|
89
|
+
atomicBytes(file, jsonBytes({ ...journal, cleanup }), 0o600);
|
|
90
|
+
return cleanup;
|
|
91
|
+
}
|
|
92
|
+
|
|
11
93
|
export function restore(backupDir) {
|
|
12
94
|
const file = path.join(backupDir, 'journal.json');
|
|
13
95
|
const journal = readJson(file);
|
|
14
96
|
assert(journal.version === 1 && Array.isArray(journal.entries), 'INSTALL_BROKEN', 'Invalid restore journal');
|
|
97
|
+
for (const entry of journal.entries) {
|
|
98
|
+
if (!Object.hasOwn(entry, 'desired')) continue; // Legacy journals retain their original recovery behavior.
|
|
99
|
+
const current = snapshot(entry.path);
|
|
100
|
+
const original = entry.existed ? { sha256: sha256(fs.readFileSync(path.join(backupDir, entry.backup))), mode: entry.mode } : null;
|
|
101
|
+
assert(equalSnapshot(current, original) || equalSnapshot(current, entry.desired)
|
|
102
|
+
|| entry.intermediate?.some(value => equalSnapshot(current, value)),
|
|
103
|
+
'INSTALL_BROKEN', 'Independent change prevents safe restore: ' + entry.path);
|
|
104
|
+
}
|
|
15
105
|
for (const entry of [...journal.entries].reverse()) {
|
|
16
106
|
regularPath(entry.path);
|
|
17
107
|
if (entry.existed) atomicBytes(entry.path, fs.readFileSync(path.join(backupDir, entry.backup)), entry.mode);
|
|
@@ -27,8 +117,41 @@ export function restore(backupDir) {
|
|
|
27
117
|
export async function overlay(options) {
|
|
28
118
|
if (options.operation === 'restore') return restore(options.backupDir);
|
|
29
119
|
const plan = options.plan ?? readJson(options.planFile);
|
|
120
|
+
if (['prepare-installation-record', 'record-installation'].includes(options.operation)) {
|
|
121
|
+
const member = plan.members[0]; const dir = path.join(plan.home, 'agents', member.targetAid);
|
|
122
|
+
const prepare = () => {
|
|
123
|
+
const config = readJson(path.join(dir, 'config.json'));
|
|
124
|
+
const manifest = plan.writes.filter(write => !write.remove && !['template.lock.json', 'template.manifest.json'].includes(path.basename(write.path)))
|
|
125
|
+
.map(write => { const bytes = fs.readFileSync(write.path); return { path: managedLocation(plan, write.path), size: bytes.length,
|
|
126
|
+
sha256: sha256(bytes), mode: fs.statSync(write.path).mode & 0o777,
|
|
127
|
+
...(managedLocation(plan, write.path) === 'agent/skills/.switches.json' ? { skills: Object.keys(plan.members[0].managedSkills ?? {}) } : {}) }; });
|
|
128
|
+
const installation = { ...options.installation, manifestDigest: 'sha256:' + sha256(jsonBytes(manifest)) };
|
|
129
|
+
assert(config.version === installation.release.version && config.update?.key === installation.source.key, 'CONFLICT', 'New installation identity changed');
|
|
130
|
+
return { manifest, installation };
|
|
131
|
+
};
|
|
132
|
+
const prepared = options.prepared ?? prepare();
|
|
133
|
+
if (options.operation === 'prepare-installation-record') return prepared;
|
|
134
|
+
if (options.prepared) assert(sha256(jsonBytes(prepare())) === sha256(jsonBytes(prepared)),
|
|
135
|
+
'CONFLICT', 'Installed resources changed before installation registration');
|
|
136
|
+
const { installation, manifest } = prepared; const bytes = jsonBytes(manifest);
|
|
137
|
+
atomicBytes(path.join(dir, 'template.manifest.json'), bytes, 0o600);
|
|
138
|
+
atomicBytes(path.join(dir, 'template.lock.json'), jsonBytes({ schemaVersion: 2, installation: null,
|
|
139
|
+
pending: { jobId: installation.committedJobId, installation } }), 0o600);
|
|
140
|
+
return { recorded: true };
|
|
141
|
+
}
|
|
142
|
+
if (options.operation === 'cleanup-upgrade') return cleanupUpgrade(plan, options.backupDir);
|
|
143
|
+
if (options.operation === 'finalize-upgrade') return finalizeInstallation(plan, options.backupDir);
|
|
144
|
+
if (options.operation === 'verify-applied') {
|
|
145
|
+
for (const write of plan.writes) {
|
|
146
|
+
const expected = desiredSnapshot(write);
|
|
147
|
+
assert(equalSnapshot(snapshot(write.path), expected), 'INTEGRITY_FAILED', 'Applied resource differs: ' + write.path);
|
|
148
|
+
}
|
|
149
|
+
return { verified: true };
|
|
150
|
+
}
|
|
30
151
|
verifyPlan(plan);
|
|
31
152
|
if (options.operation === 'verify') return { valid: true };
|
|
153
|
+
stageInstallation(plan);
|
|
154
|
+
if (options.planFile) atomicBytes(options.planFile, jsonBytes(plan), 0o600);
|
|
32
155
|
const backupDir = options.backupDir;
|
|
33
156
|
const file = path.join(backupDir, 'journal.json');
|
|
34
157
|
const journal = { version: 1, targetAid: plan.targetAid,
|
|
@@ -42,7 +165,8 @@ export async function overlay(options) {
|
|
|
42
165
|
for (const [i, write] of plan.writes.entries()) {
|
|
43
166
|
regularPath(write.path);
|
|
44
167
|
const existing = snapshot(write.path);
|
|
45
|
-
const entry = { path: write.path, existed: existing !== null, mode: existing?.mode ?? write.mode, backup: i + '.bin'
|
|
168
|
+
const entry = { path: write.path, existed: existing !== null, mode: existing?.mode ?? write.mode, backup: i + '.bin',
|
|
169
|
+
desired: desiredSnapshot(write) };
|
|
46
170
|
if (existing) atomicBytes(path.join(backupDir, entry.backup), fs.readFileSync(write.path), 0o600);
|
|
47
171
|
journal.entries.push(entry);
|
|
48
172
|
let dir = path.dirname(write.path); const missing = [];
|
|
@@ -48,22 +48,40 @@ export function regularPath(target) {
|
|
|
48
48
|
}
|
|
49
49
|
}
|
|
50
50
|
|
|
51
|
-
export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.total, onOversizedFile } = {}) {
|
|
51
|
+
export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.total, onOversizedFile, onMissingFile, onSymbolicLink } = {}) {
|
|
52
52
|
if (!fs.existsSync(root)) return [];
|
|
53
53
|
regularPath(root);
|
|
54
54
|
const files = [];
|
|
55
55
|
let total = 0;
|
|
56
56
|
let count = 0;
|
|
57
57
|
const visit = (dir) => {
|
|
58
|
-
|
|
58
|
+
let entries;
|
|
59
|
+
try { regularPath(dir); entries = fs.readdirSync(dir, { withFileTypes: true }); }
|
|
60
|
+
catch (error) {
|
|
61
|
+
if (!onMissingFile || !['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
|
|
62
|
+
onMissingFile(posix(path.relative(root, dir))); return;
|
|
63
|
+
}
|
|
64
|
+
for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
|
|
59
65
|
const file = path.join(dir, e.name);
|
|
60
66
|
if (exclude(posix(path.relative(root, file)))) continue;
|
|
67
|
+
if (e.isSymbolicLink() && onSymbolicLink) {
|
|
68
|
+
assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files', { kind: 'entry-limit', limit: LIMITS.entries });
|
|
69
|
+
count++;
|
|
70
|
+
onSymbolicLink(posix(path.relative(root, file)));
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
61
73
|
assert(!e.isSymbolicLink() && (e.isFile() || e.isDirectory()), 'INVALID_ARGUMENT', 'Only regular files/directories: ' + file);
|
|
62
|
-
assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files');
|
|
74
|
+
assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files', { kind: 'entry-limit', limit: LIMITS.entries });
|
|
63
75
|
if (e.isDirectory()) visit(file);
|
|
64
76
|
else {
|
|
65
77
|
count++;
|
|
66
|
-
|
|
78
|
+
let stat;
|
|
79
|
+
try { stat = fs.lstatSync(file); }
|
|
80
|
+
catch (error) {
|
|
81
|
+
if (!onMissingFile || !['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
|
|
82
|
+
onMissingFile(posix(path.relative(root, file))); continue;
|
|
83
|
+
}
|
|
84
|
+
assert(stat.isFile(), 'INVALID_ARGUMENT', 'Only regular files: ' + file);
|
|
67
85
|
if (stat.size > LIMITS.file && onOversizedFile) {
|
|
68
86
|
onOversizedFile({ path: posix(path.relative(root, file)), size: stat.size, limit: LIMITS.file });
|
|
69
87
|
continue;
|
|
@@ -78,6 +96,15 @@ export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.
|
|
|
78
96
|
return files.sort();
|
|
79
97
|
}
|
|
80
98
|
|
|
99
|
+
// Portable paths and one ordering on both sides, including nested files on Windows.
|
|
100
|
+
export function resourceDigest(root, render = bytes => bytes) {
|
|
101
|
+
const hash = createHash('sha256');
|
|
102
|
+
for (const relative of walkFiles(root)) {
|
|
103
|
+
hash.update(relative).update('\0').update(render(fs.readFileSync(inside(root, relative)), relative)).update('\0');
|
|
104
|
+
}
|
|
105
|
+
return 'sha256:' + hash.digest('hex');
|
|
106
|
+
}
|
|
107
|
+
|
|
81
108
|
export function atomicBytes(file, bytes, mode = 0o644) {
|
|
82
109
|
assert(isProcessRunning(parentPid), 'TASK_INTERRUPTED', 'Template coordinator exited');
|
|
83
110
|
regularPath(file);
|
|
@@ -100,7 +127,24 @@ export function snapshot(file) {
|
|
|
100
127
|
} catch (error) { if (error.code === 'ENOENT') return null; throw error; }
|
|
101
128
|
}
|
|
102
129
|
|
|
103
|
-
|
|
130
|
+
/**
|
|
131
|
+
* 比较两份快照。内容哈希始终比较;mode 只在支持 POSIX 权限的平台上比较。
|
|
132
|
+
*
|
|
133
|
+
* 为什么:Windows 上 `fs.chmod` 对普通文件基本不生效(实测写入 0o600/0o644/0o777
|
|
134
|
+
* 读回都是 0o666),而 plan/journal 里记录的是**期望** mode。若把 mode 纳入比较,
|
|
135
|
+
* 「安装后校验」与「恢复前校验」在 Windows 上必然判成不一致,restore 会以
|
|
136
|
+
* "Independent change prevents safe restore" 拒绝回滚——这不是真的冲突。
|
|
137
|
+
* 同仓 `team-preview.mjs` 的 verifyInstallationPlan 已有 `process.platform !== 'win32'`
|
|
138
|
+
* 的同类判断,这里与之保持一致。
|
|
139
|
+
*/
|
|
140
|
+
export function equalSnapshot(a, b) {
|
|
141
|
+
const normalize = value => value === null || value === undefined
|
|
142
|
+
? value
|
|
143
|
+
: { sha256: value.sha256 };
|
|
144
|
+
const left = process.platform === 'win32' ? normalize(a) : a;
|
|
145
|
+
const right = process.platform === 'win32' ? normalize(b) : b;
|
|
146
|
+
return JSON.stringify(left) === JSON.stringify(right);
|
|
147
|
+
}
|
|
104
148
|
|
|
105
149
|
export function mergeObjects(existing, overlay) {
|
|
106
150
|
const out = structuredClone(existing);
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
*/
|
|
6
6
|
import fs from 'node:fs';
|
|
7
7
|
import path from 'node:path';
|
|
8
|
-
import { renderText, renderValue } from './template-runtime.mjs';
|
|
8
|
+
import { renderText, renderValue, MEMBER_KEY, applyMemberResourceState } from './template-runtime.mjs';
|
|
9
9
|
import { validateContractSchema } from './template-contract.mjs';
|
|
10
10
|
|
|
11
11
|
/**
|
|
@@ -77,7 +77,8 @@ export function checkAgentProvider({ config, defaults = {}, providers = {}, base
|
|
|
77
77
|
* @param {{ templateRoot: string, key: string, aid: string, vars: Record<string, string>, ec: any, rec: any }} opts
|
|
78
78
|
* @returns {Array<{ id: string, definition: object }>}
|
|
79
79
|
*/
|
|
80
|
-
export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec }) {
|
|
80
|
+
export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec, member }) {
|
|
81
|
+
if (!MEMBER_KEY.test(key)) throw new Error('Invalid source member key');
|
|
81
82
|
const triggersDir = path.join(templateRoot, 'agents', key, 'triggers');
|
|
82
83
|
if (!fs.existsSync(triggersDir)) return [];
|
|
83
84
|
const agentVars = { ...vars, 'agent.aid': aid };
|
|
@@ -88,6 +89,7 @@ export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec }) {
|
|
|
88
89
|
let rendered;
|
|
89
90
|
try { rendered = renderValue(JSON.parse(fs.readFileSync(file, 'utf8')), agentVars); } catch (err) { rec.check(`trigger[${key}/${id}]`, false, err.message); continue; }
|
|
90
91
|
try {
|
|
92
|
+
rendered = applyMemberResourceState(member, 'triggers/' + id + '/trigger.json', rendered);
|
|
91
93
|
const def = ec.validateTrigger(rendered);
|
|
92
94
|
rec.check(`trigger[${key}/${id}]`, def.agentAid === aid && def.id === id, { agentAid: def.agentAid, id: def.id });
|
|
93
95
|
triggers.push({ id, definition: rendered });
|