@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
|
@@ -22,41 +22,66 @@ export function formatRuntimeDatetimeInjection(now = new Date()) {
|
|
|
22
22
|
return `Current datetime: ${date} ${time} (${timeZone})`;
|
|
23
23
|
}
|
|
24
24
|
/**
|
|
25
|
-
*
|
|
25
|
+
* 格式化工作目录与允许根的 runtime 注入文案
|
|
26
26
|
*
|
|
27
|
-
*
|
|
28
|
-
* 而不是扫全盘或猜项目根。
|
|
27
|
+
* 工具相对路径解析到 cwd;模型检索/写入应优先在此,且写入路径应落在 allowRoots。
|
|
29
28
|
*
|
|
30
29
|
* @param cwd - 本 Run 的工具 cwd(agent.workspace / RunConfig.cwd)
|
|
30
|
+
* @param options - allowRoots(L2/事务根)与 effectMode(运行模式)
|
|
31
31
|
* @returns 注入字符串(工作目录锚点块;cwd 为空时返回空串)
|
|
32
32
|
*/
|
|
33
|
-
export function formatRuntimeWorkspaceInjection(cwd) {
|
|
33
|
+
export function formatRuntimeWorkspaceInjection(cwd, options) {
|
|
34
34
|
const trimmed = cwd?.trim();
|
|
35
35
|
if (!trimmed)
|
|
36
36
|
return '';
|
|
37
|
-
|
|
37
|
+
const lines = [
|
|
38
38
|
`Workspace: ${trimmed}`,
|
|
39
39
|
'Relative tool paths resolve against this directory.',
|
|
40
40
|
'Prefer searching here first for user files and task materials; do not scan the whole disk unless the user asks.',
|
|
41
41
|
'User documents often live in subdirectories (e.g. docs/). To find a file by name, use file_list with a pattern (recursive by default) or give file_read the path under Workspace.',
|
|
42
|
-
]
|
|
42
|
+
];
|
|
43
|
+
const roots = (options?.allowRoots ?? []).map((r) => r?.trim()).filter(Boolean);
|
|
44
|
+
if (roots.length > 0) {
|
|
45
|
+
lines.push(`Allowed roots (write/read under these): ${roots.join(', ')}`);
|
|
46
|
+
lines.push('Writes outside these roots are denied in strict containment; prefer paths under Allowed roots.');
|
|
47
|
+
}
|
|
48
|
+
const mode = options?.effectMode?.trim();
|
|
49
|
+
if (mode) {
|
|
50
|
+
lines.push(`Effect mode: ${mode}`);
|
|
51
|
+
if (mode === 'host') {
|
|
52
|
+
lines.push('host mode: broad host access (not a sandbox); still avoid destructive commands.');
|
|
53
|
+
}
|
|
54
|
+
else if (mode === 'project') {
|
|
55
|
+
lines.push('project mode: coding mode — file L2 is strict, but shell may touch paths outside roots.');
|
|
56
|
+
}
|
|
57
|
+
else if (mode === 'untrusted') {
|
|
58
|
+
lines.push('untrusted mode: stay inside allowed roots; shell and egress tools may be blocked.');
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return lines.join('\n');
|
|
43
62
|
}
|
|
44
63
|
/**
|
|
45
|
-
* 将 datetime(+ 可选 workspace
|
|
64
|
+
* 将 datetime(+ 可选 workspace/roots/约定)块拼入既有 injectedContext
|
|
46
65
|
*
|
|
47
|
-
* 锚点在前:datetime → workspace → 既有注入(tasks / guidance)。
|
|
66
|
+
* 锚点在前:datetime → workspace → root_instructions → 既有注入(tasks / guidance)。
|
|
48
67
|
* 保留 `withRuntimeDatetimeInjection` 作为仅时间锚点的兼容入口。
|
|
49
68
|
*
|
|
50
69
|
* @param injectedContext - 本轮已有的注入(tasks / guidance 等),可为空
|
|
51
|
-
* @param options - now 参考时刻;cwd
|
|
70
|
+
* @param options - now 参考时刻;cwd 工具工作目录;allowRoots / effectMode;rootInstructions 预格式化约定块
|
|
52
71
|
* @returns 组合后的 injectedContext
|
|
53
72
|
*/
|
|
54
73
|
export function withRuntimeEnvironmentInjection(injectedContext, options) {
|
|
55
74
|
const now = options?.now ?? new Date();
|
|
56
75
|
const blocks = [formatRuntimeDatetimeInjection(now)];
|
|
57
|
-
const ws = formatRuntimeWorkspaceInjection(options?.cwd
|
|
76
|
+
const ws = formatRuntimeWorkspaceInjection(options?.cwd, {
|
|
77
|
+
allowRoots: options?.allowRoots,
|
|
78
|
+
effectMode: options?.effectMode,
|
|
79
|
+
});
|
|
58
80
|
if (ws)
|
|
59
81
|
blocks.push(ws);
|
|
82
|
+
const rootInst = options?.rootInstructions?.trim();
|
|
83
|
+
if (rootInst)
|
|
84
|
+
blocks.push(rootInst);
|
|
60
85
|
const base = (injectedContext ?? '').trim();
|
|
61
86
|
if (base)
|
|
62
87
|
blocks.push(base);
|
|
@@ -72,3 +97,34 @@ export function withRuntimeEnvironmentInjection(injectedContext, options) {
|
|
|
72
97
|
export function withRuntimeDatetimeInjection(injectedContext, now = new Date()) {
|
|
73
98
|
return withRuntimeEnvironmentInjection(injectedContext, { now });
|
|
74
99
|
}
|
|
100
|
+
/**
|
|
101
|
+
* 拆分 runtime 注入为「稳定锚点」与「易变快照」两份(宪法 E8:缓存稳定前缀)
|
|
102
|
+
*
|
|
103
|
+
* 稳定份(workspace/roots/effectMode + root_instructions)留 system prompt;
|
|
104
|
+
* 易变份(datetime + 既有注入 tasks/guidance)进本轮快照(消息尾部 content 侧)。
|
|
105
|
+
* `withRuntimeEnvironmentInjection` 保留合并形态供旧路径(fallback 拼接)使用。
|
|
106
|
+
*
|
|
107
|
+
* @param injectedContext - 本轮已有注入(tasks / guidance 等),可为空
|
|
108
|
+
* @param options - now / cwd / allowRoots / effectMode / rootInstructions
|
|
109
|
+
* @returns anchors(稳定份)与 volatile(易变份)
|
|
110
|
+
*/
|
|
111
|
+
export function splitRuntimeEnvironmentInjection(injectedContext, options) {
|
|
112
|
+
const anchors = [];
|
|
113
|
+
const ws = formatRuntimeWorkspaceInjection(options?.cwd, {
|
|
114
|
+
allowRoots: options?.allowRoots,
|
|
115
|
+
effectMode: options?.effectMode,
|
|
116
|
+
});
|
|
117
|
+
if (ws)
|
|
118
|
+
anchors.push(ws);
|
|
119
|
+
const rootInst = options?.rootInstructions?.trim();
|
|
120
|
+
if (rootInst)
|
|
121
|
+
anchors.push(rootInst);
|
|
122
|
+
const volatileBlocks = [formatRuntimeDatetimeInjection(options?.now ?? new Date())];
|
|
123
|
+
const base = (injectedContext ?? '').trim();
|
|
124
|
+
if (base)
|
|
125
|
+
volatileBlocks.push(base);
|
|
126
|
+
return {
|
|
127
|
+
anchors: anchors.join('\n\n'),
|
|
128
|
+
volatile: volatileBlocks.join('\n\n'),
|
|
129
|
+
};
|
|
130
|
+
}
|
|
@@ -15,7 +15,22 @@ export interface SystemPromptAssembleInput {
|
|
|
15
15
|
agentId?: string;
|
|
16
16
|
messages: Message[];
|
|
17
17
|
persona: string;
|
|
18
|
+
/**
|
|
19
|
+
* 运行时注入(**兼容旧契约**:datetime + 稳定锚点 + tasks/guidance 的合并形态)。
|
|
20
|
+
* 提供 `volatileContext` / `runtimeAnchors` 时本字段被忽略;
|
|
21
|
+
* 仅有本字段时整体按**易变**处理进快照(E8:来历不明的动态注入不得进 system 前缀)。
|
|
22
|
+
*/
|
|
18
23
|
injectedContext?: string;
|
|
24
|
+
/**
|
|
25
|
+
* 易变注入份(datetime / session tasks / guidance 等)——宪法 E8:
|
|
26
|
+
* 进本轮易变快照(消息尾部),**不进 system prompt**。优先于 `injectedContext`。
|
|
27
|
+
*/
|
|
28
|
+
volatileContext?: string;
|
|
29
|
+
/**
|
|
30
|
+
* 稳定运行时锚点(workspace/roots/effectMode/root_instructions)——
|
|
31
|
+
* 留 system prompt(缓存稳定前缀)。
|
|
32
|
+
*/
|
|
33
|
+
runtimeAnchors?: string;
|
|
19
34
|
/** 显式配置的上下文窗口;未知时省略 */
|
|
20
35
|
contextWindow?: number;
|
|
21
36
|
/**
|
|
@@ -27,6 +42,11 @@ export interface SystemPromptAssembleInput {
|
|
|
27
42
|
}
|
|
28
43
|
export interface SystemPromptAssembleOutput {
|
|
29
44
|
systemPrompt: string;
|
|
45
|
+
/**
|
|
46
|
+
* 易变快照正文(E8,placement='snapshot' 的层)。
|
|
47
|
+
* 由调用方经本轮消息尾部的 content 插槽送达;无易变层时缺省。
|
|
48
|
+
*/
|
|
49
|
+
runtimeSnapshot?: string;
|
|
30
50
|
manifest?: AssembleManifest;
|
|
31
51
|
/**
|
|
32
52
|
* true = 未按 contextWindow 比例做层预算(窗口未知)。
|
|
@@ -34,12 +54,22 @@ export interface SystemPromptAssembleOutput {
|
|
|
34
54
|
*/
|
|
35
55
|
skippedBudget?: boolean;
|
|
36
56
|
}
|
|
57
|
+
/**
|
|
58
|
+
* Turn 信封阅读规则(缓存稳定固定块;永远拼进 system)。
|
|
59
|
+
* 与 `turn-envelope.ts` 语法一一对应。
|
|
60
|
+
*/
|
|
61
|
+
export declare const TURN_SEMANTICS_MD = "## Turns (authoritative)\n\n- A **turn** is one `<turn_start id=\"tN\">` user message plus every assistant/tool\n message up to its matching `<turn_end id=\"tN\"/>`.\n- `<turn_context>` is **turn-scoped condition** (time, tasks, retrieval picks).\n It is NOT global memory. It expires outside that turn.\n- Older turns stay in the transcript frozen. For current work:\n use the latest `<turn_context>`; older picks are historical snapshots only;\n the transcript wins over any stale pick.\n- Never edit or delete `<turn_start>` / `<turn_end>` / past tool results.\n- If a tool needs old ephemeral detail, re-read the source (session log / files);\n do not assume old picks are still true.";
|
|
37
62
|
export declare function createDefaultSystemPromptAssembler(options?: {
|
|
38
63
|
assembler?: ContextAssembler;
|
|
39
64
|
assemblerConfig?: DefaultContextAssemblerConfig;
|
|
40
65
|
systemBudgetRatio?: number;
|
|
41
66
|
/** 显式 system 预算 token;与 contextWindow 无关(窗口未知时仍可用) */
|
|
42
67
|
systemBudgetTokens?: number;
|
|
68
|
+
/**
|
|
69
|
+
* 易变快照组(placement='snapshot')的 token 预算(E8)。
|
|
70
|
+
* 缺省不设上限(与历史行为一致);部署调参经 `contextAssembler.snapshotBudgetTokens`。
|
|
71
|
+
*/
|
|
72
|
+
snapshotBudgetTokens?: number;
|
|
43
73
|
getSkillPromptText?: () => Promise<string> | string;
|
|
44
74
|
memoryStore?: MemoryStore;
|
|
45
75
|
/** Knowledge Tier 0 catalog(有哪些源);内容命中不进 system */
|
|
@@ -8,6 +8,26 @@ import { CognitionLayer, KnowledgeLayer, MemoryLayer, PersonaLayer, RuntimeLayer
|
|
|
8
8
|
import { extractLayerQuery } from './layer-types.js';
|
|
9
9
|
import { loadConstitution } from './constitution/load-constitution.js';
|
|
10
10
|
const DEFAULT_SYSTEM_BUDGET_RATIO = 0.22;
|
|
11
|
+
/**
|
|
12
|
+
* Turn 信封阅读规则(缓存稳定固定块;永远拼进 system)。
|
|
13
|
+
* 与 `turn-envelope.ts` 语法一一对应。
|
|
14
|
+
*/
|
|
15
|
+
export const TURN_SEMANTICS_MD = `## Turns (authoritative)
|
|
16
|
+
|
|
17
|
+
- A **turn** is one \`<turn_start id="tN">\` user message plus every assistant/tool
|
|
18
|
+
message up to its matching \`<turn_end id="tN"/>\`.
|
|
19
|
+
- \`<turn_context>\` is **turn-scoped condition** (time, tasks, retrieval picks).
|
|
20
|
+
It is NOT global memory. It expires outside that turn.
|
|
21
|
+
- Older turns stay in the transcript frozen. For current work:
|
|
22
|
+
use the latest \`<turn_context>\`; older picks are historical snapshots only;
|
|
23
|
+
the transcript wins over any stale pick.
|
|
24
|
+
- Never edit or delete \`<turn_start>\` / \`<turn_end>\` / past tool results.
|
|
25
|
+
- If a tool needs old ephemeral detail, re-read the source (session log / files);
|
|
26
|
+
do not assume old picks are still true.`;
|
|
27
|
+
function withTurnRules(systemPrompt) {
|
|
28
|
+
const body = systemPrompt.trim();
|
|
29
|
+
return body ? `${TURN_SEMANTICS_MD}\n\n---\n\n${body}` : TURN_SEMANTICS_MD;
|
|
30
|
+
}
|
|
11
31
|
export function createDefaultSystemPromptAssembler(options) {
|
|
12
32
|
let preamble = options?.constitutionText ?? '';
|
|
13
33
|
if (!preamble && options?.constitution !== undefined && options?.constitution !== null) {
|
|
@@ -48,7 +68,7 @@ export function createDefaultSystemPromptAssembler(options) {
|
|
|
48
68
|
},
|
|
49
69
|
async assemble(input) {
|
|
50
70
|
const hasPersona = Boolean((input.persona ?? '').trim());
|
|
51
|
-
const hasInjected = Boolean((input.injectedContext ?? '').trim());
|
|
71
|
+
const hasInjected = Boolean((input.injectedContext ?? '').trim() || (input.runtimeAnchors ?? '').trim());
|
|
52
72
|
let hasSkill = false;
|
|
53
73
|
if (getSkillPromptText) {
|
|
54
74
|
hasSkill = Boolean((await getSkillPromptText()).trim());
|
|
@@ -59,7 +79,7 @@ export function createDefaultSystemPromptAssembler(options) {
|
|
|
59
79
|
cognitionStore);
|
|
60
80
|
const hasPreamble = Boolean(resolvedPreamble.trim());
|
|
61
81
|
if (!hasPersona && !hasInjected && !hasSkill && !hasRetrieval && !hasPreamble) {
|
|
62
|
-
return { systemPrompt: '' };
|
|
82
|
+
return { systemPrompt: withTurnRules('') };
|
|
63
83
|
}
|
|
64
84
|
// contextWindow 未知且未配置 systemBudgetTokens:
|
|
65
85
|
// **跳过按窗口比例的预算**,但仍装配层(不按 token 硬裁,保留完整层内容)
|
|
@@ -115,20 +135,61 @@ export function createDefaultSystemPromptAssembler(options) {
|
|
|
115
135
|
limit: options.memoryLimit,
|
|
116
136
|
}));
|
|
117
137
|
}
|
|
138
|
+
// E8 双实例:稳定锚点(workspace/root_instructions)留 system;易变注入(datetime/tasks)进快照。
|
|
139
|
+
// volatileContext 优先(新契约);仅 injectedContext 时整体按易变处理(E8 缺省)
|
|
118
140
|
layers.push(new RuntimeLayer({
|
|
119
|
-
getText: () => input.
|
|
141
|
+
getText: () => input.runtimeAnchors ?? '',
|
|
120
142
|
}));
|
|
143
|
+
layers.push(new RuntimeLayer({
|
|
144
|
+
getText: () => input.volatileContext ?? input.injectedContext ?? '',
|
|
145
|
+
placement: 'snapshot',
|
|
146
|
+
}));
|
|
147
|
+
// E8 双组装配:稳定层 → system prompt(含宪法 preamble);易变层 → 本轮快照
|
|
148
|
+
const systemLayers = layers.filter((l) => (l.placement ?? 'system') !== 'snapshot');
|
|
149
|
+
const snapshotLayers = layers.filter((l) => l.placement === 'snapshot');
|
|
150
|
+
const layerQuery = extractLayerQuery(input.messages, { topicHints: input.topicHints });
|
|
121
151
|
const result = await assembler.assemble({
|
|
122
152
|
sessionId: input.sessionId,
|
|
123
153
|
agentId: input.agentId,
|
|
124
154
|
messages: input.messages,
|
|
125
155
|
systemBudget,
|
|
126
|
-
layers,
|
|
156
|
+
layers: systemLayers,
|
|
127
157
|
signal: input.signal,
|
|
128
|
-
query:
|
|
158
|
+
query: layerQuery,
|
|
129
159
|
constitutionPreamble: passPreamblePerAssemble || resolvedPreamble ? resolvedPreamble : undefined,
|
|
130
160
|
});
|
|
131
|
-
|
|
161
|
+
let runtimeSnapshot;
|
|
162
|
+
let manifest = result.manifest;
|
|
163
|
+
if (snapshotLayers.length > 0) {
|
|
164
|
+
const snapBudget = options?.snapshotBudgetTokens != null && options.snapshotBudgetTokens > 0
|
|
165
|
+
? options.snapshotBudgetTokens
|
|
166
|
+
: Number.MAX_SAFE_INTEGER;
|
|
167
|
+
const snap = await assembler.assemble({
|
|
168
|
+
sessionId: input.sessionId,
|
|
169
|
+
agentId: input.agentId,
|
|
170
|
+
messages: input.messages,
|
|
171
|
+
systemBudget: snapBudget,
|
|
172
|
+
layers: snapshotLayers,
|
|
173
|
+
signal: input.signal,
|
|
174
|
+
query: layerQuery,
|
|
175
|
+
constitutionPreamble: '',
|
|
176
|
+
});
|
|
177
|
+
runtimeSnapshot = snap.systemPrompt.trim() || undefined;
|
|
178
|
+
manifest = {
|
|
179
|
+
...result.manifest,
|
|
180
|
+
usedSnapshotTokens: snap.manifest.usedTokens > 0 ? snap.manifest.usedTokens : undefined,
|
|
181
|
+
layers: [
|
|
182
|
+
...result.manifest.layers.map((e) => ({ ...e, placement: e.placement ?? 'system' })),
|
|
183
|
+
...snap.manifest.layers.map((e) => ({ ...e, placement: 'snapshot' })),
|
|
184
|
+
],
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
return {
|
|
188
|
+
systemPrompt: withTurnRules(result.systemPrompt),
|
|
189
|
+
runtimeSnapshot,
|
|
190
|
+
manifest,
|
|
191
|
+
skippedBudget,
|
|
192
|
+
};
|
|
132
193
|
},
|
|
133
194
|
};
|
|
134
195
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Token 估算常量
|
|
3
3
|
*
|
|
4
|
-
*
|
|
4
|
+
* 分层比率策略,按内容类型使用不同估算比率。
|
|
5
5
|
* 基于 tiktoken cl100k_base 经验值。
|
|
6
6
|
*/
|
|
7
7
|
/** 通用文本:英文约 4 chars/token,中文约 1 char/token */
|
|
@@ -12,7 +12,7 @@ export declare const TOOL_RESULT_CHARS_PER_TOKEN = 2;
|
|
|
12
12
|
export declare const JSON_CHARS_PER_TOKEN = 3;
|
|
13
13
|
/** 消息结构开销(role + 分隔符 + 边界标记) */
|
|
14
14
|
export declare const MESSAGE_OVERHEAD_TOKENS = 12;
|
|
15
|
-
/**
|
|
15
|
+
/** 安全余量系数:补偿估算不准 */
|
|
16
16
|
export declare const SAFETY_MARGIN = 1.2;
|
|
17
17
|
/** 图片 token 估算(参考 OpenAI vision: 85-170 token/tile,假设 ~1200 token) */
|
|
18
18
|
export declare const IMAGE_TOKEN_ESTIMATE = 1200;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Token 估算常量
|
|
3
3
|
*
|
|
4
|
-
*
|
|
4
|
+
* 分层比率策略,按内容类型使用不同估算比率。
|
|
5
5
|
* 基于 tiktoken cl100k_base 经验值。
|
|
6
6
|
*/
|
|
7
7
|
// ── 字符/token 比率 ──
|
|
@@ -13,7 +13,7 @@ export const TOOL_RESULT_CHARS_PER_TOKEN = 2;
|
|
|
13
13
|
export const JSON_CHARS_PER_TOKEN = 3;
|
|
14
14
|
/** 消息结构开销(role + 分隔符 + 边界标记) */
|
|
15
15
|
export const MESSAGE_OVERHEAD_TOKENS = 12;
|
|
16
|
-
/**
|
|
16
|
+
/** 安全余量系数:补偿估算不准 */
|
|
17
17
|
export const SAFETY_MARGIN = 1.2;
|
|
18
18
|
// ── 多媒体估算 ──
|
|
19
19
|
/** 图片 token 估算(参考 OpenAI vision: 85-170 token/tile,假设 ~1200 token) */
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* 不依赖 Message / LLMMessage 等领域类型,只做「内容 → token 数」。
|
|
5
5
|
* 由 `token-estimator.ts` 组装为 `TokenEstimator` 实现,也可被同层模块直接复用。
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 三层策略:
|
|
8
8
|
* 1. 优先使用 LLM 返回的实际 token 数(外部回写)
|
|
9
9
|
* 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
|
|
10
10
|
* 3. 兜底:启发式估算,按内容类型使用不同比率
|
|
@@ -15,8 +15,6 @@
|
|
|
15
15
|
* 每个 CJK 字符计为 CHARS_PER_TOKEN 个等效字符,
|
|
16
16
|
* 这样 `adjustedChars / CHARS_PER_TOKEN` 能得到准确的 token 估算。
|
|
17
17
|
*
|
|
18
|
-
* 参考 OpenClaw 的 estimateStringChars()。
|
|
19
|
-
*
|
|
20
18
|
* @param text 原始文本
|
|
21
19
|
* @returns CJK 加权后的等效字符数
|
|
22
20
|
*/
|
|
@@ -4,14 +4,14 @@
|
|
|
4
4
|
* 不依赖 Message / LLMMessage 等领域类型,只做「内容 → token 数」。
|
|
5
5
|
* 由 `token-estimator.ts` 组装为 `TokenEstimator` 实现,也可被同层模块直接复用。
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 三层策略:
|
|
8
8
|
* 1. 优先使用 LLM 返回的实际 token 数(外部回写)
|
|
9
9
|
* 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
|
|
10
10
|
* 3. 兜底:启发式估算,按内容类型使用不同比率
|
|
11
11
|
*/
|
|
12
12
|
import { CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
|
|
13
13
|
// ── CJK 检测正则 ──
|
|
14
|
-
//
|
|
14
|
+
// 非拉丁字符检测,覆盖完整东亚字符范围
|
|
15
15
|
const NON_LATIN_RE = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7AF\uF900-\uFAFF\uFF01-\uFF60\uFFE0-\uFFE6]/gu;
|
|
16
16
|
// CJK 扩展 B+ 的 surrogate pairs(U+20000-U+2FA1F)
|
|
17
17
|
const CJK_SURROGATE_HIGH_RE = /[\uD840-\uD87E][\uDC00-\uDFFF]/g;
|
|
@@ -21,8 +21,6 @@ const CJK_SURROGATE_HIGH_RE = /[\uD840-\uD87E][\uDC00-\uDFFF]/g;
|
|
|
21
21
|
* 每个 CJK 字符计为 CHARS_PER_TOKEN 个等效字符,
|
|
22
22
|
* 这样 `adjustedChars / CHARS_PER_TOKEN` 能得到准确的 token 估算。
|
|
23
23
|
*
|
|
24
|
-
* 参考 OpenClaw 的 estimateStringChars()。
|
|
25
|
-
*
|
|
26
24
|
* @param text 原始文本
|
|
27
25
|
* @returns CJK 加权后的等效字符数
|
|
28
26
|
*/
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* 实现本域 `TokenEstimator` 契约(`./types.ts`);估算原语在 `token-estimate-fns.ts`。
|
|
5
5
|
* Token 估算属 Context 域策略,不是 Core Kernel 能力。
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 三层策略:
|
|
8
8
|
* 1. 优先使用 LLM 返回的实际 token 数(usage reported prompt)- 外部回写
|
|
9
9
|
* 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
|
|
10
10
|
* 3. 兜底:启发式估算,按内容类型使用不同比率
|
|
@@ -4,15 +4,23 @@
|
|
|
4
4
|
* 实现本域 `TokenEstimator` 契约(`./types.ts`);估算原语在 `token-estimate-fns.ts`。
|
|
5
5
|
* Token 估算属 Context 域策略,不是 Core Kernel 能力。
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* 三层策略:
|
|
8
8
|
* 1. 优先使用 LLM 返回的实际 token 数(usage reported prompt)- 外部回写
|
|
9
9
|
* 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
|
|
10
10
|
* 3. 兜底:启发式估算,按内容类型使用不同比率
|
|
11
11
|
*/
|
|
12
12
|
import { estimateTextTokens, estimateAdjustedChars, estimateContentBlock, estimateToolCallTokens, } from './token-estimate-fns.js';
|
|
13
|
+
import { toolResultBody } from './tool-result-body.js';
|
|
13
14
|
import { TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, } from './token-constants.js';
|
|
14
15
|
// Re-export for callers that only need text estimation
|
|
15
16
|
export { estimateTextTokens } from './token-estimate-fns.js';
|
|
17
|
+
/**
|
|
18
|
+
* 消息级 token 估算缓存(模块级:estimator 实例众多,实例级缓存无命中率)。
|
|
19
|
+
*
|
|
20
|
+
* 安全前提:消息内容写入后不可变(估算只读 content/toolCalls/toolResults)。
|
|
21
|
+
* 估算对同一消息是纯函数,跨实例结果必须一致。
|
|
22
|
+
*/
|
|
23
|
+
const messageTokensCache = new WeakMap();
|
|
16
24
|
/**
|
|
17
25
|
* 启发式 Token 估算器实现
|
|
18
26
|
*/
|
|
@@ -27,6 +35,9 @@ export class HeuristicTokenEstimator {
|
|
|
27
35
|
* @returns 估算 token 数
|
|
28
36
|
*/
|
|
29
37
|
estimateMessage(message) {
|
|
38
|
+
const cached = messageTokensCache.get(message);
|
|
39
|
+
if (cached !== undefined)
|
|
40
|
+
return cached;
|
|
30
41
|
let tokens = MESSAGE_OVERHEAD_TOKENS;
|
|
31
42
|
if (typeof message.content === 'string') {
|
|
32
43
|
tokens += estimateTextTokens(message.content);
|
|
@@ -42,14 +53,11 @@ export class HeuristicTokenEstimator {
|
|
|
42
53
|
// 工具结果用更密集的比率(chars/2)
|
|
43
54
|
if (message.toolResults) {
|
|
44
55
|
for (const tr of message.toolResults) {
|
|
45
|
-
const body = tr
|
|
46
|
-
? JSON.stringify({ error: tr.error })
|
|
47
|
-
: typeof tr.result === 'string'
|
|
48
|
-
? tr.result
|
|
49
|
-
: JSON.stringify(tr.result ?? null);
|
|
56
|
+
const body = toolResultBody(tr);
|
|
50
57
|
tokens += Math.ceil(estimateAdjustedChars(body) / TOOL_RESULT_CHARS_PER_TOKEN);
|
|
51
58
|
}
|
|
52
59
|
}
|
|
60
|
+
messageTokensCache.set(message, tokens);
|
|
53
61
|
return tokens;
|
|
54
62
|
}
|
|
55
63
|
/**
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 历史工具结果批量冻结老化(F1-B2)— 视图级、零 LLM、write-once
|
|
3
|
+
*
|
|
4
|
+
* 语义(arch/long-session-latency.md §5 B2 + arch/b0-cache-stable-context.md §4):
|
|
5
|
+
* - **当前 run 永不老化**:最近一条真实 user 消息(排除引擎载体插槽)以来的工具结果全原文;
|
|
6
|
+
* - **近 `rawWindow` 条跨轮工具结果**保留原文;
|
|
7
|
+
* - 更旧的候选按 **`freezeBatch` 批量**降级为结构化指针(工具名 + 参数要点 + 结果轮廓 + re-run 提示);
|
|
8
|
+
* - **批量冻结(禁渐进老化)**:老化边界只以 `freezeBatch` 为步长成批推进,段间轮次视图
|
|
9
|
+
* 逐字节稳定——每轮在 recency 边界改写 1 条 = 把边界→尾部整段烧前缀缓存(B0 稿 §4);
|
|
10
|
+
* - **write-once**:指针按工具结果对象记忆化 + 纯函数定形,永不二次改写;
|
|
11
|
+
* ⚠️ 计划必须基于**完整历史**(append-only 的 session 消息序)计算,不能按被裁剪的
|
|
12
|
+
* 装配视图重算——视图收缩会让已降级条目回原文、批量边界来回翻转(评审 F1);
|
|
13
|
+
* - **视图级**:只影响发给 LLM 的消息视图(`buildLlmMessages`);session 持久层保原文。
|
|
14
|
+
*
|
|
15
|
+
* 红线(§4 能力红线):user / assistant **正文**永不降级;**error 结果永不降级**(错误可追溯性优先,
|
|
16
|
+
* 字段保真);不膨胀守卫——只有指针严格小于原文时才降级。
|
|
17
|
+
*
|
|
18
|
+
* tool_call 参数(`ageToolArgs`,默认开):**只对「结果已被老化」的那条调用**同步降级为键值摘要
|
|
19
|
+
* (长值换成长度标记,键名全保)。原因:参数是上下文中唯一无界增长的成分——结果老化成指针后
|
|
20
|
+
* 参数仍留原文,实测其总量可达指针本体的 1.1 倍,且随 session 线性增长。
|
|
21
|
+
* 降级不改变 tool_call ↔ tool_result 配对结构(`id`/`name` 不动,`arguments` 仍是合法 JSON)。
|
|
22
|
+
*
|
|
23
|
+
* @module harness/context/tool-result-aging
|
|
24
|
+
*/
|
|
25
|
+
import type { Message } from '@octopi-agent/core/types.js';
|
|
26
|
+
/** 老化配置(配置面输入;缺省见 {@link resolveToolResultAgingOptions}) */
|
|
27
|
+
export interface ToolResultAgingConfig {
|
|
28
|
+
/** 总开关(默认 true) */
|
|
29
|
+
enabled?: boolean;
|
|
30
|
+
/** 跨轮原文保留条数(默认 40) */
|
|
31
|
+
rawWindow?: number;
|
|
32
|
+
/**
|
|
33
|
+
* 批量冻结步长:老化边界只成批推进(默认 40;最小 1)。
|
|
34
|
+
* ⚠️ 1 = 逐候选即降级(等同渐进老化、每轮烧前缀缓存,仅调试用);
|
|
35
|
+
* 生产取值应 ≥ 每轮工具结果数,使冻结事件隔数轮一次。
|
|
36
|
+
* 默认 40 的实测依据:单轮工具结果数峰值 34、均值 15,批 20 会近乎每轮触发一次,
|
|
37
|
+
* 而每次燃烧量是常数级(rawWindow + 半批 + 当轮),小批次摊不动 → 回本点被拉到 100 次调用。
|
|
38
|
+
*/
|
|
39
|
+
freezeBatch?: number;
|
|
40
|
+
/** 指针目标字符数(默认 400;是目标非硬顶——error/固定骨架可超出) */
|
|
41
|
+
maxPointerChars?: number;
|
|
42
|
+
/**
|
|
43
|
+
* 是否随结果老化同步降级该次调用的参数(默认 true)
|
|
44
|
+
*
|
|
45
|
+
* 只作用于「结果已被老化」的调用;当前 run 与 rawWindow 内的参数保持原文。
|
|
46
|
+
*/
|
|
47
|
+
ageToolArgs?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* 参数摘要的目标字符数(默认 320;**只约束内容值**,键名与定位字段不计入)
|
|
50
|
+
*
|
|
51
|
+
* 定位字段(path/file/glob/pattern/cwd)与 command 头部是「这条调用碰了哪里」的唯一锚点,
|
|
52
|
+
* 恒定保留;预算过小只会让内容值更快退化,不会丢锚点。
|
|
53
|
+
*/
|
|
54
|
+
maxAgedArgChars?: number;
|
|
55
|
+
}
|
|
56
|
+
/** 老化配置(已解析、全字段非空) */
|
|
57
|
+
export interface ToolResultAgingOptions {
|
|
58
|
+
enabled: boolean;
|
|
59
|
+
rawWindow: number;
|
|
60
|
+
freezeBatch: number;
|
|
61
|
+
maxPointerChars: number;
|
|
62
|
+
ageToolArgs: boolean;
|
|
63
|
+
maxAgedArgChars: number;
|
|
64
|
+
}
|
|
65
|
+
/** 老化计划:一次装配内的降级判定(基于完整历史的纯函数结果,跨轮稳定) */
|
|
66
|
+
export interface ToolResultAgingPlan {
|
|
67
|
+
/** 要降级为指针的 toolCallId 集合 */
|
|
68
|
+
agedIds: ReadonlySet<string>;
|
|
69
|
+
/** toolCallId → 工具调用参数(指针的「参数要点」来源;取自完整历史,裁剪视图中的孤儿也有参数) */
|
|
70
|
+
argsById: ReadonlyMap<string, unknown>;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* 解析老化配置(缺省 = 拍板参数起点:40 条原文 / 批 20 / 指针 400 字符)
|
|
74
|
+
*
|
|
75
|
+
* @param input - 配置面输入(可空)
|
|
76
|
+
* @returns 全字段解析结果(非法值/0 步长回落缺省——0 或负步长等同禁用批量冻结)
|
|
77
|
+
*/
|
|
78
|
+
export declare function resolveToolResultAgingOptions(input?: ToolResultAgingConfig): ToolResultAgingOptions;
|
|
79
|
+
/**
|
|
80
|
+
* 计算老化计划:批量冻结边界 + 工具调用参数索引
|
|
81
|
+
*
|
|
82
|
+
* 边界语义:跨轮工具结果(位于最近一条真实 user 消息之前)中,最旧的
|
|
83
|
+
* `crossTurn - rawWindow` 条为候选;候选前 `freezeBatch` 整批部分「过冻结线」。
|
|
84
|
+
* 过线条目再过三道守卫才降级:error 永不降级;正文 ≤ 指针目标不降级;
|
|
85
|
+
* 实际指针不比原文短不降级(不膨胀)。历史只增不减时边界单调推进、
|
|
86
|
+
* 已降级条目永不回原文——满足 write-once(须以完整历史为输入,见模块头注)。
|
|
87
|
+
*
|
|
88
|
+
* @param messages - **完整**历史消息(按时间序;勿传裁剪后的装配视图)
|
|
89
|
+
* @param opts - 老化配置(已解析)
|
|
90
|
+
* @returns 老化计划(enabled=false 或无候选时 agedIds 为空)
|
|
91
|
+
*/
|
|
92
|
+
export declare function computeToolResultAgingPlan(messages: Message[], opts: ToolResultAgingOptions): ToolResultAgingPlan;
|
|
93
|
+
/**
|
|
94
|
+
* 把老化计划物化为消息视图副本(新建对象,不改原消息)
|
|
95
|
+
*
|
|
96
|
+
* 供「量实际请求」的估算路径使用(F1-B3:主动压缩触发线必须量老化后的视图,
|
|
97
|
+
* 否则 B2 稳态的 raw 估算会每 turn 误触发 compact = 双机制打架)。
|
|
98
|
+
* 压缩/摘要输入仍用原消息(摘要质量需要原文)。
|
|
99
|
+
*
|
|
100
|
+
* @param messages - 完整历史消息
|
|
101
|
+
* @param plan - 老化计划
|
|
102
|
+
* @param opts - 老化配置(已解析)
|
|
103
|
+
* @returns 消息副本(老化条目的正文替换为指针;无老化条目时原样返回同一数组)
|
|
104
|
+
*/
|
|
105
|
+
export declare function applyAgingToMessages(messages: Message[], plan: ToolResultAgingPlan, opts: ToolResultAgingOptions): Message[];
|
|
106
|
+
/**
|
|
107
|
+
* 生成结构化摘要指针(机械、零 LLM、确定性)
|
|
108
|
+
*
|
|
109
|
+
* 布局:工具名 + args 轮廓(截断)+ result 轮廓(截断)+ re-run 提示;
|
|
110
|
+
* 轮廓预算按 `maxPointerChars` 比例派生(旋钮真实生效)。
|
|
111
|
+
* error 分支为防御性保真(计划永不选中 error 结果)。
|
|
112
|
+
*
|
|
113
|
+
* @param tr - 工具结果(error / result 至少其一)
|
|
114
|
+
* @param args - 对应工具调用参数(可空)
|
|
115
|
+
* @param opts - 老化配置(已解析)
|
|
116
|
+
* @returns 指针文本(write-once:同输入恒同字节)
|
|
117
|
+
*/
|
|
118
|
+
export declare function agedToolResultPointer(tr: {
|
|
119
|
+
toolCallId: string;
|
|
120
|
+
name?: string;
|
|
121
|
+
error?: string;
|
|
122
|
+
result?: unknown;
|
|
123
|
+
}, args: unknown, opts: ToolResultAgingOptions): string;
|
|
124
|
+
/**
|
|
125
|
+
* 参数摘要:把「结果已被老化」的工具调用参数降级为键值摘要
|
|
126
|
+
*
|
|
127
|
+
* 规则(机械、确定性、无 LLM):
|
|
128
|
+
* 1. **键名全保**——LLM 需要知道调用了哪个路径/命令才能在必要时重跑;
|
|
129
|
+
* 2. 序列化长度超过 {@link ARG_VALUE_KEEP_CHARS} 的值替换为长度标记 `…[N chars]`;
|
|
130
|
+
* 3. 若仍是超预算,按「值从大到小、同大小按键名」顺序继续替换,保证确定性;
|
|
131
|
+
* 4. 兜底:键名太多装不下时退化为整体轮廓截断。
|
|
132
|
+
*
|
|
133
|
+
* 返回值仍是合法 JSON 值,调用方照常 `JSON.stringify`,因此 tool_call 结构不变。
|
|
134
|
+
*
|
|
135
|
+
* @param name - 工具名(兜底分支用于说明来源)
|
|
136
|
+
* @param args - 原始调用参数(任意 JSON 值)
|
|
137
|
+
* @param opts - 老化配置(已解析)
|
|
138
|
+
* @returns 摘要值(`ageToolArgs=false` 时原样返回)
|
|
139
|
+
*/
|
|
140
|
+
export declare function agedToolArgDigest(name: string, args: unknown, opts: ToolResultAgingOptions): unknown;
|