@octopi-agent/engine 0.70.7 → 0.90.11
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 +81 -5
- package/dist/config-schema/context.d.ts +24 -5
- package/dist/config-schema/context.js +28 -1
- package/dist/config-schema/engine.d.ts +205 -13
- package/dist/config-schema/engine.js +31 -2
- package/dist/config-schema/governance.d.ts +95 -0
- package/dist/config-schema/governance.js +93 -1
- package/dist/config-schema/models.d.ts +3 -3
- 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 +13 -0
- package/dist/config-schema/shared.js +22 -0
- package/dist/config-schema/substrate.d.ts +2 -2
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +201 -8
- package/dist/config.js +105 -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 +50 -5
- package/dist/harness/agent/builder.js +189 -59
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +84 -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 +46 -0
- package/dist/harness/agent/tool-purpose.js +127 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
- package/dist/harness/agent/wire-agent-builder.js +370 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
- 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 +85 -1
- package/dist/harness/context/layer-types.js +110 -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 +73 -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 +258 -0
- package/dist/harness/extension/execution-environment/effect-policy.js +358 -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/isolation.js +5 -1
- 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 +521 -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 +51 -0
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -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 +241 -70
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -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 +6 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -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 +16 -12
- package/dist/harness/index.js +10 -6
- package/dist/harness/knowledge/file-identity.d.ts +8 -0
- package/dist/harness/knowledge/file-identity.js +26 -1
- 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 +8 -5
- package/dist/harness/knowledge/index-store.d.ts +31 -4
- package/dist/harness/knowledge/index-store.js +121 -39
- package/dist/harness/knowledge/index.d.ts +2 -2
- package/dist/harness/knowledge/index.js +1 -1
- package/dist/harness/knowledge/ingest.d.ts +115 -115
- package/dist/harness/knowledge/ingest.js +154 -151
- package/dist/harness/knowledge/job-control-state.js +4 -4
- package/dist/harness/knowledge/job-control.js +11 -11
- package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
- 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/purge.js +4 -1
- 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-coverage.js +3 -1
- 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 +53 -2
- 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 +80 -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 +117 -16
- package/dist/harness/run/runner.js +668 -157
- package/dist/harness/session/attachments/llm-intent.js +17 -17
- package/dist/harness/session/history/port.js +16 -5
- package/dist/harness/session/in-memory-store.d.ts +6 -0
- package/dist/harness/session/in-memory-store.js +55 -3
- 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/title.js +25 -9
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
- package/dist/harness/shared/events/agent-event-map.js +2 -0
- package/dist/harness/shared/types/agent-definition.d.ts +23 -0
- package/dist/index.d.ts +25 -9
- package/dist/index.js +11 -2
- package/dist/integration/observability/run-telemetry.d.ts +8 -0
- package/dist/integration/observability/run-telemetry.js +31 -8
- package/dist/integration/observability/trace-collector.js +26 -4
- package/dist/integration/observability/trace-events.d.ts +1 -0
- package/dist/integration/observability/trace-events.js +2 -0
- package/dist/integration/observability/trace-logger.js +27 -17
- 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 +29 -0
- package/dist/integration/storage/jsonl.js +243 -41
- package/dist/integration/storage/session-index.js +63 -8
- package/dist/paths.d.ts +19 -0
- package/dist/paths.js +38 -1
- 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/safety-guard/config.yaml +3 -1
- 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
|
@@ -1,80 +1,108 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Execution Environment
|
|
2
|
+
* Execution Environment interface contracts
|
|
3
3
|
*
|
|
4
|
-
* @layer harness/extension/execution-environment
|
|
4
|
+
* @layer harness/extension/execution-environment
|
|
5
5
|
*/
|
|
6
|
-
|
|
6
|
+
import type { ProcessIsolationProfile } from './process-isolation.js';
|
|
7
|
+
/** Legacy coarse isolation level (prefer ProcessIsolationProfile) */
|
|
7
8
|
export type IsolationLevel = 'none' | 'process' | 'container';
|
|
8
|
-
/**
|
|
9
|
+
/** Sandbox config */
|
|
9
10
|
export interface SandboxConfig {
|
|
10
|
-
/**
|
|
11
|
-
isolationLevel
|
|
12
|
-
/**
|
|
11
|
+
/** Requested isolation level (legacy knob) */
|
|
12
|
+
isolationLevel?: IsolationLevel;
|
|
13
|
+
/** Working directory */
|
|
13
14
|
cwd?: string;
|
|
14
|
-
/**
|
|
15
|
+
/**
|
|
16
|
+
* Explicit environment. Merged on top of the scrubbed allowlist.
|
|
17
|
+
* Never spreads `process.env` — secrets must not ride along.
|
|
18
|
+
*/
|
|
15
19
|
env?: Record<string, string>;
|
|
16
|
-
/**
|
|
20
|
+
/** Resource limits */
|
|
17
21
|
limits?: ResourceLimits;
|
|
18
|
-
/**
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
+
/**
|
|
23
|
+
* Network posture for jail backends (bwrap / Seatbelt).
|
|
24
|
+
* Default when omitted: `deny` (D4-c). `allowlist` is interface-only this release
|
|
25
|
+
* and is enforced as `deny` with an honest note.
|
|
26
|
+
*/
|
|
27
|
+
networkPolicy?: 'open' | 'deny' | 'allowlist';
|
|
28
|
+
/**
|
|
29
|
+
* Absolute roots the jail may read/write (bind mounts / Seatbelt write-allow).
|
|
30
|
+
* Falls back to `[cwd]` when omitted. Not a substitute for L2 path policy.
|
|
31
|
+
*/
|
|
32
|
+
allowRoots?: string[];
|
|
33
|
+
/**
|
|
34
|
+
* D7: when true (untrusted / L4-required), jail backend must actually apply.
|
|
35
|
+
* Setup failure throws instead of falling back to supervised spawn.
|
|
36
|
+
*/
|
|
37
|
+
requireJail?: boolean;
|
|
38
|
+
/**
|
|
39
|
+
* Allow `$HOME` writes inside the jail (project/host only per 2b).
|
|
40
|
+
* tmpdir and, on POSIX, shared `/tmp` + `/var/tmp` are always writable (2a);
|
|
41
|
+
* tmp writes are not journaled (2c notReversed).
|
|
42
|
+
*/
|
|
43
|
+
homeWrite?: boolean;
|
|
44
|
+
/** Run-level hook for execute-time degradation (falls back to isolation.notes). */
|
|
45
|
+
noteSecurityDegraded?: (reason: string) => void;
|
|
46
|
+
/** Abort in-flight execution */
|
|
47
|
+
signal?: AbortSignal;
|
|
22
48
|
}
|
|
23
|
-
/**
|
|
49
|
+
/** Resource limits */
|
|
24
50
|
export interface ResourceLimits {
|
|
25
|
-
/**
|
|
51
|
+
/** Max wall time (ms) */
|
|
26
52
|
timeoutMs?: number;
|
|
27
|
-
/**
|
|
53
|
+
/** Max memory (bytes) */
|
|
28
54
|
maxMemoryBytes?: number;
|
|
29
|
-
/**
|
|
55
|
+
/** Max captured output (bytes) */
|
|
30
56
|
maxOutputBytes?: number;
|
|
31
|
-
/**
|
|
57
|
+
/** Max CPU time (ms) */
|
|
32
58
|
maxCpuTimeMs?: number;
|
|
33
59
|
}
|
|
34
|
-
/**
|
|
60
|
+
/** Resource usage */
|
|
35
61
|
export interface ResourceUsage {
|
|
36
|
-
/**
|
|
62
|
+
/** Elapsed wall time (ms) */
|
|
37
63
|
elapsedMs: number;
|
|
38
|
-
/**
|
|
64
|
+
/** Peak memory (bytes, -1 unknown) */
|
|
39
65
|
peakMemoryBytes: number;
|
|
40
|
-
/** CPU
|
|
66
|
+
/** CPU time (ms, -1 unknown) */
|
|
41
67
|
cpuTimeMs: number;
|
|
42
|
-
/**
|
|
68
|
+
/** Output size (bytes) */
|
|
43
69
|
outputBytes: number;
|
|
44
70
|
}
|
|
45
|
-
/**
|
|
71
|
+
/** Sandbox execution result */
|
|
46
72
|
export interface SandboxResult {
|
|
47
|
-
/**
|
|
73
|
+
/** Exit code */
|
|
48
74
|
exitCode: number;
|
|
49
|
-
/**
|
|
75
|
+
/** stdout */
|
|
50
76
|
stdout: string;
|
|
51
|
-
/**
|
|
77
|
+
/** stderr */
|
|
52
78
|
stderr: string;
|
|
53
|
-
/**
|
|
79
|
+
/** Terminated by sandbox (timeout, OOM, output cap) */
|
|
54
80
|
terminated: boolean;
|
|
55
|
-
/**
|
|
81
|
+
/** Terminate reason */
|
|
56
82
|
terminateReason?: string;
|
|
57
|
-
/**
|
|
83
|
+
/** Resource usage */
|
|
58
84
|
usage: ResourceUsage;
|
|
85
|
+
/** Honest isolation actually applied for this run */
|
|
86
|
+
isolation: ProcessIsolationProfile;
|
|
59
87
|
}
|
|
60
88
|
/**
|
|
61
|
-
* SandboxProvider —
|
|
62
|
-
*
|
|
63
|
-
* 在隔离环境中执行命令。不同实现可以提供不同级别的隔离:
|
|
64
|
-
* - none: 直接执行(开发模式)
|
|
65
|
-
* - process: 进程级隔离(spawn + resource limits)
|
|
66
|
-
* - container: 容器级隔离(Docker/firejail)
|
|
89
|
+
* SandboxProvider — execute commands under an isolation profile.
|
|
90
|
+
* Implementations must report real capabilities via `isolation` / `probe()`.
|
|
67
91
|
*/
|
|
68
92
|
export interface SandboxProvider {
|
|
69
|
-
/**
|
|
93
|
+
/** Legacy coarse level */
|
|
70
94
|
readonly level: IsolationLevel;
|
|
95
|
+
/** Honest isolation profile for this provider */
|
|
96
|
+
probe(): Promise<ProcessIsolationProfile>;
|
|
71
97
|
/**
|
|
72
|
-
*
|
|
98
|
+
* Execute a shell command line (platform shell) under isolation.
|
|
73
99
|
*/
|
|
74
100
|
execute(command: string, config?: SandboxConfig): Promise<SandboxResult>;
|
|
75
101
|
/**
|
|
76
|
-
*
|
|
102
|
+
* Execute an argv vector (preferred — no shell string parsing).
|
|
77
103
|
*/
|
|
104
|
+
executeArgv?(argv: string[], config?: SandboxConfig): Promise<SandboxResult>;
|
|
105
|
+
/** Whether this provider can run on the current host */
|
|
78
106
|
isAvailable(): Promise<boolean>;
|
|
79
107
|
}
|
|
80
108
|
/** 工作区配置 */
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn 文件 undo(ToolEffectPolicy L3)
|
|
3
|
+
*
|
|
4
|
+
* 即时生效 + 本轮 undo log:工具写立刻落盘,同时记录写前字节。
|
|
5
|
+
* 「编辑重发」discard 只逆放 agent 工具效应;用户手改保留。
|
|
6
|
+
* 落盘:`sessions/<sid>/undo/`(与 attachments 同级,不进 agent home / workspace)。
|
|
7
|
+
*
|
|
8
|
+
* 统一效应账本:可逆条目进 log.jsonl(有 before);不可逆只进 notReversed 结果。
|
|
9
|
+
* 见 arch/tool-effect-policy.md §5.6。
|
|
10
|
+
*/
|
|
11
|
+
import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
|
|
12
|
+
import type { MemoryEffectJournal } from '@octopi-agent/core/types/tools.js';
|
|
13
|
+
import { TurnMemoryJournal, type DiscardMemoryEffectsResult, type MemoryEffectRestorer } from './memory-undo.js';
|
|
14
|
+
/** undo 目录布局 */
|
|
15
|
+
export interface SessionUndoPaths {
|
|
16
|
+
/** `sessions/<sid>/undo` */
|
|
17
|
+
root: string;
|
|
18
|
+
logPath: string;
|
|
19
|
+
blobsDir: string;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* 解析会话 undo 目录
|
|
23
|
+
*
|
|
24
|
+
* @param sessionsDir - 通常 `OCTOPI_HOME/sessions`
|
|
25
|
+
* @param sessionId - 会话 id
|
|
26
|
+
* @returns 路径
|
|
27
|
+
*/
|
|
28
|
+
export declare function resolveSessionUndoPaths(sessionsDir: string, sessionId: string): SessionUndoPaths;
|
|
29
|
+
/** 落盘条目(按路径 coalesce) */
|
|
30
|
+
export type FileUndoEntry = {
|
|
31
|
+
op: 'create';
|
|
32
|
+
path: string;
|
|
33
|
+
afterHash: string;
|
|
34
|
+
afterRef?: string;
|
|
35
|
+
} | {
|
|
36
|
+
op: 'overwrite';
|
|
37
|
+
path: string;
|
|
38
|
+
beforeRef: string;
|
|
39
|
+
afterHash: string;
|
|
40
|
+
afterRef?: string;
|
|
41
|
+
/** 最后工具效应为删除 */
|
|
42
|
+
agentDeleted?: boolean;
|
|
43
|
+
} | {
|
|
44
|
+
op: 'delete';
|
|
45
|
+
path: string;
|
|
46
|
+
beforeRef: string;
|
|
47
|
+
agentDeleted?: boolean;
|
|
48
|
+
};
|
|
49
|
+
export type DiscardConflictReason = 'merge_conflict' | 'binary_user_wins' | 'user_deleted' | 'user_recreated' | 'budget_truncated';
|
|
50
|
+
export type NotReversedReason = 'inventory_only' | 'budget_truncated' | 'no_roots' | 'shell_journal_off';
|
|
51
|
+
/** 不可逆效应(无 before / 未记账);宿主可见,不进 LLM 历史 */
|
|
52
|
+
export interface NotReversedEffects {
|
|
53
|
+
reason: NotReversedReason;
|
|
54
|
+
created?: string[];
|
|
55
|
+
modified?: string[];
|
|
56
|
+
deleted?: string[];
|
|
57
|
+
}
|
|
58
|
+
/** 编辑重发效应逆放结果(对外即 EditResendResult) */
|
|
59
|
+
export interface EditResendResult {
|
|
60
|
+
discarded: Array<{
|
|
61
|
+
path: string;
|
|
62
|
+
action: 'deleted' | 'restored';
|
|
63
|
+
}>;
|
|
64
|
+
keptUserEdits: Array<{
|
|
65
|
+
path: string;
|
|
66
|
+
reason: DiscardConflictReason;
|
|
67
|
+
}>;
|
|
68
|
+
/** 本 turn 不可逆效应(shell 等) */
|
|
69
|
+
notReversed?: NotReversedEffects;
|
|
70
|
+
/** undoLimit / 预算撞顶:回滚不完整 */
|
|
71
|
+
truncated?: boolean;
|
|
72
|
+
entries: number;
|
|
73
|
+
/** 记忆面逆放(P2) */
|
|
74
|
+
memory: DiscardMemoryEffectsResult;
|
|
75
|
+
}
|
|
76
|
+
export type DiscardFileEffectsResult = EditResendResult;
|
|
77
|
+
/** undo 配额(缺省不限;撞顶后停记 before,业务写继续) */
|
|
78
|
+
export interface UndoLimitConfig {
|
|
79
|
+
maxEntries?: number;
|
|
80
|
+
maxBlobBytes?: number;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* undo 根是否属于「他人仍在运行的进程」。
|
|
84
|
+
*
|
|
85
|
+
* @param paths - 会话 undo 路径
|
|
86
|
+
* @returns owner pid 存活且非本进程 → true(清扫端应跳过);无 owner / 已死 → false
|
|
87
|
+
*/
|
|
88
|
+
export declare function isForeignLiveUndoOwner(paths: SessionUndoPaths): Promise<boolean>;
|
|
89
|
+
/**
|
|
90
|
+
* 本轮文件 undo log — 实现 `ToolFileEffects`
|
|
91
|
+
*/
|
|
92
|
+
export declare class TurnFileUndoLog implements ToolFileEffects {
|
|
93
|
+
private readonly paths;
|
|
94
|
+
private readonly entriesByPath;
|
|
95
|
+
private seq;
|
|
96
|
+
private sealed;
|
|
97
|
+
/** flush 串行:并行工具写盘不得丢条目 */
|
|
98
|
+
private flushChain;
|
|
99
|
+
private readonly limit?;
|
|
100
|
+
private blobBytes;
|
|
101
|
+
private limitHit;
|
|
102
|
+
/** 记忆面 journal(P2);与文件共用 undo 根 */
|
|
103
|
+
readonly memoryJournal: TurnMemoryJournal;
|
|
104
|
+
private constructor();
|
|
105
|
+
/** ToolExecutionContext.memoryEffects */
|
|
106
|
+
get memoryEffects(): MemoryEffectJournal;
|
|
107
|
+
/** undoLimit 是否已截断 */
|
|
108
|
+
get truncated(): boolean;
|
|
109
|
+
/**
|
|
110
|
+
* 开始本轮 undo。若已有残留 log(上一轮中止后继续对话),先 commit。
|
|
111
|
+
*
|
|
112
|
+
* @param options - sessionsDir + sessionId + 可选 undoLimit
|
|
113
|
+
* @returns 日志实例
|
|
114
|
+
*/
|
|
115
|
+
static begin(options: {
|
|
116
|
+
sessionsDir: string;
|
|
117
|
+
sessionId: string;
|
|
118
|
+
undoLimit?: UndoLimitConfig;
|
|
119
|
+
}): Promise<TurnFileUndoLog>;
|
|
120
|
+
get root(): string;
|
|
121
|
+
get size(): number;
|
|
122
|
+
writeFile(path: string, data: string | Uint8Array): Promise<void>;
|
|
123
|
+
appendFile(path: string, data: string | Uint8Array): Promise<void>;
|
|
124
|
+
/** 删除前调用:记 before,discard 时恢复 */
|
|
125
|
+
recordDelete(path: string, before: string | Uint8Array): Promise<void>;
|
|
126
|
+
/** 标记新建(零 before);已存在条目则不覆盖 first before */
|
|
127
|
+
recordCreate(path: string, after?: string | Uint8Array): Promise<void>;
|
|
128
|
+
/** rename:delete(from) + create/overwrite(to) */
|
|
129
|
+
recordRename(from: string, to: string): Promise<void>;
|
|
130
|
+
/** 显式 before/after 覆盖(shell diff;磁盘已是 after 时不能用 writeFile 采 before) */
|
|
131
|
+
noteNotReversed(payload: {
|
|
132
|
+
reason: 'inventory_only' | 'budget_truncated' | 'no_roots' | 'shell_journal_off';
|
|
133
|
+
created?: string[];
|
|
134
|
+
modified?: string[];
|
|
135
|
+
deleted?: string[];
|
|
136
|
+
}): Promise<void>;
|
|
137
|
+
recordOverwrite(path: string, before: string | Uint8Array, after?: string | Uint8Array): Promise<void>;
|
|
138
|
+
private recordWrite;
|
|
139
|
+
/** @returns blob hash;超配额时 undefined(调用方标 truncated) */
|
|
140
|
+
private storeBlob;
|
|
141
|
+
/** limitHit 持久化,供 gateway/close 异进程 discard 读回 */
|
|
142
|
+
private persistTruncated;
|
|
143
|
+
private flushLog;
|
|
144
|
+
private doFlushLog;
|
|
145
|
+
/** 提交:丢弃 undo,效应保留 */
|
|
146
|
+
commit(): Promise<void>;
|
|
147
|
+
/** 逆放并销毁(编辑重发) */
|
|
148
|
+
discard(memoryRestorer?: MemoryEffectRestorer): Promise<DiscardFileEffectsResult>;
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* 未配置 sessionsDir 时的 fail-closed 写入口:拒绝落盘,禁止静默绕过 undo。
|
|
152
|
+
*/
|
|
153
|
+
export declare function createUnconfiguredFileEffects(): ToolFileEffects;
|
|
154
|
+
/**
|
|
155
|
+
* 未配置 sessionsDir 时的记忆面 fail-closed 写入口。
|
|
156
|
+
*/
|
|
157
|
+
export declare function createUnconfiguredMemoryEffects(): MemoryEffectJournal;
|
|
158
|
+
/**
|
|
159
|
+
* 提交某会话残留 undo(继续对话 / turn 自然结束)
|
|
160
|
+
*
|
|
161
|
+
* @param sessionsDir - sessions 目录
|
|
162
|
+
* @param sessionId - 会话 id
|
|
163
|
+
*/
|
|
164
|
+
export declare function commitSessionFileUndo(sessionsDir: string, sessionId: string): Promise<void>;
|
|
165
|
+
/**
|
|
166
|
+
* 逆放某会话本轮文件效应(编辑重发)
|
|
167
|
+
*
|
|
168
|
+
* @param sessionsDir - sessions 目录
|
|
169
|
+
* @param sessionId - 会话 id
|
|
170
|
+
* @returns 逆放结果(宿主可见,不进 LLM 历史)
|
|
171
|
+
*/
|
|
172
|
+
export declare function discardSessionFileUndo(sessionsDir: string, sessionId: string, memoryRestorer?: MemoryEffectRestorer): Promise<DiscardFileEffectsResult>;
|
|
173
|
+
/**
|
|
174
|
+
* 会话关闭/删除时处理残留 undo(commit=manual 才有意义;auto 下 turn 已 commit)。
|
|
175
|
+
*
|
|
176
|
+
* @param options - sessionsDir + sessionId + onClose 策略
|
|
177
|
+
* @returns 实际动作
|
|
178
|
+
*/
|
|
179
|
+
export declare function resolveSessionUndoOnClose(options: {
|
|
180
|
+
sessionsDir: string;
|
|
181
|
+
sessionId: string;
|
|
182
|
+
onClose: 'commit' | 'discard';
|
|
183
|
+
memoryRestorer?: import('./memory-undo.js').MemoryEffectRestorer;
|
|
184
|
+
/** true 时跳过属于他人活跃进程的 undo(进程收尾扫描用;显式删除不应开启) */
|
|
185
|
+
skipLiveForeign?: boolean;
|
|
186
|
+
}): Promise<'committed' | 'discarded' | 'none'>;
|
|
187
|
+
/** 孤儿 undo 目录(崩溃/异常退出残留) */
|
|
188
|
+
export interface OrphanUndoDir {
|
|
189
|
+
sessionDirName: string;
|
|
190
|
+
undoRoot: string;
|
|
191
|
+
entries: number;
|
|
192
|
+
hasMemory: boolean;
|
|
193
|
+
hasNotReversed: boolean;
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* 扫描会话 undo 孤儿目录(doctor 兜底)。
|
|
197
|
+
*
|
|
198
|
+
* 正常路径下 commit/discard 会删除 `sessions/<sid>/undo`;仍存在的即残留。
|
|
199
|
+
*
|
|
200
|
+
* @param sessionsDir - `OCTOPI_HOME/sessions`
|
|
201
|
+
* @returns 孤儿列表
|
|
202
|
+
*/
|
|
203
|
+
export declare function scanOrphanSessionUndo(sessionsDir: string): Promise<OrphanUndoDir[]>;
|