evolcore 0.0.50 → 0.0.51
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +39 -2
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +65 -63
- package/dist/ability/caller/command.js +24 -15
- package/dist/ability/caller/contract.js +24 -9
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +32 -7
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +202 -63
- package/dist/ability/interop-v1.js +156 -113
- package/dist/agent-template/jobs.js +14 -110
- package/dist/agent-template/runtime.js +331 -193
- package/dist/agent-template/service.js +1029 -1104
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -3
- package/dist/agents/claude/availability.js +94 -0
- package/dist/agents/claude/capability-provider.js +154 -0
- package/dist/agents/claude/index.js +145 -0
- package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
- package/dist/agents/claude/session-file-adapter.js +246 -0
- package/dist/agents/codex/app-server-client.js +90 -10
- package/dist/agents/codex/availability.js +164 -0
- package/dist/agents/codex/capability-provider.js +138 -0
- package/dist/agents/codex/cli.js +38 -0
- package/dist/agents/codex/index.js +345 -0
- package/dist/agents/codex/mcp-elicitation.js +135 -0
- package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
- package/dist/agents/codex/session-file-adapter.js +834 -0
- package/dist/agents/dsh/availability.js +28 -0
- package/dist/agents/dsh/capability-provider.js +56 -0
- package/dist/agents/dsh/desktop-locations.ps1 +66 -0
- package/dist/agents/dsh/desktop-probe.cjs +37 -0
- package/dist/agents/dsh/index.js +98 -0
- package/dist/agents/dsh/installation.js +400 -0
- package/dist/agents/dsh/resources.js +755 -0
- package/dist/agents/dsh/runner.js +1183 -0
- package/dist/agents/dsh/runtime/README.md +243 -0
- package/dist/agents/dsh/runtime/authorization.js +23 -0
- package/dist/agents/dsh/runtime/bridge.js +837 -0
- package/dist/agents/dsh/runtime/config.js +271 -0
- package/dist/agents/dsh/runtime/entry.js +229 -0
- package/dist/agents/dsh/runtime/session-inspector.js +340 -0
- package/dist/agents/dsh/runtime/tool-policy.js +49 -0
- package/dist/agents/dsh/session-file-adapter.js +145 -0
- package/dist/agents/ecagent/index.js +215 -0
- package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
- package/dist/agents/ecagent/session-file-adapter.js +134 -0
- package/dist/agents/gemini/index.js +55 -10
- package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +1 -1
- package/dist/aun/menu/client.js +1 -1
- package/dist/aun/msg/history.js +1 -1
- package/dist/aun/msg/managed-operation.js +93 -21
- package/dist/aun/msg/p2p.js +6 -6
- package/dist/aun/service-proxy.js +1 -1
- package/dist/aun/storage/index.js +242 -0
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +180 -43
- package/dist/channels/daemon.js +3 -2
- package/dist/channels/dingtalk.js +1 -1
- package/dist/channels/feishu.js +9 -9
- package/dist/channels/qqbot.js +1 -1
- package/dist/channels/wechat.js +2 -2
- package/dist/channels/wecom.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
- package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
- package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
- package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
- package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
- package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
- package/dist/cli/ability-command.js +8 -5
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +1 -1
- package/dist/cli/agent-create.js +123 -42
- package/dist/cli/agent-template.js +400 -29
- package/dist/cli/agent.js +14 -11
- package/dist/cli/aun-commands.js +167 -111
- package/dist/cli/daemon-commands.js +38 -8
- package/dist/cli/data-command.js +1 -1
- package/dist/cli/debug-mode.js +9 -0
- package/dist/cli/directory.js +1 -2
- package/dist/cli/ecmsg-gateway.js +55 -19
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +25 -11
- package/dist/cli/init.js +124 -29
- package/dist/cli/managed-command-guard.js +2 -0
- package/dist/cli/model.js +1 -1
- package/dist/cli/restart-monitor.js +2 -2
- package/dist/cli/services-command.js +24 -1
- package/dist/cli/skill-command.js +4 -4
- package/dist/cli/task-context.js +24 -14
- package/dist/cli/team-workspace-command.js +50 -52
- package/dist/cli/thread-command.js +3 -2
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +10 -6
- package/dist/config/config-manager.js +33 -12
- package/dist/config/gateway-config.js +21 -37
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -3
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +2 -2
- package/dist/config/provider-identity-migration.js +24 -105
- package/dist/config/provider-ipc-service.js +13 -3
- package/dist/config/provider-local-sync.js +4 -1
- package/dist/config/provider-menu-request.js +21 -3
- package/dist/config/provider-templates.js +1 -1
- package/dist/config/providers-config.js +39 -15
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +74 -99
- package/dist/config/schema-migration.js +177 -11
- package/dist/config/schema-registry.js +1 -1
- package/dist/config-store.js +38 -50
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
- package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
- package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
- package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +1 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +7 -4
- package/dist/core/auth/operation-catalog.js +34 -5
- package/dist/core/baseagent/baseagent-availability.js +197 -0
- package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
- package/dist/core/baseagent/baseagent-config-shared.js +56 -0
- package/dist/core/baseagent/baseagent-identity.js +68 -0
- package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
- package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
- package/dist/core/baseagent/baseagent.js +157 -0
- package/dist/{agents → core/baseagent}/runner-types.js +36 -4
- package/dist/core/capability/capability-manager.js +79 -30
- package/dist/core/capability/providers/claude-capability-provider.js +2 -154
- package/dist/core/capability/providers/codex-capability-provider.js +2 -136
- package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
- package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
- package/dist/core/command/agent-control.js +60 -15
- package/dist/core/command/agent-template-menu.js +21 -9
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- package/dist/core/command/command-handler.js +127 -57
- package/dist/core/command/context-policy-menu.js +122 -0
- package/dist/core/command/data-root-resolver.js +157 -20
- package/dist/core/command/memory-slash.js +6 -6
- package/dist/core/command/menu-catalog.js +80 -20
- package/dist/core/command/menu-handler.js +305 -25
- package/dist/core/command/menu-protocol.js +42 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- package/dist/core/command/provider-menu.js +7 -11
- package/dist/core/command/role-menu.js +1 -1
- package/dist/core/command/skill-slash.js +17 -5
- package/dist/core/command/slash-gate.js +2 -4
- package/dist/core/command/slash-handler.js +127 -96
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +10 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
- package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
- package/dist/core/file-integrity/store.js +1 -1
- package/dist/core/handoff/ipc-registration.js +3 -3
- package/dist/core/handoff/runtime.js +1 -1
- package/dist/{agents → core/inference}/request-identity.js +2 -2
- package/dist/core/inference/text-inference.js +4 -4
- package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
- package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
- package/dist/core/initialization/service.js +54 -9
- package/dist/core/invoke/executors/media.js +1 -1
- package/dist/core/invoke/executors/text.js +1 -1
- package/dist/core/memory/consolidation-context.js +1 -1
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +4 -4
- package/dist/core/memory/memory-admin.js +6 -6
- package/dist/core/memory/memory-writer.js +1 -1
- package/dist/core/memory/relation-idle-monitor.js +1 -1
- package/dist/core/message/aun-ipc-sender.js +114 -75
- package/dist/core/message/aun-request-registry.js +13 -5
- package/dist/core/message/auto-mention-gate.js +1 -1
- package/dist/core/message/contact-admission.js +1 -1
- package/dist/core/message/im-renderer.js +19 -0
- package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
- package/dist/core/message/items-formatter.js +5 -5
- package/dist/core/message/message-admission.js +1 -1
- package/dist/core/message/message-bridge.js +135 -54
- package/dist/core/message/message-queue.js +83 -4
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +1 -1
- package/dist/core/message/response-engine.js +347 -163
- package/dist/core/message/send-options.js +9 -6
- package/dist/core/message/send-routing.js +45 -109
- package/dist/core/message/stream-idle-monitor.js +1 -1
- package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
- package/dist/core/model/catalog-service.js +29 -8
- package/dist/core/model/model-capabilities.js +88 -0
- package/dist/core/model/model-catalog.js +14 -3
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +95 -15
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
- package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
- package/dist/core/permission/approval-gateway.js +9 -18
- package/dist/core/permission/ec-command-parser.js +70 -34
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +56 -0
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
- package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
- package/dist/core/{background-session → session/background}/types.js +1 -1
- package/dist/core/session/session-file-health.js +2 -272
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +29 -2
- package/dist/core/session/session-terminal.js +185 -0
- package/dist/core/session/session-title.js +8 -11
- package/dist/core/{system-session → session/system}/memory.js +43 -9
- package/dist/core/{system-session → session/system}/registry.js +1 -1
- package/dist/core/{system-session → session/system}/types.js +1 -1
- package/dist/core/skill/index-generator.js +1 -0
- package/dist/core/task/task-activity-store.js +112 -0
- package/dist/core/task/task-recovery-service.js +2 -2
- package/dist/core/thread/ipc-operation.js +2 -2
- package/dist/core/thread/thread-operation.js +2 -1
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +14 -4
- package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
- package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
- package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
- package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
- package/dist/directory/{owner-directory-search.js → search.js} +50 -2
- package/dist/directory/{owner-directory-store.js → store.js} +2 -2
- package/dist/eck/kit-renderer.js +1 -1
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +9 -3
- package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
- package/dist/ecweb/dsh-native-service.js +413 -0
- package/dist/ecweb/providers-service.js +1 -1
- package/dist/ecweb/runtime/lifecycle.js +1 -1
- package/dist/ecweb/runtime/supervisor.js +1 -1
- package/dist/event-center/center-config.js +2 -2
- package/dist/event-center/dispatcher.js +1 -1
- package/dist/event-center/ipc-operation.js +12 -3
- package/dist/event-center/pack-loader.js +2 -2
- package/dist/event-center/registry.js +6 -6
- package/dist/event-center/runtime.js +2 -2
- package/dist/index.js +71 -42
- package/dist/ipc.js +103 -10
- package/dist/outputs/authorization.js +27 -0
- package/dist/outputs/events.js +10 -1
- package/dist/outputs/panel-cards.js +960 -0
- package/dist/paths.js +12 -0
- package/dist/pay/command.js +1 -1
- package/dist/pay/runtime.js +18 -10
- package/dist/response-system/engines/v1/proactive-flow.js +1 -1
- package/dist/services/dispatcher.js +2 -2
- package/dist/services/host/main.js +10 -1
- package/dist/services/host/protocol.js +9 -2
- package/dist/services/host/resident.js +37 -0
- package/dist/services/host-client.js +12 -0
- package/dist/services/host-recycle.js +8 -3
- package/dist/services/host-runtime.js +54 -15
- package/dist/services/index.js +83 -19
- package/dist/services/ipc-operation.js +303 -38
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +34 -25
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +28 -2
- package/dist/stats/context-usage.js +110 -0
- package/dist/stats/model-resolver.js +103 -17
- package/dist/stats/query.js +5 -0
- package/dist/trigger/application-service.js +3 -2
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -176
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +14 -2
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +57 -243
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- package/dist/utils/atomic-write.js +88 -1
- package/dist/utils/cross-platform.js +4 -42
- package/dist/utils/error-dict.json +22 -1
- package/dist/utils/error-utils.js +193 -6
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +1 -1
- package/dist/utils/logger.js +3 -1
- package/dist/utils/media-cache.js +99 -4
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/welcome.js +64 -20
- package/ecagent/README.md +35 -0
- package/ecagent/dist/agent-loop.js +80 -30
- package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
- package/ecagent/dist/harness/env/nodejs.js +49 -20
- package/ecagent/dist/harness/messages.js +3 -2
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/ecagent/dist/runtime/types.d.ts +2 -0
- package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
- package/ecagent/dist/runtime/utils/validation.js +42 -0
- package/ecagent/dist/types.d.ts +2 -0
- package/kits/docs/INDEX.md +1 -1
- package/kits/docs/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +10 -7
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +100 -13
- package/kits/docs/evolcore/aid.md +19 -3
- package/kits/docs/evolcore/config.md +94 -0
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/ec-capabilities.md +7 -10
- package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
- package/kits/docs/evolcore/event.md +1 -1
- package/kits/docs/evolcore/fs.md +49 -3
- package/kits/docs/evolcore/group.md +3 -3
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/menu-protocol.md +24 -2
- package/kits/docs/evolcore/model.md +9 -1
- package/kits/docs/evolcore/msg.md +30 -28
- package/kits/docs/evolcore/pay.md +8 -20
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +8 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- package/kits/docs/evolcore/skill.md +17 -1
- package/kits/docs/evolcore/stats.md +5 -0
- package/kits/docs/evolcore/storage.md +22 -0
- package/kits/docs/evolcore/thread-chain.md +19 -10
- package/kits/docs/evolcore/tool-authorization.md +4 -0
- package/kits/docs/evolcore/trigger.md +89 -13
- package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
- package/kits/docs/venues/feishu-group.md +3 -2
- package/kits/docs/venues/feishu-private.md +3 -2
- package/kits/rules/02-navigation.md +20 -13
- package/kits/rules/06-channel.md +18 -2
- package/kits/schemas/_meta.json +8 -4
- package/kits/schemas/agent-config.schema.23.json +19 -3
- package/kits/schemas/agent-config.schema.24.json +986 -0
- package/kits/schemas/agent-config.schema.25.json +986 -0
- package/kits/schemas/daemon.schema.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -0
- package/kits/schemas/defaults.schema.8.json +484 -0
- package/kits/schemas/providers.schema.1.json +1 -1
- package/kits/schemas/providers.schema.2.json +1 -1
- package/kits/schemas/providers.schema.3.json +8 -2
- package/kits/skills/.switches.json +4 -0
- package/kits/skills/ability/SKILL.md +194 -27
- package/kits/skills/ability/STRUCTURE.md +5 -0
- package/kits/skills/agent-output-cards/SKILL.md +90 -54
- package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
- package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
- package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
- package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
- package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
- package/kits/skills/agent-output-cards/examples/surface.html +8 -0
- package/kits/skills/agent-template-project/SKILL.md +51 -0
- package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
- package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
- package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
- package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
- package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
- package/kits/skills/ec-group/SKILL.md +3 -3
- package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +163 -41
- package/kits/skills/ec-provider/SKILL.md +5 -5
- package/kits/skills/ec-service-call/SKILL.md +3 -0
- package/kits/skills/ec-skill/SKILL.md +25 -9
- package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
- package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
- package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
- package/kits/skills/ec-trigger/SKILL.md +2 -2
- package/kits/skills/personal-assistant/SKILL.md +22 -22
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
- package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
- package/kits/skills/thread-ops/SKILL.md +19 -9
- package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
- package/kits/skills/wechat-article-reader/SKILL.md +2 -2
- package/kits/templates/system-fragments/commands.md +1 -1
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +14 -9
- package/kits/templates/system-fragments/session.md +1 -1
- package/kits/templates/system-fragments/thread.md +10 -5
- package/package.json +6 -5
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +81 -35
- package/scripts/agent-template/overlay.mjs +110 -4
- package/scripts/agent-template/shared/common.mjs +36 -4
- package/scripts/agent-template/shared/plan.mjs +4 -2
- package/scripts/agent-template/shared/service-packs.mjs +104 -0
- package/scripts/agent-template/shared/team-schema.json +467 -54
- package/scripts/agent-template/shared/template-contract.mjs +70 -68
- package/scripts/agent-template/shared/template-package.mjs +153 -36
- package/scripts/agent-template/shared/template-runtime.mjs +76 -64
- package/scripts/agent-template/shared/template.mjs +11 -46
- package/scripts/agent-template/team-pack.mjs +451 -35
- package/scripts/agent-template/team-preview.mjs +75 -226
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -176
- package/dist/agents/baseagent-capability-adapter.js +0 -102
- package/dist/agents/baseagent-plugin-loader.js +0 -145
- package/dist/agents/baseagent.js +0 -816
- package/dist/agents/codex/catalog.js +0 -80
- package/dist/agents/ecagent-plugin-lazy.js +0 -41
- package/dist/agents/tool-time-context.js +0 -55
- package/dist/core/legacy-rename.js +0 -41
- package/dist/core/plugin-lifecycle.js +0 -137
- package/dist/core/rate-window.js +0 -53
- package/dist/core/runner-reload-transaction.js +0 -60
- package/dist/core/runtime-lock.js +0 -90
- package/dist/core/soul.js +0 -66
- package/dist/core/system-session/grants.js +0 -40
- package/dist/directory/owner-directory-agentmd-sync.js +0 -89
- package/dist/directory/owner-directory-request-operation.js +0 -79
- package/dist/directory/owner-directory-text.js +0 -60
- package/kits/skills/ec-pay/references/pay-cli.md +0 -110
- /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
- /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
- /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
- /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
- /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
- /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
- /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
- /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
- /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
- /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
- /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
- /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
- /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
- /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
|
@@ -372,7 +372,7 @@ const EVOLCORE_EXECUTABLE_ALIASES = new Set(['ec', 'ec.cmd', 'ec.exe', 'ec.ps1']
|
|
|
372
372
|
* 轻量发送入口 `ecmsg` 的前缀映射:`ecmsg <args...>` 等价于 `ec msg <args...>`。
|
|
373
373
|
*
|
|
374
374
|
* 必须在这里归一,不能只做一个独立脚本——委托审批是按规范化 argv 的哈希
|
|
375
|
-
* arm 的(
|
|
375
|
+
* arm 的(Codex runner 的 armApprovedDelegationCommand)。若 `ecmsg` 不归一到
|
|
376
376
|
* `['ec','msg',...]`,策略层会把它当普通命令(kind: 'none'),既不 arm 审批,
|
|
377
377
|
* daemon 侧也算不出匹配的哈希,最终必然 INVALID_DELEGATION;更糟的是它会绕过
|
|
378
378
|
* ec_shell_composite_command 与会话身份绑定,成为冒充发送的后门。
|
|
@@ -392,12 +392,13 @@ const EVOLCORE_SUBCOMMANDS = new Set([
|
|
|
392
392
|
'mode', 'model', 'msg', 'mv', 'net', 'queue', 'response', 'restart',
|
|
393
393
|
'restart-monitor', 'rpc', 'start', 'stats', 'status', 'stop', 'storage', 'task',
|
|
394
394
|
'trigger', 'proxy', 'version', 'watch', 'session', 'team', 'upgrade', 'update',
|
|
395
|
-
'directory', 'getmeta', 'integrity', 'invoke', 'memory', 'provider', 'role', 'skill', 'thread', 'pay',
|
|
395
|
+
'directory', 'getmeta', 'integrity', 'invoke', 'memory', 'provider', 'plugin', 'role', 'skill', 'thread', 'pay',
|
|
396
396
|
]);
|
|
397
397
|
// Development/install entrypoints that are part of this repository's CLI.
|
|
398
398
|
// Only these exact relative paths are canonicalized; arbitrary Node scripts
|
|
399
399
|
// must never become an EC command merely because their filename is similar.
|
|
400
|
-
const EVOLCORE_NODE_WRAPPER_PATHS = new Set(['bin/ec.js', 'dist/cli/index.js']);
|
|
400
|
+
const EVOLCORE_NODE_WRAPPER_PATHS = new Set(['bin/ec.js', 'dist/cli/index.js', 'bin/ecmsg.js']);
|
|
401
|
+
const ECMSG_NODE_PREFIX = /^node(?:\.exe)?[ \t]+(['"]?)(?:\.[\\/])?bin[\\/]ecmsg\.js\1(?=$|\s|[;&|`()<>])/i;
|
|
401
402
|
const SHELL_UNQUOTED_META = new Set([
|
|
402
403
|
';', '&', '|', '`', '<', '>', '$', '(', ')', '*', '?', '[', ']', '{', '}', '#',
|
|
403
404
|
]);
|
|
@@ -449,15 +450,18 @@ function stripHeredocBodies(command) {
|
|
|
449
450
|
// never establish an EC invocation.
|
|
450
451
|
const POWERSHELL_ASSIGNMENT_PREFIX = /^\$(?:[A-Za-z_][\w:]*|\{[^{}\r\n]+\})\s*=(?!=)/u;
|
|
451
452
|
function hasEcCommandPrefix(command, dialect = 'posix') {
|
|
453
|
+
const posix = dialect === 'posix';
|
|
452
454
|
let quote = null;
|
|
453
455
|
let escaped = false;
|
|
454
456
|
let boundary = true;
|
|
457
|
+
let wordBoundary = true;
|
|
455
458
|
const powerShell = dialect === 'powershell';
|
|
456
459
|
for (let index = 0; index < command.length; index++) {
|
|
457
460
|
const char = command[index];
|
|
458
461
|
if (escaped) {
|
|
459
462
|
escaped = false;
|
|
460
463
|
boundary = false;
|
|
464
|
+
wordBoundary = false;
|
|
461
465
|
continue;
|
|
462
466
|
}
|
|
463
467
|
if (quote === 'single') {
|
|
@@ -478,6 +482,15 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
|
|
|
478
482
|
quote = null;
|
|
479
483
|
continue;
|
|
480
484
|
}
|
|
485
|
+
if (posix && char === '\\') {
|
|
486
|
+
// A continued line does not end a command or word. Other escaped
|
|
487
|
+
// characters are word data, including whitespace and separators.
|
|
488
|
+
if (command[index + 1] === '\n')
|
|
489
|
+
index++;
|
|
490
|
+
else
|
|
491
|
+
escaped = true;
|
|
492
|
+
continue;
|
|
493
|
+
}
|
|
481
494
|
if (powerShell && char === '`') {
|
|
482
495
|
escaped = true;
|
|
483
496
|
continue;
|
|
@@ -489,7 +502,8 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
|
|
|
489
502
|
index = end + 1;
|
|
490
503
|
continue;
|
|
491
504
|
}
|
|
492
|
-
if (
|
|
505
|
+
if (char === '#' && (posix && wordBoundary
|
|
506
|
+
|| powerShell && (index === 0 || /\s/.test(command[index - 1])))) {
|
|
493
507
|
const end = command.indexOf('\n', index);
|
|
494
508
|
if (end < 0)
|
|
495
509
|
return false;
|
|
@@ -508,23 +522,28 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
|
|
|
508
522
|
if (powerShell ? isPowerShellSingleQuote(char) : char === "'") {
|
|
509
523
|
quote = 'single';
|
|
510
524
|
boundary = false;
|
|
525
|
+
wordBoundary = false;
|
|
511
526
|
continue;
|
|
512
527
|
}
|
|
513
528
|
if (powerShell ? isPowerShellDoubleQuote(char) : char === '"') {
|
|
514
529
|
quote = 'double';
|
|
515
530
|
boundary = false;
|
|
531
|
+
wordBoundary = false;
|
|
516
532
|
continue;
|
|
517
533
|
}
|
|
518
534
|
if (powerShell && /[{}\r\n]/.test(char)) {
|
|
519
535
|
boundary = true;
|
|
520
536
|
continue;
|
|
521
537
|
}
|
|
522
|
-
if (/[;&|`()<>]/.test(char)) {
|
|
538
|
+
if (posix && char === '\n' || /[;&|`()<>]/.test(char)) {
|
|
523
539
|
boundary = true;
|
|
540
|
+
wordBoundary = true;
|
|
524
541
|
continue;
|
|
525
542
|
}
|
|
526
|
-
if (
|
|
543
|
+
if (/\s/.test(char)) {
|
|
544
|
+
wordBoundary = !posix || char === ' ' || char === '\t';
|
|
527
545
|
continue;
|
|
546
|
+
}
|
|
528
547
|
if (boundary && powerShell && char === '$') {
|
|
529
548
|
const assignment = POWERSHELL_ASSIGNMENT_PREFIX.exec(command.slice(index));
|
|
530
549
|
if (assignment) {
|
|
@@ -538,7 +557,10 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
|
|
|
538
557
|
// `ecmsg ... && rm -rf /` 会落成 kind:'none',绕过复合命令拦截。
|
|
539
558
|
if (boundary && /^ecmsg(?:\.cmd|\.exe|\.ps1)?(?=$|\s|[;&|`()<>])/i.test(command.slice(index)))
|
|
540
559
|
return true;
|
|
560
|
+
if (boundary && ECMSG_NODE_PREFIX.test(command.slice(index)))
|
|
561
|
+
return true;
|
|
541
562
|
boundary = false;
|
|
563
|
+
wordBoundary = false;
|
|
542
564
|
}
|
|
543
565
|
return false;
|
|
544
566
|
}
|
|
@@ -844,9 +866,12 @@ export function normalizeEvolcoreCommandArgv(argv) {
|
|
|
844
866
|
if (entryAlias && EVOLCORE_MSG_ENTRY_ALIASES.has(entryAlias)) {
|
|
845
867
|
return ['ec', 'msg', ...materialized.slice(1)];
|
|
846
868
|
}
|
|
847
|
-
if (typeof executable === 'string' && isNodeExecutable(executable) && materialized
|
|
848
|
-
|
|
849
|
-
|
|
869
|
+
if (typeof executable === 'string' && isNodeExecutable(executable) && typeof materialized[1] === 'string') {
|
|
870
|
+
const wrapper = normalizeNodeWrapperPath(materialized[1]);
|
|
871
|
+
if (wrapper === 'bin/ecmsg.js')
|
|
872
|
+
return ['ec', 'msg', ...materialized.slice(2)];
|
|
873
|
+
if (wrapper)
|
|
874
|
+
return ['ec', ...materialized.slice(2)];
|
|
850
875
|
}
|
|
851
876
|
return materialized;
|
|
852
877
|
}
|
|
@@ -1300,7 +1325,8 @@ export function parseCodexCarrierCommand(carrier, options = {}) {
|
|
|
1300
1325
|
: parsed;
|
|
1301
1326
|
}
|
|
1302
1327
|
export function literalShellParseRemedy(failure) {
|
|
1303
|
-
if (failure.issue === 'shell-composition'
|
|
1328
|
+
if (failure.issue === 'shell-composition'
|
|
1329
|
+
|| failure.issue === 'structural-newline' && failure.dialect === 'posix') {
|
|
1304
1330
|
return '一次调用只执行一条完整命令;查询和操作请拆成独立工具调用,不要拼接管道、重定向、分号或子表达式。';
|
|
1305
1331
|
}
|
|
1306
1332
|
if (failure.dialect === 'posix' && failure.issue === 'unsupported-escape') {
|
|
@@ -2994,13 +3020,13 @@ export function parseBoundedOutputShellCommand(command, options = {}) {
|
|
|
2994
3020
|
// 所以两种情况都切在 operators[0].start,绝不能按 end 切——那会把 `2>&1` 混进 argv。
|
|
2995
3021
|
const first = operators[0];
|
|
2996
3022
|
const sourceText = trimShellSpacing(input.slice(0, first.start));
|
|
3023
|
+
// 源命令允许 `$TMPDIR` 作**参数**(`--spec-file $TMPDIR/x.json`):
|
|
3024
|
+
// 它已被换成哨兵串,不会在 spawn 时被再次展开,最终路径由 policy 层
|
|
3025
|
+
// 用本会话 TMPDIR 还原并校验。限制只针对重定向目标——那是替另一条命令
|
|
3026
|
+
// 指定写入位置,不能借 `$TMPDIR` 表达(见下面 redirect 分支)。
|
|
2997
3027
|
const argv = parseLiteralShellArgv(sourceText, literalOptions);
|
|
2998
3028
|
if (!argv)
|
|
2999
3029
|
return null;
|
|
3000
|
-
// `$TMPDIR` is a transport-level path reference, never an argument
|
|
3001
|
-
// expansion for the privileged command itself.
|
|
3002
|
-
if (argv.some(value => value.includes(MANAGED_TMPDIR_TOKEN)))
|
|
3003
|
-
return null;
|
|
3004
3030
|
const filterChain = [];
|
|
3005
3031
|
let outputPath;
|
|
3006
3032
|
let discardStdout = false;
|
|
@@ -3051,8 +3077,18 @@ export function parseBoundedOutputShellCommand(command, options = {}) {
|
|
|
3051
3077
|
prevEnd = segmentEnd;
|
|
3052
3078
|
cursor++;
|
|
3053
3079
|
}
|
|
3080
|
+
// 源命令参数里的 `$TMPDIR` 已在 tokenize 阶段换成哨兵串(literalOptions
|
|
3081
|
+
// 关掉了 allowManagedTmpDir,避免它被当成展开放行)。这里必须显式还原成
|
|
3082
|
+
// 本会话的真实 TMPDIR,否则下游 spawn 会拿到字面量哨兵。
|
|
3083
|
+
// 没有 managedTempDir 就无从还原 → 拒绝,不能让 `$TMPDIR` 逃进 argv。
|
|
3084
|
+
const needsRestore = argv.some(value => value.includes(MANAGED_TMPDIR_TOKEN));
|
|
3085
|
+
if (needsRestore && !options.managedTempDir)
|
|
3086
|
+
return null;
|
|
3087
|
+
const restoredArgv = needsRestore
|
|
3088
|
+
? argv.map(value => restoreManagedTmpDirToken(value, options.managedTempDir))
|
|
3089
|
+
: argv;
|
|
3054
3090
|
return {
|
|
3055
|
-
argv,
|
|
3091
|
+
argv: restoredArgv,
|
|
3056
3092
|
mergeStderr,
|
|
3057
3093
|
...(discardStdout ? { discardStdout } : {}),
|
|
3058
3094
|
...(discardStderr ? { discardStderr } : {}),
|
|
@@ -3379,7 +3415,9 @@ export function resolveCanonicalEvolcoreToolInput(input, options = {}) {
|
|
|
3379
3415
|
? parseFailure(classification.issue, command, 0, 0, dialect ?? 'posix')
|
|
3380
3416
|
: parsed,
|
|
3381
3417
|
};
|
|
3382
|
-
|
|
3418
|
+
// Match the classifier's treatment of heredoc data in this fallback too.
|
|
3419
|
+
const prefixCommand = !dialect || dialect === 'posix' ? stripHeredocBodies(command) : command;
|
|
3420
|
+
if (!parsed.ok && (hasEcCommandPrefix(prefixCommand, dialect)
|
|
3383
3421
|
|| carrier?.dialect === 'powershell' && hasPowerShellCredentialAssignment(command))) {
|
|
3384
3422
|
return { kind: 'invalid', failure: parsed };
|
|
3385
3423
|
}
|
|
@@ -3425,7 +3463,7 @@ const PROACTIVE_SEND_VALUE_FLAGS = new Set([
|
|
|
3425
3463
|
'--check-every', '--trigger-prompt', '--return', '--timeout',
|
|
3426
3464
|
]);
|
|
3427
3465
|
const PROACTIVE_SEND_BOOLEAN_FLAGS = new Set([
|
|
3428
|
-
'--mention-all',
|
|
3466
|
+
'--mention-all', '--selfmode',
|
|
3429
3467
|
]);
|
|
3430
3468
|
/**
|
|
3431
3469
|
* 三态取值选项:`--encrypt yes|no|auto`,必须带取值;不写该参数才是默认 `auto`。
|
|
@@ -3826,8 +3864,8 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
|
|
|
3826
3864
|
return undefined;
|
|
3827
3865
|
const commandText = [input.command, input.input, ...(Array.isArray(input.commandArgv) ? input.commandArgv : [])]
|
|
3828
3866
|
.filter((value) => typeof value === 'string').join(' ');
|
|
3829
|
-
// `ecmsg send`
|
|
3830
|
-
//
|
|
3867
|
+
// 诊断同时认 `ecmsg send` 与它规范化后的内部形态(`ec msg|group send`),否则
|
|
3868
|
+
// ecmsg 写法被拒时只会掉进"上一轮未包含意图表达"的笼统提示,模型拿不到可操作原因。
|
|
3831
3869
|
if (!/\bec(?:\.cmd|\.exe)?\s+(?:group|msg)\s+send\b|\becmsg(?:\.cmd|\.exe|\.ps1)?\s+send\b/i.test(commandText)) {
|
|
3832
3870
|
return undefined;
|
|
3833
3871
|
}
|
|
@@ -3838,7 +3876,7 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
|
|
|
3838
3876
|
return `当前汇报命令未通过规范解析(${result.issue},${result.dialect},位置 ${result.offset});`
|
|
3839
3877
|
+ '请检查引号和转义,并将发送作为一条独立命令。';
|
|
3840
3878
|
}
|
|
3841
|
-
//
|
|
3879
|
+
// 正文里只是提到发送命令的其它命令(如 ec memory note "ecmsg send …")不是发送调用。
|
|
3842
3880
|
const argv = result.argv;
|
|
3843
3881
|
if (argv[0] !== 'ec' || (argv[1] !== 'msg' && argv[1] !== 'group') || argv[2] !== 'send')
|
|
3844
3882
|
return undefined;
|
|
@@ -3854,24 +3892,21 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
|
|
|
3854
3892
|
}
|
|
3855
3893
|
const scope = argv[1];
|
|
3856
3894
|
const prefix = '发送命令被拒:';
|
|
3857
|
-
//
|
|
3858
|
-
//
|
|
3859
|
-
|
|
3860
|
-
|
|
3861
|
-
? `ecmsg send ${session?.channelId ? `--to ${session.channelId}` : '(群会话内直接省略 --to)'} "<正文>"`
|
|
3862
|
-
: `ecmsg send${session?.channelId ? ` --to ${session.channelId}` : ''} "<正文>"`;
|
|
3863
|
-
// 带 --thread 的发送走话题路由校验,允许省略 from/to;走到这里说明话题本身没解析通过。
|
|
3895
|
+
// 面向模型的写法统一是 `ecmsg send`:本端恒为会话本端,不写 from;
|
|
3896
|
+
// 接收方由话题和模式推出,不用 --to。
|
|
3897
|
+
const expectedForm = 'ecmsg send "<正文>"';
|
|
3898
|
+
// 带 --thread 的发送走话题路由校验;走到这里说明话题本身没解析通过。
|
|
3864
3899
|
if (sendOptionValue(argv, '--thread')) {
|
|
3865
|
-
return `${prefix}带 --thread
|
|
3866
|
-
+
|
|
3867
|
-
+
|
|
3900
|
+
return `${prefix}带 --thread 的跨话题发送未通过校验——话题必须已存在于本端,且不能是当前话题:`
|
|
3901
|
+
+ `独立话题写 thread-…,主话题写 main:<aidA>:<aidB>(两端之一必须是本端)。`
|
|
3902
|
+
+ `跨话题默认是委托(收件人为该话题对端);要发给自己加 --selfmode。`
|
|
3868
3903
|
+ `主话题 id 只在本端之间有效,不要转发给别人使用。可用 ec thread list <对方AID> 取得可用值。`;
|
|
3869
3904
|
}
|
|
3870
3905
|
// 私聊/群聊用错了 scope。
|
|
3871
3906
|
if (session?.chatType && (session.chatType === 'group') !== (scope === 'group')) {
|
|
3872
3907
|
return session.chatType === 'group'
|
|
3873
3908
|
? `${prefix}当前是群聊会话,公开回复直接写 ecmsg send "<正文>"(群会话里即群内公开发送);`
|
|
3874
|
-
+ `要私下联系本条消息的发送者,用
|
|
3909
|
+
+ `要私下联系本条消息的发送者,用 --thread <与对方的私聊话题>。`
|
|
3875
3910
|
: `${prefix}当前是私聊会话,回复用 ${expectedForm};群回复在群会话里同样用 ecmsg send。`;
|
|
3876
3911
|
}
|
|
3877
3912
|
const from = argv[3];
|
|
@@ -3895,7 +3930,7 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
|
|
|
3895
3930
|
}
|
|
3896
3931
|
if (session?.channelId && to !== session.channelId) {
|
|
3897
3932
|
return `${prefix}目标必须是当前会话${scope === 'group' ? '群' : '对端'} ${session.channelId},命令里写的是 ${to};`
|
|
3898
|
-
+ `要联系其他对象请走 --thread
|
|
3933
|
+
+ `要联系其他对象请走 --thread 跨话题发送(先用 ec thread list <对方AID> 选话题,或直接写主话题 main:<本端AID>:<对方AID>)。`;
|
|
3899
3934
|
}
|
|
3900
3935
|
const payloadDiagnosis = diagnoseProactiveSendPayload(argv, scope, 5, { allowAttachment: true });
|
|
3901
3936
|
if (payloadDiagnosis.ok)
|
|
@@ -3923,8 +3958,9 @@ function sendOptionValue(argv, flag) {
|
|
|
3923
3958
|
/**
|
|
3924
3959
|
* 带 `--thread` 的跨话题发送:目标由话题推断,不受「只能发给当前对端/群」限制。
|
|
3925
3960
|
*
|
|
3926
|
-
*
|
|
3927
|
-
*
|
|
3961
|
+
* 入参是规范化后的 argv:`ecmsg send "<text>" --thread <id>` 归一为内部形态
|
|
3962
|
+
* `ec msg send "<text>" --thread <id>`(目标取话题 peer);带显式 self/target 的
|
|
3963
|
+
* 内部完整形式 `ec msg|group send <self> <target> ... --thread <id>` 同样支持。
|
|
3928
3964
|
* `resolveThread` 必须校验话题存在于本端索引、scope 与话题类型一致,且给出
|
|
3929
3965
|
* target 时与话题 peer 相同;这里只做语法与发送者校验。
|
|
3930
3966
|
*/
|
|
@@ -0,0 +1,234 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 托管会话内的受管本地文件:路径边界校验 + 安全读取。
|
|
3
|
+
*
|
|
4
|
+
* 为什么在 core 而不是 trigger:这套逻辑被消息发送、handoff、支付和 Trigger
|
|
5
|
+
* 共用,只有 Trigger 是它的首个使用方。放在 trigger 下会让其它调用方的报错
|
|
6
|
+
* 说成「Trigger input」,误导用户。
|
|
7
|
+
*
|
|
8
|
+
* 不同用途共享路径与句柄校验,只在允许的根目录、报错措辞和大小上限上有差异:
|
|
9
|
+
* - trigger Trigger 脚本/提示词,上限 4 MiB
|
|
10
|
+
* - message 发送链路的 --text-from-file / --payload-file,上限 1 MiB
|
|
11
|
+
* - attachment 附件源文件与支付图片,上限 4 MiB
|
|
12
|
+
* - credential 当前 Agent credentials/ 子树,上限 128 KiB,POSIX 要求私有权限
|
|
13
|
+
*/
|
|
14
|
+
import fs from 'node:fs';
|
|
15
|
+
import path from 'node:path';
|
|
16
|
+
import { agentDir, resolveRoot } from '../../paths.js';
|
|
17
|
+
import { classifyProtectedPath, isSameOrDescendant } from './protected-paths.js';
|
|
18
|
+
/** Trigger 脚本与附件源文件的上限。 */
|
|
19
|
+
export const TRIGGER_LOCAL_FILE_LIMIT = 4 * 1024 * 1024;
|
|
20
|
+
/**
|
|
21
|
+
* 发送链路上限。
|
|
22
|
+
*
|
|
23
|
+
* 真正的硬限制在传输层:整条 JSON-RPC 信封超过 1,000,000 字节会被拒绝。
|
|
24
|
+
* 这里提前卡在 1 MiB,让用户在读文件阶段就拿到明确原因,而不是发送时才失败。
|
|
25
|
+
*/
|
|
26
|
+
export const MESSAGE_LOCAL_FILE_LIMIT = 1024 * 1024;
|
|
27
|
+
/** 各用途的文件大小上限。 */
|
|
28
|
+
export function managedLocalFileLimit(kind) {
|
|
29
|
+
return kind === 'credential' ? 128 * 1024 : kind === 'message' ? MESSAGE_LOCAL_FILE_LIMIT : TRIGGER_LOCAL_FILE_LIMIT;
|
|
30
|
+
}
|
|
31
|
+
/** 报错时的主语,让用户能对上自己正在做的事。 */
|
|
32
|
+
function managedLocalFileLabel(kind) {
|
|
33
|
+
if (kind === 'trigger')
|
|
34
|
+
return 'Trigger input';
|
|
35
|
+
if (kind === 'message')
|
|
36
|
+
return 'Message file';
|
|
37
|
+
if (kind === 'credential')
|
|
38
|
+
return 'Agent credential file';
|
|
39
|
+
return 'Attachment source';
|
|
40
|
+
}
|
|
41
|
+
function formatMiB(bytes) {
|
|
42
|
+
return `${Math.round(bytes / (1024 * 1024))} MiB`;
|
|
43
|
+
}
|
|
44
|
+
export function resolveManagedLocalPath(input, scope, kind) {
|
|
45
|
+
const messages = managedLocalFileMessages(kind);
|
|
46
|
+
if (!input || /[\0\r\n]/.test(input) || hasUnsafeWindowsPathSyntax(input))
|
|
47
|
+
throw new Error(messages.invalidPath);
|
|
48
|
+
const normalizedInput = input.replace(/\\/g, '/');
|
|
49
|
+
if (normalizedInput.split('/').includes('..'))
|
|
50
|
+
throw new Error(messages.parentTraversal);
|
|
51
|
+
const lexical = path.resolve(scope?.cwd ?? process.cwd(), input);
|
|
52
|
+
if (!scope)
|
|
53
|
+
return fs.realpathSync.native(lexical);
|
|
54
|
+
const project = fs.realpathSync.native(scope.projectPath);
|
|
55
|
+
const runtime = scope.sessionRuntimeDir
|
|
56
|
+
? fs.realpathSync.native(scope.sessionRuntimeDir)
|
|
57
|
+
: undefined;
|
|
58
|
+
const credentialRoot = kind === 'credential' ? path.join(agentDir(scope.selfAid), 'credentials') : undefined;
|
|
59
|
+
const inCredentialLexically = !!credentialRoot && isSameOrDescendant(lexical, credentialRoot);
|
|
60
|
+
if (credentialRoot) {
|
|
61
|
+
const agentRoot = path.dirname(credentialRoot);
|
|
62
|
+
const agentStat = fs.lstatSync(agentRoot);
|
|
63
|
+
if (!agentStat.isDirectory() || agentStat.isSymbolicLink())
|
|
64
|
+
throw new Error(messages.symbolicLink);
|
|
65
|
+
}
|
|
66
|
+
assertSessionRuntimeScope(lexical, runtime, messages.otherSessionTemp);
|
|
67
|
+
const inProjectLexically = isSameOrDescendant(lexical, project);
|
|
68
|
+
const inSessionTempLexically = !!runtime && isSameOrDescendant(lexical, runtime);
|
|
69
|
+
if (!inProjectLexically && !inSessionTempLexically && !inCredentialLexically) {
|
|
70
|
+
throw new Error(messages.outsideScope);
|
|
71
|
+
}
|
|
72
|
+
let current = lexical;
|
|
73
|
+
while (true) {
|
|
74
|
+
const stat = fs.lstatSync(current);
|
|
75
|
+
if (stat.isSymbolicLink()) {
|
|
76
|
+
throw new Error(messages.symbolicLink);
|
|
77
|
+
}
|
|
78
|
+
if (current === project || current === runtime || current === credentialRoot)
|
|
79
|
+
break;
|
|
80
|
+
const parent = path.dirname(current);
|
|
81
|
+
if (parent === current)
|
|
82
|
+
break;
|
|
83
|
+
current = parent;
|
|
84
|
+
}
|
|
85
|
+
const resolved = fs.realpathSync.native(lexical);
|
|
86
|
+
assertSessionRuntimeScope(resolved, runtime, messages.otherSessionTemp);
|
|
87
|
+
const inProject = isSameOrDescendant(lexical, project) && isSameOrDescendant(resolved, project);
|
|
88
|
+
const inSessionTemp = !!runtime
|
|
89
|
+
&& isSameOrDescendant(lexical, runtime)
|
|
90
|
+
&& isSameOrDescendant(resolved, runtime);
|
|
91
|
+
const inCredential = !!credentialRoot
|
|
92
|
+
&& inCredentialLexically && isSameOrDescendant(resolved, credentialRoot);
|
|
93
|
+
if (!inProject && !inSessionTemp && !inCredential) {
|
|
94
|
+
throw new Error(messages.outsideScope);
|
|
95
|
+
}
|
|
96
|
+
const root = resolveRoot();
|
|
97
|
+
const lexicalClass = classifyProtectedPath(lexical, { root, selfAid: scope.selfAid });
|
|
98
|
+
const resolvedClass = classifyProtectedPath(resolved, { root, selfAid: scope.selfAid });
|
|
99
|
+
if (!inCredential && !scope.allowProtectedPaths
|
|
100
|
+
&& (isProtectedManagedInputClass(lexicalClass) || isProtectedManagedInputClass(resolvedClass))) {
|
|
101
|
+
throw new Error(messages.protectedPath);
|
|
102
|
+
}
|
|
103
|
+
return resolved;
|
|
104
|
+
}
|
|
105
|
+
export function resolveTriggerLocalPath(input, scope) {
|
|
106
|
+
return resolveManagedLocalPath(input, scope, 'trigger');
|
|
107
|
+
}
|
|
108
|
+
export function resolveAttachmentLocalPath(input, scope) {
|
|
109
|
+
return resolveManagedLocalPath(input, scope, 'attachment');
|
|
110
|
+
}
|
|
111
|
+
/** 发送链路(--text-from-file / --payload-file)的路径校验。 */
|
|
112
|
+
export function resolveMessageLocalPath(input, scope) {
|
|
113
|
+
return resolveManagedLocalPath(input, scope, 'message');
|
|
114
|
+
}
|
|
115
|
+
function managedLocalFileMessages(kind) {
|
|
116
|
+
const label = managedLocalFileLabel(kind);
|
|
117
|
+
return {
|
|
118
|
+
invalidPath: `Invalid ${label.toLowerCase()} path`,
|
|
119
|
+
parentTraversal: `${label} path cannot traverse parent directories`,
|
|
120
|
+
outsideScope: kind === 'credential'
|
|
121
|
+
? 'Agent credential file must be inside the current project, session TMPDIR, or current Agent credentials directory'
|
|
122
|
+
: `${label} must be inside the current project or session TMPDIR`,
|
|
123
|
+
symbolicLink: `${label} must not traverse a symbolic link or junction`,
|
|
124
|
+
protectedPath: `${label} references a protected path`,
|
|
125
|
+
otherSessionTemp: `${label} must not reference another session TMPDIR`,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
function isProtectedManagedInputClass(value) {
|
|
129
|
+
return value === 'h-file' || value === 'h-directory' || value === 'l-path' || value === 'unknown';
|
|
130
|
+
}
|
|
131
|
+
function hasUnsafeWindowsPathSyntax(input) {
|
|
132
|
+
if (process.platform !== 'win32')
|
|
133
|
+
return false;
|
|
134
|
+
const normalized = input.replace(/\\/g, '/');
|
|
135
|
+
const withoutDrive = /^[A-Za-z]:\//.test(normalized) ? normalized.slice(2) : normalized;
|
|
136
|
+
return withoutDrive.includes(':') || withoutDrive.split('/').some(segment => (/[. ]$/.test(segment) && segment !== '.' && segment !== '..') || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(segment));
|
|
137
|
+
}
|
|
138
|
+
function assertSessionRuntimeScope(candidate, runtime, errorMessage) {
|
|
139
|
+
if (!runtime)
|
|
140
|
+
return;
|
|
141
|
+
const parent = path.dirname(runtime);
|
|
142
|
+
if (!isSameOrDescendant(candidate, parent))
|
|
143
|
+
return;
|
|
144
|
+
const firstSegment = path.relative(parent, candidate).split(path.sep)[0];
|
|
145
|
+
if (/^ec-session-[a-f0-9]{24}$/i.test(firstSegment)
|
|
146
|
+
&& !isSameOrDescendant(candidate, runtime)) {
|
|
147
|
+
throw new Error(errorMessage);
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
function sameFileIdentity(left, right) {
|
|
151
|
+
return left.dev === right.dev && left.ino === right.ino;
|
|
152
|
+
}
|
|
153
|
+
function sameFileMetadata(left, right) {
|
|
154
|
+
return left.size === right.size && left.mtimeMs === right.mtimeMs && left.ctimeMs === right.ctimeMs;
|
|
155
|
+
}
|
|
156
|
+
export function readManagedLocalFile(input, scope, kind) {
|
|
157
|
+
const sourceLabel = managedLocalFileLabel(kind);
|
|
158
|
+
const limit = managedLocalFileLimit(kind);
|
|
159
|
+
const resolved = resolveManagedLocalPath(input, scope, kind);
|
|
160
|
+
const expected = fs.lstatSync(resolved);
|
|
161
|
+
if (!expected.isFile())
|
|
162
|
+
throw new Error(`${sourceLabel} must be a regular file`);
|
|
163
|
+
if (scope && expected.nlink !== 1)
|
|
164
|
+
throw new Error(`${sourceLabel} must not be hard-linked`);
|
|
165
|
+
const noFollow = fs.constants.O_NOFOLLOW ?? 0;
|
|
166
|
+
const descriptor = fs.openSync(resolved, fs.constants.O_RDONLY | noFollow);
|
|
167
|
+
try {
|
|
168
|
+
const opened = fs.fstatSync(descriptor);
|
|
169
|
+
const openedPath = fs.lstatSync(resolved);
|
|
170
|
+
// Windows path and handle stats can report different dev/ino values for the
|
|
171
|
+
// same file. Compare identities within each API and metadata across APIs;
|
|
172
|
+
// retain the additional path-to-handle identity check on POSIX.
|
|
173
|
+
if (!opened.isFile() || !openedPath.isFile() || openedPath.isSymbolicLink()
|
|
174
|
+
|| !sameFileIdentity(openedPath, expected) || !sameFileMetadata(openedPath, expected)
|
|
175
|
+
|| (process.platform !== 'win32' && !sameFileIdentity(opened, expected))
|
|
176
|
+
|| !sameFileMetadata(opened, expected)
|
|
177
|
+
|| (scope && (opened.nlink !== 1 || openedPath.nlink !== 1))
|
|
178
|
+
|| resolveManagedLocalPath(input, scope, kind) !== resolved) {
|
|
179
|
+
throw new Error(`${sourceLabel} changed during validation`);
|
|
180
|
+
}
|
|
181
|
+
if (kind === 'credential' && process.platform !== 'win32' && (opened.mode & 0o077) !== 0) {
|
|
182
|
+
throw new Error('Agent credential file must be private (mode 0600)');
|
|
183
|
+
}
|
|
184
|
+
if (opened.size > limit) {
|
|
185
|
+
throw new Error(`${sourceLabel} exceeds the ${formatMiB(limit)} limit`);
|
|
186
|
+
}
|
|
187
|
+
const buffer = Buffer.alloc(Math.min(opened.size + 1, limit + 1));
|
|
188
|
+
let length = 0;
|
|
189
|
+
while (length < buffer.length) {
|
|
190
|
+
const count = fs.readSync(descriptor, buffer, length, buffer.length - length, length);
|
|
191
|
+
if (!count)
|
|
192
|
+
break;
|
|
193
|
+
length += count;
|
|
194
|
+
}
|
|
195
|
+
const afterRead = fs.fstatSync(descriptor);
|
|
196
|
+
const afterPath = fs.lstatSync(resolved);
|
|
197
|
+
if (length !== opened.size || !afterRead.isFile()
|
|
198
|
+
|| !sameFileIdentity(afterRead, opened) || !sameFileMetadata(afterRead, opened)
|
|
199
|
+
|| !sameFileIdentity(afterPath, expected)
|
|
200
|
+
|| !afterPath.isFile() || afterPath.isSymbolicLink() || !sameFileMetadata(afterPath, opened)
|
|
201
|
+
|| (scope && (afterRead.nlink !== 1 || afterPath.nlink !== 1))
|
|
202
|
+
|| resolveManagedLocalPath(input, scope, kind) !== resolved) {
|
|
203
|
+
throw new Error(`${sourceLabel} changed during reading`);
|
|
204
|
+
}
|
|
205
|
+
return buffer.subarray(0, length);
|
|
206
|
+
}
|
|
207
|
+
finally {
|
|
208
|
+
fs.closeSync(descriptor);
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
export function readTriggerLocalFile(input, scope) {
|
|
212
|
+
return readManagedLocalFile(input, scope, 'trigger');
|
|
213
|
+
}
|
|
214
|
+
/** 发送链路的文件读取:与 trigger 共用实现,但报错主语和上限不同。 */
|
|
215
|
+
export function readMessageLocalFile(input, scope) {
|
|
216
|
+
return readManagedLocalFile(input, scope, 'message');
|
|
217
|
+
}
|
|
218
|
+
/** 校验 base64 直传的 Trigger 脚本内容。 */
|
|
219
|
+
export function decodeManagedBase64File(contentBase64, label, limit) {
|
|
220
|
+
const maxBase64Length = 4 * Math.ceil(limit / 3);
|
|
221
|
+
if (typeof contentBase64 !== 'string'
|
|
222
|
+
|| contentBase64.length > maxBase64Length
|
|
223
|
+
|| contentBase64.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(contentBase64)) {
|
|
224
|
+
throw new Error(`${label} must be canonical base64 under ${formatMiB(limit)}`);
|
|
225
|
+
}
|
|
226
|
+
const contents = Buffer.from(contentBase64, 'base64');
|
|
227
|
+
if (contents.length > limit || contents.toString('base64') !== contentBase64) {
|
|
228
|
+
throw new Error(`${label} must be canonical base64 under ${formatMiB(limit)}`);
|
|
229
|
+
}
|
|
230
|
+
return contents;
|
|
231
|
+
}
|
|
232
|
+
export function decodeTriggerScriptFile(contentBase64) {
|
|
233
|
+
return decodeManagedBase64File(contentBase64, 'Trigger file content', TRIGGER_LOCAL_FILE_LIMIT);
|
|
234
|
+
}
|
|
@@ -457,6 +457,43 @@ export function getLClassWritePatterns(root = resolveRoot()) {
|
|
|
457
457
|
path.join(absoluteRoot, 'agents', '*', 'roles') + '/**',
|
|
458
458
|
];
|
|
459
459
|
}
|
|
460
|
+
export function getExistingCodexProjectSkillRoots(projectPath) {
|
|
461
|
+
const project = path.resolve(projectPath);
|
|
462
|
+
let repositoryRoot;
|
|
463
|
+
let cursor = project;
|
|
464
|
+
while (true) {
|
|
465
|
+
if (fs.existsSync(path.join(cursor, '.git'))) {
|
|
466
|
+
repositoryRoot = cursor;
|
|
467
|
+
break;
|
|
468
|
+
}
|
|
469
|
+
const parent = path.dirname(cursor);
|
|
470
|
+
if (parent === cursor)
|
|
471
|
+
break;
|
|
472
|
+
cursor = parent;
|
|
473
|
+
}
|
|
474
|
+
// Codex falls back to cwd when there is no repository marker.
|
|
475
|
+
repositoryRoot ??= project;
|
|
476
|
+
const candidates = new Set([
|
|
477
|
+
path.join(project, '.codex', 'skills'),
|
|
478
|
+
path.join(repositoryRoot, '.codex', 'skills'),
|
|
479
|
+
]);
|
|
480
|
+
for (cursor = project;; cursor = path.dirname(cursor)) {
|
|
481
|
+
candidates.add(path.join(cursor, '.agents', 'skills'));
|
|
482
|
+
if (cursor === repositoryRoot)
|
|
483
|
+
break;
|
|
484
|
+
}
|
|
485
|
+
const canonicalRoot = resolveThroughExistingAncestor(repositoryRoot);
|
|
486
|
+
return [...candidates].filter(target => {
|
|
487
|
+
try {
|
|
488
|
+
const expected = path.resolve(canonicalRoot, path.relative(repositoryRoot, target));
|
|
489
|
+
return fs.statSync(target).isDirectory()
|
|
490
|
+
&& normalizeForComparison(fs.realpathSync(target)) === normalizeForComparison(expected);
|
|
491
|
+
}
|
|
492
|
+
catch {
|
|
493
|
+
return false;
|
|
494
|
+
}
|
|
495
|
+
});
|
|
496
|
+
}
|
|
460
497
|
const CLAUDE_PROTECTED_TARGET_LIMIT = 8192;
|
|
461
498
|
const CLAUDE_GLOB_MAGIC = /[*?[\]]/;
|
|
462
499
|
const CODEX_GLOB_MAGIC = /[*?[\]]/;
|
|
@@ -721,6 +758,24 @@ export function getExistingAgentAttachmentDirs(root = resolveRoot(), options = {
|
|
|
721
758
|
catch { }
|
|
722
759
|
return [...targets];
|
|
723
760
|
}
|
|
761
|
+
export function getExistingSelfAttachmentDirs(root = resolveRoot(), options = {}) {
|
|
762
|
+
const selfAid = normalizeAid(options.selfAid);
|
|
763
|
+
if (!selfAid)
|
|
764
|
+
return [];
|
|
765
|
+
const directories = [
|
|
766
|
+
...getExistingAgentAttachmentDirs(root, { selfAid }),
|
|
767
|
+
...getExistingRelationAttachmentDirs(root, { selfAid }),
|
|
768
|
+
];
|
|
769
|
+
return [...new Set(directories)].filter(directory => {
|
|
770
|
+
try {
|
|
771
|
+
return !fs.lstatSync(directory).isSymbolicLink()
|
|
772
|
+
&& normalizeForComparison(fs.realpathSync(directory)) === normalizeForComparison(directory);
|
|
773
|
+
}
|
|
774
|
+
catch {
|
|
775
|
+
return false;
|
|
776
|
+
}
|
|
777
|
+
});
|
|
778
|
+
}
|
|
724
779
|
export function buildClaudeProtectedFilesystem(root = resolveRoot(), options = {}) {
|
|
725
780
|
const hClassPaths = [
|
|
726
781
|
...getExistingHClassMaskTargets(root, options).map(target => target.path),
|
|
@@ -1002,6 +1057,7 @@ export function buildCodexProtectedFilesystemRules(root = resolveRoot(), options
|
|
|
1002
1057
|
const filesystem = compactWindowsCodexFilesystemRules({
|
|
1003
1058
|
...buildCodexHClassFilesystemRules(root, hClassOptions),
|
|
1004
1059
|
...lClassRules,
|
|
1060
|
+
...Object.fromEntries(getExistingSelfAttachmentDirs(root, options).map(directory => [directory, 'read'])),
|
|
1005
1061
|
}, platform);
|
|
1006
1062
|
if (platform === 'linux' && options.outerHClassGuard) {
|
|
1007
1063
|
const dataDirectory = path.join(resolveThroughExistingAncestor(root), 'data');
|