@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
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* 2. LLM 摘要(如果可用)
|
|
7
7
|
* 3. 截断(兜底)
|
|
8
8
|
*
|
|
9
|
-
*
|
|
9
|
+
* 智能路由 + 四阶段压缩算法。
|
|
10
10
|
*/
|
|
11
11
|
import type { Compressor, CompressParams, CompressResult } from './types.js';
|
|
12
12
|
export declare class HybridCompressor implements Compressor {
|
|
@@ -17,8 +17,8 @@ export declare class HybridCompressor implements Compressor {
|
|
|
17
17
|
* 压缩消息
|
|
18
18
|
*
|
|
19
19
|
* 策略:
|
|
20
|
-
* 1.
|
|
21
|
-
* 2.
|
|
20
|
+
* 1. 机械预处理(截断旧工具结果)——只作用于**丢弃体/机械路径**,不进 LLM 摘要输入
|
|
21
|
+
* 2. 如果有摘要函数,对**原文**做 LLM 摘要(F-b:禁止先打码再摘要)
|
|
22
22
|
* 3. 否则使用截断
|
|
23
23
|
*/
|
|
24
24
|
compress(params: CompressParams): Promise<CompressResult>;
|
|
@@ -6,19 +6,20 @@
|
|
|
6
6
|
* 2. LLM 摘要(如果可用)
|
|
7
7
|
* 3. 截断(兜底)
|
|
8
8
|
*
|
|
9
|
-
*
|
|
9
|
+
* 智能路由 + 四阶段压缩算法。
|
|
10
10
|
*/
|
|
11
11
|
import { HeuristicTokenEstimator } from './token-estimator.js';
|
|
12
12
|
import { LLMSummaryCompressor } from './llm-summarizer.js';
|
|
13
|
+
import { toolResultBody } from './tool-result-body.js';
|
|
13
14
|
import { TruncateCompressor } from './truncate-compressor.js';
|
|
14
15
|
/**
|
|
15
16
|
* 工具结果截断阈值(字符数)
|
|
16
17
|
*/
|
|
17
18
|
const TOOL_RESULT_TRUNCATE_THRESHOLD = 200;
|
|
18
19
|
/**
|
|
19
|
-
*
|
|
20
|
+
* 工具结果截断后的占位符(中性归档措辞——禁止诱导重跑)
|
|
20
21
|
*/
|
|
21
|
-
const TOOL_RESULT_PLACEHOLDER = '[Tool output
|
|
22
|
+
const TOOL_RESULT_PLACEHOLDER = '[Tool output archived in session log — do NOT re-run unless the output is needed again.]';
|
|
22
23
|
export class HybridCompressor {
|
|
23
24
|
llmCompressor;
|
|
24
25
|
truncateCompressor;
|
|
@@ -30,8 +31,8 @@ export class HybridCompressor {
|
|
|
30
31
|
* 压缩消息
|
|
31
32
|
*
|
|
32
33
|
* 策略:
|
|
33
|
-
* 1.
|
|
34
|
-
* 2.
|
|
34
|
+
* 1. 机械预处理(截断旧工具结果)——只作用于**丢弃体/机械路径**,不进 LLM 摘要输入
|
|
35
|
+
* 2. 如果有摘要函数,对**原文**做 LLM 摘要(F-b:禁止先打码再摘要)
|
|
35
36
|
* 3. 否则使用截断
|
|
36
37
|
*/
|
|
37
38
|
async compress(params) {
|
|
@@ -46,30 +47,31 @@ export class HybridCompressor {
|
|
|
46
47
|
}
|
|
47
48
|
// 计算当前 token 数
|
|
48
49
|
const currentTokens = estimator.estimateMessages(messages);
|
|
49
|
-
//
|
|
50
|
-
|
|
50
|
+
// 如果已经在预算内,不需要压缩。
|
|
51
|
+
// requireSummary 除外:主动摘要路径的主交付是语义摘要,达标也必须继续到摘要级。
|
|
52
|
+
if (currentTokens <= targetTokens && !params.requireSummary) {
|
|
51
53
|
return {
|
|
52
54
|
result: [...messages],
|
|
53
55
|
estimatedTokens: currentTokens,
|
|
54
56
|
};
|
|
55
57
|
}
|
|
56
|
-
//
|
|
58
|
+
// 机械预处理:仅给机械截断/残差用(F-b:不进摘要输入)
|
|
57
59
|
const preprocessed = this.preprocessToolResults(messages);
|
|
58
60
|
const preprocessedTokens = estimator.estimateMessages(preprocessed);
|
|
59
|
-
//
|
|
60
|
-
if (preprocessedTokens <= targetTokens) {
|
|
61
|
+
// 如果预处理后已在预算内(requireSummary 时同样继续:机械截断不产出语义摘要)
|
|
62
|
+
if (preprocessedTokens <= targetTokens && !params.requireSummary) {
|
|
61
63
|
return {
|
|
62
64
|
result: preprocessed,
|
|
63
65
|
estimatedTokens: preprocessedTokens,
|
|
64
66
|
droppedSummary: 'Old tool outputs truncated',
|
|
65
67
|
};
|
|
66
68
|
}
|
|
67
|
-
// 第二级:LLM
|
|
69
|
+
// 第二级:LLM 摘要 —— 输入为原文(F-b)
|
|
68
70
|
if (params.summarize) {
|
|
69
71
|
try {
|
|
70
72
|
const result = await this.llmCompressor.compress({
|
|
71
73
|
...params,
|
|
72
|
-
messages
|
|
74
|
+
messages,
|
|
73
75
|
});
|
|
74
76
|
return result;
|
|
75
77
|
}
|
|
@@ -78,7 +80,7 @@ export class HybridCompressor {
|
|
|
78
80
|
console.warn('LLM summarization failed, falling back to truncation:', err);
|
|
79
81
|
}
|
|
80
82
|
}
|
|
81
|
-
//
|
|
83
|
+
// 第三级:截断(兜底)——机械预处理后的丢弃体
|
|
82
84
|
return this.truncateCompressor.compress({
|
|
83
85
|
...params,
|
|
84
86
|
messages: preprocessed,
|
|
@@ -113,18 +115,11 @@ export class HybridCompressor {
|
|
|
113
115
|
}
|
|
114
116
|
// 旧的工具结果:截断冗长的输出
|
|
115
117
|
const truncatedResults = msg.toolResults.map(tr => {
|
|
116
|
-
const body = tr
|
|
117
|
-
? JSON.stringify({ error: tr.error })
|
|
118
|
-
: typeof tr.result === 'string'
|
|
119
|
-
? tr.result
|
|
120
|
-
: JSON.stringify(tr.result ?? null);
|
|
118
|
+
const body = toolResultBody(tr);
|
|
121
119
|
if (body.length > TOOL_RESULT_TRUNCATE_THRESHOLD) {
|
|
122
|
-
//
|
|
120
|
+
// error 永不打码(错误可追溯性优先,与 B2 同红线);只截断成功结果
|
|
123
121
|
if (tr.error !== undefined) {
|
|
124
|
-
return
|
|
125
|
-
...tr,
|
|
126
|
-
error: TOOL_RESULT_PLACEHOLDER,
|
|
127
|
-
};
|
|
122
|
+
return tr;
|
|
128
123
|
}
|
|
129
124
|
return {
|
|
130
125
|
...tr,
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Harness Context 模块导出
|
|
3
3
|
*/
|
|
4
|
-
export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams,
|
|
4
|
+
export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, CompactResult, AfterTurnParams, TokenEstimator, SummarizeFunction, MessageSelector, SelectResult, SelectOptions, Compressor, CompressParams, CompressResult, BudgetAllocator, BudgetAllocateParams, BudgetAllocateResult, ContextCompactReason, ContextCompactEvent, ContextEmitFn, ContextCompactSnapshot, } from './types.js';
|
|
5
5
|
export { DefaultContextEngine } from './default-context-engine.js';
|
|
6
6
|
export type { DefaultContextEngineConfig } from './default-context-engine.js';
|
|
7
|
+
export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
|
|
8
|
+
export type { TurnEnvelopeSlot, TurnEnvelopeParts } from './turn-envelope.js';
|
|
7
9
|
export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
|
|
8
10
|
export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
|
|
9
11
|
export { LAYER_ORDER, LAYER_PRIORITY, LAYER_DEFAULT_SHARE, extractLayerQuery, isThinLayerQuery, hasLayerText, } from './layer-types.js';
|
|
@@ -24,3 +26,5 @@ export { loadConstitution, productConstitutionPath } from './constitution/load-c
|
|
|
24
26
|
export type { ConstitutionConfig, ConstitutionMode, LoadedConstitution } from './constitution/load-constitution.js';
|
|
25
27
|
export type { SystemPromptAssembleInput, SystemPromptAssembleOutput, } from './system-prompt-assembler.js';
|
|
26
28
|
export { formatRuntimeDatetimeInjection, formatRuntimeWorkspaceInjection, withRuntimeDatetimeInjection, withRuntimeEnvironmentInjection, } from './runtime-datetime.js';
|
|
29
|
+
export { clearRootInstructionCache, formatRootInstructionsInjection, loadRootInstructionDocs, loadRootInstructionsInjection, } from './root-instructions.js';
|
|
30
|
+
export type { RootInstructionDoc } from './root-instructions.js';
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
* Harness Context 模块导出
|
|
3
3
|
*/
|
|
4
4
|
export { DefaultContextEngine } from './default-context-engine.js';
|
|
5
|
+
export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
|
|
5
6
|
// ── Token 估算(跨域门面;浏览器侧可直连 token-estimator / token-constants) ──
|
|
6
7
|
export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
|
|
7
8
|
export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
|
|
@@ -15,3 +16,4 @@ export { createProviderSummarize, pickSummarizeProvider } from './summarize.js';
|
|
|
15
16
|
export { createDefaultSystemPromptAssembler } from './system-prompt-assembler.js';
|
|
16
17
|
export { loadConstitution, productConstitutionPath } from './constitution/load-constitution.js';
|
|
17
18
|
export { formatRuntimeDatetimeInjection, formatRuntimeWorkspaceInjection, withRuntimeDatetimeInjection, withRuntimeEnvironmentInjection, } from './runtime-datetime.js';
|
|
19
|
+
export { clearRootInstructionCache, formatRootInstructionsInjection, loadRootInstructionDocs, loadRootInstructionsInjection, } from './root-instructions.js';
|
|
@@ -96,8 +96,9 @@ export async function probeContextLayerHealth(deps) {
|
|
|
96
96
|
let wisdomEntries;
|
|
97
97
|
if (deps.wisdomStore) {
|
|
98
98
|
try {
|
|
99
|
-
const
|
|
100
|
-
|
|
99
|
+
const stats = await deps.wisdomStore.stats();
|
|
100
|
+
// 未退役条目(含 trial/contested);不是注入命中数
|
|
101
|
+
wisdomEntries = stats.total - (stats.byStatus.retired ?? 0) - (stats.byStatus.superseded ?? 0);
|
|
101
102
|
summary.wisdom = wisdomEntries;
|
|
102
103
|
}
|
|
103
104
|
catch {
|
|
@@ -10,6 +10,8 @@ export declare const ALL_LAYER_IDS: readonly ContextLayerId[];
|
|
|
10
10
|
export type LayerUiStatus = 'idle' | 'included' | 'empty' | 'dropped' | 'error' | 'unregistered';
|
|
11
11
|
export interface LayerRuntimeView {
|
|
12
12
|
id: ContextLayerId;
|
|
13
|
+
/** E8 装配位置(system/snapshot);同 id 双实例时主行=system、附加行=snapshot */
|
|
14
|
+
placement?: 'system' | 'snapshot';
|
|
13
15
|
status: LayerUiStatus;
|
|
14
16
|
included: boolean;
|
|
15
17
|
tokens: number;
|
|
@@ -31,6 +33,8 @@ export interface ContextLayersSnapshot {
|
|
|
31
33
|
systemBudget: number;
|
|
32
34
|
structureReserve?: number;
|
|
33
35
|
usedTokens: number;
|
|
36
|
+
/** 易变快照组实际使用 token(E8;无 snapshot 层时缺省) */
|
|
37
|
+
usedSnapshotTokens?: number;
|
|
34
38
|
shares: Partial<Record<ContextLayerId, number>>;
|
|
35
39
|
query?: string;
|
|
36
40
|
/** 恒为契约层顺序,便于 UI 直接渲染 */
|
|
@@ -27,18 +27,41 @@ export const ALL_LAYER_IDS = [
|
|
|
27
27
|
*/
|
|
28
28
|
export function buildContextLayersSnapshot(params) {
|
|
29
29
|
const { manifest } = params;
|
|
30
|
-
|
|
30
|
+
// E8:同 id 可有 system/snapshot 双条目(如 runtime 双实例)——按 id#placement 分键;
|
|
31
|
+
// 主行(七层表)优先取 system 份,snapshot 份追加为附加行,观测面不丢内容
|
|
32
|
+
const entryByKey = new Map();
|
|
31
33
|
for (const entry of manifest.layers) {
|
|
32
|
-
|
|
34
|
+
const placement = entry.placement === 'snapshot' ? 'snapshot' : 'system';
|
|
35
|
+
entryByKey.set(`${entry.id}#${placement}`, entry);
|
|
33
36
|
}
|
|
37
|
+
const dualSnapshotExtras = manifest.layers.filter((e) => e.placement === 'snapshot' && entryByKey.has(`${e.id}#system`));
|
|
34
38
|
const enabled = params.enabledLayerIds ??
|
|
35
39
|
manifest.layers.map((l) => l.id);
|
|
36
40
|
const enabledSet = new Set(enabled);
|
|
41
|
+
const toView = (entry) => ({
|
|
42
|
+
id: entry.id,
|
|
43
|
+
placement: entry.placement === 'snapshot' ? 'snapshot' : 'system',
|
|
44
|
+
status: deriveLayerStatus(entry),
|
|
45
|
+
included: entry.included,
|
|
46
|
+
tokens: entry.tokens,
|
|
47
|
+
budgetTokens: entry.budgetTokens ?? 0,
|
|
48
|
+
priority: entry.priority,
|
|
49
|
+
order: entry.order,
|
|
50
|
+
droppable: entry.droppable ?? entry.id !== 'persona',
|
|
51
|
+
reason: entry.reason,
|
|
52
|
+
dropped: entry.dropped,
|
|
53
|
+
sources: entry.sources,
|
|
54
|
+
preview: entry.preview,
|
|
55
|
+
content: entry.content,
|
|
56
|
+
});
|
|
37
57
|
const layers = ALL_LAYER_IDS.map((id) => {
|
|
38
|
-
const entry =
|
|
58
|
+
const entry = entryByKey.get(`${id}#system`) ?? entryByKey.get(`${id}#snapshot`);
|
|
39
59
|
const droppable = entry?.droppable ?? (id !== 'persona');
|
|
40
60
|
const base = {
|
|
41
61
|
id,
|
|
62
|
+
// 占位行(unregistered/idle)也带 placement:契约缺省 = query 择取层(memory/cognition/wisdom)
|
|
63
|
+
// 属快照组、其余属 system 组(layers.ts 各层构造 placement),否则 UI 分组会把它们错放进 System
|
|
64
|
+
placement: id === 'memory' || id === 'cognition' || id === 'wisdom' ? 'snapshot' : 'system',
|
|
42
65
|
priority: entry?.priority ?? LAYER_PRIORITY[id],
|
|
43
66
|
order: entry?.order ?? LAYER_ORDER[id],
|
|
44
67
|
droppable,
|
|
@@ -62,28 +85,17 @@ export function buildContextLayersSnapshot(params) {
|
|
|
62
85
|
budgetTokens: 0,
|
|
63
86
|
};
|
|
64
87
|
}
|
|
65
|
-
return
|
|
66
|
-
id,
|
|
67
|
-
status: deriveLayerStatus(entry),
|
|
68
|
-
included: entry.included,
|
|
69
|
-
tokens: entry.tokens,
|
|
70
|
-
budgetTokens: entry.budgetTokens ?? 0,
|
|
71
|
-
priority: entry.priority,
|
|
72
|
-
order: entry.order,
|
|
73
|
-
droppable: entry.droppable ?? droppable,
|
|
74
|
-
reason: entry.reason,
|
|
75
|
-
dropped: entry.dropped,
|
|
76
|
-
sources: entry.sources,
|
|
77
|
-
preview: entry.preview,
|
|
78
|
-
content: entry.content,
|
|
79
|
-
};
|
|
88
|
+
return toView(entry);
|
|
80
89
|
});
|
|
90
|
+
// 双生 snapshot 条目(如 runtime 易变份)追加为附加行,观测面不丢内容
|
|
91
|
+
layers.push(...dualSnapshotExtras.map(toView));
|
|
81
92
|
return {
|
|
82
93
|
sessionId: manifest.sessionId,
|
|
83
94
|
assembledAt: params.assembledAt,
|
|
84
95
|
systemBudget: manifest.systemBudget,
|
|
85
96
|
structureReserve: manifest.structureReserve,
|
|
86
97
|
usedTokens: manifest.usedTokens,
|
|
98
|
+
usedSnapshotTokens: manifest.usedSnapshotTokens,
|
|
87
99
|
shares: manifest.shares,
|
|
88
100
|
query: params.query,
|
|
89
101
|
layers,
|
|
@@ -75,6 +75,13 @@ export interface LayerContent {
|
|
|
75
75
|
/** 溯源:文件路径、memory id、skill id 等 */
|
|
76
76
|
sources?: string[];
|
|
77
77
|
}
|
|
78
|
+
/**
|
|
79
|
+
* 装配位置(宪法 E8:缓存稳定前缀)
|
|
80
|
+
*
|
|
81
|
+
* - `system`(缺省):缓存稳定片段 → system prompt
|
|
82
|
+
* - `snapshot`:每 run 易变快照(Run 作用域 / query 相关择取)→ 消息尾部 content 侧
|
|
83
|
+
*/
|
|
84
|
+
export type LayerPlacement = 'system' | 'snapshot';
|
|
78
85
|
/**
|
|
79
86
|
* ContextLayer — 单层内容提供者
|
|
80
87
|
*
|
|
@@ -93,6 +100,14 @@ export interface ContextLayer {
|
|
|
93
100
|
readonly droppable: boolean;
|
|
94
101
|
/** system prompt 中的位置(小的在前) */
|
|
95
102
|
readonly order: number;
|
|
103
|
+
/**
|
|
104
|
+
* 装配位置(宪法 E8)。缺省 `system`。
|
|
105
|
+
*
|
|
106
|
+
* 跨 run 可变的内容(query 相关检索择取、datetime、tasks/guidance 等)
|
|
107
|
+
* 必须标 `snapshot`:不得进入 system prompt 前缀,由调用方作为本轮
|
|
108
|
+
* 易变快照在消息尾部(content 侧)送达。
|
|
109
|
+
*/
|
|
110
|
+
readonly placement?: LayerPlacement;
|
|
96
111
|
/**
|
|
97
112
|
* 变更指纹。与上次不同则强制重新 assemble;返回 null 表示每轮都重算。
|
|
98
113
|
*
|
|
@@ -108,6 +123,8 @@ export interface ContextLayer {
|
|
|
108
123
|
/** 装配清单(可观测,不进入模型输入) */
|
|
109
124
|
export interface LayerManifestEntry {
|
|
110
125
|
id: ContextLayerId;
|
|
126
|
+
/** 装配位置(E8);缺省 system */
|
|
127
|
+
placement?: LayerPlacement;
|
|
111
128
|
included: boolean;
|
|
112
129
|
tokens: number;
|
|
113
130
|
/** 本层硬顶 token(仅 layerShares 配置过的层);无单层上限时缺省 */
|
|
@@ -134,8 +151,10 @@ export interface AssembleManifest {
|
|
|
134
151
|
systemBudget: number;
|
|
135
152
|
/** 结构预留(分隔符等) */
|
|
136
153
|
structureReserve?: number;
|
|
137
|
-
/** 实际使用的 token */
|
|
154
|
+
/** 实际使用的 token(system 组) */
|
|
138
155
|
usedTokens: number;
|
|
156
|
+
/** 易变快照组实际使用的 token(E8;无 snapshot 层时缺省) */
|
|
157
|
+
usedSnapshotTokens?: number;
|
|
139
158
|
/**
|
|
140
159
|
* 显式配置的 layerShares 硬顶比例(未配置的层不出现)
|
|
141
160
|
* 不再表示「启用层归一化后的全局配额」
|
|
@@ -178,6 +197,34 @@ export interface ContextAssembleParams {
|
|
|
178
197
|
};
|
|
179
198
|
signal?: AbortSignal;
|
|
180
199
|
}
|
|
200
|
+
/**
|
|
201
|
+
* 判断消息 source 是否为引擎载体插槽(非用户发言)
|
|
202
|
+
*
|
|
203
|
+
* @param source - `message.metadata.source`
|
|
204
|
+
* @returns true 表示机器插槽(快照/grounding/附件/摘要)
|
|
205
|
+
*/
|
|
206
|
+
export declare function isEngineCarrierSource(source: unknown): boolean;
|
|
207
|
+
/**
|
|
208
|
+
* 聊天回放隐藏谓词(D9 收敛的唯一真源)。
|
|
209
|
+
*
|
|
210
|
+
* observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
|
|
211
|
+
* 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
|
|
212
|
+
* 语义(D8 拍板后):
|
|
213
|
+
* - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
|
|
214
|
+
* 只进 LLM 上下文,不进聊天回放;
|
|
215
|
+
* - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
|
|
216
|
+
* (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
|
|
217
|
+
* 的唯一可见凭证,隐藏它等于允许静默掐断任务;
|
|
218
|
+
* - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
|
|
219
|
+
*
|
|
220
|
+
* @param input - 消息的 role / metadata.source / 正文文本
|
|
221
|
+
* @returns true = 聊天回放跳过本条
|
|
222
|
+
*/
|
|
223
|
+
export declare function isChatReplayHidden(input: {
|
|
224
|
+
role?: string;
|
|
225
|
+
source?: string;
|
|
226
|
+
text: string;
|
|
227
|
+
}): boolean;
|
|
181
228
|
export interface ExtractLayerQueryOptions {
|
|
182
229
|
/**
|
|
183
230
|
* 额外主题线索(会话任务标题/当前步骤等)。
|
|
@@ -198,6 +245,7 @@ export declare function isThinLayerQuery(text: string): boolean;
|
|
|
198
245
|
*
|
|
199
246
|
* 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
|
|
200
247
|
* 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
|
|
248
|
+
* 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
|
|
201
249
|
*
|
|
202
250
|
* @param messages - 会话消息(含本轮用户输入)
|
|
203
251
|
* @param options - topicHints / maxChars
|
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
* 各层业务实现(检索、打分、落盘)可在后续迭代中逐个替换,
|
|
14
14
|
* 不改变本契约。
|
|
15
15
|
*/
|
|
16
|
+
import { extractUserMessageText } from './turn-envelope.js';
|
|
16
17
|
/**
|
|
17
18
|
* 默认层顺序(数字越小越靠 system prompt 前部)
|
|
18
19
|
*
|
|
@@ -58,16 +59,79 @@ export const LAYER_DEFAULT_SHARE = {
|
|
|
58
59
|
// ── 工具函数 ──
|
|
59
60
|
/** 纯应答/推进语:本身无检索语义,需要回看上文 */
|
|
60
61
|
const ACK_LAYER_QUERY_RE = /^(好|好的|好呀|好吧|嗯+|行|可以|继续|接着|然后呢?|下一步|收到|开始吧?|没问题|就这样|ok+|okay|yes|yeah|yep|go(\s+on)?|proceed)[\s!!。.~~]*$/i;
|
|
62
|
+
/**
|
|
63
|
+
* 引擎托管的 user 角色插槽(快照/grounding/附件/摘要)——不是用户发言。
|
|
64
|
+
* 检索 query 只采信真实用户文本;否则上轮快照(含旧记忆择取)会混入 query
|
|
65
|
+
* 造成择取自我强化漂移。
|
|
66
|
+
*/
|
|
67
|
+
const ENGINE_CARRIER_SOURCES = new Set([
|
|
68
|
+
'runtimeSnapshot',
|
|
69
|
+
'knowledgeGrounding',
|
|
70
|
+
'sessionAttachment',
|
|
71
|
+
'contextSummary',
|
|
72
|
+
/** reliability/steer 注入(wrap-up / planning / noop / truncate notice 等)——非用户发言 */
|
|
73
|
+
'engineHint',
|
|
74
|
+
/** turn 闭标(`<turn_end id/>`)——不是用户发言 */
|
|
75
|
+
'turnEnd',
|
|
76
|
+
/**
|
|
77
|
+
* 引擎主动停止的收口说明(RunGuard / Budget 裁决)。
|
|
78
|
+
*
|
|
79
|
+
* 引擎有权终止 turn,就必须留下用户可见的原因;这条既不是用户发言,
|
|
80
|
+
* 也不进 LLM 上下文(见 DefaultContextEngine.buildLlmMessages)。
|
|
81
|
+
*/
|
|
82
|
+
'runStopped',
|
|
83
|
+
]);
|
|
84
|
+
/**
|
|
85
|
+
* 判断消息 source 是否为引擎载体插槽(非用户发言)
|
|
86
|
+
*
|
|
87
|
+
* @param source - `message.metadata.source`
|
|
88
|
+
* @returns true 表示机器插槽(快照/grounding/附件/摘要)
|
|
89
|
+
*/
|
|
90
|
+
export function isEngineCarrierSource(source) {
|
|
91
|
+
return ENGINE_CARRIER_SOURCES.has(source);
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* 聊天回放隐藏谓词(D9 收敛的唯一真源)。
|
|
95
|
+
*
|
|
96
|
+
* observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
|
|
97
|
+
* 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
|
|
98
|
+
* 语义(D8 拍板后):
|
|
99
|
+
* - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
|
|
100
|
+
* 只进 LLM 上下文,不进聊天回放;
|
|
101
|
+
* - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
|
|
102
|
+
* (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
|
|
103
|
+
* 的唯一可见凭证,隐藏它等于允许静默掐断任务;
|
|
104
|
+
* - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
|
|
105
|
+
*
|
|
106
|
+
* @param input - 消息的 role / metadata.source / 正文文本
|
|
107
|
+
* @returns true = 聊天回放跳过本条
|
|
108
|
+
*/
|
|
109
|
+
export function isChatReplayHidden(input) {
|
|
110
|
+
if (input.source === 'knowledgeGrounding' ||
|
|
111
|
+
input.source === 'sessionAttachment' ||
|
|
112
|
+
input.source === 'runtimeSnapshot' ||
|
|
113
|
+
input.source === 'turnEnd') {
|
|
114
|
+
return true;
|
|
115
|
+
}
|
|
116
|
+
if (input.role !== 'system')
|
|
117
|
+
return false;
|
|
118
|
+
if (input.source === 'systemPrompt')
|
|
119
|
+
return true;
|
|
120
|
+
return (input.text.length > 200 &&
|
|
121
|
+
/AGENTS\.md|Session Startup|Operating Instructions|Agent Persona/i.test(input.text));
|
|
122
|
+
}
|
|
61
123
|
function userMessageText(m) {
|
|
124
|
+
let text = '';
|
|
62
125
|
if (typeof m.content === 'string')
|
|
63
|
-
|
|
64
|
-
if (Array.isArray(m.content)) {
|
|
65
|
-
|
|
126
|
+
text = m.content;
|
|
127
|
+
else if (Array.isArray(m.content)) {
|
|
128
|
+
text = m.content
|
|
66
129
|
.filter((b) => b.type === 'text')
|
|
67
130
|
.map((b) => b.text)
|
|
68
131
|
.join(' ');
|
|
69
132
|
}
|
|
70
|
-
|
|
133
|
+
// turn_start 信封:检索只采 <user_message>,不采 turn_context picks
|
|
134
|
+
return extractUserMessageText(text);
|
|
71
135
|
}
|
|
72
136
|
/**
|
|
73
137
|
* 是否无检索语义的短应答(继续/好/可以…)
|
|
@@ -85,6 +149,7 @@ export function isThinLayerQuery(text) {
|
|
|
85
149
|
*
|
|
86
150
|
* 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
|
|
87
151
|
* 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
|
|
152
|
+
* 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
|
|
88
153
|
*
|
|
89
154
|
* @param messages - 会话消息(含本轮用户输入)
|
|
90
155
|
* @param options - topicHints / maxChars
|
|
@@ -96,6 +161,9 @@ export function extractLayerQuery(messages, options) {
|
|
|
96
161
|
const m = messages[i];
|
|
97
162
|
if (m.role !== 'user')
|
|
98
163
|
continue;
|
|
164
|
+
const src = m.metadata?.source;
|
|
165
|
+
if (src && ENGINE_CARRIER_SOURCES.has(src))
|
|
166
|
+
continue;
|
|
99
167
|
const text = userMessageText(m).trim();
|
|
100
168
|
if (text)
|
|
101
169
|
userTexts.push(text);
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* 不在本文件做相关性打分、embedding、衰减等智能逻辑。
|
|
6
6
|
* 各层质量打磨后续替换 assemble 实现即可,契约不变。
|
|
7
7
|
*/
|
|
8
|
-
import type { ContextLayer, ContextLayerId, LayerAssembleContext, LayerContent } from './layer-types.js';
|
|
8
|
+
import type { ContextLayer, ContextLayerId, LayerAssembleContext, LayerContent, LayerPlacement } from './layer-types.js';
|
|
9
9
|
import type { MemoryStore, ConceptGraphStore } from '../memory/types.js';
|
|
10
10
|
import type { KnowledgeCatalogProvider } from '../knowledge/catalog-types.js';
|
|
11
11
|
declare abstract class BaseLayer implements ContextLayer {
|
|
@@ -14,7 +14,8 @@ declare abstract class BaseLayer implements ContextLayer {
|
|
|
14
14
|
readonly defaultShare: number;
|
|
15
15
|
readonly droppable: boolean;
|
|
16
16
|
readonly order: number;
|
|
17
|
-
|
|
17
|
+
readonly placement: LayerPlacement;
|
|
18
|
+
constructor(id: ContextLayerId, overrides?: Partial<Pick<ContextLayer, 'priority' | 'defaultShare' | 'droppable' | 'order' | 'placement'>>);
|
|
18
19
|
abstract assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
|
|
19
20
|
protected content(text: string, extra?: Partial<LayerContent>): LayerContent | null;
|
|
20
21
|
/**
|
|
@@ -64,6 +65,8 @@ export declare class RuntimeLayer extends BaseLayer {
|
|
|
64
65
|
constructor(options: {
|
|
65
66
|
getText: (ctx: LayerAssembleContext) => Promise<string> | string;
|
|
66
67
|
order?: number;
|
|
68
|
+
/** E8:稳定锚点(workspace/root_instructions)留 system;易变注入(datetime/tasks)标 snapshot */
|
|
69
|
+
placement?: LayerPlacement;
|
|
67
70
|
});
|
|
68
71
|
assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
|
|
69
72
|
}
|
|
@@ -106,19 +109,35 @@ export declare class CognitionLayer extends BaseLayer {
|
|
|
106
109
|
assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
|
|
107
110
|
}
|
|
108
111
|
/**
|
|
109
|
-
* Wisdom 层 —
|
|
112
|
+
* Wisdom 层 — 小核心 + 场景匹配注入判断范式
|
|
110
113
|
*
|
|
111
|
-
*
|
|
112
|
-
* 后续可改为场景匹配 / applicableScenarios 过滤。
|
|
114
|
+
* 不做全量 dump。匹配失败只注入 core(宁缺毋滥)。
|
|
113
115
|
*/
|
|
114
116
|
export declare class WisdomLayer extends BaseLayer {
|
|
115
|
-
private readonly
|
|
117
|
+
private readonly select;
|
|
118
|
+
private readonly onInjected?;
|
|
119
|
+
private readonly coreMaxItems?;
|
|
120
|
+
private readonly scenarioMaxItems?;
|
|
116
121
|
constructor(options: {
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
122
|
+
select: (query: string) => Promise<Array<{
|
|
123
|
+
entry: {
|
|
124
|
+
id: string;
|
|
125
|
+
statement: string;
|
|
126
|
+
scenario: {
|
|
127
|
+
problemTypes: string[];
|
|
128
|
+
antiScenarios?: string[];
|
|
129
|
+
};
|
|
130
|
+
effect: {
|
|
131
|
+
posture?: string;
|
|
132
|
+
questions?: string[];
|
|
133
|
+
};
|
|
134
|
+
};
|
|
135
|
+
bucket: 'core' | 'scenario';
|
|
121
136
|
}>>;
|
|
137
|
+
/** S1 applied 入账(注入命中) */
|
|
138
|
+
onInjected?: (ids: string[]) => void | Promise<void>;
|
|
139
|
+
coreMaxItems?: number;
|
|
140
|
+
scenarioMaxItems?: number;
|
|
122
141
|
order?: number;
|
|
123
142
|
});
|
|
124
143
|
assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
|
|
@@ -133,11 +152,9 @@ export interface CreateDefaultLayersOptions {
|
|
|
133
152
|
knowledgeShowProgress?: 'off' | 'bucket' | 'exact';
|
|
134
153
|
memoryStore?: MemoryStore;
|
|
135
154
|
cognitionStore?: ConceptGraphStore;
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
priority: number;
|
|
140
|
-
}>>;
|
|
155
|
+
wisdomStore?: import('../memory/types.js').WisdomStore;
|
|
156
|
+
wisdomCoreMaxItems?: number;
|
|
157
|
+
wisdomScenarioMaxItems?: number;
|
|
141
158
|
}
|
|
142
159
|
/**
|
|
143
160
|
* 按可用依赖创建启用层列表
|