@octopi-agent/engine 0.97.15 → 0.102.10
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/dist/config-schema/agent.d.ts +37 -5
- package/dist/config-schema/agent.js +24 -4
- package/dist/config-schema/context.d.ts +6 -36
- package/dist/config-schema/context.js +4 -28
- package/dist/config-schema/engine.d.ts +61 -160
- package/dist/config-schema/engine.js +1 -5
- package/dist/config-schema/governance.d.ts +10 -1
- package/dist/config-schema/governance.js +38 -1
- package/dist/config-schema/models.d.ts +2 -8
- package/dist/config-schema/models.js +0 -2
- package/dist/config-schema/run.d.ts +2 -2
- package/dist/config-schema/run.js +2 -2
- package/dist/config-schema/shared.d.ts +0 -3
- package/dist/config-schema/shared.js +0 -2
- package/dist/config-schema/substrate.d.ts +14 -88
- package/dist/config-schema/substrate.js +22 -107
- package/dist/config.d.ts +45 -113
- package/dist/config.js +8 -2
- package/dist/harness/activation/dispatcher.js +7 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- package/dist/harness/activation/runtime.js +13 -5
- package/dist/harness/activation/types.d.ts +2 -2
- package/dist/harness/agent/builder.d.ts +34 -2
- package/dist/harness/agent/builder.js +189 -58
- package/dist/harness/agent/config-bridge.js +9 -2
- package/dist/harness/agent/config-integrity.d.ts +66 -0
- package/dist/harness/agent/config-integrity.js +108 -2
- package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
- package/dist/harness/agent/wire-agent-builder.js +31 -7
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- package/dist/harness/capabilities/document/port.js +6 -3
- package/dist/harness/capabilities/document/types.d.ts +5 -0
- package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +21 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +12 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
- package/dist/harness/collaboration/delegation/child-run.js +4 -4
- package/dist/harness/collaboration/delegation/index.d.ts +1 -1
- package/dist/harness/collaboration/delegation/index.js +1 -1
- package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
- package/dist/harness/collaboration/delegation/notifier.js +8 -1
- package/dist/harness/collaboration/delegation/service.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.js +2 -1
- package/dist/harness/collaboration/delegation/store.d.ts +2 -0
- package/dist/harness/collaboration/delegation/store.js +2 -1
- package/dist/harness/collaboration/delegation/types.d.ts +23 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.js +11 -1
- package/dist/harness/context/budget-allocator.d.ts +26 -18
- package/dist/harness/context/budget-allocator.js +67 -32
- package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
- package/dist/harness/context/capabilities/compact/engine.js +169 -121
- package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
- package/dist/harness/context/capabilities/compact/handover.js +7 -5
- package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
- package/dist/harness/context/capabilities/compact/index.js +4 -0
- package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
- package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
- package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
- package/dist/harness/context/capabilities/compact/messages.js +91 -0
- package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
- package/dist/harness/context/capabilities/compact/types.js +11 -1
- package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
- package/dist/harness/context/capabilities/compact/view-split.js +72 -0
- package/dist/harness/context/capabilities/summary/port.js +0 -1
- package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/resolver.js +4 -9
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/types.d.ts +4 -7
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +236 -0
- package/dist/harness/context/default-context-engine.d.ts +195 -119
- package/dist/harness/context/default-context-engine.js +1241 -743
- package/dist/harness/context/index.d.ts +2 -2
- package/dist/harness/context/index.js +1 -1
- package/dist/harness/context/layer-types.d.ts +15 -0
- package/dist/harness/context/layer-types.js +14 -1
- package/dist/harness/context/layers.d.ts +16 -19
- package/dist/harness/context/layers.js +42 -14
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/summarize.d.ts +3 -3
- package/dist/harness/context/summarize.js +11 -4
- package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
- package/dist/harness/context/system-prompt-assembler.js +3 -1
- package/dist/harness/context/token-constants.d.ts +8 -6
- package/dist/harness/context/token-constants.js +8 -7
- package/dist/harness/context/token-estimate-fns.d.ts +37 -27
- package/dist/harness/context/token-estimate-fns.js +85 -66
- package/dist/harness/context/token-estimator.d.ts +27 -12
- package/dist/harness/context/token-estimator.js +120 -66
- package/dist/harness/context/token-segments.d.ts +88 -0
- package/dist/harness/context/token-segments.js +103 -0
- package/dist/harness/context/tool-result-aging.d.ts +6 -1
- package/dist/harness/context/tool-result-aging.js +16 -5
- package/dist/harness/context/tool-result-body.js +2 -0
- package/dist/harness/context/transform/anchors.d.ts +66 -0
- package/dist/harness/context/transform/anchors.js +125 -0
- package/dist/harness/context/transform/fold.d.ts +56 -0
- package/dist/harness/context/transform/fold.js +135 -0
- package/dist/harness/context/transform/migrate.d.ts +41 -0
- package/dist/harness/context/transform/migrate.js +69 -0
- package/dist/harness/context/transform/types.d.ts +129 -0
- package/dist/harness/context/transform/types.js +19 -0
- package/dist/harness/context/turn-envelope.d.ts +6 -3
- package/dist/harness/context/types.d.ts +127 -117
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +24 -2
- package/dist/harness/extension/execution-environment/effect-policy.js +30 -0
- package/dist/harness/extension/execution-environment/ops-audit.d.ts +7 -3
- package/dist/harness/extension/execution-environment/ops-audit.js +11 -12
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
- package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
- package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
- package/dist/harness/extension/execution-environment/undo-log.js +31 -10
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
- package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
- package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +17 -24
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
- package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
- package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
- package/dist/harness/governance/accounting/usage-ledger.js +23 -1
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
- package/dist/harness/governance/security/capability-enforcer.js +1 -2
- package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
- package/dist/harness/governance/security/default-risk-policy.js +1 -0
- package/dist/harness/governance/security/default-security-guard.js +9 -0
- package/dist/harness/governance/security/index.d.ts +1 -0
- package/dist/harness/governance/security/index.js +2 -0
- package/dist/harness/governance/security/risk-evaluator.js +13 -0
- package/dist/harness/governance/security/risk-types.d.ts +12 -0
- package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
- package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
- package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
- package/dist/harness/governance/security/shell-parser-shared.js +188 -0
- package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
- package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
- package/dist/harness/governance/security/shell-parser.d.ts +23 -10
- package/dist/harness/governance/security/shell-parser.js +37 -496
- package/dist/harness/governance/security/vendor/README.md +24 -0
- package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
- package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
- package/dist/harness/index.d.ts +12 -12
- package/dist/harness/index.js +7 -7
- package/dist/harness/knowledge/boot-config.d.ts +55 -0
- package/dist/harness/knowledge/boot-config.js +50 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +24 -2
- package/dist/harness/knowledge/client.js +19 -5
- package/dist/harness/knowledge/db.js +5 -0
- package/dist/harness/knowledge/describe-sample.d.ts +23 -0
- package/dist/harness/knowledge/describe-sample.js +58 -0
- package/dist/harness/knowledge/describe.d.ts +8 -0
- package/dist/harness/knowledge/describe.js +18 -2
- package/dist/harness/knowledge/engine-thread.js +6 -0
- package/dist/harness/knowledge/grounding.js +3 -1
- package/dist/harness/knowledge/http-app.js +35 -4
- package/dist/harness/knowledge/http-params.d.ts +18 -0
- package/dist/harness/knowledge/http-params.js +24 -0
- package/dist/harness/knowledge/index.d.ts +2 -0
- package/dist/harness/knowledge/index.js +1 -0
- package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +13 -2
- package/dist/harness/knowledge/query-service.js +4 -2
- package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
- package/dist/harness/knowledge/query-worker-client.js +4 -2
- package/dist/harness/knowledge/query-worker.js +4 -2
- package/dist/harness/knowledge/read-http.js +5 -1
- package/dist/harness/knowledge/serve.d.ts +8 -7
- package/dist/harness/knowledge/serve.js +9 -0
- package/dist/harness/knowledge/source-store.js +26 -3
- package/dist/harness/knowledge/start-service-process.d.ts +15 -7
- package/dist/harness/knowledge/start-service-process.js +21 -9
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +37 -9
- package/dist/harness/knowledge/writer-service.js +120 -14
- package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
- package/dist/harness/knowledge/writer-worker-client.js +20 -2
- package/dist/harness/knowledge/writer-worker.js +9 -1
- package/dist/harness/memory/index.d.ts +6 -2
- package/dist/harness/memory/index.js +4 -1
- package/dist/harness/memory/memory-events.d.ts +25 -0
- package/dist/harness/memory/memory-events.js +38 -0
- package/dist/harness/memory/sqlite/agent-db.js +15 -0
- package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
- package/dist/harness/memory/sqlite/wisdom-store.js +86 -12
- package/dist/harness/memory/steward-policy.d.ts +3 -0
- package/dist/harness/memory/steward-policy.js +1 -1
- package/dist/harness/memory/types.d.ts +47 -7
- package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
- package/dist/harness/memory/wisdom-attribution.js +287 -0
- package/dist/harness/memory/wisdom-events.d.ts +37 -0
- package/dist/harness/memory/wisdom-events.js +61 -0
- package/dist/harness/memory/wisdom-formation.d.ts +31 -1
- package/dist/harness/memory/wisdom-formation.js +130 -33
- package/dist/harness/memory/wisdom-gates.d.ts +14 -0
- package/dist/harness/memory/wisdom-gates.js +59 -19
- package/dist/harness/memory/wisdom.d.ts +7 -2
- package/dist/harness/memory/wisdom.js +49 -2
- package/dist/harness/observability/observer/hub.js +25 -15
- package/dist/harness/observability/observer/types.d.ts +10 -6
- package/dist/harness/run/agent/agent.d.ts +40 -21
- package/dist/harness/run/agent/agent.js +66 -13
- package/dist/harness/run/agent/index.d.ts +1 -1
- package/dist/harness/run/budget/budget.d.ts +28 -10
- package/dist/harness/run/budget/budget.js +38 -15
- package/dist/harness/run/model/index.d.ts +3 -1
- package/dist/harness/run/model/index.js +2 -1
- package/dist/harness/run/model/resolver.d.ts +4 -1
- package/dist/harness/run/model/resolver.js +36 -2
- package/dist/harness/run/model/run-scope.d.ts +2 -0
- package/dist/harness/run/model/run-scope.js +7 -0
- package/dist/harness/run/model/types.d.ts +22 -5
- package/dist/harness/run/model/types.js +3 -2
- package/dist/harness/run/model/window-truth.d.ts +37 -0
- package/dist/harness/run/model/window-truth.js +39 -0
- package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
- package/dist/harness/run/reliability/context-length-feedback.js +128 -0
- package/dist/harness/run/reliability/harness-events.d.ts +3 -3
- package/dist/harness/run/reliability/model-error-policy.js +4 -0
- package/dist/harness/run/reliability/run-agent.d.ts +10 -4
- package/dist/harness/run/reliability/run-agent.js +137 -53
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
- package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
- package/dist/harness/run/run-guard/default-run-guard.js +8 -8
- package/dist/harness/run/run-scope.d.ts +41 -4
- package/dist/harness/run/runner.d.ts +71 -31
- package/dist/harness/run/runner.js +368 -106
- package/dist/harness/session/attachments/index.d.ts +1 -0
- package/dist/harness/session/attachments/index.js +1 -0
- package/dist/harness/session/attachments/inject.d.ts +21 -10
- package/dist/harness/session/attachments/inject.js +76 -24
- package/dist/harness/session/attachments/recall-index.d.ts +70 -0
- package/dist/harness/session/attachments/recall-index.js +219 -0
- package/dist/harness/session/attachments/service.d.ts +21 -0
- package/dist/harness/session/attachments/service.js +258 -139
- package/dist/harness/session/attachments/types.d.ts +6 -0
- package/dist/harness/session/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +2 -2
- package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
- package/dist/harness/shared/events/agent-event-map.js +3 -2
- package/dist/harness/shared/events/scenario-events.d.ts +6 -6
- package/dist/harness/shared/paths/glob.d.ts +52 -0
- package/dist/harness/shared/paths/glob.js +218 -0
- package/dist/harness/shared/paths/index.d.ts +84 -0
- package/dist/harness/shared/paths/index.js +179 -0
- package/dist/harness/shared/types/agent-definition.d.ts +1 -2
- package/dist/index.d.ts +14 -17
- package/dist/index.js +7 -9
- package/dist/integration/observability/metrics.d.ts +6 -6
- package/dist/integration/observability/metrics.js +13 -13
- package/dist/integration/observability/observer-bridge.js +2 -2
- package/dist/integration/observability/trace-collector.d.ts +5 -5
- package/dist/integration/observability/trace-collector.js +34 -35
- package/dist/integration/observability/trace-events.d.ts +3 -3
- package/dist/integration/observability/trace-events.js +3 -3
- package/dist/integration/providers/anthropic.js +14 -1
- package/dist/integration/providers/openai.js +7 -1
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump.d.ts +1 -1
- package/dist/integration/storage/archive-manager.d.ts +6 -0
- package/dist/integration/storage/archive-manager.js +10 -0
- package/dist/integration/storage/jsonl.d.ts +1 -1
- package/dist/integration/storage/jsonl.js +18 -16
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
- package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
- package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
- package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
- package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
- package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
- package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +13 -5
- package/dist/subsystems/wisdom-steward/formation/handler.js +39 -23
- package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
- package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
- package/package.json +16 -14
- package/dist/harness/context/hybrid-compressor.d.ts +0 -41
- package/dist/harness/context/hybrid-compressor.js +0 -159
- package/dist/harness/context/llm-summarizer.d.ts +0 -46
- package/dist/harness/context/llm-summarizer.js +0 -249
- package/dist/harness/context/smart-router.d.ts +0 -75
- package/dist/harness/context/smart-router.js +0 -118
- package/dist/harness/context/truncate-compressor.d.ts +0 -28
- package/dist/harness/context/truncate-compressor.js +0 -107
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shell Parser Shared — 解析引擎共享常量与命令拆壳
|
|
3
|
+
*
|
|
4
|
+
* tree-sitter 适配层与 fallback 字符串解析器共用:
|
|
5
|
+
* 解释器名单、内联代码 flag、wrapper 命令拆壳、转义处理。
|
|
6
|
+
* 两个解析引擎必须保持同一套语义,否则风险分档会在引擎切换时漂移。
|
|
7
|
+
*/
|
|
8
|
+
// ── Wrapper 命令 ──
|
|
9
|
+
/** 已知的解释器名称(管道到解释器 = 执行外部代码) */
|
|
10
|
+
export const INTERPRETER_NAMES = new Set([
|
|
11
|
+
'sh', 'bash', 'zsh', 'dash', 'ksh', 'fish',
|
|
12
|
+
'python', 'python3', 'ruby', 'perl', 'node', 'php',
|
|
13
|
+
'lua', 'tclsh', 'Rscript', 'scala', 'groovy',
|
|
14
|
+
'powershell', 'powershell.exe', 'pwsh', 'pwsh.exe', 'cmd', 'cmd.exe',
|
|
15
|
+
]);
|
|
16
|
+
/**
|
|
17
|
+
* 已知的内联代码执行参数
|
|
18
|
+
*
|
|
19
|
+
* python -c "...", node -e "...", ruby -e "...", perl -e "..."
|
|
20
|
+
*/
|
|
21
|
+
export const INLINE_CODE_FLAGS = {
|
|
22
|
+
'python': ['-c'], 'python3': ['-c'],
|
|
23
|
+
'node': ['-e', '--eval'],
|
|
24
|
+
'ruby': ['-e'],
|
|
25
|
+
'perl': ['-e'],
|
|
26
|
+
'php': ['-r'],
|
|
27
|
+
'bash': ['-c'], 'sh': ['-c'], 'zsh': ['-c'],
|
|
28
|
+
// Windows shells
|
|
29
|
+
'powershell': ['-Command', '-command', '-c', '-EncodedCommand', '-encodedcommand'],
|
|
30
|
+
'powershell.exe': ['-Command', '-command', '-c', '-EncodedCommand', '-encodedcommand'],
|
|
31
|
+
'pwsh': ['-Command', '-command', '-c', '-EncodedCommand', '-encodedcommand'],
|
|
32
|
+
'pwsh.exe': ['-Command', '-command', '-c', '-EncodedCommand', '-encodedcommand'],
|
|
33
|
+
'cmd': ['/c', '/C', '/k', '/K'],
|
|
34
|
+
'cmd.exe': ['/c', '/C', '/k', '/K'],
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* 仅对真正的 wrapper 剥壳。
|
|
38
|
+
*
|
|
39
|
+
* 不要把 cmd/start 放进来:它们的选项(/c、/b)会被误当成命令名,
|
|
40
|
+
* 且 cmd /c 本身就是内联执行,应保留原命令以便 INLINE_CODE_FLAGS 识别。
|
|
41
|
+
*/
|
|
42
|
+
export const WRAPPER_COMMANDS = new Set([
|
|
43
|
+
'sudo', 'env', 'exec', 'nohup', 'strace', 'time',
|
|
44
|
+
]);
|
|
45
|
+
/** sudo 中带参数值的选项(选项后一个 token 是选项值,不是命令名) */
|
|
46
|
+
const SUDO_VALUE_FLAGS = new Set([
|
|
47
|
+
'-u', '-g', '-h', '-p', '-U', '-C', '-D', '-r', '-t', '-T',
|
|
48
|
+
'--user', '--group', '--host', '--prompt', '--role', '--type',
|
|
49
|
+
'--close-from', '--chdir', '--command-timeout',
|
|
50
|
+
]);
|
|
51
|
+
/** bash 需要被 `\` 转义的元字符。其余字符前的 `\` 视为 Windows 路径分隔符并原样保留。 */
|
|
52
|
+
export const BASH_ESCAPE_TARGETS = new Set([
|
|
53
|
+
'"', "'", '$', '`', ' ', '\t', '\n',
|
|
54
|
+
'|', '&', ';', '(', ')', '<', '>',
|
|
55
|
+
]);
|
|
56
|
+
/**
|
|
57
|
+
* 合并被空格切开的 Windows 绝对路径
|
|
58
|
+
*
|
|
59
|
+
* `del C:\Program Files\App\x.exe` → `C:\Program` + `Files\App\x.exe`
|
|
60
|
+
* → `C:\Program Files\App\x.exe`
|
|
61
|
+
*
|
|
62
|
+
* 规则:当前 token 是盘符/UNC 绝对路径,下一段含路径分隔符,
|
|
63
|
+
* 且当前最后一段无文件扩展名时合并。
|
|
64
|
+
* 已知局限:`cp C:\data backup\old` 也可能被误合并。
|
|
65
|
+
*/
|
|
66
|
+
export function mergeSplitWindowsPaths(tokens) {
|
|
67
|
+
const out = [];
|
|
68
|
+
let i = 0;
|
|
69
|
+
while (i < tokens.length) {
|
|
70
|
+
let cur = tokens[i];
|
|
71
|
+
while (i + 1 < tokens.length) {
|
|
72
|
+
if (!/^[A-Za-z]:[\\/]/.test(cur) && !cur.startsWith('\\\\'))
|
|
73
|
+
break;
|
|
74
|
+
const next = tokens[i + 1];
|
|
75
|
+
if (!next || next.startsWith('-') || next.startsWith('/'))
|
|
76
|
+
break;
|
|
77
|
+
if (/^[A-Za-z]:[\\/]/.test(next) || next.startsWith('\\\\'))
|
|
78
|
+
break;
|
|
79
|
+
if (!next.includes('\\') && !next.includes('/'))
|
|
80
|
+
break;
|
|
81
|
+
const lastSeg = cur.replace(/[\\/]+$/, '').split(/[\\/]/).pop() ?? '';
|
|
82
|
+
if (lastSeg.includes('.'))
|
|
83
|
+
break;
|
|
84
|
+
cur = `${cur} ${next}`;
|
|
85
|
+
i++;
|
|
86
|
+
}
|
|
87
|
+
out.push(cur);
|
|
88
|
+
i++;
|
|
89
|
+
}
|
|
90
|
+
return out;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* 去除单个 token 的 bash 反斜杠转义(引号已由解析层剥除)。
|
|
94
|
+
*
|
|
95
|
+
* `\` 仅在 BASH_ESCAPE_TARGETS 前被吃掉;其余位置的 `\`
|
|
96
|
+
* 按 Windows 路径分隔符保留(保护路径判定依赖完整路径串)。
|
|
97
|
+
*
|
|
98
|
+
* @param text - token 文本
|
|
99
|
+
* @returns 去转义后的值
|
|
100
|
+
*/
|
|
101
|
+
export function unescapeToken(text) {
|
|
102
|
+
let out = '';
|
|
103
|
+
for (let i = 0; i < text.length; i++) {
|
|
104
|
+
const ch = text[i];
|
|
105
|
+
if (ch === '\\' && i + 1 < text.length && BASH_ESCAPE_TARGETS.has(text[i + 1])) {
|
|
106
|
+
out += text[i + 1];
|
|
107
|
+
i++;
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
out += ch;
|
|
111
|
+
}
|
|
112
|
+
return out;
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* 剥掉 sudo/env/exec 等 wrapper,定位真实命令。
|
|
116
|
+
*
|
|
117
|
+
* @param tokens - 已去除重定向的 token 序列
|
|
118
|
+
* @returns 拆壳结果;wrapper 后无命令残留时返回 null
|
|
119
|
+
*/
|
|
120
|
+
export function unwrapWrapperTokens(tokens) {
|
|
121
|
+
const wrappers = [];
|
|
122
|
+
let i = 0;
|
|
123
|
+
while (i < tokens.length) {
|
|
124
|
+
const token = tokens[i];
|
|
125
|
+
if (!WRAPPER_COMMANDS.has(token))
|
|
126
|
+
break;
|
|
127
|
+
wrappers.push(token);
|
|
128
|
+
i++;
|
|
129
|
+
// sudo 的选项:无值选项直接跳过;带值选项连同选项值一起跳过
|
|
130
|
+
if (token === 'sudo') {
|
|
131
|
+
while (i < tokens.length && tokens[i].startsWith('-')) {
|
|
132
|
+
const flag = tokens[i].split('=', 1)[0];
|
|
133
|
+
i++;
|
|
134
|
+
if (SUDO_VALUE_FLAGS.has(flag) && i < tokens.length) {
|
|
135
|
+
i++;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
// env 跳过选项与环境变量(KEY=VALUE 格式)
|
|
140
|
+
if (token === 'env') {
|
|
141
|
+
while (i < tokens.length &&
|
|
142
|
+
(tokens[i].startsWith('-') || /^[A-Z_][A-Z0-9_]*=/.test(tokens[i]))) {
|
|
143
|
+
i++;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
if (i >= tokens.length)
|
|
148
|
+
return null;
|
|
149
|
+
return {
|
|
150
|
+
command: tokens[i],
|
|
151
|
+
args: tokens.slice(i + 1),
|
|
152
|
+
wrappers,
|
|
153
|
+
isSudo: wrappers.includes('sudo'),
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
// ── 特殊模式检测(与引擎无关的原始文本判定) ──
|
|
157
|
+
/**
|
|
158
|
+
* 检测后台执行
|
|
159
|
+
*
|
|
160
|
+
* @param cmd - 原始命令字符串
|
|
161
|
+
* @returns 是否以单个 `&` 结尾
|
|
162
|
+
*/
|
|
163
|
+
export function detectBackground(cmd) {
|
|
164
|
+
const trimmed = cmd.trim();
|
|
165
|
+
return trimmed.endsWith('&') && !trimmed.endsWith('&&');
|
|
166
|
+
}
|
|
167
|
+
/**
|
|
168
|
+
* 检测内联代码执行(按已拆壳的命令段)
|
|
169
|
+
*
|
|
170
|
+
* python -c "...", node -e "...", bash -c "...",
|
|
171
|
+
* powershell -Command "...", cmd /c "..." 等。命令名大小写不敏感(Windows shell)。
|
|
172
|
+
*
|
|
173
|
+
* @param segments - 已拆壳的命令段列表
|
|
174
|
+
* @returns 是否存在内联代码形态
|
|
175
|
+
*/
|
|
176
|
+
export function detectInlineCode(segments) {
|
|
177
|
+
for (const seg of segments) {
|
|
178
|
+
const flags = INLINE_CODE_FLAGS[seg.command] ??
|
|
179
|
+
INLINE_CODE_FLAGS[seg.command.toLowerCase()];
|
|
180
|
+
if (!flags)
|
|
181
|
+
continue;
|
|
182
|
+
const argSet = new Set(seg.args.map((a) => a.toLowerCase()));
|
|
183
|
+
if (flags.some((f) => argSet.has(f.toLowerCase()))) {
|
|
184
|
+
return true;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
return false;
|
|
188
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shell Parser (tree-sitter) — 主解析引擎
|
|
3
|
+
*
|
|
4
|
+
* 基于 web-tree-sitter + tree-sitter-bash(vendored wasm,见 vendor/)。
|
|
5
|
+
* 容错解析:引号、`$()`、heredoc、`[[ ]]`、重定向等结构由语法树精确还原,
|
|
6
|
+
* 不再依赖字符串启发式(字符串解析历史上曾在引号内 `2>/dev/null` 类文本上误判)。
|
|
7
|
+
*
|
|
8
|
+
* 适配职责:把 bash 语法树映射回 ParsedCommand/ParsedSegment 契约,
|
|
9
|
+
* 风险评估(risk-evaluator)与降级策略(degradation)无需感知引擎差异。
|
|
10
|
+
*
|
|
11
|
+
* 映射约定:
|
|
12
|
+
* - `variable_assignment`(`VAR=val`)/ `declaration_command`(export/declare/local)
|
|
13
|
+
* 是声明不是命令执行,不产生命令段;值里的 `$(...)` 仍按子 shell 检测。
|
|
14
|
+
* - 命令替换/进程替换/子 shell(`$(...)`、反引号、`<(…)`、`(…)`)里的命令
|
|
15
|
+
* 会真实执行,因此展开为独立命令段参与风险评估。
|
|
16
|
+
* - heredoc 正文是 stdin 数据:字面内容不解析、不产生路径目标;定界符未加引号时
|
|
17
|
+
* 正文里的 `$(...)` 属真实执行,照常展开为命令段。
|
|
18
|
+
* - 整句重定向(如 `for …; done > /dev/null`)挂在句内第一个命令段上;
|
|
19
|
+
* 句内无命令时(`> file` 单独成句)记入 orphanRedirects,仍参与路径评估。
|
|
20
|
+
* - 语法树含 ERROR/MISSING 时返回 null,由 facade 回退 fallback 引擎并标记不确定。
|
|
21
|
+
*
|
|
22
|
+
* 初始化是异步的(WASM 加载);解析是同步的。生产路径在 Agent 构建时
|
|
23
|
+
* await initShellParser(),未初始化时 facade 自动回退 fallback 引擎。
|
|
24
|
+
*/
|
|
25
|
+
import type { ParsedCommand } from './risk-types.js';
|
|
26
|
+
/**
|
|
27
|
+
* 初始化 tree-sitter 解析引擎(幂等)
|
|
28
|
+
*
|
|
29
|
+
* 失败不抛错:降级到 fallback 引擎(parseShellCommand 自动回退),仅告警。
|
|
30
|
+
*/
|
|
31
|
+
export declare function initShellParser(): Promise<void>;
|
|
32
|
+
/**
|
|
33
|
+
* tree-sitter 引擎是否就绪
|
|
34
|
+
*
|
|
35
|
+
* @returns 是否已成功初始化
|
|
36
|
+
*/
|
|
37
|
+
export declare function isShellParserReady(): boolean;
|
|
38
|
+
/**
|
|
39
|
+
* 当前生效的解析引擎
|
|
40
|
+
*
|
|
41
|
+
* @returns 'treesitter' 或 'fallback'
|
|
42
|
+
*/
|
|
43
|
+
export declare function getShellParserEngine(): 'treesitter' | 'fallback';
|
|
44
|
+
/**
|
|
45
|
+
* 用 tree-sitter 解析 Shell 命令
|
|
46
|
+
*
|
|
47
|
+
* @param raw - 原始命令字符串
|
|
48
|
+
* @returns 解析结果;引擎未就绪、语法树含 ERROR 或内部异常时返回 null(调用方回退)
|
|
49
|
+
*/
|
|
50
|
+
export declare function parseShellCommandWithTreeSitter(raw: string): (ParsedCommand & {
|
|
51
|
+
parsed: boolean;
|
|
52
|
+
}) | null;
|
|
@@ -0,0 +1,370 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shell Parser (tree-sitter) — 主解析引擎
|
|
3
|
+
*
|
|
4
|
+
* 基于 web-tree-sitter + tree-sitter-bash(vendored wasm,见 vendor/)。
|
|
5
|
+
* 容错解析:引号、`$()`、heredoc、`[[ ]]`、重定向等结构由语法树精确还原,
|
|
6
|
+
* 不再依赖字符串启发式(字符串解析历史上曾在引号内 `2>/dev/null` 类文本上误判)。
|
|
7
|
+
*
|
|
8
|
+
* 适配职责:把 bash 语法树映射回 ParsedCommand/ParsedSegment 契约,
|
|
9
|
+
* 风险评估(risk-evaluator)与降级策略(degradation)无需感知引擎差异。
|
|
10
|
+
*
|
|
11
|
+
* 映射约定:
|
|
12
|
+
* - `variable_assignment`(`VAR=val`)/ `declaration_command`(export/declare/local)
|
|
13
|
+
* 是声明不是命令执行,不产生命令段;值里的 `$(...)` 仍按子 shell 检测。
|
|
14
|
+
* - 命令替换/进程替换/子 shell(`$(...)`、反引号、`<(…)`、`(…)`)里的命令
|
|
15
|
+
* 会真实执行,因此展开为独立命令段参与风险评估。
|
|
16
|
+
* - heredoc 正文是 stdin 数据:字面内容不解析、不产生路径目标;定界符未加引号时
|
|
17
|
+
* 正文里的 `$(...)` 属真实执行,照常展开为命令段。
|
|
18
|
+
* - 整句重定向(如 `for …; done > /dev/null`)挂在句内第一个命令段上;
|
|
19
|
+
* 句内无命令时(`> file` 单独成句)记入 orphanRedirects,仍参与路径评估。
|
|
20
|
+
* - 语法树含 ERROR/MISSING 时返回 null,由 facade 回退 fallback 引擎并标记不确定。
|
|
21
|
+
*
|
|
22
|
+
* 初始化是异步的(WASM 加载);解析是同步的。生产路径在 Agent 构建时
|
|
23
|
+
* await initShellParser(),未初始化时 facade 自动回退 fallback 引擎。
|
|
24
|
+
*/
|
|
25
|
+
import { INTERPRETER_NAMES, unescapeToken, mergeSplitWindowsPaths, unwrapWrapperTokens, detectBackground, detectInlineCode, } from './shell-parser-shared.js';
|
|
26
|
+
// ── 初始化 ──
|
|
27
|
+
let parserInstance = null;
|
|
28
|
+
let initPromise = null;
|
|
29
|
+
/**
|
|
30
|
+
* 初始化 tree-sitter 解析引擎(幂等)
|
|
31
|
+
*
|
|
32
|
+
* 失败不抛错:降级到 fallback 引擎(parseShellCommand 自动回退),仅告警。
|
|
33
|
+
*/
|
|
34
|
+
export async function initShellParser() {
|
|
35
|
+
if (parserInstance)
|
|
36
|
+
return;
|
|
37
|
+
initPromise ??= doInit();
|
|
38
|
+
await initPromise;
|
|
39
|
+
}
|
|
40
|
+
async function doInit() {
|
|
41
|
+
try {
|
|
42
|
+
const { Parser: TsParser, Language: TsLanguage } = await import('web-tree-sitter');
|
|
43
|
+
await TsParser.init();
|
|
44
|
+
const language = await TsLanguage.load(new URL('./vendor/tree-sitter-bash.wasm', import.meta.url));
|
|
45
|
+
const instance = new TsParser();
|
|
46
|
+
instance.setLanguage(language);
|
|
47
|
+
parserInstance = instance;
|
|
48
|
+
}
|
|
49
|
+
catch (err) {
|
|
50
|
+
// 吞掉的是 WASM 加载/编译失败(环境问题,重试不会改变结果):
|
|
51
|
+
// 解析能力降级到 fallback 引擎,功能不中断;此处是加载失败唯一会到达的路径。
|
|
52
|
+
console.warn('[shell-parser] tree-sitter 初始化失败,回退 fallback 解析器:', err);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* tree-sitter 引擎是否就绪
|
|
57
|
+
*
|
|
58
|
+
* @returns 是否已成功初始化
|
|
59
|
+
*/
|
|
60
|
+
export function isShellParserReady() {
|
|
61
|
+
return parserInstance !== null;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* 当前生效的解析引擎
|
|
65
|
+
*
|
|
66
|
+
* @returns 'treesitter' 或 'fallback'
|
|
67
|
+
*/
|
|
68
|
+
export function getShellParserEngine() {
|
|
69
|
+
return parserInstance ? 'treesitter' : 'fallback';
|
|
70
|
+
}
|
|
71
|
+
// ── 解析入口 ──
|
|
72
|
+
/**
|
|
73
|
+
* 用 tree-sitter 解析 Shell 命令
|
|
74
|
+
*
|
|
75
|
+
* @param raw - 原始命令字符串
|
|
76
|
+
* @returns 解析结果;引擎未就绪、语法树含 ERROR 或内部异常时返回 null(调用方回退)
|
|
77
|
+
*/
|
|
78
|
+
export function parseShellCommandWithTreeSitter(raw) {
|
|
79
|
+
if (!parserInstance)
|
|
80
|
+
return null;
|
|
81
|
+
try {
|
|
82
|
+
const tree = parserInstance.parse(raw);
|
|
83
|
+
try {
|
|
84
|
+
if (!tree || tree.rootNode.hasError)
|
|
85
|
+
return null;
|
|
86
|
+
return mapTree(raw, tree.rootNode);
|
|
87
|
+
}
|
|
88
|
+
finally {
|
|
89
|
+
// 映射已把数据拷成普通对象;显式释放 WASM 侧树内存(热路径,不等 GC)
|
|
90
|
+
tree?.delete();
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
// 吞掉的是 web-tree-sitter 对极端输入的内部异常(如超长/异常字节序列):
|
|
95
|
+
// 返回 null 由 facade 回退 fallback 并标记不确定;解析本身无其他失败路径。
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
function mapTree(raw, root) {
|
|
100
|
+
const ctx = { segments: [], orphans: [] };
|
|
101
|
+
extract(root, ctx, null);
|
|
102
|
+
const spanned = ctx.segments.sort((a, b) => a.start - b.start);
|
|
103
|
+
const segments = spanned.map((s) => s.seg);
|
|
104
|
+
const connectors = buildConnectors(raw, spanned);
|
|
105
|
+
return {
|
|
106
|
+
parsed: true,
|
|
107
|
+
raw,
|
|
108
|
+
segments,
|
|
109
|
+
connectors,
|
|
110
|
+
hasShellPipe: detectShellPipe(root),
|
|
111
|
+
hasInlineCode: detectInlineCode(segments),
|
|
112
|
+
hasSubshell: detectSubshellNodes(root),
|
|
113
|
+
hasBackground: detectBackground(raw),
|
|
114
|
+
orphanRedirects: ctx.orphans.length > 0 ? ctx.orphans : undefined,
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* 提取命令段
|
|
119
|
+
*
|
|
120
|
+
* @param node - 当前语法树节点
|
|
121
|
+
* @param ctx - 收集器
|
|
122
|
+
* @param spanNode - 整句包装节点(redirected_statement),用于连接符定位
|
|
123
|
+
*/
|
|
124
|
+
function extract(node, ctx, spanNode) {
|
|
125
|
+
switch (node.type) {
|
|
126
|
+
case 'redirected_statement': {
|
|
127
|
+
const redirects = [];
|
|
128
|
+
let body = null;
|
|
129
|
+
for (const child of node.namedChildren) {
|
|
130
|
+
if (child.type === 'file_redirect') {
|
|
131
|
+
const redirect = mapFileRedirect(child);
|
|
132
|
+
if (redirect)
|
|
133
|
+
redirects.push(redirect);
|
|
134
|
+
// 重定向目标里的命令替换仍会执行
|
|
135
|
+
extract(child, ctx, null);
|
|
136
|
+
}
|
|
137
|
+
else if (child.type === 'heredoc_redirect') {
|
|
138
|
+
// heredoc 正文是 stdin 数据:字面内容不执行,也不产生路径目标;
|
|
139
|
+
// 但定界符未加引号时正文里的 $(...) 会真实执行
|
|
140
|
+
// (语法树只在未引号 heredoc 中展开命令替换)——照常下钻提取
|
|
141
|
+
extract(child, ctx, null);
|
|
142
|
+
}
|
|
143
|
+
else if (!body) {
|
|
144
|
+
body = child;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
const before = ctx.segments.length;
|
|
148
|
+
if (body)
|
|
149
|
+
extract(body, ctx, node);
|
|
150
|
+
if (redirects.length > 0) {
|
|
151
|
+
if (ctx.segments.length > before) {
|
|
152
|
+
// 整句重定向挂在句内第一个命令段上(目标风险由重定向目标评估兜底)
|
|
153
|
+
ctx.segments[before].seg.redirects.push(...redirects);
|
|
154
|
+
}
|
|
155
|
+
else {
|
|
156
|
+
// 句内无命令(`> file` 单独成句):目标仍可能是写入,不可丢
|
|
157
|
+
ctx.orphans.push(...redirects);
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return;
|
|
161
|
+
}
|
|
162
|
+
case 'command': {
|
|
163
|
+
const seg = mapCommand(node);
|
|
164
|
+
if (seg) {
|
|
165
|
+
const span = spanNode ?? node;
|
|
166
|
+
ctx.segments.push({ seg, start: span.startIndex, end: span.endIndex });
|
|
167
|
+
}
|
|
168
|
+
break;
|
|
169
|
+
}
|
|
170
|
+
default:
|
|
171
|
+
break;
|
|
172
|
+
}
|
|
173
|
+
// 通用递归:命令替换/子 shell/进程替换里的命令会真实执行
|
|
174
|
+
for (const child of node.namedChildren) {
|
|
175
|
+
extract(child, ctx, null);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* 映射单条命令节点
|
|
180
|
+
*
|
|
181
|
+
* @param node - command 节点
|
|
182
|
+
* @returns 命令段;无命令名(纯赋值等)时返回 null
|
|
183
|
+
*/
|
|
184
|
+
function mapCommand(node) {
|
|
185
|
+
let commandName = null;
|
|
186
|
+
const argNodes = [];
|
|
187
|
+
const redirects = [];
|
|
188
|
+
for (const child of node.namedChildren) {
|
|
189
|
+
// 命令名之前的 KEY=VAL 是环境赋值不是参数;命令名之后的是实参
|
|
190
|
+
if (child.type === 'variable_assignment' && !commandName)
|
|
191
|
+
continue;
|
|
192
|
+
if (child.type === 'file_redirect') {
|
|
193
|
+
// 挂在命令节点自身的重定向(少见形态):目标不可静默丢弃
|
|
194
|
+
const redirect = mapFileRedirect(child);
|
|
195
|
+
if (redirect)
|
|
196
|
+
redirects.push(redirect);
|
|
197
|
+
continue;
|
|
198
|
+
}
|
|
199
|
+
if (child.type === 'heredoc_redirect')
|
|
200
|
+
continue;
|
|
201
|
+
if (!commandName && child.type === 'command_name') {
|
|
202
|
+
commandName = child;
|
|
203
|
+
continue;
|
|
204
|
+
}
|
|
205
|
+
argNodes.push(child);
|
|
206
|
+
}
|
|
207
|
+
if (!commandName)
|
|
208
|
+
return null;
|
|
209
|
+
const command = wordValue(commandName);
|
|
210
|
+
const args = argNodes.map(wordValue);
|
|
211
|
+
// Windows 未加引号的空格路径先合并(`del C:\Program Files\App\x.exe`),
|
|
212
|
+
// 再走与 fallback 相同的 wrapper 拆壳;两引擎此语义必须一致
|
|
213
|
+
const unwrapped = unwrapWrapperTokens(mergeSplitWindowsPaths([command, ...args]));
|
|
214
|
+
if (!unwrapped)
|
|
215
|
+
return null;
|
|
216
|
+
return {
|
|
217
|
+
command: unwrapped.command,
|
|
218
|
+
args: unwrapped.args,
|
|
219
|
+
redirects,
|
|
220
|
+
isSudo: unwrapped.isSudo,
|
|
221
|
+
wrappers: unwrapped.wrappers,
|
|
222
|
+
raw: node.text,
|
|
223
|
+
};
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* 映射重定向节点
|
|
227
|
+
*
|
|
228
|
+
* @param node - file_redirect 节点
|
|
229
|
+
* @returns 重定向信息;缺目标时返回 null
|
|
230
|
+
*/
|
|
231
|
+
function mapFileRedirect(node) {
|
|
232
|
+
let op = '';
|
|
233
|
+
let destination = null;
|
|
234
|
+
for (const child of node.children) {
|
|
235
|
+
// 操作符是匿名 token(>、>>、<、&>、>& 等),type 等于原文
|
|
236
|
+
if (child.namedChildren.length === 0 && /^[<>&]+$/.test(child.text)) {
|
|
237
|
+
op += child.text;
|
|
238
|
+
continue;
|
|
239
|
+
}
|
|
240
|
+
if (child.type === 'file_descriptor')
|
|
241
|
+
continue;
|
|
242
|
+
destination = child;
|
|
243
|
+
}
|
|
244
|
+
if (!destination)
|
|
245
|
+
return null;
|
|
246
|
+
// fd 复制(`2>&1`、`>&2`):目标是 fd 号不是路径,沿用 fd:N 标记
|
|
247
|
+
const target = destination.type === 'number' && op.includes('&')
|
|
248
|
+
? `fd:${destination.text}`
|
|
249
|
+
: wordValue(destination);
|
|
250
|
+
let type;
|
|
251
|
+
if (op.includes('>>'))
|
|
252
|
+
type = 'append';
|
|
253
|
+
else if (op.includes('<'))
|
|
254
|
+
type = 'input';
|
|
255
|
+
else
|
|
256
|
+
type = 'overwrite';
|
|
257
|
+
return { type, target };
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* 提取词值:剥引号、去 bash 转义,插值/命令替换保留原文
|
|
261
|
+
*
|
|
262
|
+
* @param node - 词类节点(word/string/raw_string/number/expansion/…)
|
|
263
|
+
* @returns 风险评估用的词值
|
|
264
|
+
*/
|
|
265
|
+
function wordValue(node) {
|
|
266
|
+
switch (node.type) {
|
|
267
|
+
case 'ansi_c_string':
|
|
268
|
+
// $'...' ANSI-C 引用:剥掉 `$'` 与收尾 `'`,按转义规则还原
|
|
269
|
+
return unescapeToken(node.text.slice(2, -1));
|
|
270
|
+
case 'raw_string':
|
|
271
|
+
// 单引号内全字面量(含反斜杠),只剥外层引号
|
|
272
|
+
return node.text.slice(1, -1);
|
|
273
|
+
case 'string':
|
|
274
|
+
case 'concatenation': {
|
|
275
|
+
let out = '';
|
|
276
|
+
for (const child of node.namedChildren) {
|
|
277
|
+
out += wordValue(child);
|
|
278
|
+
}
|
|
279
|
+
return out;
|
|
280
|
+
}
|
|
281
|
+
case 'command_name':
|
|
282
|
+
case 'word':
|
|
283
|
+
case 'number': {
|
|
284
|
+
if (node.namedChildren.length > 0) {
|
|
285
|
+
let out = '';
|
|
286
|
+
for (const child of node.namedChildren) {
|
|
287
|
+
out += wordValue(child);
|
|
288
|
+
}
|
|
289
|
+
return out;
|
|
290
|
+
}
|
|
291
|
+
return unescapeToken(node.text);
|
|
292
|
+
}
|
|
293
|
+
case 'string_content':
|
|
294
|
+
return unescapeToken(node.text);
|
|
295
|
+
default:
|
|
296
|
+
// expansion / simple_expansion / command_substitution / process_substitution /
|
|
297
|
+
// arithmetic_expansion 等:保留原文(内联载荷探测按原文匹配)
|
|
298
|
+
return node.text;
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
// ── 连接符(按相邻命令段之间的原文定位) ──
|
|
302
|
+
/**
|
|
303
|
+
* 构建连接符列表
|
|
304
|
+
*
|
|
305
|
+
* @param raw - 原始命令
|
|
306
|
+
* @param spanned - 按源位置排序的命令段
|
|
307
|
+
* @returns 相邻命令段之间的连接符
|
|
308
|
+
*/
|
|
309
|
+
function buildConnectors(raw, spanned) {
|
|
310
|
+
const connectors = [];
|
|
311
|
+
for (let i = 0; i + 1 < spanned.length; i++) {
|
|
312
|
+
const prev = spanned[i];
|
|
313
|
+
const next = spanned[i + 1];
|
|
314
|
+
// 嵌套命令替换(下一段落在上一段源区间内)没有分隔原文,按 ; 处理
|
|
315
|
+
if (next.start < prev.end) {
|
|
316
|
+
connectors.push(';');
|
|
317
|
+
continue;
|
|
318
|
+
}
|
|
319
|
+
const slice = raw.slice(prev.end, next.start);
|
|
320
|
+
const match = slice.match(/\|\||&&|[|;&\n]/);
|
|
321
|
+
connectors.push((match ? match[0] : '\n'));
|
|
322
|
+
}
|
|
323
|
+
return connectors;
|
|
324
|
+
}
|
|
325
|
+
// ── 特殊模式检测(结构判定) ──
|
|
326
|
+
function walk(node, visit) {
|
|
327
|
+
visit(node);
|
|
328
|
+
for (const child of node.namedChildren) {
|
|
329
|
+
walk(child, visit);
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
/**
|
|
333
|
+
* 检测管道到解释器(管道最后一级是裸解释器)
|
|
334
|
+
*/
|
|
335
|
+
function detectShellPipe(root) {
|
|
336
|
+
let found = false;
|
|
337
|
+
walk(root, (n) => {
|
|
338
|
+
if (found || n.type !== 'pipeline')
|
|
339
|
+
return;
|
|
340
|
+
const named = n.namedChildren;
|
|
341
|
+
if (named.length < 2)
|
|
342
|
+
return;
|
|
343
|
+
// 末级可能被整句重定向包裹(`a | bash >log | …`):剥一层再看
|
|
344
|
+
const last = named[named.length - 1];
|
|
345
|
+
const target = last.type === 'redirected_statement'
|
|
346
|
+
? last.namedChildren.find((c) => c.type === 'command')
|
|
347
|
+
: last;
|
|
348
|
+
const seg = target && target.type === 'command' ? mapCommand(target) : null;
|
|
349
|
+
if (seg && INTERPRETER_NAMES.has(seg.command) && seg.args.length === 0) {
|
|
350
|
+
found = true;
|
|
351
|
+
}
|
|
352
|
+
});
|
|
353
|
+
return found;
|
|
354
|
+
}
|
|
355
|
+
/**
|
|
356
|
+
* 检测子 shell($(...)、反引号、(...))
|
|
357
|
+
*
|
|
358
|
+
* 结构判定:单引号里的字面 `$(...)` 不会误报(fallback 的 raw 扫描会)。
|
|
359
|
+
*/
|
|
360
|
+
function detectSubshellNodes(root) {
|
|
361
|
+
let found = false;
|
|
362
|
+
walk(root, (n) => {
|
|
363
|
+
if (found)
|
|
364
|
+
return;
|
|
365
|
+
if (n.type === 'command_substitution' || n.type === 'subshell') {
|
|
366
|
+
found = true;
|
|
367
|
+
}
|
|
368
|
+
});
|
|
369
|
+
return found;
|
|
370
|
+
}
|
|
@@ -1,17 +1,20 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Shell Parser —
|
|
2
|
+
* Shell Parser — 解析入口 facade
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
* 3. 识别 >, >>, < 重定向 → 提取目标路径
|
|
9
|
-
* 4. 识别 sudo, env, exec 等 wrapper → 解包实际命令
|
|
4
|
+
* 主引擎:tree-sitter(shell-parser-treesitter.ts,vendored bash 语法 wasm);
|
|
5
|
+
* 回退引擎:纯字符串解析(shell-parser-fallback.ts,长期保留的降级防线,
|
|
6
|
+
* 保证主引擎缺席/解析报错时硬边界探测仍有输入)。
|
|
7
|
+
* 消费方(risk-evaluator / degradation)只依赖本模块导出,不感知引擎差异。
|
|
10
8
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
9
|
+
* 回退语义:
|
|
10
|
+
* - 引擎未初始化(未走 Agent 构建引导的直接调用,如单元测试)→ fallback 结果;
|
|
11
|
+
* - tree-sitter 对某输入解析报错(语法树含 ERROR)或内部异常 → fallback 结果
|
|
12
|
+
* 并标记 `uncertain: true`,风险分档会附加「结构不确定」因子走 unknown 通道。
|
|
13
13
|
*/
|
|
14
14
|
import type { ParsedCommand } from './risk-types.js';
|
|
15
|
+
import { initShellParser, isShellParserReady, getShellParserEngine } from './shell-parser-treesitter.js';
|
|
16
|
+
export { initShellParser, isShellParserReady, getShellParserEngine };
|
|
17
|
+
export { parseShellCommandFallback } from './shell-parser-fallback.js';
|
|
15
18
|
/**
|
|
16
19
|
* 解析 Shell 命令
|
|
17
20
|
*
|
|
@@ -23,13 +26,23 @@ export declare function parseShellCommand(raw: string): ParsedCommand & {
|
|
|
23
26
|
};
|
|
24
27
|
/**
|
|
25
28
|
* 获取所有命令名(不含 wrapper)
|
|
29
|
+
*
|
|
30
|
+
* @param parsed - 解析结果
|
|
31
|
+
* @returns 命令名列表
|
|
26
32
|
*/
|
|
27
33
|
export declare function getCommandNames(parsed: ParsedCommand): string[];
|
|
28
34
|
/**
|
|
29
|
-
*
|
|
35
|
+
* 获取所有重定向目标路径(含未挂载到命令段的孤立重定向)
|
|
36
|
+
*
|
|
37
|
+
* @param parsed - 解析结果
|
|
38
|
+
* @returns 重定向目标列表
|
|
30
39
|
*/
|
|
31
40
|
export declare function getRedirectTargets(parsed: ParsedCommand): string[];
|
|
32
41
|
/**
|
|
33
42
|
* 判断命令是否包含指定的命令名
|
|
43
|
+
*
|
|
44
|
+
* @param parsed - 解析结果
|
|
45
|
+
* @param command - 命令名
|
|
46
|
+
* @returns 是否包含
|
|
34
47
|
*/
|
|
35
48
|
export declare function hasCommand(parsed: ParsedCommand, command: string): boolean;
|