@octopi-agent/engine 0.70.7 → 0.86.38
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/LICENSE +201 -201
- package/NOTICE +7 -7
- package/README.md +64 -26
- package/dist/config-schema/agent.d.ts +89 -1
- package/dist/config-schema/agent.js +69 -0
- package/dist/config-schema/context.d.ts +23 -4
- package/dist/config-schema/context.js +28 -1
- package/dist/config-schema/engine.d.ts +201 -9
- package/dist/config-schema/engine.js +31 -2
- package/dist/config-schema/governance.d.ts +95 -0
- package/dist/config-schema/governance.js +91 -0
- package/dist/config-schema/models.d.ts +1 -1
- package/dist/config-schema/observability.d.ts +6 -0
- package/dist/config-schema/observability.js +16 -0
- package/dist/config-schema/run.d.ts +10 -0
- package/dist/config-schema/run.js +18 -0
- package/dist/config-schema/shared.d.ts +10 -0
- package/dist/config-schema/shared.js +10 -0
- package/dist/config-schema/substrate.d.ts +1 -1
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +178 -7
- package/dist/config.js +113 -3
- package/dist/harness/activation/compiler.js +3 -0
- package/dist/harness/activation/runtime.d.ts +7 -0
- package/dist/harness/activation/runtime.js +60 -2
- package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
- package/dist/harness/activation/sources/agent-signal.js +33 -0
- package/dist/harness/activation/types.d.ts +6 -1
- package/dist/harness/agent/builder.d.ts +47 -3
- package/dist/harness/agent/builder.js +180 -54
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +81 -291
- package/dist/harness/agent/index.d.ts +3 -1
- package/dist/harness/agent/index.js +2 -1
- package/dist/harness/agent/tool-purpose.d.ts +38 -0
- package/dist/harness/agent/tool-purpose.js +118 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
- package/dist/harness/agent/wire-agent-builder.js +363 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
- package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
- package/dist/harness/collaboration/delegation/child-run.js +241 -0
- package/dist/harness/collaboration/delegation/index.d.ts +26 -0
- package/dist/harness/collaboration/delegation/index.js +25 -0
- package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
- package/dist/harness/collaboration/delegation/notifier.js +84 -0
- package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
- package/dist/harness/collaboration/delegation/registry-types.js +61 -0
- package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
- package/dist/harness/collaboration/delegation/registry.js +220 -0
- package/dist/harness/collaboration/delegation/service.d.ts +249 -0
- package/dist/harness/collaboration/delegation/service.js +499 -0
- package/dist/harness/collaboration/delegation/store.d.ts +155 -0
- package/dist/harness/collaboration/delegation/store.js +271 -0
- package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
- package/dist/harness/collaboration/delegation/transport.js +61 -0
- package/dist/harness/collaboration/delegation/types.d.ts +231 -0
- package/dist/harness/collaboration/delegation/types.js +70 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
- package/dist/harness/collaboration/delegation/wiring.js +145 -0
- package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
- package/dist/harness/collaboration/orchestration/index.js +11 -11
- package/dist/harness/context/assembler.d.ts +2 -2
- package/dist/harness/context/assembler.js +12 -7
- package/dist/harness/context/capabilities/compact/engine.js +80 -38
- package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
- package/dist/harness/context/capabilities/summary/registry.js +10 -0
- package/dist/harness/context/constitution/default-agents.md +230 -228
- package/dist/harness/context/default-context-engine.d.ts +101 -23
- package/dist/harness/context/default-context-engine.js +483 -172
- package/dist/harness/context/hybrid-compressor.d.ts +3 -3
- package/dist/harness/context/hybrid-compressor.js +18 -23
- package/dist/harness/context/index.d.ts +5 -1
- package/dist/harness/context/index.js +2 -0
- package/dist/harness/context/layer-snapshot.d.ts +4 -0
- package/dist/harness/context/layer-snapshot.js +30 -18
- package/dist/harness/context/layer-types.d.ts +49 -1
- package/dist/harness/context/layer-types.js +72 -4
- package/dist/harness/context/layers.d.ts +5 -2
- package/dist/harness/context/layers.js +11 -5
- package/dist/harness/context/llm-summarizer.d.ts +15 -1
- package/dist/harness/context/llm-summarizer.js +107 -56
- package/dist/harness/context/message-selector.js +6 -2
- package/dist/harness/context/root-instructions.d.ts +72 -0
- package/dist/harness/context/root-instructions.js +227 -0
- package/dist/harness/context/runtime-datetime.d.ts +34 -7
- package/dist/harness/context/runtime-datetime.js +66 -10
- package/dist/harness/context/smart-router.d.ts +1 -1
- package/dist/harness/context/smart-router.js +1 -1
- package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
- package/dist/harness/context/system-prompt-assembler.js +67 -6
- package/dist/harness/context/token-constants.d.ts +2 -2
- package/dist/harness/context/token-constants.js +2 -2
- package/dist/harness/context/token-estimate-fns.d.ts +1 -3
- package/dist/harness/context/token-estimate-fns.js +2 -4
- package/dist/harness/context/token-estimator.d.ts +1 -1
- package/dist/harness/context/token-estimator.js +14 -6
- package/dist/harness/context/tool-result-aging.d.ts +140 -0
- package/dist/harness/context/tool-result-aging.js +331 -0
- package/dist/harness/context/tool-result-body.d.ts +10 -0
- package/dist/harness/context/tool-result-body.js +27 -0
- package/dist/harness/context/turn-envelope.d.ts +123 -0
- package/dist/harness/context/turn-envelope.js +188 -0
- package/dist/harness/context/types.d.ts +35 -47
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
- package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
- package/dist/harness/extension/execution-environment/index.d.ts +18 -2
- package/dist/harness/extension/execution-environment/index.js +11 -2
- package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
- package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
- package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
- package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
- package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
- package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
- package/dist/harness/extension/execution-environment/sandbox.js +493 -51
- package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
- package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
- package/dist/harness/extension/execution-environment/types.d.ts +67 -39
- package/dist/harness/extension/execution-environment/types.js +2 -2
- package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
- package/dist/harness/extension/execution-environment/undo-log.js +627 -0
- package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
- package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
- package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
- package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
- package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
- package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
- package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
- package/dist/harness/governance/credentials/index.d.ts +1 -1
- package/dist/harness/governance/credentials/store.d.ts +16 -4
- package/dist/harness/governance/credentials/store.js +33 -6
- package/dist/harness/governance/credentials/types.d.ts +11 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
- package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
- package/dist/harness/governance/human-in-the-loop/index.js +3 -3
- package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
- package/dist/harness/governance/human-in-the-loop/types.js +6 -2
- package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
- package/dist/harness/governance/security/capability-enforcer.js +31 -8
- package/dist/harness/governance/security/degradation.js +5 -7
- package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
- package/dist/harness/governance/security/risk-evaluator.js +4 -82
- package/dist/harness/governance/security/temp-path.d.ts +41 -0
- package/dist/harness/governance/security/temp-path.js +117 -0
- package/dist/harness/governance/session-acl/index.d.ts +1 -0
- package/dist/harness/governance/session-acl/index.js +1 -0
- package/dist/harness/governance/session-acl/rights.d.ts +12 -0
- package/dist/harness/governance/session-acl/rights.js +89 -7
- package/dist/harness/governance/session-acl/seed-roles.js +9 -1
- package/dist/harness/governance/session-acl/service.js +21 -29
- package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
- package/dist/harness/governance/session-acl/tool-rights.js +238 -0
- package/dist/harness/governance/session-acl/types.d.ts +22 -0
- package/dist/harness/index.d.ts +14 -12
- package/dist/harness/index.js +9 -6
- package/dist/harness/knowledge/file-index-store.js +11 -11
- package/dist/harness/knowledge/grounding.d.ts +2 -1
- package/dist/harness/knowledge/grounding.js +6 -3
- package/dist/harness/knowledge/index.d.ts +2 -2
- package/dist/harness/knowledge/index.js +1 -1
- package/dist/harness/knowledge/ingest.js +4 -1
- package/dist/harness/knowledge/job-control-state.js +4 -4
- package/dist/harness/knowledge/job-control.js +11 -11
- package/dist/harness/knowledge/membership-store.js +11 -11
- package/dist/harness/knowledge/network-guard.d.ts +61 -4
- package/dist/harness/knowledge/network-guard.js +390 -113
- package/dist/harness/knowledge/query-service.js +3 -3
- package/dist/harness/knowledge/writer-service.d.ts +2 -0
- package/dist/harness/knowledge/writer-service.js +14 -13
- package/dist/harness/memory/backfill-trigger.d.ts +2 -2
- package/dist/harness/memory/backfill-trigger.js +4 -4
- package/dist/harness/memory/index.d.ts +1 -0
- package/dist/harness/memory/index.js +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +2 -0
- package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
- package/dist/harness/memory/sqlite/memory-store.js +14 -4
- package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
- package/dist/harness/memory/store.d.ts +1 -0
- package/dist/harness/memory/store.js +3 -0
- package/dist/harness/memory/time-format.d.ts +28 -0
- package/dist/harness/memory/time-format.js +52 -0
- package/dist/harness/memory/types.d.ts +12 -0
- package/dist/harness/observability/observer/hub.js +23 -1
- package/dist/harness/observability/observer/index.d.ts +2 -2
- package/dist/harness/observability/observer/index.js +1 -1
- package/dist/harness/observability/observer/types.d.ts +57 -0
- package/dist/harness/observability/observer/types.js +118 -9
- package/dist/harness/run/agent/agent.d.ts +18 -0
- package/dist/harness/run/agent/agent.js +26 -0
- package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
- package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
- package/dist/harness/run/reliability/harness-events.d.ts +4 -0
- package/dist/harness/run/reliability/run-agent.js +110 -18
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
- package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
- package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
- package/dist/harness/run/run-guard/default-run-guard.js +104 -44
- package/dist/harness/run/run-scope.d.ts +52 -0
- package/dist/harness/run/runner.d.ts +101 -16
- package/dist/harness/run/runner.js +556 -158
- package/dist/harness/session/attachments/llm-intent.js +17 -17
- package/dist/harness/session/history/port.js +1 -0
- package/dist/harness/session/in-memory-store.d.ts +1 -0
- package/dist/harness/session/in-memory-store.js +22 -1
- package/dist/harness/session/schedules/index.d.ts +10 -0
- package/dist/harness/session/schedules/index.js +10 -0
- package/dist/harness/session/schedules/render.d.ts +13 -0
- package/dist/harness/session/schedules/render.js +63 -0
- package/dist/harness/session/schedules/service.d.ts +179 -0
- package/dist/harness/session/schedules/service.js +695 -0
- package/dist/harness/session/schedules/store.d.ts +119 -0
- package/dist/harness/session/schedules/store.js +323 -0
- package/dist/harness/session/schedules/tools.d.ts +39 -0
- package/dist/harness/session/schedules/tools.js +442 -0
- package/dist/harness/session/schedules/types.d.ts +104 -0
- package/dist/harness/session/schedules/types.js +97 -0
- package/dist/harness/session/tasks/tools.js +22 -0
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +13 -0
- package/dist/harness/shared/types/agent-definition.d.ts +23 -0
- package/dist/index.d.ts +23 -9
- package/dist/index.js +10 -2
- package/dist/integration/providers/anthropic.d.ts +10 -0
- package/dist/integration/providers/anthropic.js +44 -1
- package/dist/integration/providers/openai.d.ts +10 -0
- package/dist/integration/providers/openai.js +58 -2
- package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
- package/dist/integration/providers/wire-dump-diff.js +351 -0
- package/dist/integration/providers/wire-dump.d.ts +178 -0
- package/dist/integration/providers/wire-dump.js +396 -0
- package/dist/integration/storage/jsonl.d.ts +11 -0
- package/dist/integration/storage/jsonl.js +148 -39
- package/dist/integration/storage/session-index.js +63 -8
- package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
- package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
- package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
- package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
- package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
- package/package.json +115 -115
- package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
- package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
- package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
- package/dist/harness/collaboration/multi-agent/index.js +0 -15
- package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
- package/dist/harness/collaboration/multi-agent/process.js +0 -256
- package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
- package/dist/harness/collaboration/multi-agent/registry.js +0 -137
- package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
- package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
- package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
- package/dist/harness/collaboration/multi-agent/types.js +0 -15
- package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
- package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
- package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
- package/dist/harness/collaboration/orchestration/async-task.js +0 -359
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
- package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
- package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
- package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
- package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
- package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
- package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
- package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
- package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
- package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
- package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
- package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
- package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
- package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
- package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
- package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
- package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
- package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
- package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
- package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
- package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
- package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
- package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
- package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
- package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
- package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
- package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
- package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
- package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
|
@@ -14,8 +14,6 @@ export interface ContextEngineInfo {
|
|
|
14
14
|
id: string;
|
|
15
15
|
/** 引擎名称 */
|
|
16
16
|
name: string;
|
|
17
|
-
/** 是否拥有压缩能力(外部引擎可能自行管理) */
|
|
18
|
-
ownsCompaction: boolean;
|
|
19
17
|
}
|
|
20
18
|
/**
|
|
21
19
|
* Token 估算器
|
|
@@ -111,11 +109,16 @@ export interface AssembleParams {
|
|
|
111
109
|
* 本快照用于重启后快速重建「应给 LLM 的视图」,避免立刻再打一次摘要。
|
|
112
110
|
*/
|
|
113
111
|
export interface ContextCompactSnapshot {
|
|
114
|
-
/**
|
|
112
|
+
/** 语义摘要正文(previousSummary;机械降级占位说明不算,不入快照) */
|
|
115
113
|
summary?: string;
|
|
116
|
-
/**
|
|
114
|
+
/** 上次主动压缩时的全量消息条数(再压缩增长门;≠摘要覆盖终点) */
|
|
117
115
|
lastProactiveMessageCount?: number;
|
|
118
|
-
/**
|
|
116
|
+
/**
|
|
117
|
+
* 摘要覆盖终点(下标,不含)= tailStart。
|
|
118
|
+
* sticky 增量起点;写成 messages.length 会把 tail 误算进覆盖 → 滑出丢消息。
|
|
119
|
+
*/
|
|
120
|
+
lastProactiveCoverEnd?: number;
|
|
121
|
+
/** 上次主动压缩后的视图 token 估算 */
|
|
119
122
|
lastProactiveTokens?: number;
|
|
120
123
|
}
|
|
121
124
|
/**
|
|
@@ -124,12 +127,16 @@ export interface ContextCompactSnapshot {
|
|
|
124
127
|
* 由 Harness 层注入,ContextEngine 用它调用 LLM 生成摘要。
|
|
125
128
|
* 这样 ContextEngine 不直接依赖 ModelProvider,保持解耦。
|
|
126
129
|
*
|
|
127
|
-
*
|
|
130
|
+
* 契约(迭代式更新):`options.previousSummary` 已按约定嵌入 `messages` 正文
|
|
131
|
+
* ("Previous summary: …" 段),实现方无需再读 opts 拼 prompt;**返回值即完整
|
|
132
|
+
* 更新后的摘要**,调用方不得再与旧摘要拼接。
|
|
133
|
+
*
|
|
134
|
+
* @param messages - 摘要请求消息(system 指令 + 用户正文;非原始对话序列)
|
|
128
135
|
* @param options - 摘要选项
|
|
129
|
-
* @returns
|
|
136
|
+
* @returns 完整更新后的摘要文本
|
|
130
137
|
*/
|
|
131
138
|
export type SummarizeFunction = (messages: LLMMessage[], options?: {
|
|
132
|
-
/**
|
|
139
|
+
/** 上次摘要(已嵌入 messages 正文;仅作元信息回传) */
|
|
133
140
|
previousSummary?: string;
|
|
134
141
|
/** 摘要 token 预算 */
|
|
135
142
|
maxTokens?: number;
|
|
@@ -163,25 +170,6 @@ export interface IngestParams {
|
|
|
163
170
|
sessionId: string;
|
|
164
171
|
message: Message;
|
|
165
172
|
}
|
|
166
|
-
export interface CompactParams {
|
|
167
|
-
sessionId: string;
|
|
168
|
-
/** E4:compact 键分量 */
|
|
169
|
-
agentId?: string;
|
|
170
|
-
/**
|
|
171
|
-
* Token 预算;未知 contextWindow 时可省略。
|
|
172
|
-
* 无预算且未 force 时跳过自动门槛判断;force 走结构压缩。
|
|
173
|
-
*/
|
|
174
|
-
tokenBudget?: number;
|
|
175
|
-
/** 显式压缩目标(配置 context.compactTargetTokens) */
|
|
176
|
-
compactTargetTokens?: number;
|
|
177
|
-
/** 是否强制压缩(手动 / overflow 兜底);force 不依赖 contextWindow */
|
|
178
|
-
force?: boolean;
|
|
179
|
-
/** 当前 token 数(可选,避免重复计算) */
|
|
180
|
-
currentTokenCount?: number;
|
|
181
|
-
/** 结构压缩用的头尾保护条数;未传用引擎配置 */
|
|
182
|
-
protectFirstN?: number;
|
|
183
|
-
protectLastN?: number;
|
|
184
|
-
}
|
|
185
173
|
export interface CompactResult {
|
|
186
174
|
ok: boolean;
|
|
187
175
|
compacted: boolean;
|
|
@@ -189,6 +177,11 @@ export interface CompactResult {
|
|
|
189
177
|
tokensBefore: number;
|
|
190
178
|
tokensAfter?: number;
|
|
191
179
|
summary?: string;
|
|
180
|
+
/**
|
|
181
|
+
* 摘要覆盖终点(下标,**不含**)= tailStart。
|
|
182
|
+
* sticky 重建的增量起点;写 `messages.length` 会把 tail 误算进覆盖 → 滑出后丢消息。
|
|
183
|
+
*/
|
|
184
|
+
coveredMessageCount?: number;
|
|
192
185
|
}
|
|
193
186
|
export interface AfterTurnParams {
|
|
194
187
|
sessionId: string;
|
|
@@ -209,7 +202,6 @@ export interface AfterTurnParams {
|
|
|
209
202
|
*
|
|
210
203
|
* 可选方法:
|
|
211
204
|
* - ingest(): 存储消息
|
|
212
|
-
* - compact(): 压缩存储
|
|
213
205
|
* - afterTurn(): 更新状态(turn 为**本轮增量**消息)
|
|
214
206
|
*
|
|
215
207
|
* 本域契约(@layer harness/context);Harness 提供 DefaultContextEngine。
|
|
@@ -232,25 +224,6 @@ export interface ContextEngine {
|
|
|
232
224
|
* 某些引擎(如外部服务)可能需要这一步。
|
|
233
225
|
*/
|
|
234
226
|
ingest?(params: IngestParams): Promise<void>;
|
|
235
|
-
/**
|
|
236
|
-
* 压缩存储(可选)
|
|
237
|
-
*
|
|
238
|
-
* 当存储超限时,压缩旧消息。
|
|
239
|
-
* 引擎可以选择摘要、截断、外部存储等方式。
|
|
240
|
-
*/
|
|
241
|
-
compact?(params: CompactParams): Promise<CompactResult>;
|
|
242
|
-
/**
|
|
243
|
-
* 结构压缩(手动 / overflow)— 不依赖 contextWindow
|
|
244
|
-
* 头尾保护 + 中间段摘要
|
|
245
|
-
*/
|
|
246
|
-
compactStructural?(input: {
|
|
247
|
-
sessionId: string;
|
|
248
|
-
/** E4:compact 键分量;缺省时内部状态键 = sessionId */
|
|
249
|
-
agentId?: string;
|
|
250
|
-
messages: Message[];
|
|
251
|
-
summarize?: SummarizeFunction;
|
|
252
|
-
compactTargetTokens?: number;
|
|
253
|
-
}): Promise<CompactResult>;
|
|
254
227
|
/**
|
|
255
228
|
* 每轮结束后更新状态(可选)
|
|
256
229
|
*
|
|
@@ -286,6 +259,21 @@ export interface CompressParams {
|
|
|
286
259
|
previousSummary?: string;
|
|
287
260
|
summarize?: SummarizeFunction;
|
|
288
261
|
tokenEstimator?: TokenEstimator;
|
|
262
|
+
/**
|
|
263
|
+
* 要求产出语义摘要:设置后,机械截断(旧工具输出截断/兜底截断)即使已达标
|
|
264
|
+
* 也不得就此短路返回——必须尝试摘要级。主动摘要路径(applyProactiveCompact)使用:
|
|
265
|
+
* 否则压缩成功但永不产摘要,状态机的复用分支永远无法启用。
|
|
266
|
+
*
|
|
267
|
+
* 实现约定:仅约束「可摘要时不得走机械短路」;无摘要能力(如无 summarize)时
|
|
268
|
+
* 的机械降级结果是允许的,调用方以「结果中无语义摘要」识别降级
|
|
269
|
+
* (见 DefaultContextEngine.extractSummaryText)。
|
|
270
|
+
*/
|
|
271
|
+
requireSummary?: boolean;
|
|
272
|
+
/**
|
|
273
|
+
* 缓存前缀:与会话 LLM 请求**同形**的 system+history(buildLlmMessages 产物)。
|
|
274
|
+
* 摘要请求只许在其**尾部**追加指令;禁止改 system / 历史字节——否则打穿 provider 前缀缓存。
|
|
275
|
+
*/
|
|
276
|
+
llmPrefix?: LLMMessage[];
|
|
289
277
|
}
|
|
290
278
|
export interface CompressResult {
|
|
291
279
|
/** 压缩后的消息/摘要 */
|
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ToolEffectPolicy P3 — 运行模式预设与有效策略
|
|
3
|
+
*
|
|
4
|
+
* 命名模式(workspace / project / host / untrusted)展开为正交旋钮。
|
|
5
|
+
* 见 arch/tool-effect-policy.md §7。
|
|
6
|
+
*/
|
|
7
|
+
import type { HitlDecision } from '@octopi-agent/core/types/tools.js';
|
|
8
|
+
import type { ToolIsolationMode } from './isolation.js';
|
|
9
|
+
import { type ProcessIsolationProfile } from './process-isolation.js';
|
|
10
|
+
/** 命名运行模式 */
|
|
11
|
+
export type EffectRunMode = 'workspace' | 'project' | 'host' | 'untrusted';
|
|
12
|
+
/**
|
|
13
|
+
* Engine default when `effectPolicy.mode` is omitted (secure-by-default).
|
|
14
|
+
* Scaffold/`octopi init` / `octopi.example.json` set `mode: "host"` explicitly
|
|
15
|
+
* so evaluation gets full capability; embedders who omit `mode` get `workspace`.
|
|
16
|
+
* See `docs/process-isolation.md`.
|
|
17
|
+
*/
|
|
18
|
+
export declare const DEFAULT_EFFECT_RUN_MODE: EffectRunMode;
|
|
19
|
+
/** 路径包含级别(L2) */
|
|
20
|
+
export type PathContainment = 'strict' | 'soft' | 'none';
|
|
21
|
+
/** shell 工具策略(非「越界」;无 L4 时 deny=拒绝整个 shell) */
|
|
22
|
+
export type ShellEscapePolicy = 'deny' | 'confirm' | 'allow';
|
|
23
|
+
/** commit 策略 */
|
|
24
|
+
export type EffectCommitPolicy = 'auto' | 'manual';
|
|
25
|
+
/** 效应确认通道 */
|
|
26
|
+
/** 效应意图(host-gate confirmEffect 入参) */
|
|
27
|
+
export type EffectIntent = {
|
|
28
|
+
kind: 'file.write';
|
|
29
|
+
path: string;
|
|
30
|
+
mode: 'create' | 'overwrite' | 'append' | 'edit';
|
|
31
|
+
/** 是否落在事务 root 内(可 undo) */
|
|
32
|
+
transactional: boolean;
|
|
33
|
+
} | {
|
|
34
|
+
kind: 'shell';
|
|
35
|
+
command: string;
|
|
36
|
+
cwd?: string;
|
|
37
|
+
} | {
|
|
38
|
+
/** project_run / package_install — executes workspace-defined scripts. Not shellEscape-gated. */
|
|
39
|
+
kind: 'runner';
|
|
40
|
+
command: string;
|
|
41
|
+
cwd?: string;
|
|
42
|
+
description?: string;
|
|
43
|
+
} | {
|
|
44
|
+
/** Local VCS porcelain (git). Not shellEscape-gated. */
|
|
45
|
+
kind: 'vcs';
|
|
46
|
+
operation: string;
|
|
47
|
+
cwd?: string;
|
|
48
|
+
description?: string;
|
|
49
|
+
} | {
|
|
50
|
+
kind: 'memory.write';
|
|
51
|
+
domain: 'memory' | 'cognition' | 'wisdom';
|
|
52
|
+
transactional: true;
|
|
53
|
+
} | {
|
|
54
|
+
kind: 'other';
|
|
55
|
+
description: string;
|
|
56
|
+
};
|
|
57
|
+
export type ConfirmEffectDecision = HitlDecision;
|
|
58
|
+
/**
|
|
59
|
+
* host-gate 确认回调(P4)。engine 不内置审批 UI。
|
|
60
|
+
* 宿主可自动放行 / 弹自己的确认框 / 策略引擎。
|
|
61
|
+
* 返回 {@link HitlDecision};session/always 由引擎 HitlDecisionCache 记账。
|
|
62
|
+
*/
|
|
63
|
+
export type ConfirmEffect = NonNullable<import('@octopi-agent/core/types/tools.js').ToolExecutionContext['confirmEffect']>;
|
|
64
|
+
export type EffectConfirmChannel = 'engine' | 'host-gate';
|
|
65
|
+
/** shell 记账深度(§5.6):snapshot=采 before 可逆;off=只知情 */
|
|
66
|
+
export type ShellJournalMode = 'snapshot' | 'off';
|
|
67
|
+
/** How to admit `untrusted` when L4 process jail is missing */
|
|
68
|
+
export type UntrustedAdmission = 'refuse' | 'degrade';
|
|
69
|
+
/** Effective tool surface after isolation admission */
|
|
70
|
+
export type ToolSurface = 'full' | 'reduced';
|
|
71
|
+
/** Machine-readable degradations (never silent) */
|
|
72
|
+
export type SecurityDegradation = 'no_process_jail' | 'network_open' | 'env_inherit' | 'privilege_same' | 'filesystem_not_jailed';
|
|
73
|
+
/** 配置形状(可覆盖预设) */
|
|
74
|
+
export interface EffectPolicyConfig {
|
|
75
|
+
/**
|
|
76
|
+
* Omitted = `DEFAULT_EFFECT_RUN_MODE` (**workspace**, secure-by-default).
|
|
77
|
+
* Scaffold/config templates set `"mode": "host"` explicitly for local evaluation.
|
|
78
|
+
*/
|
|
79
|
+
mode?: EffectRunMode;
|
|
80
|
+
/**
|
|
81
|
+
* `untrusted` 无 L4 时:`refuse`(缺省,第三方)拒绝运行;
|
|
82
|
+
* `degrade` 降 effectiveMode + toolSurface=reduced + securityDegraded。
|
|
83
|
+
*/
|
|
84
|
+
untrustedAdmission?: UntrustedAdmission;
|
|
85
|
+
/** 额外事务 root(绝对路径);并入 allowRoots */
|
|
86
|
+
transactionRoots?: string[];
|
|
87
|
+
pathContainment?: PathContainment;
|
|
88
|
+
shellEscape?: ShellEscapePolicy;
|
|
89
|
+
/**
|
|
90
|
+
* Jail network posture (D4-c). Omitted = mode default:
|
|
91
|
+
* host/project → `open`, workspace/untrusted → `deny`.
|
|
92
|
+
*/
|
|
93
|
+
network?: 'open' | 'deny' | 'allowlist';
|
|
94
|
+
processLimits?: boolean;
|
|
95
|
+
commit?: EffectCommitPolicy;
|
|
96
|
+
/** commit=manual 时会话关闭/超时如何收残留 undo */
|
|
97
|
+
onClose?: 'commit' | 'discard';
|
|
98
|
+
effects?: EffectConfirmChannel;
|
|
99
|
+
/** 覆盖模式推导的 toolIsolation */
|
|
100
|
+
toolIsolation?: ToolIsolationMode;
|
|
101
|
+
/** undo 配额;缺省不限。撞顶停记 before,业务写继续 */
|
|
102
|
+
undoLimit?: {
|
|
103
|
+
maxEntries?: number;
|
|
104
|
+
maxBlobBytes?: number;
|
|
105
|
+
};
|
|
106
|
+
/** shell 记账深度;缺省 snapshot */
|
|
107
|
+
shellJournal?: ShellJournalMode;
|
|
108
|
+
/** shell 清点/快照预算;缺省不限 */
|
|
109
|
+
shellJournalLimit?: {
|
|
110
|
+
maxFiles?: number;
|
|
111
|
+
maxBytes?: number;
|
|
112
|
+
maxFileSize?: number;
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
/** 展开后的有效策略 */
|
|
116
|
+
export interface EffectiveEffectPolicy {
|
|
117
|
+
/** Configured/requested mode (audit trail) */
|
|
118
|
+
requestedMode: EffectRunMode;
|
|
119
|
+
/**
|
|
120
|
+
* Effective mode after untrusted admission.
|
|
121
|
+
* Equals `requestedMode` when isolation is sufficient (or mode ≠ untrusted).
|
|
122
|
+
*/
|
|
123
|
+
mode: EffectRunMode;
|
|
124
|
+
untrustedAdmission: UntrustedAdmission;
|
|
125
|
+
/** `reduced` strips shell/http/MCP-style power when untrusted degrades */
|
|
126
|
+
toolSurface: ToolSurface;
|
|
127
|
+
/** Non-empty when isolation is weaker than requested */
|
|
128
|
+
securityDegraded: SecurityDegradation[];
|
|
129
|
+
toolIsolation: ToolIsolationMode;
|
|
130
|
+
pathContainment: PathContainment;
|
|
131
|
+
shellEscape: ShellEscapePolicy;
|
|
132
|
+
/** Resolved jail network posture */
|
|
133
|
+
network: 'open' | 'deny' | 'allowlist';
|
|
134
|
+
processLimits: boolean;
|
|
135
|
+
commit: EffectCommitPolicy;
|
|
136
|
+
onClose: 'commit' | 'discard';
|
|
137
|
+
effects: EffectConfirmChannel;
|
|
138
|
+
/** L2 允许根(含 workspace + transactionRoots) */
|
|
139
|
+
allowRoots: string[];
|
|
140
|
+
/** 事务 root 语义标签 */
|
|
141
|
+
transactionRoots: Array<'workspace' | 'memory' | 'host'>;
|
|
142
|
+
undoLimit?: {
|
|
143
|
+
maxEntries?: number;
|
|
144
|
+
maxBlobBytes?: number;
|
|
145
|
+
};
|
|
146
|
+
shellJournal: ShellJournalMode;
|
|
147
|
+
shellJournalLimit?: {
|
|
148
|
+
maxFiles?: number;
|
|
149
|
+
maxBytes?: number;
|
|
150
|
+
maxFileSize?: number;
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* 展开 effectPolicy 为有效策略
|
|
155
|
+
*
|
|
156
|
+
* @param config - 用户配置(mode 可省略,缺省 `DEFAULT_EFFECT_RUN_MODE`)
|
|
157
|
+
* @param baseWorkspace - 工具基路径(agent.workspace / RunConfig.cwd)
|
|
158
|
+
* @returns 有效策略
|
|
159
|
+
*/
|
|
160
|
+
/**
|
|
161
|
+
* Expand effectPolicy into an effective policy.
|
|
162
|
+
*
|
|
163
|
+
* `untrusted` requires an L4 process profile. When the host cannot offer it:
|
|
164
|
+
* - `untrustedAdmission: 'refuse'` (default) throws
|
|
165
|
+
* - `untrustedAdmission: 'degrade'` renames effectiveMode to workspace,
|
|
166
|
+
* sets toolSurface=reduced, and records securityDegraded[] (never silent)
|
|
167
|
+
*
|
|
168
|
+
* @param config - user config (mode optional)
|
|
169
|
+
* @param baseWorkspace - tool base path
|
|
170
|
+
* @param isolation - probed process isolation (optional; treated as supervised if absent)
|
|
171
|
+
* @returns effective policy with requested vs effective mode
|
|
172
|
+
* @throws Error when untrusted is refused
|
|
173
|
+
*/
|
|
174
|
+
export declare function resolveEffectiveEffectPolicy(config: EffectPolicyConfig, baseWorkspace?: string, isolation?: ProcessIsolationProfile): EffectiveEffectPolicy;
|
|
175
|
+
/**
|
|
176
|
+
* Whether a tool is on the reduced surface (untrusted degrade).
|
|
177
|
+
* Reduced keeps content tools inside L2; strips egress and code-exec power.
|
|
178
|
+
*
|
|
179
|
+
* @param toolName - registered tool name
|
|
180
|
+
* @param surface - full or reduced
|
|
181
|
+
* @returns whether the tool may run
|
|
182
|
+
*/
|
|
183
|
+
export declare function isToolAllowedOnSurface(toolName: string, surface: ToolSurface, capabilities?: readonly string[] | null): boolean;
|
|
184
|
+
/**
|
|
185
|
+
* L2:路径是否落在 allowRoots 内
|
|
186
|
+
*
|
|
187
|
+
* @param resolved - 已 resolve 的绝对路径
|
|
188
|
+
* @param allowRoots - 允许根
|
|
189
|
+
* @param containment - 级别;none 一律放行;soft 仅用于审计(由调用方记日志)
|
|
190
|
+
* @returns 是否允许
|
|
191
|
+
*/
|
|
192
|
+
export declare function isPathAllowed(resolved: string, allowRoots: string[], containment: PathContainment): boolean;
|
|
193
|
+
/**
|
|
194
|
+
* 效应闸(P4):事务内自动放行;host-gate 交给宿主;engine 通道按内置策略。
|
|
195
|
+
*
|
|
196
|
+
* @param intent - 效应意图
|
|
197
|
+
* @param options - 通道与回调
|
|
198
|
+
* @throws Error 当拒绝执行时
|
|
199
|
+
*/
|
|
200
|
+
export declare function gateEffect(intent: EffectIntent, options: {
|
|
201
|
+
effects: EffectConfirmChannel;
|
|
202
|
+
confirmEffect?: ConfirmEffect;
|
|
203
|
+
shellEscape?: ShellEscapePolicy;
|
|
204
|
+
/** SEC-7:session-scope 缓存键;缺省尝试 RunScope */
|
|
205
|
+
sessionId?: string;
|
|
206
|
+
/** SEC-7:always-scope 缓存键(agent 分桶);缺省尝试 RunScope */
|
|
207
|
+
agentId?: string;
|
|
208
|
+
hitlCache?: import('../../governance/human-in-the-loop/decision-cache.js').HitlDecisionCache;
|
|
209
|
+
}): Promise<void>;
|
|
210
|
+
/**
|
|
211
|
+
* Session-only effect overrides. Append-only: may add allow roots for this
|
|
212
|
+
* session; must never loosen pathContainment / shellEscape.
|
|
213
|
+
*/
|
|
214
|
+
export interface SessionEffectOverrides {
|
|
215
|
+
/** Extra allow/transaction roots (absolute paths), merged into allowRoots */
|
|
216
|
+
transactionRoots?: string[];
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Parse `session.metadata.effectOverrides` safely (read path).
|
|
220
|
+
*
|
|
221
|
+
* Invalid entries are **skipped**, not thrown: a poisoned/corrupt metadata bag
|
|
222
|
+
* must not abort run start. Strict validation belongs on the write API
|
|
223
|
+
* (`normalizeTransactionRoots`).
|
|
224
|
+
*
|
|
225
|
+
* @param metadata - session metadata bag
|
|
226
|
+
* @returns valid absolute roots only (empty when absent/invalid)
|
|
227
|
+
*/
|
|
228
|
+
export declare function readSessionEffectOverrides(metadata: Record<string, unknown> | undefined): SessionEffectOverrides;
|
|
229
|
+
/**
|
|
230
|
+
* Normalize and validate transaction root paths (absolute, non-empty).
|
|
231
|
+
*
|
|
232
|
+
* @param paths - raw paths
|
|
233
|
+
* @returns absolute normalized unique paths
|
|
234
|
+
* @throws Error when a path is empty or not absolute
|
|
235
|
+
*/
|
|
236
|
+
export declare function normalizeTransactionRoots(paths: string[]): string[];
|
|
237
|
+
/**
|
|
238
|
+
* Append session roots to base allowRoots (dedupe; base wins on conflicts).
|
|
239
|
+
*
|
|
240
|
+
* @param baseRoots - roots from effectPolicy / workspace
|
|
241
|
+
* @param extraRoots - session temporary roots
|
|
242
|
+
* @returns combined unique list
|
|
243
|
+
*/
|
|
244
|
+
export declare function mergeTransactionRoots(baseRoots: string[], extraRoots: string[] | undefined): string[];
|
|
245
|
+
/**
|
|
246
|
+
* Metadata key used on SessionData.metadata / SessionStore.updateMetadata.
|
|
247
|
+
*/
|
|
248
|
+
export declare const SESSION_EFFECT_OVERRIDES_KEY = "effectOverrides";
|