@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
package/dist/config.d.ts
CHANGED
|
@@ -22,6 +22,8 @@ export interface AgentConfig {
|
|
|
22
22
|
home?: string;
|
|
23
23
|
/** 沙箱工作目录:agent 工具操作的 cwd,默认为 home 下的 workspace 子目录 */
|
|
24
24
|
workspace?: string;
|
|
25
|
+
/** ToolEffectPolicy(P3) */
|
|
26
|
+
effectPolicy?: import('./harness/extension/execution-environment/effect-policy.js').EffectPolicyConfig;
|
|
25
27
|
/**
|
|
26
28
|
* Persona 配置(向后兼容:string 形式等价于 home)
|
|
27
29
|
* - string: persona 目录路径(已废弃,请使用 home)
|
|
@@ -54,6 +56,27 @@ export interface AgentConfig {
|
|
|
54
56
|
knowledge?: {
|
|
55
57
|
recall?: KnowledgeRecallMode;
|
|
56
58
|
};
|
|
59
|
+
/** 特质标签(arch/delegation.md §9.2:供父 agent 按特质发现委派目标);无权限语义 */
|
|
60
|
+
traits?: string[];
|
|
61
|
+
/** 委派策略(arch/delegation.md §9.2);整段可省略 = 用 DEFAULT_DELEGATION_POLICY(委派默认开启)*/
|
|
62
|
+
delegation?: {
|
|
63
|
+
/** 能否被委派(默认 true;显式 false = 只能被用户直接对话) */
|
|
64
|
+
callable: boolean;
|
|
65
|
+
/** 允许哪些 agentId 调我(缺省 = 任意) */
|
|
66
|
+
callableBy?: string[];
|
|
67
|
+
/** 我能不能再委派、获得 delegate_* 工具(默认 true) */
|
|
68
|
+
canDelegate: boolean;
|
|
69
|
+
/** 递归上限(默认 1 = 我能派子,子不能再派;runaway 兜底) */
|
|
70
|
+
maxDepth?: number;
|
|
71
|
+
/** 被委派时的权利天花板(只能收紧不能放宽,D3) */
|
|
72
|
+
rightsCeiling?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionRights;
|
|
73
|
+
/** 委派预算上限(请求预算与此取交集) */
|
|
74
|
+
budget?: {
|
|
75
|
+
maxTurns?: number;
|
|
76
|
+
maxTokens?: number;
|
|
77
|
+
timeoutMs?: number;
|
|
78
|
+
};
|
|
79
|
+
};
|
|
57
80
|
}
|
|
58
81
|
/**
|
|
59
82
|
* Knowledge 内容召回模式
|
|
@@ -65,6 +88,19 @@ export interface AgentConfig {
|
|
|
65
88
|
export type KnowledgeRecallMode = 'off' | 'hint' | 'hybrid' | 'inject';
|
|
66
89
|
/** Knowledge 全局配置(agents[].knowledge 覆盖 recall 等) */
|
|
67
90
|
export interface KnowledgeRuntimeConfig {
|
|
91
|
+
/** Knowledge Service 连接(v2:Gateway 不打开 knowledge.db);对齐 KnowledgeConfigSchema */
|
|
92
|
+
service?: {
|
|
93
|
+
baseUrl?: string;
|
|
94
|
+
token?: string;
|
|
95
|
+
/** 缺省 true:serve 时拉起本地 Knowledge;false 则只连 baseUrl */
|
|
96
|
+
manageLocal?: boolean;
|
|
97
|
+
/** manageLocal 本地监听端口(缺省 18280) */
|
|
98
|
+
port?: number;
|
|
99
|
+
timeoutMs?: number;
|
|
100
|
+
connectTimeoutMs?: number;
|
|
101
|
+
};
|
|
102
|
+
/** true = Knowledge 不可用则 run 失败(默认 fail-open) */
|
|
103
|
+
required?: boolean;
|
|
68
104
|
recall?: KnowledgeRecallMode;
|
|
69
105
|
autoInject?: {
|
|
70
106
|
minScore?: number;
|
|
@@ -211,6 +247,13 @@ export interface WebSearchToolConfig {
|
|
|
211
247
|
export interface SessionConfig {
|
|
212
248
|
/** DM 作用域: main / per-peer / per-channel-peer */
|
|
213
249
|
dmScope?: 'main' | 'per-peer' | 'per-channel-peer';
|
|
250
|
+
/**
|
|
251
|
+
* 上下文租约(毫秒)。**显式配置才生效**;缺省关闭。
|
|
252
|
+
*
|
|
253
|
+
* 闲置超过该值后,下一轮 LLM 默认消息窗口从租约点截断(Discourse 全量保留,
|
|
254
|
+
* 可用 session_search / session_read 查旧内容)。与 memory 冷沉淀解耦。
|
|
255
|
+
*/
|
|
256
|
+
idleExpiryMs?: number;
|
|
214
257
|
}
|
|
215
258
|
/**
|
|
216
259
|
* Plugin 配置
|
|
@@ -395,6 +438,17 @@ export interface AgentRuntimeJsonConfig {
|
|
|
395
438
|
/** 订阅 runtime.agent_signal(多 Agent 通知);默认随 escalate 一起挂 */
|
|
396
439
|
agentSignal?: boolean;
|
|
397
440
|
}
|
|
441
|
+
/**
|
|
442
|
+
* SessionSchedule 预算 / 兜底(arch/session-schedules.md P1)
|
|
443
|
+
*/
|
|
444
|
+
export interface SchedulesJsonConfig {
|
|
445
|
+
/** 每会话未闭合作业上限;0 = 不限(默认 50) */
|
|
446
|
+
maxOpenPerSession?: number;
|
|
447
|
+
/** 每小时 wakeup 点火上限(进程级);0 = 不限(默认 120) */
|
|
448
|
+
maxWakesPerHour?: number;
|
|
449
|
+
/** 兜底扫描间隔 ms(默认 60000);0 = 关闭 */
|
|
450
|
+
tickIntervalMs?: number;
|
|
451
|
+
}
|
|
398
452
|
/**
|
|
399
453
|
* 上下文引擎配置
|
|
400
454
|
*
|
|
@@ -407,11 +461,11 @@ export interface ContextEngineConfig {
|
|
|
407
461
|
protectFirstN?: number;
|
|
408
462
|
/** 尾部保护消息数(默认 20) */
|
|
409
463
|
protectLastN?: number;
|
|
410
|
-
/** 触发压缩的阈值比例(默认 0.5) */
|
|
411
|
-
compactThreshold?: number;
|
|
412
464
|
/**
|
|
413
|
-
*
|
|
414
|
-
*
|
|
465
|
+
* 窗口比例线:消息 token / messagesBudget 超过该比例时,
|
|
466
|
+
* 在硬溢出前先主动压缩(默认 0.6)。
|
|
467
|
+
* `0` = **禁止发起新的**路径 A 压缩(不只禁 LLM;目标线/窗口比例线同闸);**不**丢弃已有
|
|
468
|
+
* `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)本就不打 LLM。
|
|
415
469
|
*/
|
|
416
470
|
proactiveCompactRatio?: number;
|
|
417
471
|
/**
|
|
@@ -419,6 +473,34 @@ export interface ContextEngineConfig {
|
|
|
419
473
|
* 冷却期内优先缓存重建,降低单 turn 双摘要。
|
|
420
474
|
*/
|
|
421
475
|
proactiveCooldownMs?: number;
|
|
476
|
+
/**
|
|
477
|
+
* 历史工具结果批量冻结老化(F1-B2):当前 run 永不老化、近 rawWindow 条跨轮原文、
|
|
478
|
+
* 更旧按 freezeBatch 成批降级为结构化指针(视图级、write-once、禁渐进)。
|
|
479
|
+
*/
|
|
480
|
+
historyAging?: {
|
|
481
|
+
/** 总开关(默认 true) */
|
|
482
|
+
enabled?: boolean;
|
|
483
|
+
/** 跨轮原文保留条数(默认 40) */
|
|
484
|
+
rawWindow?: number;
|
|
485
|
+
/**
|
|
486
|
+
* 批量冻结步长(默认 20;最小 1)。
|
|
487
|
+
* ⚠️ 1 = 逐候选即降级(等同渐进老化、每轮烧前缀缓存,仅调试用);
|
|
488
|
+
* 生产取值应 ≥ 每轮工具结果数。
|
|
489
|
+
*/
|
|
490
|
+
freezeBatch?: number;
|
|
491
|
+
/** 指针目标字符数(默认 400;是目标非硬顶) */
|
|
492
|
+
maxPointerChars?: number;
|
|
493
|
+
};
|
|
494
|
+
/**
|
|
495
|
+
* 工作目标 token(与窗口解耦,F1-B3):目标线 = targetTokens × compactFallbackRatio,
|
|
496
|
+
* 与窗口比例线取 min。默认 200000;0 = 只挂窗口比例线(proactiveCompactRatio)。
|
|
497
|
+
*/
|
|
498
|
+
targetTokens?: number;
|
|
499
|
+
/**
|
|
500
|
+
* 目标线倍数(默认 3)。触发线 = targetTokens × compactFallbackRatio;
|
|
501
|
+
* 须 > B2 老化稳态,否则双机制打架。窗口比例线始终并存。
|
|
502
|
+
*/
|
|
503
|
+
compactFallbackRatio?: number;
|
|
422
504
|
/** 输出预留比例(默认 0.20) */
|
|
423
505
|
outputRatio?: number;
|
|
424
506
|
/** 输出预留最小值(默认 2000) */
|
|
@@ -517,6 +599,11 @@ export interface ContextAssemblerConfig {
|
|
|
517
599
|
systemBudgetRatio?: number;
|
|
518
600
|
/** 显式 system 预算 token(窗口未知时仍可用,优先于 ratio) */
|
|
519
601
|
systemBudgetTokens?: number;
|
|
602
|
+
/**
|
|
603
|
+
* 易变快照组(E8,placement='snapshot' 层)的 token 预算。
|
|
604
|
+
* 缺省不设上限;设置后快照组超预算按层优先级截断/丢弃。
|
|
605
|
+
*/
|
|
606
|
+
snapshotBudgetTokens?: number;
|
|
520
607
|
/** 显式压缩目标 token;窗口未知时用于结构压缩/assemble 预算 */
|
|
521
608
|
compactTargetTokens?: number;
|
|
522
609
|
/**
|
|
@@ -682,9 +769,19 @@ export interface ModelsConfig {
|
|
|
682
769
|
embedding?: EmbeddingModelConfig;
|
|
683
770
|
}
|
|
684
771
|
/** 自主子系统配置(框架级:搜索路径与审计;子系统自身参数写在各自 config.yaml) */
|
|
772
|
+
/** ModelCallConfig — octopi.json 中的 modelCall 字段(引擎模型调用 watchdog 超时) */
|
|
773
|
+
export interface ModelCallConfig {
|
|
774
|
+
/** 流式 chunk 间最大静默(含首 token 等待),毫秒 */
|
|
775
|
+
idleTimeoutMs?: number;
|
|
776
|
+
/** 单次模型调用总时长上限,毫秒 */
|
|
777
|
+
absoluteTimeoutMs?: number;
|
|
778
|
+
}
|
|
685
779
|
export interface SubsystemsConfig {
|
|
686
|
-
/**
|
|
687
|
-
|
|
780
|
+
/**
|
|
781
|
+
* 审计日志目录(默认 `~/.octopi/audit`)。
|
|
782
|
+
* `false` = 显式关闭子系统审计。
|
|
783
|
+
*/
|
|
784
|
+
auditDir?: string | false;
|
|
688
785
|
/** 允许注册:id / packageId / `memory.steward.*` 前缀 */
|
|
689
786
|
allowlist?: string[];
|
|
690
787
|
/** 禁止注册(deny 优先) */
|
|
@@ -696,6 +793,13 @@ export interface SubsystemsConfig {
|
|
|
696
793
|
export interface HarnessConfig {
|
|
697
794
|
/** 自主子系统配置 */
|
|
698
795
|
subsystems?: SubsystemsConfig;
|
|
796
|
+
/**
|
|
797
|
+
* 委派编排(arch/delegation.md §8)。
|
|
798
|
+
* `maxActiveDelegationsPerSession` 是失控防护,不是并发闸(D9)。
|
|
799
|
+
*/
|
|
800
|
+
delegation?: {
|
|
801
|
+
maxActiveDelegationsPerSession?: number;
|
|
802
|
+
};
|
|
699
803
|
/** Agent 列表 */
|
|
700
804
|
agents: AgentConfig[];
|
|
701
805
|
/** 模型配置(集中定义 provider + model) */
|
|
@@ -708,8 +812,12 @@ export interface HarnessConfig {
|
|
|
708
812
|
budgetPolicy?: BudgetPolicyJsonConfig;
|
|
709
813
|
/** 过程监督配置(行为监督;与 budget 组合) */
|
|
710
814
|
runGuard?: RunGuardJsonConfig;
|
|
815
|
+
/** 模型调用 watchdog 超时(modelCall 段) */
|
|
816
|
+
modelCall?: ModelCallConfig;
|
|
711
817
|
/** 激活宿主(long-lived;Schedule/Escalate 等) */
|
|
712
818
|
agentRuntime?: AgentRuntimeJsonConfig;
|
|
819
|
+
/** SessionSchedule 预算与兜底 tick */
|
|
820
|
+
schedules?: SchedulesJsonConfig;
|
|
713
821
|
/** 上下文引擎配置 */
|
|
714
822
|
contextEngine?: ContextEngineConfig;
|
|
715
823
|
/** 公用能力 summary(harness/context/capabilities) */
|
|
@@ -851,6 +959,13 @@ export interface HarnessConfig {
|
|
|
851
959
|
*
|
|
852
960
|
* 硬边界与 ToolCallRiskPolicy 始终执行;此处只调处置/范围/灵敏度。
|
|
853
961
|
*/
|
|
962
|
+
/**
|
|
963
|
+
* 命名凭证库策略(SEC-3c)
|
|
964
|
+
* 默认:有绑定则强制;无绑定可解析。requireBindings=true 时无绑定即拒。
|
|
965
|
+
*/
|
|
966
|
+
credentials?: {
|
|
967
|
+
requireBindings?: boolean;
|
|
968
|
+
};
|
|
854
969
|
security?: {
|
|
855
970
|
/**
|
|
856
971
|
* 风险命中后的处置(硬边界不受影响)
|
|
@@ -860,6 +975,14 @@ export interface HarnessConfig {
|
|
|
860
975
|
enforce?: 'block' | 'audit';
|
|
861
976
|
/** 注入检测灵敏度 */
|
|
862
977
|
injectionSensitivity?: 'low' | 'medium' | 'high';
|
|
978
|
+
/**
|
|
979
|
+
* 工具/引擎出站网络门禁(http_request、Knowledge 默认)
|
|
980
|
+
* 默认拒私网/环回/metadata;内网目标需显式 allowPrivateNetwork
|
|
981
|
+
*/
|
|
982
|
+
network?: {
|
|
983
|
+
/** 显式放行私网/环回(lab/内网);metadata/链路本地始终拒绝 */
|
|
984
|
+
allowPrivateNetwork?: boolean;
|
|
985
|
+
};
|
|
863
986
|
/** 绝对路径额外允许范围 */
|
|
864
987
|
allowedPaths?: string[];
|
|
865
988
|
};
|
|
@@ -875,12 +998,24 @@ export interface HarnessConfig {
|
|
|
875
998
|
* - `session-lock`:共享路径;同 sessionId 由 Runner 锁串行(不路径隔离)
|
|
876
999
|
*/
|
|
877
1000
|
toolIsolation?: 'none' | 'session-subdir' | 'session-lock';
|
|
1001
|
+
/** ToolEffectPolicy 运行模式(P3) */
|
|
1002
|
+
effectPolicy?: import('./harness/extension/execution-environment/effect-policy.js').EffectPolicyConfig;
|
|
878
1003
|
/**
|
|
879
1004
|
* Session ACL 角色目录(E6)
|
|
880
1005
|
*
|
|
881
1006
|
* 缺省使用内置五角色;可覆盖/新增。handoff 默认仅宿主。
|
|
882
1007
|
*/
|
|
883
1008
|
sessionAcl?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionAclConfig;
|
|
1009
|
+
/**
|
|
1010
|
+
* send_file 外发限额
|
|
1011
|
+
*
|
|
1012
|
+
* - `maxBytes`:单文件上限(字节);缺省 2GB
|
|
1013
|
+
* - `maxReleasesPerSession`:每会话 release 次数;缺省 / 0 = 不限
|
|
1014
|
+
*/
|
|
1015
|
+
fileSend?: {
|
|
1016
|
+
maxBytes?: number;
|
|
1017
|
+
maxReleasesPerSession?: number;
|
|
1018
|
+
};
|
|
884
1019
|
/** 并发控制配置 */
|
|
885
1020
|
concurrency?: {
|
|
886
1021
|
/** 多 Key Provider 负载均衡池 */
|
|
@@ -950,6 +1085,17 @@ export interface HarnessConfig {
|
|
|
950
1085
|
captureStreamDeltas?: boolean;
|
|
951
1086
|
/** 是否记录完整模型请求 */
|
|
952
1087
|
captureModelRequest?: boolean;
|
|
1088
|
+
/**
|
|
1089
|
+
* LLM wire dump:把 provider 实际发送的完整请求体按 session 落盘,用于比对前缀稳定性
|
|
1090
|
+
*
|
|
1091
|
+
* 默认关闭。落盘根目录缺省 `<OCTOPI_HOME>/logs/llm-requests`;
|
|
1092
|
+
* 分析命令:`octopi llm-diff [sessionId]`。
|
|
1093
|
+
*
|
|
1094
|
+
* 生效路径:`octopi serve`(CLI daemon 自建共享 sink)。库嵌入方可把
|
|
1095
|
+
* `createWireDumpSink()` 的结果经 `createProviderFromConfig(name, pc, { wireDump })` 注入。
|
|
1096
|
+
* 配置面只含纯数据(不含 `resolveContext` 等运行时钩子)。
|
|
1097
|
+
*/
|
|
1098
|
+
llmRequestDump?: import('./integration/providers/wire-dump.js').WireDumpConfig;
|
|
953
1099
|
};
|
|
954
1100
|
}
|
|
955
1101
|
/**
|
|
@@ -975,10 +1121,35 @@ export interface NormalizedModelInfo {
|
|
|
975
1121
|
contextWindow?: number;
|
|
976
1122
|
maxTokens?: number;
|
|
977
1123
|
}
|
|
1124
|
+
/**
|
|
1125
|
+
* 包一层计时探针:llm_start / llm_first_token(TTFT)/ llm_end
|
|
1126
|
+
*
|
|
1127
|
+
* @param inner - 真实 provider
|
|
1128
|
+
* @returns 透传装饰器
|
|
1129
|
+
*/
|
|
1130
|
+
export declare function withTimingProbe(inner: ModelProvider): ModelProvider;
|
|
1131
|
+
/**
|
|
1132
|
+
* 按 `observability.llmRequestDump` 配置构造 wire dump sink
|
|
1133
|
+
*
|
|
1134
|
+
* 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
|
|
1135
|
+
* `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
|
|
1136
|
+
* provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
|
|
1137
|
+
*
|
|
1138
|
+
* @param cfg - `observability.llmRequestDump` 配置段
|
|
1139
|
+
* @returns sink;未启用时 undefined
|
|
1140
|
+
*/
|
|
1141
|
+
export declare function createWireDumpSinkFromConfig(cfg?: import('./integration/providers/wire-dump.js').WireDumpConfig): Promise<import('./integration/providers/wire-dump.js').WireDumpSink | undefined>;
|
|
978
1142
|
/**
|
|
979
1143
|
* 从 ModelProviderConfig 创建 ModelProvider 实例
|
|
980
1144
|
*
|
|
981
1145
|
* 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
|
|
982
1146
|
* 使用动态 import 以支持 ESM。
|
|
1147
|
+
*
|
|
1148
|
+
* @param name - provider 名称
|
|
1149
|
+
* @param pc - provider 配置
|
|
1150
|
+
* @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
|
|
1151
|
+
* @returns provider 实例(计时探针 → wire dump → 原生 provider 的装饰链)
|
|
983
1152
|
*/
|
|
984
|
-
export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig
|
|
1153
|
+
export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig, options?: {
|
|
1154
|
+
wireDump?: import('./integration/providers/wire-dump.js').WireDumpSink;
|
|
1155
|
+
}): Promise<ModelProvider>;
|
package/dist/config.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getRunScope } from './harness/run/run-scope.js';
|
|
1
2
|
import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
|
|
2
3
|
/** 产品默认上下文窗口(与 core/types/model-info 一致,未声明能力时按此预算) */
|
|
3
4
|
export { DEFAULT_CONTEXT_WINDOW };
|
|
@@ -142,20 +143,129 @@ function resolveFallbackModels(fallbacks, models, defaults, depth = 0) {
|
|
|
142
143
|
});
|
|
143
144
|
}
|
|
144
145
|
// ── Provider 工厂 ──
|
|
146
|
+
// [timing probe] 长 session 首 run 延迟定位:LLM 调用计时装饰器(诊断后移除或转正)
|
|
147
|
+
/**
|
|
148
|
+
* 估算请求规模(字符近似值,仅用于计时日志)
|
|
149
|
+
*
|
|
150
|
+
* @param request - LLM 请求
|
|
151
|
+
* @returns msgs/chars/toolChars 计数串
|
|
152
|
+
*/
|
|
153
|
+
function timingReqSize(request) {
|
|
154
|
+
let chars = 0;
|
|
155
|
+
for (const m of request.messages ?? []) {
|
|
156
|
+
const c = m.content;
|
|
157
|
+
chars += typeof c === 'string' ? c.length : JSON.stringify(c ?? '').length;
|
|
158
|
+
}
|
|
159
|
+
const toolChars = request.tools ? JSON.stringify(request.tools).length : 0;
|
|
160
|
+
return `msgs=${request.messages?.length ?? 0} chars=${chars} toolChars=${toolChars}`;
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* 包一层计时探针:llm_start / llm_first_token(TTFT)/ llm_end
|
|
164
|
+
*
|
|
165
|
+
* @param inner - 真实 provider
|
|
166
|
+
* @returns 透传装饰器
|
|
167
|
+
*/
|
|
168
|
+
// [timing probe] 临时导出供 CLI daemon 的第二处 provider 工厂复用(诊断后随探针一起收)
|
|
169
|
+
export function withTimingProbe(inner) {
|
|
170
|
+
return {
|
|
171
|
+
name: inner.name,
|
|
172
|
+
defaultModel: inner.defaultModel,
|
|
173
|
+
models: inner.models,
|
|
174
|
+
isAvailable: () => inner.isAvailable(),
|
|
175
|
+
getModelInfo: (modelName) => inner.getModelInfo(modelName),
|
|
176
|
+
getModelInfos: () => inner.getModelInfos(),
|
|
177
|
+
chat: async (request) => {
|
|
178
|
+
const t0 = Date.now();
|
|
179
|
+
console.log(`[timing] stage=llm_start ms=${t0} provider=${inner.name} mode=chat model=${request.model ?? inner.defaultModel ?? '?'} ${timingReqSize(request)}`);
|
|
180
|
+
try {
|
|
181
|
+
const res = await inner.chat(request);
|
|
182
|
+
console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=chat outcome=ok finish=${res.finishReason ?? '?'} outChars=${(res.content ?? '').length}`);
|
|
183
|
+
return res;
|
|
184
|
+
}
|
|
185
|
+
catch (err) {
|
|
186
|
+
console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=chat outcome=error`);
|
|
187
|
+
throw err;
|
|
188
|
+
}
|
|
189
|
+
},
|
|
190
|
+
stream: async function* (request) {
|
|
191
|
+
const t0 = Date.now();
|
|
192
|
+
const model = request.model ?? inner.defaultModel ?? '?';
|
|
193
|
+
console.log(`[timing] stage=llm_start ms=${t0} provider=${inner.name} mode=stream model=${model} ${timingReqSize(request)}`);
|
|
194
|
+
let first = true;
|
|
195
|
+
let outcome = 'abandoned';
|
|
196
|
+
try {
|
|
197
|
+
for await (const chunk of inner.stream(request)) {
|
|
198
|
+
if (first) {
|
|
199
|
+
first = false;
|
|
200
|
+
console.log(`[timing] stage=llm_first_token ms=${Date.now()} ttft=${Date.now() - t0} provider=${inner.name} model=${model}`);
|
|
201
|
+
}
|
|
202
|
+
yield chunk;
|
|
203
|
+
}
|
|
204
|
+
outcome = 'ok';
|
|
205
|
+
}
|
|
206
|
+
catch (err) {
|
|
207
|
+
outcome = 'error';
|
|
208
|
+
throw err;
|
|
209
|
+
}
|
|
210
|
+
finally {
|
|
211
|
+
console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=stream outcome=${outcome}`);
|
|
212
|
+
}
|
|
213
|
+
},
|
|
214
|
+
};
|
|
215
|
+
}
|
|
216
|
+
/**
|
|
217
|
+
* 按 `observability.llmRequestDump` 配置构造 wire dump sink
|
|
218
|
+
*
|
|
219
|
+
* 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
|
|
220
|
+
* `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
|
|
221
|
+
* provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
|
|
222
|
+
*
|
|
223
|
+
* @param cfg - `observability.llmRequestDump` 配置段
|
|
224
|
+
* @returns sink;未启用时 undefined
|
|
225
|
+
*/
|
|
226
|
+
export async function createWireDumpSinkFromConfig(cfg) {
|
|
227
|
+
if (!cfg?.enabled)
|
|
228
|
+
return undefined;
|
|
229
|
+
// 与 withWireDump 一致按需加载:dump 未启用时 fs/crypto 不进常规 provider 创建路径
|
|
230
|
+
const { createWireDumpSink } = await import('./integration/providers/wire-dump.js');
|
|
231
|
+
return createWireDumpSink({
|
|
232
|
+
dir: cfg.dir,
|
|
233
|
+
maxCallsPerSession: cfg.maxCallsPerSession,
|
|
234
|
+
maxBodyBytes: cfg.maxBodyBytes,
|
|
235
|
+
resolveContext: () => {
|
|
236
|
+
const scope = getRunScope();
|
|
237
|
+
return scope
|
|
238
|
+
? { sessionId: scope.sessionId, agentId: scope.agentId, runId: scope.runId }
|
|
239
|
+
: undefined;
|
|
240
|
+
},
|
|
241
|
+
});
|
|
242
|
+
}
|
|
145
243
|
/**
|
|
146
244
|
* 从 ModelProviderConfig 创建 ModelProvider 实例
|
|
147
245
|
*
|
|
148
246
|
* 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
|
|
149
247
|
* 使用动态 import 以支持 ESM。
|
|
248
|
+
*
|
|
249
|
+
* @param name - provider 名称
|
|
250
|
+
* @param pc - provider 配置
|
|
251
|
+
* @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
|
|
252
|
+
* @returns provider 实例(计时探针 → wire dump → 原生 provider 的装饰链)
|
|
150
253
|
*/
|
|
151
|
-
export async function createProviderFromConfig(name, pc) {
|
|
254
|
+
export async function createProviderFromConfig(name, pc, options) {
|
|
152
255
|
const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
|
|
153
256
|
const models = pc.models.map(m => ({ name: m.name ?? m.id, contextWindow: m.contextWindow, maxOutputTokens: m.maxTokens }));
|
|
154
257
|
const defaultModel = pc.models[0]?.name ?? pc.models[0]?.id;
|
|
258
|
+
let decorate = withTimingProbe;
|
|
259
|
+
if (options?.wireDump) {
|
|
260
|
+
// 仅诊断路径才加载 wire dump(fs/crypto 不进入常规 provider 创建)
|
|
261
|
+
const { withWireDump } = await import('./integration/providers/wire-dump.js');
|
|
262
|
+
const sink = options.wireDump;
|
|
263
|
+
decorate = (inner) => withTimingProbe(withWireDump(inner, sink));
|
|
264
|
+
}
|
|
155
265
|
if (apiType === 'anthropic') {
|
|
156
266
|
const { AnthropicProvider } = await import('./integration/providers/anthropic.js');
|
|
157
|
-
return new AnthropicProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined });
|
|
267
|
+
return decorate(new AnthropicProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
|
|
158
268
|
}
|
|
159
269
|
const { OpenAIProvider } = await import('./integration/providers/openai.js');
|
|
160
|
-
return new OpenAIProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined });
|
|
270
|
+
return decorate(new OpenAIProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
|
|
161
271
|
}
|
|
@@ -52,6 +52,9 @@ function compileOne(trigger) {
|
|
|
52
52
|
...(trigger.metadata?.parentAgentId
|
|
53
53
|
? { parentAgentId: trigger.metadata.parentAgentId }
|
|
54
54
|
: {}),
|
|
55
|
+
...(trigger.metadata?.delegationId
|
|
56
|
+
? { delegationId: trigger.metadata.delegationId }
|
|
57
|
+
: {}),
|
|
55
58
|
...(trigger.metadata?.attachments?.length
|
|
56
59
|
? { attachmentIds: trigger.metadata.attachments.map((a) => a.id) }
|
|
57
60
|
: {}),
|
|
@@ -54,6 +54,13 @@ export declare class AgentRuntime {
|
|
|
54
54
|
abort(agentId: string, sessionId: string): void;
|
|
55
55
|
/** 是否存在该 agent+session 的活跃 Run(/stop 文案与竞态观测) */
|
|
56
56
|
hasActiveRun(agentId: string, sessionId: string): boolean;
|
|
57
|
+
/**
|
|
58
|
+
* 是否存在该会话的活跃 Run(不看 agent 归属)。
|
|
59
|
+
*
|
|
60
|
+
* @param sessionId - 会话 id
|
|
61
|
+
* @returns 该会话下任一 Run 在途即 true
|
|
62
|
+
*/
|
|
63
|
+
hasActiveRunForSession(sessionId: string): boolean;
|
|
57
64
|
/**
|
|
58
65
|
* 监听 Runtime 事件。
|
|
59
66
|
* - `on(listener)`:全部事件
|
|
@@ -10,6 +10,21 @@ import { CoalesceBuffer } from './coalesce.js';
|
|
|
10
10
|
import { buildRunRequest, resolveSessionId } from './compiler.js';
|
|
11
11
|
import { ExplicitRouter } from './router.js';
|
|
12
12
|
import { RuntimeEvents } from './types.js';
|
|
13
|
+
/**
|
|
14
|
+
* Trigger → 事件回执用裁剪引用(不含 payload 正文)
|
|
15
|
+
*
|
|
16
|
+
* @param trigger - 完整 trigger
|
|
17
|
+
* @returns 裁剪引用(id/type/agentId/sessionId/metadata)
|
|
18
|
+
*/
|
|
19
|
+
function toTriggerRef(trigger) {
|
|
20
|
+
return {
|
|
21
|
+
id: trigger.id,
|
|
22
|
+
type: trigger.type,
|
|
23
|
+
agentId: trigger.agentId,
|
|
24
|
+
sessionId: trigger.sessionId,
|
|
25
|
+
metadata: trigger.metadata,
|
|
26
|
+
};
|
|
27
|
+
}
|
|
13
28
|
export class AgentRuntime {
|
|
14
29
|
events;
|
|
15
30
|
router;
|
|
@@ -102,6 +117,19 @@ export class AgentRuntime {
|
|
|
102
117
|
}
|
|
103
118
|
return false;
|
|
104
119
|
}
|
|
120
|
+
/**
|
|
121
|
+
* 是否存在该会话的活跃 Run(不看 agent 归属)。
|
|
122
|
+
*
|
|
123
|
+
* @param sessionId - 会话 id
|
|
124
|
+
* @returns 该会话下任一 Run 在途即 true
|
|
125
|
+
*/
|
|
126
|
+
hasActiveRunForSession(sessionId) {
|
|
127
|
+
for (const run of this.activeRuns.values()) {
|
|
128
|
+
if (run.sessionId === sessionId)
|
|
129
|
+
return true;
|
|
130
|
+
}
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
105
133
|
on(typeOrListener, maybeListener) {
|
|
106
134
|
if (typeof typeOrListener === 'function') {
|
|
107
135
|
this.listeners.add(typeOrListener);
|
|
@@ -134,6 +162,7 @@ export class AgentRuntime {
|
|
|
134
162
|
async dispatch(trigger, options) {
|
|
135
163
|
if (!this.started) {
|
|
136
164
|
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
165
|
+
triggerRef: toTriggerRef(trigger),
|
|
137
166
|
triggerId: trigger.id,
|
|
138
167
|
reason: 'runtime_stopped',
|
|
139
168
|
});
|
|
@@ -148,13 +177,26 @@ export class AgentRuntime {
|
|
|
148
177
|
const targets = await this.router.resolve(trigger, this.agents);
|
|
149
178
|
if (targets.length === 0) {
|
|
150
179
|
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
180
|
+
triggerRef: toTriggerRef(trigger),
|
|
151
181
|
triggerId: trigger.id,
|
|
152
182
|
reason: 'no_agent',
|
|
153
183
|
});
|
|
154
184
|
return { status: 'skipped', reason: 'no_agent' };
|
|
155
185
|
}
|
|
156
186
|
if (targets.length === 1) {
|
|
157
|
-
|
|
187
|
+
const result = await this.dispatchToTarget(trigger, targets[0], options);
|
|
188
|
+
// 单目标丢弃也必须留下 TRIGGER_DROPPED(与 fan-out 对称):
|
|
189
|
+
// 「trigger 未被受理必有 dropped 事件」是委派送达回执(delegation §7.1)
|
|
190
|
+
// 依赖的不变量,缺事件 = 送达回执无法证伪。受理后 run 失败走 RUN_FAILED
|
|
191
|
+
// (消息可能已进父上下文,按已送达处理,不回执)
|
|
192
|
+
if (result.status === 'skipped') {
|
|
193
|
+
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
194
|
+
triggerRef: toTriggerRef(trigger),
|
|
195
|
+
triggerId: trigger.id,
|
|
196
|
+
reason: result.reason,
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
return result;
|
|
158
200
|
}
|
|
159
201
|
// fan-out:串行;聚合为 FanoutDispatchResult(ran/aborted/failed 均不静默丢弃)
|
|
160
202
|
const results = [];
|
|
@@ -167,6 +209,7 @@ export class AgentRuntime {
|
|
|
167
209
|
const allSkipped = results.every((r) => r.result.status === 'skipped');
|
|
168
210
|
if (anyFailed) {
|
|
169
211
|
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
212
|
+
triggerRef: toTriggerRef(trigger),
|
|
170
213
|
triggerId: trigger.id,
|
|
171
214
|
reason: 'fanout_partial_failure',
|
|
172
215
|
results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
|
|
@@ -177,6 +220,12 @@ export class AgentRuntime {
|
|
|
177
220
|
const reason = results[0]?.result.status === 'skipped'
|
|
178
221
|
? results[0].result.reason
|
|
179
222
|
: 'no_agent';
|
|
223
|
+
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
224
|
+
triggerRef: toTriggerRef(trigger),
|
|
225
|
+
triggerId: trigger.id,
|
|
226
|
+
reason,
|
|
227
|
+
results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
|
|
228
|
+
});
|
|
180
229
|
return { status: 'skipped', reason };
|
|
181
230
|
}
|
|
182
231
|
// anyRan(含 mixed ran + aborted/skipped)→ ran + 明细
|
|
@@ -219,7 +268,13 @@ export class AgentRuntime {
|
|
|
219
268
|
if (!this.started) {
|
|
220
269
|
return { status: 'skipped', reason: 'runtime_stopped' };
|
|
221
270
|
}
|
|
222
|
-
|
|
271
|
+
// I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
|
|
272
|
+
const isScheduleWake = triggers.some((t) => t.type === 'schedule');
|
|
273
|
+
const request = buildRunRequest(agent, triggers, sessionId, {
|
|
274
|
+
actorType: isScheduleWake ? 'timer' : undefined,
|
|
275
|
+
actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : undefined,
|
|
276
|
+
intent: isScheduleWake ? 'schedule_wake' : undefined,
|
|
277
|
+
});
|
|
223
278
|
const controller = new AbortController();
|
|
224
279
|
const run = {
|
|
225
280
|
requestId: request.requestId,
|
|
@@ -272,6 +327,9 @@ export class AgentRuntime {
|
|
|
272
327
|
requestId: request.requestId,
|
|
273
328
|
agentId: agent.agentId,
|
|
274
329
|
sessionId,
|
|
330
|
+
// 回执关联:已受理的 trigger(run 失败但消息可能已进父上下文,
|
|
331
|
+
// 送达语义视为已送达,订阅方自行判定)
|
|
332
|
+
triggerRefs: request.triggers.map(toTriggerRef),
|
|
275
333
|
error: message,
|
|
276
334
|
});
|
|
277
335
|
return { status: 'failed', error: message };
|
|
@@ -6,12 +6,21 @@
|
|
|
6
6
|
import type { EventBus } from '@octopi-agent/core/index.js';
|
|
7
7
|
import type { Trigger, TriggerPayload, TriggerSource } from '../types.js';
|
|
8
8
|
export declare const AGENT_SIGNAL_EVENT_TYPE = "runtime.agent_signal";
|
|
9
|
+
/**
|
|
10
|
+
* 查询总线上是否有存活的 `AgentSignalSource` 接收端。
|
|
11
|
+
*
|
|
12
|
+
* @param events - 事件总线
|
|
13
|
+
* @returns 有接收端返回 true;投递器应据此拒绝把通知判为已送达
|
|
14
|
+
*/
|
|
15
|
+
export declare function hasAgentSignalReceiver(events: EventBus): boolean;
|
|
9
16
|
export interface AgentSignal {
|
|
10
17
|
fromAgentId: string;
|
|
11
18
|
toAgentId: string;
|
|
12
19
|
sessionId?: string;
|
|
13
20
|
payload: TriggerPayload;
|
|
14
21
|
reason?: string;
|
|
22
|
+
/** 委派单 ID(collaboration/delegation);透传到消息 metadata */
|
|
23
|
+
delegationId?: string;
|
|
15
24
|
}
|
|
16
25
|
export interface AgentSignalSourceConfig {
|
|
17
26
|
id?: string;
|
|
@@ -23,6 +32,8 @@ export declare class AgentSignalSource implements TriggerSource {
|
|
|
23
32
|
readonly type: "agent_signal";
|
|
24
33
|
private disposables;
|
|
25
34
|
private running;
|
|
35
|
+
/** 本实例是否已计入 receiverBuses(防未 start 的 stop / 二次 stop 误删兄弟登记) */
|
|
36
|
+
private receiverCounted;
|
|
26
37
|
constructor(config?: AgentSignalSourceConfig);
|
|
27
38
|
start(emit: (t: Trigger) => void): Promise<void>;
|
|
28
39
|
stop(): Promise<void>;
|