@octopi-agent/engine 0.65.0 → 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 +285 -9
- package/dist/config-schema/engine.js +35 -3
- 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 +87 -1
- package/dist/config-schema/substrate.js +114 -0
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +249 -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 +48 -4
- package/dist/harness/agent/builder.js +206 -55
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +83 -280
- 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/gate.js +2 -2
- package/dist/harness/context/capabilities/summary/policies.js +5 -5
- package/dist/harness/context/capabilities/summary/registry.js +39 -24
- 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-health.js +3 -2
- 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 +32 -15
- package/dist/harness/context/layers.js +87 -71
- 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 +33 -0
- package/dist/harness/context/system-prompt-assembler.js +78 -7
- 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 +4 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +1 -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 +278 -82
- 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.d.ts +11 -1
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -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 +18 -15
- package/dist/harness/index.js +11 -7
- 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 +8 -8
- package/dist/harness/knowledge/retriever.js +1 -1
- package/dist/harness/knowledge/source-store.d.ts +17 -2
- package/dist/harness/knowledge/source-store.js +6 -5
- 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/cognition-decay.d.ts +36 -0
- package/dist/harness/memory/cognition-decay.js +55 -0
- package/dist/harness/memory/cognition-gates.d.ts +60 -0
- package/dist/harness/memory/cognition-gates.js +191 -0
- package/dist/harness/memory/cognition-trigger.d.ts +30 -0
- package/dist/harness/memory/cognition-trigger.js +41 -0
- package/dist/harness/memory/cognition-types.d.ts +1 -1
- package/dist/harness/memory/cognition.d.ts +40 -8
- package/dist/harness/memory/cognition.js +432 -79
- package/dist/harness/memory/conceptualizer.d.ts +66 -0
- package/dist/harness/memory/conceptualizer.js +246 -0
- package/dist/harness/memory/index.d.ts +17 -2
- package/dist/harness/memory/index.js +12 -1
- package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
- package/dist/harness/memory/sqlite/agent-db.js +120 -15
- package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
- package/dist/harness/memory/sqlite/cognition-store.js +591 -144
- 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.d.ts +33 -14
- package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
- 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 +343 -16
- package/dist/harness/memory/types.js +49 -0
- package/dist/harness/memory/wisdom-formation.d.ts +101 -0
- package/dist/harness/memory/wisdom-formation.js +304 -0
- package/dist/harness/memory/wisdom-gates.d.ts +50 -0
- package/dist/harness/memory/wisdom-gates.js +204 -0
- package/dist/harness/memory/wisdom-policy.d.ts +107 -0
- package/dist/harness/memory/wisdom-policy.js +220 -0
- package/dist/harness/memory/wisdom-types.d.ts +3 -2
- package/dist/harness/memory/wisdom-types.js +2 -2
- package/dist/harness/memory/wisdom.d.ts +27 -0
- package/dist/harness/memory/wisdom.js +181 -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 +27 -0
- package/dist/harness/run/agent/agent.js +45 -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 +116 -20
- 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 +557 -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/index.d.ts +1 -0
- package/dist/harness/session/index.js +1 -0
- package/dist/harness/session/schedules/index.d.ts +10 -0
- package/dist/harness/session/schedules/index.js +10 -0
- package/dist/harness/session/schedules/render.d.ts +13 -0
- package/dist/harness/session/schedules/render.js +63 -0
- package/dist/harness/session/schedules/service.d.ts +179 -0
- package/dist/harness/session/schedules/service.js +695 -0
- package/dist/harness/session/schedules/store.d.ts +119 -0
- package/dist/harness/session/schedules/store.js +323 -0
- package/dist/harness/session/schedules/tools.d.ts +39 -0
- package/dist/harness/session/schedules/tools.js +442 -0
- package/dist/harness/session/schedules/types.d.ts +104 -0
- package/dist/harness/session/schedules/types.js +97 -0
- package/dist/harness/session/tasks/tools.js +22 -0
- package/dist/harness/session/title.d.ts +86 -0
- package/dist/harness/session/title.js +268 -0
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
- package/dist/harness/shared/events/agent-event-map.js +1 -0
- package/dist/harness/shared/types/agent-definition.d.ts +23 -0
- package/dist/index.d.ts +25 -9
- package/dist/index.js +11 -2
- package/dist/integration/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 -0
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
- package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
- package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
- package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
- package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
- package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
- package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
- package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
- package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
- package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
- package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
- 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
|
@@ -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;
|
|
@@ -0,0 +1,331 @@
|
|
|
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 { isEngineCarrierSource } from './layer-types.js';
|
|
26
|
+
import { toolResultBody } from './tool-result-body.js';
|
|
27
|
+
/** args / result 轮廓占 maxPointerChars 的比例(合计 ~0.65,加固定骨架 ≈ 目标) */
|
|
28
|
+
const ARGS_OUTLINE_RATIO = 0.2;
|
|
29
|
+
const RESULT_OUTLINE_RATIO = 0.45;
|
|
30
|
+
/** 轮廓下限(小旋钮下仍可读) */
|
|
31
|
+
const MIN_ARGS_OUTLINE_CHARS = 24;
|
|
32
|
+
const MIN_RESULT_OUTLINE_CHARS = 48;
|
|
33
|
+
/**
|
|
34
|
+
* 参数摘要中「原样保留」的单个值上限
|
|
35
|
+
*
|
|
36
|
+
* 只用来区分「标识性短值」(路径、命令、行号)与「载荷长值」(文件内容、diff 正文)。
|
|
37
|
+
* 64 足以容纳常见路径,又远小于任何文件内容。
|
|
38
|
+
*/
|
|
39
|
+
const ARG_VALUE_KEEP_CHARS = 64;
|
|
40
|
+
const TRUNCATION_MARK = '…[truncated]';
|
|
41
|
+
/**
|
|
42
|
+
* 解析老化配置(缺省 = 拍板参数起点:40 条原文 / 批 20 / 指针 400 字符)
|
|
43
|
+
*
|
|
44
|
+
* @param input - 配置面输入(可空)
|
|
45
|
+
* @returns 全字段解析结果(非法值/0 步长回落缺省——0 或负步长等同禁用批量冻结)
|
|
46
|
+
*/
|
|
47
|
+
export function resolveToolResultAgingOptions(input) {
|
|
48
|
+
const rawWindow = Number.isInteger(input?.rawWindow) && (input?.rawWindow ?? -1) >= 0 ? input.rawWindow : 40;
|
|
49
|
+
const freezeBatch = Number.isInteger(input?.freezeBatch) && (input?.freezeBatch ?? -1) >= 1 ? input.freezeBatch : 40;
|
|
50
|
+
const maxPointerChars = Number.isInteger(input?.maxPointerChars) && (input?.maxPointerChars ?? -1) > 0 ? input.maxPointerChars : 400;
|
|
51
|
+
const maxAgedArgChars = Number.isInteger(input?.maxAgedArgChars) && (input?.maxAgedArgChars ?? -1) > 0
|
|
52
|
+
? input.maxAgedArgChars
|
|
53
|
+
: 320;
|
|
54
|
+
return {
|
|
55
|
+
enabled: input?.enabled ?? true,
|
|
56
|
+
rawWindow,
|
|
57
|
+
freezeBatch,
|
|
58
|
+
maxPointerChars,
|
|
59
|
+
ageToolArgs: input?.ageToolArgs ?? true,
|
|
60
|
+
maxAgedArgChars,
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* 计算老化计划:批量冻结边界 + 工具调用参数索引
|
|
65
|
+
*
|
|
66
|
+
* 边界语义:跨轮工具结果(位于最近一条真实 user 消息之前)中,最旧的
|
|
67
|
+
* `crossTurn - rawWindow` 条为候选;候选前 `freezeBatch` 整批部分「过冻结线」。
|
|
68
|
+
* 过线条目再过三道守卫才降级:error 永不降级;正文 ≤ 指针目标不降级;
|
|
69
|
+
* 实际指针不比原文短不降级(不膨胀)。历史只增不减时边界单调推进、
|
|
70
|
+
* 已降级条目永不回原文——满足 write-once(须以完整历史为输入,见模块头注)。
|
|
71
|
+
*
|
|
72
|
+
* @param messages - **完整**历史消息(按时间序;勿传裁剪后的装配视图)
|
|
73
|
+
* @param opts - 老化配置(已解析)
|
|
74
|
+
* @returns 老化计划(enabled=false 或无候选时 agedIds 为空)
|
|
75
|
+
*/
|
|
76
|
+
export function computeToolResultAgingPlan(messages, opts) {
|
|
77
|
+
const argsById = new Map();
|
|
78
|
+
const ordered = [];
|
|
79
|
+
let lastGenuineUserIdx = -1;
|
|
80
|
+
for (let i = 0; i < messages.length; i++) {
|
|
81
|
+
const msg = messages[i];
|
|
82
|
+
if (msg.role === 'user' && !isEngineCarrierSource(msg.metadata?.source)) {
|
|
83
|
+
lastGenuineUserIdx = i;
|
|
84
|
+
}
|
|
85
|
+
for (const tc of msg.toolCalls ?? []) {
|
|
86
|
+
argsById.set(tc.id, tc.arguments);
|
|
87
|
+
}
|
|
88
|
+
for (const tr of msg.toolResults ?? []) {
|
|
89
|
+
ordered.push({
|
|
90
|
+
toolCallId: tr.toolCallId,
|
|
91
|
+
msgIndex: i,
|
|
92
|
+
bodyLength: toolResultBody(tr).length,
|
|
93
|
+
isError: tr.error !== undefined,
|
|
94
|
+
tr,
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
const agedIds = new Set();
|
|
99
|
+
if (!opts.enabled)
|
|
100
|
+
return { agedIds, argsById };
|
|
101
|
+
// 边界 = 完整历史最后一个真实 user(两遍判定:旧轮结果在遇到后续 user 前不可下结论)
|
|
102
|
+
const crossTurn = ordered.filter((e) => e.msgIndex < lastGenuineUserIdx);
|
|
103
|
+
const candidates = crossTurn.slice(0, Math.max(0, crossTurn.length - opts.rawWindow));
|
|
104
|
+
const covered = candidates.length - (candidates.length % opts.freezeBatch);
|
|
105
|
+
for (let i = 0; i < covered; i++) {
|
|
106
|
+
const cand = candidates[i];
|
|
107
|
+
if (cand.isError)
|
|
108
|
+
continue; // 红线:error 结果永不降级(错误可追溯性优先)
|
|
109
|
+
if (cand.bodyLength <= opts.maxPointerChars)
|
|
110
|
+
continue; // 预筛:小于指针目标不值得
|
|
111
|
+
const pointer = agedToolResultPointer(cand.tr, argsById.get(cand.toolCallId), opts);
|
|
112
|
+
if (pointer.length < cand.bodyLength) {
|
|
113
|
+
agedIds.add(cand.toolCallId);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
return { agedIds, argsById };
|
|
117
|
+
}
|
|
118
|
+
// 指针 write-once 缓存:同 `tr` 对象 + 同配置指纹 → 同字节(toolResultBody 同款 WeakMap 先例;
|
|
119
|
+
// 消息内容写入后不可变,对象身份稳定;即便对象重建,纯函数定形也保证字节一致)。
|
|
120
|
+
const pointerCache = new WeakMap();
|
|
121
|
+
/**
|
|
122
|
+
* 把老化计划物化为消息视图副本(新建对象,不改原消息)
|
|
123
|
+
*
|
|
124
|
+
* 供「量实际请求」的估算路径使用(F1-B3:主动压缩触发线必须量老化后的视图,
|
|
125
|
+
* 否则 B2 稳态的 raw 估算会每 turn 误触发 compact = 双机制打架)。
|
|
126
|
+
* 压缩/摘要输入仍用原消息(摘要质量需要原文)。
|
|
127
|
+
*
|
|
128
|
+
* @param messages - 完整历史消息
|
|
129
|
+
* @param plan - 老化计划
|
|
130
|
+
* @param opts - 老化配置(已解析)
|
|
131
|
+
* @returns 消息副本(老化条目的正文替换为指针;无老化条目时原样返回同一数组)
|
|
132
|
+
*/
|
|
133
|
+
export function applyAgingToMessages(messages, plan, opts) {
|
|
134
|
+
if (plan.agedIds.size === 0)
|
|
135
|
+
return messages;
|
|
136
|
+
return messages.map((msg) => {
|
|
137
|
+
let next = msg;
|
|
138
|
+
// 参数与结果同步老化:只动「结果已老化」的那条调用,配对结构不变
|
|
139
|
+
if (opts.ageToolArgs && msg.toolCalls?.length) {
|
|
140
|
+
let callsChanged = false;
|
|
141
|
+
const toolCalls = msg.toolCalls.map((tc) => {
|
|
142
|
+
if (!plan.agedIds.has(tc.id))
|
|
143
|
+
return tc;
|
|
144
|
+
callsChanged = true;
|
|
145
|
+
return { ...tc, arguments: agedToolArgDigest(tc.name, tc.arguments, opts) };
|
|
146
|
+
});
|
|
147
|
+
if (callsChanged)
|
|
148
|
+
next = { ...next, toolCalls };
|
|
149
|
+
}
|
|
150
|
+
if (!msg.toolResults?.length)
|
|
151
|
+
return next;
|
|
152
|
+
let changed = false;
|
|
153
|
+
const results = msg.toolResults.map((tr) => {
|
|
154
|
+
if (!plan.agedIds.has(tr.toolCallId))
|
|
155
|
+
return tr;
|
|
156
|
+
changed = true;
|
|
157
|
+
return {
|
|
158
|
+
...tr,
|
|
159
|
+
result: agedToolResultPointer(tr, plan.argsById.get(tr.toolCallId), opts),
|
|
160
|
+
};
|
|
161
|
+
});
|
|
162
|
+
return changed ? { ...next, toolResults: results } : next;
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* 生成结构化摘要指针(机械、零 LLM、确定性)
|
|
167
|
+
*
|
|
168
|
+
* 布局:工具名 + args 轮廓(截断)+ result 轮廓(截断)+ re-run 提示;
|
|
169
|
+
* 轮廓预算按 `maxPointerChars` 比例派生(旋钮真实生效)。
|
|
170
|
+
* error 分支为防御性保真(计划永不选中 error 结果)。
|
|
171
|
+
*
|
|
172
|
+
* @param tr - 工具结果(error / result 至少其一)
|
|
173
|
+
* @param args - 对应工具调用参数(可空)
|
|
174
|
+
* @param opts - 老化配置(已解析)
|
|
175
|
+
* @returns 指针文本(write-once:同输入恒同字节)
|
|
176
|
+
*/
|
|
177
|
+
export function agedToolResultPointer(tr, args, opts) {
|
|
178
|
+
const fingerprint = `${opts.maxPointerChars}|${args === undefined ? '' : JSON.stringify(args)}|${tr.error !== undefined ? 'e' : 'r'}`;
|
|
179
|
+
const cached = pointerCache.get(tr);
|
|
180
|
+
if (cached && cached.fingerprint === fingerprint)
|
|
181
|
+
return cached.text;
|
|
182
|
+
const argsBudget = Math.max(MIN_ARGS_OUTLINE_CHARS, Math.floor(opts.maxPointerChars * ARGS_OUTLINE_RATIO));
|
|
183
|
+
const resultBudget = Math.max(MIN_RESULT_OUTLINE_CHARS, Math.floor(opts.maxPointerChars * RESULT_OUTLINE_RATIO));
|
|
184
|
+
const argsOutline = truncateOutline(safeJson(args ?? {}), argsBudget);
|
|
185
|
+
// 结果轮廓只保留头部,若不给总量,读方会把「头部那几条」误当成全部(file_search 尤甚)
|
|
186
|
+
const resultBody = toolResultOutline(tr);
|
|
187
|
+
const errorOrResult = tr.error !== undefined
|
|
188
|
+
? `error: ${tr.error}` // 防御性保真:错误文案不截断、不改写
|
|
189
|
+
: `result ${resultBody.length} chars: ${truncateOutline(resultBody, resultBudget)}`;
|
|
190
|
+
const text = `[aged tool result · pointer] tool: ${tr.name ?? 'unknown'}; ` +
|
|
191
|
+
`args: ${argsOutline}; ${errorOrResult}; ` +
|
|
192
|
+
'full output kept in session log — do NOT re-run unless the output is needed again';
|
|
193
|
+
pointerCache.set(tr, { fingerprint, text });
|
|
194
|
+
return text;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* 参数摘要:把「结果已被老化」的工具调用参数降级为键值摘要
|
|
198
|
+
*
|
|
199
|
+
* 规则(机械、确定性、无 LLM):
|
|
200
|
+
* 1. **键名全保**——LLM 需要知道调用了哪个路径/命令才能在必要时重跑;
|
|
201
|
+
* 2. 序列化长度超过 {@link ARG_VALUE_KEEP_CHARS} 的值替换为长度标记 `…[N chars]`;
|
|
202
|
+
* 3. 若仍是超预算,按「值从大到小、同大小按键名」顺序继续替换,保证确定性;
|
|
203
|
+
* 4. 兜底:键名太多装不下时退化为整体轮廓截断。
|
|
204
|
+
*
|
|
205
|
+
* 返回值仍是合法 JSON 值,调用方照常 `JSON.stringify`,因此 tool_call 结构不变。
|
|
206
|
+
*
|
|
207
|
+
* @param name - 工具名(兜底分支用于说明来源)
|
|
208
|
+
* @param args - 原始调用参数(任意 JSON 值)
|
|
209
|
+
* @param opts - 老化配置(已解析)
|
|
210
|
+
* @returns 摘要值(`ageToolArgs=false` 时原样返回)
|
|
211
|
+
*/
|
|
212
|
+
export function agedToolArgDigest(name, args, opts) {
|
|
213
|
+
if (!opts.ageToolArgs || args == null)
|
|
214
|
+
return args;
|
|
215
|
+
if (typeof args !== 'object' || Array.isArray(args)) {
|
|
216
|
+
return { _aged: `${name} arguments elided`, outline: truncateOutline(safeJson(args), opts.maxAgedArgChars) };
|
|
217
|
+
}
|
|
218
|
+
const cached = argDigestCache.get(args);
|
|
219
|
+
const fingerprint = `${opts.maxAgedArgChars}`;
|
|
220
|
+
if (cached && cached.fingerprint === fingerprint)
|
|
221
|
+
return cached.value;
|
|
222
|
+
const entries = Object.entries(args).map(([k, v]) => ({
|
|
223
|
+
k,
|
|
224
|
+
v,
|
|
225
|
+
size: safeJson(v).length,
|
|
226
|
+
}));
|
|
227
|
+
const out = {};
|
|
228
|
+
for (const e of entries) {
|
|
229
|
+
out[e.k] = digestArgValue(e.k, e.v, e.size);
|
|
230
|
+
}
|
|
231
|
+
// 预算只约束「内容值」,定位字段不计入:
|
|
232
|
+
// 否则一条绝对路径就能吃掉整个预算,反而先把唯一锚点挤掉(实测 path 均长 79,
|
|
233
|
+
// 若计入预算,file_edit 这类调用会退化成「看不到改了哪个文件」)。
|
|
234
|
+
const contentChars = () => safeJson(Object.fromEntries(Object.entries(out).filter(([k]) => !ANCHOR_FIELDS.has(k)))).length;
|
|
235
|
+
const contentEntries = entries
|
|
236
|
+
.filter((e) => !ANCHOR_FIELDS.has(e.k))
|
|
237
|
+
.sort((a, b) => b.size - a.size || (a.k < b.k ? -1 : a.k > b.k ? 1 : 0));
|
|
238
|
+
for (const e of contentEntries) {
|
|
239
|
+
if (contentChars() <= opts.maxAgedArgChars)
|
|
240
|
+
break;
|
|
241
|
+
out[e.k] = elidedMarker(e.size);
|
|
242
|
+
}
|
|
243
|
+
const value = contentChars() > opts.maxAgedArgChars
|
|
244
|
+
? { _aged: `${name} arguments elided`, outline: truncateOutline(safeJson(args), opts.maxAgedArgChars) }
|
|
245
|
+
: out;
|
|
246
|
+
argDigestCache.set(args, { fingerprint, value });
|
|
247
|
+
return value;
|
|
248
|
+
}
|
|
249
|
+
/** 值被省略时的长度标记 */
|
|
250
|
+
function elidedMarker(chars) {
|
|
251
|
+
return `…[${chars} chars]`;
|
|
252
|
+
}
|
|
253
|
+
/**
|
|
254
|
+
* 定位字段:它们短、且是「这条调用到底碰了哪里」的唯一锚点,优先全保
|
|
255
|
+
*
|
|
256
|
+
* 实测:`path` 均长 79 字符(全保仅 +1.5% 请求体),而 `command` 均长 414
|
|
257
|
+
* (全保 +8.6%)。因此路径类全保、命令类只留头部。
|
|
258
|
+
*/
|
|
259
|
+
const LOCATOR_FIELDS = new Set(['path', 'file', 'glob', 'pattern', 'cwd']);
|
|
260
|
+
/**
|
|
261
|
+
* 锚点字段:不占用内容预算(否则定位信息会被内容载荷挤出)
|
|
262
|
+
*
|
|
263
|
+
* 定位字段与命令字段都属锚点——`command` 头部回答「跑了什么」,
|
|
264
|
+
* 若让它和 `old_text` 之类抢同一个预算,多条命令一累加就会把头部整体省略掉。
|
|
265
|
+
*/
|
|
266
|
+
const ANCHOR_FIELDS = new Set([...LOCATOR_FIELDS, 'command', 'cmd']);
|
|
267
|
+
/** 定位字段全保上限(超长的罕见路径才会退化为标记) */
|
|
268
|
+
const LOCATOR_KEEP_CHARS = 200;
|
|
269
|
+
/** 命令类字段保留的头部长度(其余用长度标记收尾) */
|
|
270
|
+
const COMMAND_HEAD_CHARS = 100;
|
|
271
|
+
/** 命令类字段名 */
|
|
272
|
+
const COMMAND_FIELDS = new Set(['command', 'cmd']);
|
|
273
|
+
function isLocatorField(key) {
|
|
274
|
+
return LOCATOR_FIELDS.has(key);
|
|
275
|
+
}
|
|
276
|
+
/**
|
|
277
|
+
* 单个参数值的降级策略(确定性、与顺序无关)
|
|
278
|
+
*
|
|
279
|
+
* @param key - 字段名
|
|
280
|
+
* @param value - 字段值
|
|
281
|
+
* @param size - 值的 JSON 序列化长度
|
|
282
|
+
* @returns 保留原值、头部摘录或长度标记
|
|
283
|
+
*/
|
|
284
|
+
function digestArgValue(key, value, size) {
|
|
285
|
+
if (size <= ARG_VALUE_KEEP_CHARS)
|
|
286
|
+
return value;
|
|
287
|
+
if (isLocatorField(key) && size <= LOCATOR_KEEP_CHARS)
|
|
288
|
+
return value;
|
|
289
|
+
if (COMMAND_FIELDS.has(key) && typeof value === 'string') {
|
|
290
|
+
// 短命令原样保留;长命令保留头部(头部才是「跑了什么」的判据)
|
|
291
|
+
if (value.length <= COMMAND_HEAD_CHARS)
|
|
292
|
+
return value;
|
|
293
|
+
return `${value.slice(0, COMMAND_HEAD_CHARS)}…[+${value.length - COMMAND_HEAD_CHARS} chars]`;
|
|
294
|
+
}
|
|
295
|
+
return elidedMarker(size);
|
|
296
|
+
}
|
|
297
|
+
// 参数摘要 write-once 缓存:同 args 对象 + 同配置 → 同值(与 pointerCache 同理)
|
|
298
|
+
const argDigestCache = new WeakMap();
|
|
299
|
+
/**
|
|
300
|
+
* 结果轮廓:结果正文序列化的头部(机械截断,非摘要改写)
|
|
301
|
+
*
|
|
302
|
+
* @param tr - 工具结果
|
|
303
|
+
* @returns 序列化正文(string result 原文;否则 JSON)
|
|
304
|
+
*/
|
|
305
|
+
function toolResultOutline(tr) {
|
|
306
|
+
return typeof tr.result === 'string' ? tr.result : safeJson(tr.result ?? null);
|
|
307
|
+
}
|
|
308
|
+
/**
|
|
309
|
+
* JSON 序列化(异常时降级为 String(),不抛错)
|
|
310
|
+
*
|
|
311
|
+
* @param value - 任意值
|
|
312
|
+
* @returns JSON 字符串
|
|
313
|
+
*/
|
|
314
|
+
function safeJson(value) {
|
|
315
|
+
try {
|
|
316
|
+
return JSON.stringify(value) ?? String(value);
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
return String(value);
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
/**
|
|
323
|
+
* 机械截断轮廓(超长加显式标记;机械截断 ≠ 摘要改写)
|
|
324
|
+
*
|
|
325
|
+
* @param text - 原文
|
|
326
|
+
* @param maxChars - 轮廓字符上限
|
|
327
|
+
* @returns 轮廓文本
|
|
328
|
+
*/
|
|
329
|
+
function truncateOutline(text, maxChars) {
|
|
330
|
+
return text.length <= maxChars ? text : `${text.slice(0, maxChars)}${TRUNCATION_MARK}`;
|
|
331
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* toolResultBody — 工具结果正文序列化(带缓存)
|
|
3
|
+
*
|
|
4
|
+
* 消息内容写入后不可变(全库无对已存在消息 content/toolResults/toolCalls 的
|
|
5
|
+
* 原地修改;压缩器一律新建对象),同一 `tr` 对象可安全复用序列化结果。
|
|
6
|
+
* 这消除每轮 context 装配里对同一批 toolResults 反复 `JSON.stringify` 的开销。
|
|
7
|
+
*/
|
|
8
|
+
const cache = new WeakMap();
|
|
9
|
+
/**
|
|
10
|
+
* 序列化工具结果正文:error → `{"error":...}`;string result 原文;否则 JSON。
|
|
11
|
+
*
|
|
12
|
+
* @param tr - 工具结果(error / result 至少其一)
|
|
13
|
+
* @returns 正文字符串
|
|
14
|
+
*/
|
|
15
|
+
export function toolResultBody(tr) {
|
|
16
|
+
const key = tr;
|
|
17
|
+
const hit = cache.get(key);
|
|
18
|
+
if (hit !== undefined)
|
|
19
|
+
return hit;
|
|
20
|
+
const body = tr.error !== undefined
|
|
21
|
+
? JSON.stringify({ error: tr.error })
|
|
22
|
+
: typeof tr.result === 'string'
|
|
23
|
+
? tr.result
|
|
24
|
+
: JSON.stringify(tr.result ?? null);
|
|
25
|
+
cache.set(key, body);
|
|
26
|
+
return body;
|
|
27
|
+
}
|