@octopi-agent/engine 0.55.0
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 -0
- package/NOTICE +7 -0
- package/README.md +26 -0
- package/dist/builtin-model-info.d.ts +30 -0
- package/dist/builtin-model-info.js +118 -0
- package/dist/config-schema/agent.d.ts +72 -0
- package/dist/config-schema/agent.js +38 -0
- package/dist/config-schema/context.d.ts +122 -0
- package/dist/config-schema/context.js +100 -0
- package/dist/config-schema/engine.d.ts +665 -0
- package/dist/config-schema/engine.js +55 -0
- package/dist/config-schema/governance.d.ts +81 -0
- package/dist/config-schema/governance.js +55 -0
- package/dist/config-schema/models.d.ts +159 -0
- package/dist/config-schema/models.js +92 -0
- package/dist/config-schema/observability.d.ts +57 -0
- package/dist/config-schema/observability.js +59 -0
- package/dist/config-schema/run.d.ts +102 -0
- package/dist/config-schema/run.js +99 -0
- package/dist/config-schema/shared.d.ts +54 -0
- package/dist/config-schema/shared.js +43 -0
- package/dist/config-schema/substrate.d.ts +156 -0
- package/dist/config-schema/substrate.js +191 -0
- package/dist/config-schema/subsystems.d.ts +11 -0
- package/dist/config-schema/subsystems.js +13 -0
- package/dist/config-schema/web-search.d.ts +32 -0
- package/dist/config-schema/web-search.js +38 -0
- package/dist/config.d.ts +840 -0
- package/dist/config.js +161 -0
- package/dist/harness/activation/coalesce.d.ts +38 -0
- package/dist/harness/activation/coalesce.js +80 -0
- package/dist/harness/activation/compiler.d.ts +15 -0
- package/dist/harness/activation/compiler.js +136 -0
- package/dist/harness/activation/dispatcher.d.ts +19 -0
- package/dist/harness/activation/dispatcher.js +31 -0
- package/dist/harness/activation/event-source-types.d.ts +63 -0
- package/dist/harness/activation/event-source-types.js +13 -0
- package/dist/harness/activation/index.d.ts +20 -0
- package/dist/harness/activation/index.js +14 -0
- package/dist/harness/activation/router.d.ts +16 -0
- package/dist/harness/activation/router.js +28 -0
- package/dist/harness/activation/runtime.d.ts +78 -0
- package/dist/harness/activation/runtime.js +310 -0
- package/dist/harness/activation/sources/agent-signal.d.ts +34 -0
- package/dist/harness/activation/sources/agent-signal.js +93 -0
- package/dist/harness/activation/sources/escalate-bridge.d.ts +43 -0
- package/dist/harness/activation/sources/escalate-bridge.js +85 -0
- package/dist/harness/activation/sources/index.d.ts +6 -0
- package/dist/harness/activation/sources/index.js +3 -0
- package/dist/harness/activation/sources/schedule.d.ts +43 -0
- package/dist/harness/activation/sources/schedule.js +102 -0
- package/dist/harness/activation/types.d.ts +166 -0
- package/dist/harness/activation/types.js +15 -0
- package/dist/harness/agent/builder.d.ts +456 -0
- package/dist/harness/agent/builder.js +1414 -0
- package/dist/harness/agent/config-bridge.d.ts +80 -0
- package/dist/harness/agent/config-bridge.js +424 -0
- package/dist/harness/agent/index.d.ts +15 -0
- package/dist/harness/agent/index.js +12 -0
- package/dist/harness/agent/persona.d.ts +52 -0
- package/dist/harness/agent/persona.js +166 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/index.d.ts +4 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/index.js +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +18 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +83 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +36 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +54 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/index.d.ts +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/index.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +24 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +142 -0
- package/dist/harness/collaboration/autonomous-subsystem/errors.d.ts +8 -0
- package/dist/harness/collaboration/autonomous-subsystem/errors.js +11 -0
- package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +25 -0
- package/dist/harness/collaboration/autonomous-subsystem/index.js +28 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +34 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +368 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +131 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +531 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +116 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +551 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/index.d.ts +5 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/index.js +3 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.d.ts +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +128 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +46 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +57 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +48 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +108 -0
- package/dist/harness/collaboration/autonomous-subsystem/session/index.d.ts +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/session/index.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/session/manager.d.ts +26 -0
- package/dist/harness/collaboration/autonomous-subsystem/session/manager.js +78 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +110 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +190 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/index.d.ts +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/index.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +107 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +405 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +3 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +65 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +116 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +64 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +89 -0
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +559 -0
- package/dist/harness/collaboration/autonomous-subsystem/types.js +21 -0
- package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +144 -0
- package/dist/harness/collaboration/multi-agent/agent-registry-types.js +25 -0
- package/dist/harness/collaboration/multi-agent/index.d.ts +17 -0
- package/dist/harness/collaboration/multi-agent/index.js +15 -0
- package/dist/harness/collaboration/multi-agent/message-channel-types.d.ts +69 -0
- package/dist/harness/collaboration/multi-agent/message-channel-types.js +16 -0
- package/dist/harness/collaboration/multi-agent/process.d.ts +167 -0
- package/dist/harness/collaboration/multi-agent/process.js +256 -0
- package/dist/harness/collaboration/multi-agent/registry.d.ts +36 -0
- package/dist/harness/collaboration/multi-agent/registry.js +137 -0
- package/dist/harness/collaboration/multi-agent/swarm.d.ts +135 -0
- package/dist/harness/collaboration/multi-agent/swarm.js +317 -0
- package/dist/harness/collaboration/multi-agent/types.d.ts +66 -0
- package/dist/harness/collaboration/multi-agent/types.js +15 -0
- package/dist/harness/collaboration/orchestration/async-task-store.d.ts +107 -0
- package/dist/harness/collaboration/orchestration/async-task-store.js +12 -0
- package/dist/harness/collaboration/orchestration/async-task.d.ts +156 -0
- package/dist/harness/collaboration/orchestration/async-task.js +359 -0
- package/dist/harness/collaboration/orchestration/cognitive-loop.d.ts +93 -0
- package/dist/harness/collaboration/orchestration/cognitive-loop.js +6 -0
- package/dist/harness/collaboration/orchestration/index.d.ts +19 -0
- package/dist/harness/collaboration/orchestration/index.js +16 -0
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +47 -0
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +61 -0
- package/dist/harness/collaboration/orchestration/planner/index.d.ts +9 -0
- package/dist/harness/collaboration/orchestration/planner/index.js +6 -0
- package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +54 -0
- package/dist/harness/collaboration/orchestration/planner/llm-planner.js +167 -0
- package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +85 -0
- package/dist/harness/collaboration/orchestration/planner/rule-planner.js +175 -0
- package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +21 -0
- package/dist/harness/collaboration/orchestration/quality/classifier.js +235 -0
- package/dist/harness/collaboration/orchestration/quality/gate.d.ts +29 -0
- package/dist/harness/collaboration/orchestration/quality/gate.js +409 -0
- package/dist/harness/collaboration/orchestration/quality/index.d.ts +9 -0
- package/dist/harness/collaboration/orchestration/quality/index.js +8 -0
- package/dist/harness/collaboration/orchestration/quality/types.d.ts +159 -0
- package/dist/harness/collaboration/orchestration/quality/types.js +33 -0
- package/dist/harness/collaboration/orchestration/reflector/index.d.ts +5 -0
- package/dist/harness/collaboration/orchestration/reflector/index.js +4 -0
- package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +41 -0
- package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +142 -0
- package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +5 -0
- package/dist/harness/collaboration/orchestration/scheduler/index.js +4 -0
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +143 -0
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +297 -0
- package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +12 -0
- package/dist/harness/collaboration/orchestration/strategy/classifier.js +81 -0
- package/dist/harness/collaboration/orchestration/strategy/index.d.ts +3 -0
- package/dist/harness/collaboration/orchestration/strategy/index.js +2 -0
- package/dist/harness/collaboration/orchestration/strategy/router.d.ts +28 -0
- package/dist/harness/collaboration/orchestration/strategy/router.js +105 -0
- package/dist/harness/collaboration/orchestration/strategy/types.d.ts +49 -0
- package/dist/harness/collaboration/orchestration/strategy/types.js +4 -0
- package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +86 -0
- package/dist/harness/collaboration/orchestration/workflow/engine.js +298 -0
- package/dist/harness/collaboration/orchestration/workflow/index.d.ts +9 -0
- package/dist/harness/collaboration/orchestration/workflow/index.js +7 -0
- package/dist/harness/collaboration/orchestration/workflow/types.d.ts +143 -0
- package/dist/harness/collaboration/orchestration/workflow/types.js +7 -0
- package/dist/harness/context/assembler.d.ts +74 -0
- package/dist/harness/context/assembler.js +315 -0
- package/dist/harness/context/budget-allocator.d.ts +41 -0
- package/dist/harness/context/budget-allocator.js +80 -0
- package/dist/harness/context/capabilities/compact/engine.d.ts +15 -0
- package/dist/harness/context/capabilities/compact/engine.js +320 -0
- package/dist/harness/context/capabilities/compact/index.d.ts +7 -0
- package/dist/harness/context/capabilities/compact/index.js +6 -0
- package/dist/harness/context/capabilities/compact/types.d.ts +78 -0
- package/dist/harness/context/capabilities/compact/types.js +6 -0
- package/dist/harness/context/capabilities/index.d.ts +10 -0
- package/dist/harness/context/capabilities/index.js +10 -0
- package/dist/harness/context/capabilities/summary/budget.d.ts +23 -0
- package/dist/harness/context/capabilities/summary/budget.js +26 -0
- package/dist/harness/context/capabilities/summary/executor.d.ts +37 -0
- package/dist/harness/context/capabilities/summary/executor.js +189 -0
- package/dist/harness/context/capabilities/summary/gate.d.ts +43 -0
- package/dist/harness/context/capabilities/summary/gate.js +69 -0
- package/dist/harness/context/capabilities/summary/index.d.ts +17 -0
- package/dist/harness/context/capabilities/summary/index.js +15 -0
- package/dist/harness/context/capabilities/summary/memory-cache.d.ts +16 -0
- package/dist/harness/context/capabilities/summary/memory-cache.js +42 -0
- package/dist/harness/context/capabilities/summary/oversized.d.ts +51 -0
- package/dist/harness/context/capabilities/summary/oversized.js +80 -0
- package/dist/harness/context/capabilities/summary/policies.d.ts +12 -0
- package/dist/harness/context/capabilities/summary/policies.js +139 -0
- package/dist/harness/context/capabilities/summary/port.d.ts +29 -0
- package/dist/harness/context/capabilities/summary/port.js +124 -0
- package/dist/harness/context/capabilities/summary/registry.d.ts +50 -0
- package/dist/harness/context/capabilities/summary/registry.js +182 -0
- package/dist/harness/context/capabilities/summary/resolver.d.ts +35 -0
- package/dist/harness/context/capabilities/summary/resolver.js +145 -0
- package/dist/harness/context/capabilities/summary/structured.d.ts +35 -0
- package/dist/harness/context/capabilities/summary/structured.js +163 -0
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +86 -0
- package/dist/harness/context/capabilities/summary/tool-binding.js +166 -0
- package/dist/harness/context/capabilities/summary/types.d.ts +171 -0
- package/dist/harness/context/capabilities/summary/types.js +6 -0
- package/dist/harness/context/compact-key.d.ts +13 -0
- package/dist/harness/context/compact-key.js +17 -0
- package/dist/harness/context/constitution/default-agents.md +227 -0
- package/dist/harness/context/constitution/load-constitution.d.ts +30 -0
- package/dist/harness/context/constitution/load-constitution.js +66 -0
- package/dist/harness/context/default-context-engine.d.ts +171 -0
- package/dist/harness/context/default-context-engine.js +836 -0
- package/dist/harness/context/hybrid-compressor.d.ts +41 -0
- package/dist/harness/context/hybrid-compressor.js +158 -0
- package/dist/harness/context/index.d.ts +26 -0
- package/dist/harness/context/index.js +17 -0
- package/dist/harness/context/layer-health.d.ts +58 -0
- package/dist/harness/context/layer-health.js +160 -0
- package/dist/harness/context/layer-snapshot.d.ts +69 -0
- package/dist/harness/context/layer-snapshot.js +133 -0
- package/dist/harness/context/layer-types.d.ts +184 -0
- package/dist/harness/context/layer-types.js +79 -0
- package/dist/harness/context/layers.d.ts +146 -0
- package/dist/harness/context/layers.js +371 -0
- package/dist/harness/context/llm-summarizer.d.ts +38 -0
- package/dist/harness/context/llm-summarizer.js +220 -0
- package/dist/harness/context/message-selector.d.ts +44 -0
- package/dist/harness/context/message-selector.js +180 -0
- package/dist/harness/context/runtime-datetime.d.ts +49 -0
- package/dist/harness/context/runtime-datetime.js +74 -0
- package/dist/harness/context/smart-router.d.ts +75 -0
- package/dist/harness/context/smart-router.js +118 -0
- package/dist/harness/context/summarize.d.ts +39 -0
- package/dist/harness/context/summarize.js +50 -0
- package/dist/harness/context/system-prompt-assembler.d.ts +56 -0
- package/dist/harness/context/system-prompt-assembler.js +122 -0
- package/dist/harness/context/token-constants.d.ts +24 -0
- package/dist/harness/context/token-constants.js +27 -0
- package/dist/harness/context/token-estimate-fns.d.ts +70 -0
- package/dist/harness/context/token-estimate-fns.js +117 -0
- package/dist/harness/context/token-estimator.d.ts +63 -0
- package/dist/harness/context/token-estimator.js +126 -0
- package/dist/harness/context/truncate-compressor.d.ts +28 -0
- package/dist/harness/context/truncate-compressor.js +100 -0
- package/dist/harness/context/types.d.ts +316 -0
- package/dist/harness/context/types.js +9 -0
- package/dist/harness/extension/execution-environment/index.d.ts +10 -0
- package/dist/harness/extension/execution-environment/index.js +8 -0
- package/dist/harness/extension/execution-environment/isolation.d.ts +56 -0
- package/dist/harness/extension/execution-environment/isolation.js +56 -0
- package/dist/harness/extension/execution-environment/sandbox.d.ts +12 -0
- package/dist/harness/extension/execution-environment/sandbox.js +87 -0
- package/dist/harness/extension/execution-environment/types.d.ts +157 -0
- package/dist/harness/extension/execution-environment/types.js +6 -0
- package/dist/harness/extension/execution-environment/workspace.d.ts +26 -0
- package/dist/harness/extension/execution-environment/workspace.js +171 -0
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +34 -0
- package/dist/harness/extension/plugin-ecosystem/channel-types.js +12 -0
- package/dist/harness/extension/plugin-ecosystem/commands/builtin.d.ts +34 -0
- package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +185 -0
- package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +15 -0
- package/dist/harness/extension/plugin-ecosystem/commands/index.js +11 -0
- package/dist/harness/extension/plugin-ecosystem/commands/parse.d.ts +17 -0
- package/dist/harness/extension/plugin-ecosystem/commands/parse.js +41 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +6 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +49 -0
- package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +71 -0
- package/dist/harness/extension/plugin-ecosystem/commands/router.js +302 -0
- package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.d.ts +10 -0
- package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.js +59 -0
- package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +126 -0
- package/dist/harness/extension/plugin-ecosystem/commands/types.js +7 -0
- package/dist/harness/extension/plugin-ecosystem/commands/user-source.d.ts +16 -0
- package/dist/harness/extension/plugin-ecosystem/commands/user-source.js +102 -0
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +13 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +10 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/bridge.d.ts +42 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +88 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/discovery.d.ts +39 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/discovery.js +117 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/index.d.ts +10 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/index.js +8 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/manager.d.ts +74 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/manager.js +146 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/types.d.ts +149 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/types.js +12 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +294 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +270 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +100 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +158 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +101 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +65 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +7 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +7 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +26 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +26 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +86 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +139 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +135 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +353 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +504 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +368 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +261 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +44 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +123 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +210 -0
- package/dist/harness/extension/plugin-ecosystem/skills/types.d.ts +29 -0
- package/dist/harness/extension/plugin-ecosystem/skills/types.js +7 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +34 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +92 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +101 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +570 -0
- package/dist/harness/extension/plugin-ecosystem/tools/env-info.d.ts +8 -0
- package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +49 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.d.ts +14 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +126 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +23 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +659 -0
- package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +28 -0
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +170 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +14 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +12 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.d.ts +25 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +164 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +19 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +197 -0
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +82 -0
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +251 -0
- package/dist/harness/extension/plugin-ecosystem/tools/session-history.d.ts +21 -0
- package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +165 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +65 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +262 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +34 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +30 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.d.ts +66 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.js +12 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search.d.ts +23 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +84 -0
- package/dist/harness/governance/accounting/index.d.ts +5 -0
- package/dist/harness/governance/accounting/index.js +3 -0
- package/dist/harness/governance/accounting/session-ledger.d.ts +67 -0
- package/dist/harness/governance/accounting/session-ledger.js +84 -0
- package/dist/harness/governance/accounting/usage-ledger.d.ts +107 -0
- package/dist/harness/governance/accounting/usage-ledger.js +137 -0
- package/dist/harness/governance/credentials/crypto.d.ts +34 -0
- package/dist/harness/governance/credentials/crypto.js +79 -0
- package/dist/harness/governance/credentials/db.d.ts +32 -0
- package/dist/harness/governance/credentials/db.js +87 -0
- package/dist/harness/governance/credentials/index.d.ts +9 -0
- package/dist/harness/governance/credentials/index.js +7 -0
- package/dist/harness/governance/credentials/store.d.ts +47 -0
- package/dist/harness/governance/credentials/store.js +228 -0
- package/dist/harness/governance/credentials/types.d.ts +67 -0
- package/dist/harness/governance/credentials/types.js +30 -0
- package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +32 -0
- package/dist/harness/governance/human-in-the-loop/approval-manager.js +93 -0
- package/dist/harness/governance/human-in-the-loop/index.d.ts +9 -0
- package/dist/harness/governance/human-in-the-loop/index.js +7 -0
- package/dist/harness/governance/human-in-the-loop/types.d.ts +66 -0
- package/dist/harness/governance/human-in-the-loop/types.js +6 -0
- package/dist/harness/governance/index.d.ts +10 -0
- package/dist/harness/governance/index.js +10 -0
- package/dist/harness/governance/security/capability-enforcer.d.ts +56 -0
- package/dist/harness/governance/security/capability-enforcer.js +132 -0
- package/dist/harness/governance/security/default-risk-policy.d.ts +66 -0
- package/dist/harness/governance/security/default-risk-policy.js +75 -0
- package/dist/harness/governance/security/default-security-guard.d.ts +105 -0
- package/dist/harness/governance/security/default-security-guard.js +578 -0
- package/dist/harness/governance/security/degradation.d.ts +14 -0
- package/dist/harness/governance/security/degradation.js +208 -0
- package/dist/harness/governance/security/index.d.ts +10 -0
- package/dist/harness/governance/security/index.js +10 -0
- package/dist/harness/governance/security/risk-evaluator.d.ts +68 -0
- package/dist/harness/governance/security/risk-evaluator.js +1043 -0
- package/dist/harness/governance/security/risk-types.d.ts +74 -0
- package/dist/harness/governance/security/risk-types.js +7 -0
- package/dist/harness/governance/security/shell-parser.d.ts +35 -0
- package/dist/harness/governance/security/shell-parser.js +525 -0
- package/dist/harness/governance/security/tool-call-risk-policy.d.ts +6 -0
- package/dist/harness/governance/security/tool-call-risk-policy.js +6 -0
- package/dist/harness/governance/session-acl/index.d.ts +11 -0
- package/dist/harness/governance/session-acl/index.js +7 -0
- package/dist/harness/governance/session-acl/rights.d.ts +78 -0
- package/dist/harness/governance/session-acl/rights.js +142 -0
- package/dist/harness/governance/session-acl/seed-roles.d.ts +16 -0
- package/dist/harness/governance/session-acl/seed-roles.js +85 -0
- package/dist/harness/governance/session-acl/service.d.ts +136 -0
- package/dist/harness/governance/session-acl/service.js +407 -0
- package/dist/harness/governance/session-acl/types.d.ts +102 -0
- package/dist/harness/governance/session-acl/types.js +5 -0
- package/dist/harness/index.d.ts +137 -0
- package/dist/harness/index.js +106 -0
- package/dist/harness/knowledge/adapters.d.ts +68 -0
- package/dist/harness/knowledge/adapters.js +421 -0
- package/dist/harness/knowledge/catalog-index.d.ts +7 -0
- package/dist/harness/knowledge/catalog-index.js +7 -0
- package/dist/harness/knowledge/catalog-types.d.ts +33 -0
- package/dist/harness/knowledge/catalog-types.js +10 -0
- package/dist/harness/knowledge/connector-fetcher.d.ts +13 -0
- package/dist/harness/knowledge/connector-fetcher.js +27 -0
- package/dist/harness/knowledge/connectors.d.ts +55 -0
- package/dist/harness/knowledge/connectors.js +181 -0
- package/dist/harness/knowledge/db.d.ts +26 -0
- package/dist/harness/knowledge/db.js +235 -0
- package/dist/harness/knowledge/describe.d.ts +40 -0
- package/dist/harness/knowledge/describe.js +52 -0
- package/dist/harness/knowledge/fetchers.d.ts +66 -0
- package/dist/harness/knowledge/fetchers.js +342 -0
- package/dist/harness/knowledge/grounding.d.ts +98 -0
- package/dist/harness/knowledge/grounding.js +208 -0
- package/dist/harness/knowledge/hit-log.d.ts +74 -0
- package/dist/harness/knowledge/hit-log.js +99 -0
- package/dist/harness/knowledge/html.d.ts +20 -0
- package/dist/harness/knowledge/html.js +103 -0
- package/dist/harness/knowledge/index-store.d.ts +150 -0
- package/dist/harness/knowledge/index-store.js +394 -0
- package/dist/harness/knowledge/index.d.ts +38 -0
- package/dist/harness/knowledge/index.js +24 -0
- package/dist/harness/knowledge/ingest.d.ts +162 -0
- package/dist/harness/knowledge/ingest.js +814 -0
- package/dist/harness/knowledge/network-guard.d.ts +57 -0
- package/dist/harness/knowledge/network-guard.js +242 -0
- package/dist/harness/knowledge/paths.d.ts +14 -0
- package/dist/harness/knowledge/paths.js +17 -0
- package/dist/harness/knowledge/purge.d.ts +34 -0
- package/dist/harness/knowledge/purge.js +51 -0
- package/dist/harness/knowledge/retriever.d.ts +83 -0
- package/dist/harness/knowledge/retriever.js +184 -0
- package/dist/harness/knowledge/secret-scan.d.ts +11 -0
- package/dist/harness/knowledge/secret-scan.js +32 -0
- package/dist/harness/knowledge/source-store.d.ts +107 -0
- package/dist/harness/knowledge/source-store.js +516 -0
- package/dist/harness/knowledge/types.d.ts +129 -0
- package/dist/harness/knowledge/types.js +14 -0
- package/dist/harness/memory/backfill-coverage.d.ts +80 -0
- package/dist/harness/memory/backfill-coverage.js +146 -0
- package/dist/harness/memory/backfill-trigger.d.ts +83 -0
- package/dist/harness/memory/backfill-trigger.js +247 -0
- package/dist/harness/memory/cognition-types.d.ts +4 -0
- package/dist/harness/memory/cognition-types.js +4 -0
- package/dist/harness/memory/cognition.d.ts +16 -0
- package/dist/harness/memory/cognition.js +107 -0
- package/dist/harness/memory/confidence.d.ts +63 -0
- package/dist/harness/memory/confidence.js +157 -0
- package/dist/harness/memory/decay-policy.d.ts +22 -0
- package/dist/harness/memory/decay-policy.js +28 -0
- package/dist/harness/memory/gates.d.ts +39 -0
- package/dist/harness/memory/gates.js +176 -0
- package/dist/harness/memory/health-probe.d.ts +36 -0
- package/dist/harness/memory/health-probe.js +78 -0
- package/dist/harness/memory/index.d.ts +32 -0
- package/dist/harness/memory/index.js +26 -0
- package/dist/harness/memory/similarity.d.ts +33 -0
- package/dist/harness/memory/similarity.js +69 -0
- package/dist/harness/memory/sqlite/agent-db.d.ts +73 -0
- package/dist/harness/memory/sqlite/agent-db.js +277 -0
- package/dist/harness/memory/sqlite/backfill-coverage.d.ts +13 -0
- package/dist/harness/memory/sqlite/backfill-coverage.js +57 -0
- package/dist/harness/memory/sqlite/cognition-store.d.ts +34 -0
- package/dist/harness/memory/sqlite/cognition-store.js +188 -0
- package/dist/harness/memory/sqlite/embedding-from-models.d.ts +47 -0
- package/dist/harness/memory/sqlite/embedding-from-models.js +90 -0
- package/dist/harness/memory/sqlite/embedding.d.ts +93 -0
- package/dist/harness/memory/sqlite/embedding.js +268 -0
- package/dist/harness/memory/sqlite/index.d.ts +22 -0
- package/dist/harness/memory/sqlite/index.js +17 -0
- package/dist/harness/memory/sqlite/keyword-search.d.ts +37 -0
- package/dist/harness/memory/sqlite/keyword-search.js +113 -0
- package/dist/harness/memory/sqlite/knowledge-registry.d.ts +45 -0
- package/dist/harness/memory/sqlite/knowledge-registry.js +59 -0
- package/dist/harness/memory/sqlite/memory-store.d.ts +80 -0
- package/dist/harness/memory/sqlite/memory-store.js +548 -0
- package/dist/harness/memory/sqlite/sqlite-vec.d.ts +45 -0
- package/dist/harness/memory/sqlite/sqlite-vec.js +159 -0
- package/dist/harness/memory/sqlite/vector-search.d.ts +41 -0
- package/dist/harness/memory/sqlite/vector-search.js +72 -0
- package/dist/harness/memory/sqlite/wisdom-store.d.ts +23 -0
- package/dist/harness/memory/sqlite/wisdom-store.js +64 -0
- package/dist/harness/memory/steward-policy.d.ts +122 -0
- package/dist/harness/memory/steward-policy.js +369 -0
- package/dist/harness/memory/store.d.ts +33 -0
- package/dist/harness/memory/store.js +173 -0
- package/dist/harness/memory/types.d.ts +170 -0
- package/dist/harness/memory/types.js +7 -0
- package/dist/harness/memory/wisdom-types.d.ts +4 -0
- package/dist/harness/memory/wisdom-types.js +4 -0
- package/dist/harness/observability/diagnostics/index.d.ts +5 -0
- package/dist/harness/observability/diagnostics/index.js +4 -0
- package/dist/harness/observability/diagnostics/registry.d.ts +19 -0
- package/dist/harness/observability/diagnostics/registry.js +74 -0
- package/dist/harness/observability/diagnostics/types.d.ts +42 -0
- package/dist/harness/observability/diagnostics/types.js +6 -0
- package/dist/harness/observability/observer/hub.d.ts +107 -0
- package/dist/harness/observability/observer/hub.js +907 -0
- package/dist/harness/observability/observer/index.d.ts +4 -0
- package/dist/harness/observability/observer/index.js +3 -0
- package/dist/harness/observability/observer/run-snapshot.d.ts +47 -0
- package/dist/harness/observability/observer/run-snapshot.js +65 -0
- package/dist/harness/observability/observer/types.d.ts +370 -0
- package/dist/harness/observability/observer/types.js +379 -0
- package/dist/harness/observability/run-telemetry.d.ts +51 -0
- package/dist/harness/observability/run-telemetry.js +28 -0
- package/dist/harness/run/agent/agent.d.ts +142 -0
- package/dist/harness/run/agent/agent.js +192 -0
- package/dist/harness/run/agent/index.d.ts +8 -0
- package/dist/harness/run/agent/index.js +7 -0
- package/dist/harness/run/budget/budget.d.ts +94 -0
- package/dist/harness/run/budget/budget.js +124 -0
- package/dist/harness/run/budget/index.d.ts +7 -0
- package/dist/harness/run/budget/index.js +6 -0
- package/dist/harness/run/concurrency/index.d.ts +18 -0
- package/dist/harness/run/concurrency/index.js +14 -0
- package/dist/harness/run/concurrency/provider-pool.d.ts +128 -0
- package/dist/harness/run/concurrency/provider-pool.js +329 -0
- package/dist/harness/run/concurrency/rate-limiter.d.ts +109 -0
- package/dist/harness/run/concurrency/rate-limiter.js +233 -0
- package/dist/harness/run/concurrency/session-gate.d.ts +85 -0
- package/dist/harness/run/concurrency/session-gate.js +176 -0
- package/dist/harness/run/concurrency/session-lease.d.ts +79 -0
- package/dist/harness/run/concurrency/session-lease.js +100 -0
- package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +41 -0
- package/dist/harness/run/concurrency/tool-loop-detection-core.js +239 -0
- package/dist/harness/run/concurrency/tool-loop-detection.d.ts +8 -0
- package/dist/harness/run/concurrency/tool-loop-detection.js +7 -0
- package/dist/harness/run/concurrency/tool-validator.d.ts +96 -0
- package/dist/harness/run/concurrency/tool-validator.js +195 -0
- package/dist/harness/run/index.d.ts +14 -0
- package/dist/harness/run/index.js +14 -0
- package/dist/harness/run/model/index.d.ts +9 -0
- package/dist/harness/run/model/index.js +7 -0
- package/dist/harness/run/model/resolver.d.ts +111 -0
- package/dist/harness/run/model/resolver.js +192 -0
- package/dist/harness/run/model/run-scope.d.ts +43 -0
- package/dist/harness/run/model/run-scope.js +64 -0
- package/dist/harness/run/model/types.d.ts +47 -0
- package/dist/harness/run/model/types.js +9 -0
- package/dist/harness/run/reliability/circuit-breaker.d.ts +87 -0
- package/dist/harness/run/reliability/circuit-breaker.js +130 -0
- package/dist/harness/run/reliability/fallback-provider.d.ts +40 -0
- package/dist/harness/run/reliability/fallback-provider.js +118 -0
- package/dist/harness/run/reliability/harness-events.d.ts +109 -0
- package/dist/harness/run/reliability/harness-events.js +7 -0
- package/dist/harness/run/reliability/index.d.ts +12 -0
- package/dist/harness/run/reliability/index.js +7 -0
- package/dist/harness/run/reliability/model-binding.d.ts +22 -0
- package/dist/harness/run/reliability/model-binding.js +27 -0
- package/dist/harness/run/reliability/provider-wrapper.d.ts +26 -0
- package/dist/harness/run/reliability/provider-wrapper.js +61 -0
- package/dist/harness/run/reliability/run-agent.d.ts +86 -0
- package/dist/harness/run/reliability/run-agent.js +932 -0
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +80 -0
- package/dist/harness/run/reliability/run-metrics-collector.js +194 -0
- package/dist/harness/run/reliability/run-model-context.d.ts +19 -0
- package/dist/harness/run/reliability/run-model-context.js +32 -0
- package/dist/harness/run/run-guard/default-run-guard.d.ts +75 -0
- package/dist/harness/run/run-guard/default-run-guard.js +347 -0
- package/dist/harness/run/run-guard/index.d.ts +9 -0
- package/dist/harness/run/run-guard/index.js +8 -0
- package/dist/harness/run/run-scope.d.ts +81 -0
- package/dist/harness/run/run-scope.js +58 -0
- package/dist/harness/run/runner.d.ts +362 -0
- package/dist/harness/run/runner.js +1290 -0
- package/dist/harness/session/attachments/extract.d.ts +35 -0
- package/dist/harness/session/attachments/extract.js +72 -0
- package/dist/harness/session/attachments/index.d.ts +11 -0
- package/dist/harness/session/attachments/index.js +11 -0
- package/dist/harness/session/attachments/inject.d.ts +71 -0
- package/dist/harness/session/attachments/inject.js +142 -0
- package/dist/harness/session/attachments/intent.d.ts +32 -0
- package/dist/harness/session/attachments/intent.js +69 -0
- package/dist/harness/session/attachments/llm-intent.d.ts +17 -0
- package/dist/harness/session/attachments/llm-intent.js +74 -0
- package/dist/harness/session/attachments/paths.d.ts +15 -0
- package/dist/harness/session/attachments/paths.js +18 -0
- package/dist/harness/session/attachments/sanitize.d.ts +23 -0
- package/dist/harness/session/attachments/sanitize.js +55 -0
- package/dist/harness/session/attachments/service.d.ts +105 -0
- package/dist/harness/session/attachments/service.js +320 -0
- package/dist/harness/session/attachments/types.d.ts +64 -0
- package/dist/harness/session/attachments/types.js +17 -0
- package/dist/harness/session/compact.d.ts +23 -0
- package/dist/harness/session/compact.js +53 -0
- package/dist/harness/session/history/index.d.ts +4 -0
- package/dist/harness/session/history/index.js +3 -0
- package/dist/harness/session/history/port.d.ts +51 -0
- package/dist/harness/session/history/port.js +480 -0
- package/dist/harness/session/history/score.d.ts +71 -0
- package/dist/harness/session/history/score.js +225 -0
- package/dist/harness/session/history/types.d.ts +157 -0
- package/dist/harness/session/history/types.js +29 -0
- package/dist/harness/session/in-memory-store.d.ts +21 -0
- package/dist/harness/session/in-memory-store.js +48 -0
- package/dist/harness/session/index.d.ts +12 -0
- package/dist/harness/session/index.js +12 -0
- package/dist/harness/session/state-machine.d.ts +18 -0
- package/dist/harness/session/state-machine.js +31 -0
- package/dist/harness/session/tasks/index.d.ts +11 -0
- package/dist/harness/session/tasks/index.js +9 -0
- package/dist/harness/session/tasks/render.d.ts +12 -0
- package/dist/harness/session/tasks/render.js +57 -0
- package/dist/harness/session/tasks/service.d.ts +69 -0
- package/dist/harness/session/tasks/service.js +327 -0
- package/dist/harness/session/tasks/tools.d.ts +17 -0
- package/dist/harness/session/tasks/tools.js +210 -0
- package/dist/harness/session/tasks/types.d.ts +29 -0
- package/dist/harness/session/tasks/types.js +11 -0
- package/dist/harness/session/types.d.ts +88 -0
- package/dist/harness/session/types.js +7 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +264 -0
- package/dist/harness/shared/events/agent-event-map.js +51 -0
- package/dist/harness/shared/events/index.d.ts +6 -0
- package/dist/harness/shared/events/index.js +4 -0
- package/dist/harness/shared/events/scenario-events.d.ts +96 -0
- package/dist/harness/shared/events/scenario-events.js +7 -0
- package/dist/harness/shared/types/agent-definition.d.ts +51 -0
- package/dist/harness/shared/types/agent-definition.js +8 -0
- package/dist/harness/shared/types/hook-context.d.ts +10 -0
- package/dist/harness/shared/types/hook-context.js +6 -0
- package/dist/harness/shared/types/index.d.ts +7 -0
- package/dist/harness/shared/types/index.js +4 -0
- package/dist/harness/shared/types/queue-mode.d.ts +4 -0
- package/dist/harness/shared/types/queue-mode.js +1 -0
- package/dist/harness/shared/types/thinking-level.d.ts +4 -0
- package/dist/harness/shared/types/thinking-level.js +1 -0
- package/dist/index.d.ts +117 -0
- package/dist/index.js +80 -0
- package/dist/integration/agent-runtime/channel-message-source.d.ts +27 -0
- package/dist/integration/agent-runtime/channel-message-source.js +58 -0
- package/dist/integration/agent-runtime/file-watch-source.d.ts +31 -0
- package/dist/integration/agent-runtime/file-watch-source.js +63 -0
- package/dist/integration/agent-runtime/index.d.ts +6 -0
- package/dist/integration/agent-runtime/index.js +3 -0
- package/dist/integration/agent-runtime/webhook-source.d.ts +39 -0
- package/dist/integration/agent-runtime/webhook-source.js +112 -0
- package/dist/integration/index.d.ts +23 -0
- package/dist/integration/index.js +23 -0
- package/dist/integration/mcp/index.d.ts +6 -0
- package/dist/integration/mcp/index.js +6 -0
- package/dist/integration/mcp/sdk-client.d.ts +39 -0
- package/dist/integration/mcp/sdk-client.js +157 -0
- package/dist/integration/observability/exporters.d.ts +111 -0
- package/dist/integration/observability/exporters.js +167 -0
- package/dist/integration/observability/index.d.ts +21 -0
- package/dist/integration/observability/index.js +16 -0
- package/dist/integration/observability/log-observer.d.ts +12 -0
- package/dist/integration/observability/log-observer.js +59 -0
- package/dist/integration/observability/metrics.d.ts +116 -0
- package/dist/integration/observability/metrics.js +237 -0
- package/dist/integration/observability/noop-observer.d.ts +12 -0
- package/dist/integration/observability/noop-observer.js +22 -0
- package/dist/integration/observability/observer-bridge.d.ts +56 -0
- package/dist/integration/observability/observer-bridge.js +195 -0
- package/dist/integration/observability/run-telemetry.d.ts +28 -0
- package/dist/integration/observability/run-telemetry.js +83 -0
- package/dist/integration/observability/trace-collector.d.ts +124 -0
- package/dist/integration/observability/trace-collector.js +253 -0
- package/dist/integration/observability/trace-events.d.ts +69 -0
- package/dist/integration/observability/trace-events.js +83 -0
- package/dist/integration/observability/trace-logger.d.ts +110 -0
- package/dist/integration/observability/trace-logger.js +219 -0
- package/dist/integration/providers/anthropic.d.ts +92 -0
- package/dist/integration/providers/anthropic.js +432 -0
- package/dist/integration/providers/index.d.ts +4 -0
- package/dist/integration/providers/index.js +2 -0
- package/dist/integration/providers/openai.d.ts +120 -0
- package/dist/integration/providers/openai.js +429 -0
- package/dist/integration/providers/usage.d.ts +20 -0
- package/dist/integration/providers/usage.js +69 -0
- package/dist/integration/storage/archive-manager.d.ts +79 -0
- package/dist/integration/storage/archive-manager.js +223 -0
- package/dist/integration/storage/jsonl.d.ts +51 -0
- package/dist/integration/storage/jsonl.js +246 -0
- package/dist/integration/storage/memory.d.ts +7 -0
- package/dist/integration/storage/memory.js +7 -0
- package/dist/integration/storage/session-index.d.ts +57 -0
- package/dist/integration/storage/session-index.js +379 -0
- package/dist/integration/web-search/brave.d.ts +13 -0
- package/dist/integration/web-search/brave.js +64 -0
- package/dist/integration/web-search/duckduckgo.d.ts +12 -0
- package/dist/integration/web-search/duckduckgo.js +102 -0
- package/dist/integration/web-search/factory.d.ts +91 -0
- package/dist/integration/web-search/factory.js +166 -0
- package/dist/integration/web-search/http.d.ts +22 -0
- package/dist/integration/web-search/http.js +94 -0
- package/dist/integration/web-search/index.d.ts +16 -0
- package/dist/integration/web-search/index.js +9 -0
- package/dist/integration/web-search/mimo.d.ts +57 -0
- package/dist/integration/web-search/mimo.js +226 -0
- package/dist/integration/web-search/serper.d.ts +13 -0
- package/dist/integration/web-search/serper.js +59 -0
- package/dist/integration/web-search/tavily.d.ts +16 -0
- package/dist/integration/web-search/tavily.js +56 -0
- package/dist/paths.d.ts +14 -0
- package/dist/paths.js +22 -0
- package/dist/subsystems/memory-steward/backfill/SUBSYSTEM.md +30 -0
- package/dist/subsystems/memory-steward/backfill/config.yaml +51 -0
- package/dist/subsystems/memory-steward/backfill/handler.d.ts +18 -0
- package/dist/subsystems/memory-steward/backfill/handler.js +343 -0
- package/dist/subsystems/memory-steward/govern/SUBSYSTEM.md +12 -0
- package/dist/subsystems/memory-steward/govern/config.yaml +65 -0
- package/dist/subsystems/memory-steward/govern/handler.d.ts +19 -0
- package/dist/subsystems/memory-steward/govern/handler.js +79 -0
- package/dist/subsystems/safety-guard/SUBSYSTEM.md +60 -0
- package/dist/subsystems/safety-guard/config.yaml +40 -0
- package/package.json +110 -0
|
@@ -0,0 +1,1290 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SessionAwareRunner — Session 感知的运行器
|
|
3
|
+
*
|
|
4
|
+
* Harness 层组件。在 Agent.run()(自带 reliability)之上管理 Session 生命周期:
|
|
5
|
+
* - 消息持久化
|
|
6
|
+
* - Session 锁(同一 session 同时只有一个运行)
|
|
7
|
+
* - Daily reset / Idle reset
|
|
8
|
+
* - 并发控制
|
|
9
|
+
*
|
|
10
|
+
* Agent 是 Harness 运行时门面;不要再手拼 runAgentWithReliability。
|
|
11
|
+
*/
|
|
12
|
+
import { getTextContent } from '@octopi-agent/core/types.js';
|
|
13
|
+
import { createSessionStateMachine } from '../session/state-machine.js';
|
|
14
|
+
import { HeuristicTokenEstimator } from '../context/index.js';
|
|
15
|
+
import { extractLayerQuery } from '../context/layer-types.js';
|
|
16
|
+
import { withRuntimeEnvironmentInjection } from '../context/runtime-datetime.js';
|
|
17
|
+
import { renderSessionTasksInjection } from '../session/tasks/render.js';
|
|
18
|
+
import { createRunId } from './run-scope.js';
|
|
19
|
+
import { DEFAULT_TOOL_ISOLATION, resolveToolIsolationCwd, } from '../extension/execution-environment/isolation.js';
|
|
20
|
+
import { mkdirSync } from 'node:fs';
|
|
21
|
+
import { join } from 'node:path';
|
|
22
|
+
import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
|
|
23
|
+
import { readSessionCompact, writeSessionCompact } from '../session/compact.js';
|
|
24
|
+
import { InProcessSessionLock, } from './concurrency/session-lease.js';
|
|
25
|
+
const DEFAULT_CONFIG = {
|
|
26
|
+
sessionExpiryMs: 24 * 60 * 60 * 1000, // 24 小时
|
|
27
|
+
idleExpiryMs: 2 * 60 * 60 * 1000, // 2 小时
|
|
28
|
+
enableDailyReset: true,
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* 适配 HarnessLoopEvent → AgentEvent(向后兼容)
|
|
32
|
+
*
|
|
33
|
+
* HarnessLoopEvent = Loop 协议事件 + budget/run_guard 扩展。
|
|
34
|
+
* 旧消费者(Gateway/TUI)期望 AgentEvent。
|
|
35
|
+
* 此函数桥接两者,避免一次性更新所有下游。
|
|
36
|
+
*/
|
|
37
|
+
/**
|
|
38
|
+
* 将 Loop yield 事件适配为 EventBus 信封(向后兼容词表)
|
|
39
|
+
*
|
|
40
|
+
* @param event - HarnessLoopEvent
|
|
41
|
+
* @param meta - agentId / sessionId
|
|
42
|
+
* @param state - 桥接过程中的可变状态(assistant 文本等)
|
|
43
|
+
* @returns AgentEvent;不广播时返回 null
|
|
44
|
+
*
|
|
45
|
+
* 导出供桥接映射测试使用;生产调用方仍为 SessionAwareRunner.handle。
|
|
46
|
+
*/
|
|
47
|
+
export function adaptLoopEvent(event, meta, state) {
|
|
48
|
+
switch (event.type) {
|
|
49
|
+
case 'run_guard_metrics':
|
|
50
|
+
return {
|
|
51
|
+
type: 'run.guard.metrics',
|
|
52
|
+
timestamp: event.timestamp,
|
|
53
|
+
agentId: meta.agentId,
|
|
54
|
+
sessionId: meta.sessionId,
|
|
55
|
+
data: { ...event.data },
|
|
56
|
+
};
|
|
57
|
+
case 'security_blocked':
|
|
58
|
+
// 跟踪停止原因:security
|
|
59
|
+
state.stopReason = 'security_stopped';
|
|
60
|
+
return {
|
|
61
|
+
type: 'security.blocked',
|
|
62
|
+
timestamp: event.timestamp,
|
|
63
|
+
agentId: meta.agentId,
|
|
64
|
+
sessionId: meta.sessionId,
|
|
65
|
+
data: { ...event.data },
|
|
66
|
+
};
|
|
67
|
+
case 'agent_start':
|
|
68
|
+
return { type: 'engine.start', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: {} };
|
|
69
|
+
case 'agent_end':
|
|
70
|
+
// reason='error' 时映射为 engine.error(向后兼容旧引擎行为)
|
|
71
|
+
if (event.reason === 'error') {
|
|
72
|
+
return { type: 'engine.error', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: { error: event.error instanceof Error ? event.error.message : String(event.error ?? 'Unknown error') } };
|
|
73
|
+
}
|
|
74
|
+
return { type: 'engine.end', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: { reason: event.reason } };
|
|
75
|
+
case 'turn_start':
|
|
76
|
+
// 必须带 session 元数据:gatewayBus.onAll 以 event.sessionId 为 WS 广播前提
|
|
77
|
+
return { type: 'iteration.start', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: {} };
|
|
78
|
+
case 'assistant_message':
|
|
79
|
+
state.assistantContent = typeof event.message.content === 'string' ? event.message.content : '';
|
|
80
|
+
return null;
|
|
81
|
+
case 'turn_end':
|
|
82
|
+
// phase 透传给 UI:pre_tools ≠ 本轮 run 结束(见 architecture.md)
|
|
83
|
+
return {
|
|
84
|
+
type: 'turn.end',
|
|
85
|
+
timestamp: Date.now(),
|
|
86
|
+
agentId: meta.agentId,
|
|
87
|
+
sessionId: meta.sessionId,
|
|
88
|
+
data: {
|
|
89
|
+
content: state.assistantContent,
|
|
90
|
+
userText: state.lastUserContent ?? '',
|
|
91
|
+
hasToolCalls: event.hasToolCalls,
|
|
92
|
+
phase: event.phase,
|
|
93
|
+
usage: event.usage,
|
|
94
|
+
truncated: event.truncated,
|
|
95
|
+
error: event.error,
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
case 'llm_stream_delta':
|
|
99
|
+
return { type: 'llm_stream_delta', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: event.data };
|
|
100
|
+
case 'tool_start':
|
|
101
|
+
return { type: 'tool.exec.start', timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: { toolCallId: event.toolCall.id, toolName: event.toolCall.name, args: event.toolCall.arguments } };
|
|
102
|
+
case 'tool_end':
|
|
103
|
+
return {
|
|
104
|
+
type: 'tool.exec.end',
|
|
105
|
+
timestamp: event.timestamp,
|
|
106
|
+
agentId: meta.agentId,
|
|
107
|
+
sessionId: meta.sessionId,
|
|
108
|
+
data: {
|
|
109
|
+
toolCallId: event.toolCall.id,
|
|
110
|
+
toolName: event.toolCall.name,
|
|
111
|
+
args: event.toolCall.arguments,
|
|
112
|
+
hasError: !!event.result.isError,
|
|
113
|
+
result: event.result.content,
|
|
114
|
+
durationMs: event.result.durationMs,
|
|
115
|
+
},
|
|
116
|
+
};
|
|
117
|
+
case 'stream.fallback_to_sync':
|
|
118
|
+
case 'stream.fallback_failed':
|
|
119
|
+
// 必须带 session 元数据:gatewayBus.onAll 以 event.sessionId 为 WS 广播前提
|
|
120
|
+
return { type: event.type, timestamp: event.timestamp, agentId: meta.agentId, sessionId: meta.sessionId, data: event.data };
|
|
121
|
+
case 'budget_exceeded':
|
|
122
|
+
// 对齐 EventBus BUDGET_EXCEEDED;用户可见停止原因
|
|
123
|
+
return {
|
|
124
|
+
type: 'budget.exceeded',
|
|
125
|
+
timestamp: event.timestamp,
|
|
126
|
+
agentId: meta.agentId,
|
|
127
|
+
sessionId: meta.sessionId,
|
|
128
|
+
data: { ...event.data },
|
|
129
|
+
};
|
|
130
|
+
// P2 BudgetControlEvent 新形状
|
|
131
|
+
case 'budget.wrap_up':
|
|
132
|
+
return {
|
|
133
|
+
type: 'budget.wrap_up',
|
|
134
|
+
timestamp: event.timestamp,
|
|
135
|
+
agentId: meta.agentId,
|
|
136
|
+
sessionId: meta.sessionId,
|
|
137
|
+
data: {
|
|
138
|
+
metric: event.metric,
|
|
139
|
+
unit: event.unit,
|
|
140
|
+
used: event.used,
|
|
141
|
+
hard: event.hard,
|
|
142
|
+
userMessage: event.userMessage,
|
|
143
|
+
resumeHint: event.resumeHint,
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
case 'budget.exceeded':
|
|
147
|
+
// 跟踪停止原因:context / policy
|
|
148
|
+
state.stopReason = event.metric === 'context' ? 'context_stopped' : 'policy_stopped';
|
|
149
|
+
return {
|
|
150
|
+
type: 'budget.exceeded',
|
|
151
|
+
timestamp: event.timestamp,
|
|
152
|
+
agentId: meta.agentId,
|
|
153
|
+
sessionId: meta.sessionId,
|
|
154
|
+
data: {
|
|
155
|
+
metric: event.metric,
|
|
156
|
+
userMessage: event.userMessage,
|
|
157
|
+
resumeHint: event.resumeHint,
|
|
158
|
+
},
|
|
159
|
+
};
|
|
160
|
+
case 'run_guard_stopped':
|
|
161
|
+
// 跟踪停止原因:behavior
|
|
162
|
+
state.stopReason = 'behavior_stopped';
|
|
163
|
+
return {
|
|
164
|
+
type: 'run_guard.stopped',
|
|
165
|
+
timestamp: event.timestamp,
|
|
166
|
+
agentId: meta.agentId,
|
|
167
|
+
sessionId: meta.sessionId,
|
|
168
|
+
data: { ...event.data },
|
|
169
|
+
};
|
|
170
|
+
case 'run_guard_recovered':
|
|
171
|
+
return {
|
|
172
|
+
type: 'run_guard.recovered',
|
|
173
|
+
timestamp: event.timestamp,
|
|
174
|
+
agentId: meta.agentId,
|
|
175
|
+
sessionId: meta.sessionId,
|
|
176
|
+
data: { ...event.data },
|
|
177
|
+
};
|
|
178
|
+
case 'usage.advisory':
|
|
179
|
+
return {
|
|
180
|
+
type: 'usage.advisory',
|
|
181
|
+
timestamp: event.timestamp,
|
|
182
|
+
agentId: meta.agentId,
|
|
183
|
+
sessionId: meta.sessionId,
|
|
184
|
+
data: {
|
|
185
|
+
metric: event.metric,
|
|
186
|
+
unit: event.unit,
|
|
187
|
+
used: event.used,
|
|
188
|
+
hard: event.hard,
|
|
189
|
+
userMessage: event.userMessage,
|
|
190
|
+
},
|
|
191
|
+
};
|
|
192
|
+
default:
|
|
193
|
+
return null;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* SessionAwareRunner
|
|
198
|
+
*/
|
|
199
|
+
export class SessionAwareRunner {
|
|
200
|
+
agent;
|
|
201
|
+
harness;
|
|
202
|
+
store;
|
|
203
|
+
/** Session lease(E2/E7):默认 in-process FIFO;可替换 */
|
|
204
|
+
sessionLease;
|
|
205
|
+
config;
|
|
206
|
+
/** Session 状态机缓存 */
|
|
207
|
+
stateMachines = new Map();
|
|
208
|
+
/** 自主子系统运行时 */
|
|
209
|
+
_subsystemRuntime;
|
|
210
|
+
_backfillTrigger;
|
|
211
|
+
_memoryHealthProbe;
|
|
212
|
+
/** EventBus 引用(用于子系统/多 Agent 上下文) */
|
|
213
|
+
_events;
|
|
214
|
+
/** 产品 Observer Hub(Run 现场;可选) */
|
|
215
|
+
_observerHub;
|
|
216
|
+
/** 工具运行时上下文提供者 */
|
|
217
|
+
toolContextProvider;
|
|
218
|
+
/** 文件式 persona 的 run 时解析器;每次 handle 前解析,实现热更新 */
|
|
219
|
+
systemPromptResolver;
|
|
220
|
+
/** 最后一次成功解析的纯 persona(不含 injectedContext),用于 resolver 失败时的干净回退 */
|
|
221
|
+
lastCleanPersonaPrompt;
|
|
222
|
+
/** 按层契约组装 system prompt(persona + runtime);未设置时退回字符串拼接 */
|
|
223
|
+
systemPromptAssembler;
|
|
224
|
+
/** 会话重置时清理 Assembler 层缓存 */
|
|
225
|
+
systemPromptAssemblerClear;
|
|
226
|
+
/** turn 级 Knowledge grounding(可选;arch/knowledge-layer.md §4.4) */
|
|
227
|
+
groundingAssembler;
|
|
228
|
+
/** 模型快照解析器(Gateway 注入;每 run 只调一次) */
|
|
229
|
+
resolveModelOverride;
|
|
230
|
+
constructor(agent, harness, store, config) {
|
|
231
|
+
this.agent = agent;
|
|
232
|
+
this.harness = harness;
|
|
233
|
+
this.store = store;
|
|
234
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
235
|
+
this.sessionLease = config?.sessionLease ?? new InProcessSessionLock();
|
|
236
|
+
this._events = config?.events;
|
|
237
|
+
this._observerHub = config?.observerHub;
|
|
238
|
+
this.resolveModelOverride = config?.resolveModelOverride;
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* 注入 Observer Hub(Gateway / 测试用)
|
|
242
|
+
*
|
|
243
|
+
* @param hub - ObserverHub 实例
|
|
244
|
+
*/
|
|
245
|
+
setObserverHub(hub) {
|
|
246
|
+
this._observerHub = hub;
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* 发射事件:先采 Observer Hub,再进 EventBus(协调总线)
|
|
250
|
+
*/
|
|
251
|
+
emitObserved(event) {
|
|
252
|
+
try {
|
|
253
|
+
this._observerHub?.ingestEvent(event);
|
|
254
|
+
}
|
|
255
|
+
catch {
|
|
256
|
+
// 观测 fail-open:不阻断事件广播
|
|
257
|
+
}
|
|
258
|
+
this._events?.emit(event);
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* 注入模型快照解析器(Gateway 在 buildAgent 后调用)
|
|
262
|
+
*
|
|
263
|
+
* @param resolver - modelRef → ResolvedModel
|
|
264
|
+
*/
|
|
265
|
+
setModelResolver(resolver) {
|
|
266
|
+
this.resolveModelOverride = resolver;
|
|
267
|
+
}
|
|
268
|
+
/**
|
|
269
|
+
* 提取 run 级 modelRef
|
|
270
|
+
*
|
|
271
|
+
* 优先级:
|
|
272
|
+
* 1. 消息级覆盖(RunConfig.model,仅当调用方显式传入)
|
|
273
|
+
* 2. 会话覆盖(session.metadata.model)
|
|
274
|
+
* 3. undefined → Resolver 按 agent 默认解析
|
|
275
|
+
*
|
|
276
|
+
* **不要**把 agent 默认模型写进 RunConfig.model,否则会吞掉会话覆盖。
|
|
277
|
+
*/
|
|
278
|
+
readRunModelRef(session, runConfig) {
|
|
279
|
+
const fromRun = runConfig.model?.trim() || undefined;
|
|
280
|
+
const sessionMetaModel = session.metadata?.model;
|
|
281
|
+
let fromSession;
|
|
282
|
+
if (typeof sessionMetaModel === 'string') {
|
|
283
|
+
fromSession = sessionMetaModel.trim() || undefined;
|
|
284
|
+
}
|
|
285
|
+
else if (sessionMetaModel && typeof sessionMetaModel === 'object') {
|
|
286
|
+
const obj = sessionMetaModel;
|
|
287
|
+
if (typeof obj.model === 'string' && obj.model) {
|
|
288
|
+
fromSession = typeof obj.provider === 'string' && obj.provider
|
|
289
|
+
? `${obj.provider}/${obj.model}`
|
|
290
|
+
: obj.model;
|
|
291
|
+
}
|
|
292
|
+
}
|
|
293
|
+
return fromRun || fromSession || undefined;
|
|
294
|
+
}
|
|
295
|
+
/** 设置自主子系统运行时 */
|
|
296
|
+
setSubsystemRuntime(runtime) {
|
|
297
|
+
this._subsystemRuntime = runtime;
|
|
298
|
+
}
|
|
299
|
+
/** 补录触发协调器(idle 漂移 / 硬收敛快照) */
|
|
300
|
+
setBackfillTrigger(trigger) {
|
|
301
|
+
this._backfillTrigger?.dispose();
|
|
302
|
+
this._backfillTrigger = trigger;
|
|
303
|
+
}
|
|
304
|
+
/** health 探测(govern 双脉搏) */
|
|
305
|
+
setMemoryHealthProbe(probe) {
|
|
306
|
+
this._memoryHealthProbe?.stop();
|
|
307
|
+
this._memoryHealthProbe = probe;
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* 释放 Runner 侧后台定时器/监听(BackfillTrigger / HealthProbe / SubsystemRuntime)。
|
|
311
|
+
* Gateway 热重建 agent 或进程内多次 build 时必须调用,否则 timer 泄漏、重复 emit。
|
|
312
|
+
*/
|
|
313
|
+
dispose() {
|
|
314
|
+
this._backfillTrigger?.dispose();
|
|
315
|
+
this._backfillTrigger = undefined;
|
|
316
|
+
this._memoryHealthProbe?.stop();
|
|
317
|
+
this._memoryHealthProbe = undefined;
|
|
318
|
+
this._subsystemRuntime?.dispose();
|
|
319
|
+
this._subsystemRuntime = undefined;
|
|
320
|
+
}
|
|
321
|
+
/** 设置工具运行时上下文提供者 */
|
|
322
|
+
setToolContextProvider(provider) {
|
|
323
|
+
this.toolContextProvider = provider;
|
|
324
|
+
}
|
|
325
|
+
/**
|
|
326
|
+
* 设置 persona 解析器
|
|
327
|
+
*
|
|
328
|
+
* 每次 handle 且 RunConfig.systemPrompt 为空时调用;
|
|
329
|
+
* 文件变更后下一轮自动生效,无需重启。
|
|
330
|
+
*
|
|
331
|
+
* @param resolver - 从磁盘解析纯 persona
|
|
332
|
+
* @param initialCleanPersona - build 时读到的磁盘 persona(可能为 '');
|
|
333
|
+
* 用于区分「从未有人格文件」(保留默认 tools prompt)与「有过后被删空」(热删除清空)
|
|
334
|
+
*/
|
|
335
|
+
setSystemPromptResolver(resolver, initialCleanPersona = '') {
|
|
336
|
+
this.systemPromptResolver = resolver;
|
|
337
|
+
// 仅首次挂 resolver 时播种;替换 resolver 不得用可能被 injectedContext 污染的 context 覆盖
|
|
338
|
+
if (this.lastCleanPersonaPrompt === undefined) {
|
|
339
|
+
this.lastCleanPersonaPrompt = initialCleanPersona;
|
|
340
|
+
}
|
|
341
|
+
}
|
|
342
|
+
/**
|
|
343
|
+
* 设置 system prompt 层装配器
|
|
344
|
+
*
|
|
345
|
+
* 每轮在 persona resolve 与 injectedContext 计算完成后调用,
|
|
346
|
+
* 替代原先的字符串拼接。未设置时保持旧路径(兼容)。
|
|
347
|
+
*/
|
|
348
|
+
setSystemPromptAssembler(assembler, clearSession) {
|
|
349
|
+
this.systemPromptAssembler = assembler;
|
|
350
|
+
this.systemPromptAssemblerClear = clearSession;
|
|
351
|
+
}
|
|
352
|
+
/**
|
|
353
|
+
* 注入 turn 级 Knowledge grounding(可选)
|
|
354
|
+
*/
|
|
355
|
+
setGroundingAssembler(assembler) {
|
|
356
|
+
this.groundingAssembler = assembler;
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
359
|
+
* 处理一条消息
|
|
360
|
+
*
|
|
361
|
+
* @param sessionId - Session 标识
|
|
362
|
+
* @param input - 用户输入消息
|
|
363
|
+
* @param runConfig - Agent 运行配置
|
|
364
|
+
* @param signal - 中止信号
|
|
365
|
+
* @yields AgentEvent 事件流(向后兼容格式)
|
|
366
|
+
*/
|
|
367
|
+
async *handle(sessionId, input, runConfig, signal) {
|
|
368
|
+
// 1. 并发门控(如果配置了 SessionGate);排队期间响应 abort
|
|
369
|
+
const gate = this.config.sessionGate;
|
|
370
|
+
let gateRelease;
|
|
371
|
+
if (gate) {
|
|
372
|
+
try {
|
|
373
|
+
gateRelease = await gate.enter(signal);
|
|
374
|
+
}
|
|
375
|
+
catch (err) {
|
|
376
|
+
// 用户中止:空 generator,Runtime 按 signal.aborted 判 skipped(aborted),勿成 failed
|
|
377
|
+
if (signal?.aborted) {
|
|
378
|
+
return;
|
|
379
|
+
}
|
|
380
|
+
throw err;
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
// 2. 获取锁(等锁期间响应 abort;被中止则不进入 Run)
|
|
384
|
+
let release;
|
|
385
|
+
try {
|
|
386
|
+
release = await this.acquireLock(sessionId, signal);
|
|
387
|
+
}
|
|
388
|
+
catch (err) {
|
|
389
|
+
if (signal?.aborted) {
|
|
390
|
+
gateRelease?.();
|
|
391
|
+
return;
|
|
392
|
+
}
|
|
393
|
+
throw err;
|
|
394
|
+
}
|
|
395
|
+
// 拿锁后若已中止:不 load / 不 push,避免幽灵用户消息(arch/agent-runtime.md 审查项)
|
|
396
|
+
if (signal?.aborted) {
|
|
397
|
+
release();
|
|
398
|
+
gateRelease?.();
|
|
399
|
+
return;
|
|
400
|
+
}
|
|
401
|
+
const _agentId = runConfig.agentId ?? 'default';
|
|
402
|
+
/** Observer 收口状态(finally 统一关闭,含异常路径) */
|
|
403
|
+
let observerRunId = '';
|
|
404
|
+
let observerFinalMessages;
|
|
405
|
+
let observerEndReason;
|
|
406
|
+
let observerErrorMsg;
|
|
407
|
+
let hasTurnEnd = false;
|
|
408
|
+
try {
|
|
409
|
+
// 3. 加载或创建 session
|
|
410
|
+
let session = await this.store.load(sessionId);
|
|
411
|
+
if (!session) {
|
|
412
|
+
session = this.createSession(sessionId, runConfig.agentId ?? 'default');
|
|
413
|
+
}
|
|
414
|
+
// 模型 2:历史数据缺省 primary 时回填(单 agent 行为不变)
|
|
415
|
+
if (!session.primaryAgentId) {
|
|
416
|
+
session.primaryAgentId = session.agentId || _agentId;
|
|
417
|
+
}
|
|
418
|
+
if (!session.tasks)
|
|
419
|
+
session.tasks = [];
|
|
420
|
+
// E6:可选 ACL(注入时才强制);primary 自动 owner;带入 agent 天花板
|
|
421
|
+
const acl = this.config.sessionAcl;
|
|
422
|
+
if (acl) {
|
|
423
|
+
const auth = acl.authorizeRun({
|
|
424
|
+
session,
|
|
425
|
+
agentId: _agentId,
|
|
426
|
+
agentMax: this.config.agentMaxSessionRights,
|
|
427
|
+
});
|
|
428
|
+
if (!auth.ok) {
|
|
429
|
+
yield {
|
|
430
|
+
type: 'engine.error',
|
|
431
|
+
timestamp: Date.now(),
|
|
432
|
+
agentId: _agentId,
|
|
433
|
+
sessionId,
|
|
434
|
+
data: { error: auth.reason ?? 'session ACL denied run' },
|
|
435
|
+
};
|
|
436
|
+
return;
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
// 4. 检查 session 是否需要重置
|
|
440
|
+
this.checkSessionReset(session);
|
|
441
|
+
// 4b. 绑定会话任务服务(工具与注入共用同一内存对象)
|
|
442
|
+
this.config.sessionTaskService?.attachSession(session);
|
|
443
|
+
// 5. 追加用户消息
|
|
444
|
+
session.messages.push(input);
|
|
445
|
+
session.meta.lastInteractionAt = Date.now();
|
|
446
|
+
session.meta.updatedAt = Date.now();
|
|
447
|
+
this._backfillTrigger?.noteActivity(sessionId, _agentId, session.meta.lastInteractionAt);
|
|
448
|
+
// 通知子系统:主会话生命周期态(通用)
|
|
449
|
+
this.emitObserved({
|
|
450
|
+
type: 'session.lifecycle.updated',
|
|
451
|
+
timestamp: Date.now(),
|
|
452
|
+
agentId: _agentId,
|
|
453
|
+
sessionId,
|
|
454
|
+
data: {
|
|
455
|
+
lifecycle: 'active',
|
|
456
|
+
lastInteractionAt: session.meta.lastInteractionAt,
|
|
457
|
+
},
|
|
458
|
+
});
|
|
459
|
+
// 状态机:→ processing
|
|
460
|
+
// 持锁后无并发 handle;processing/error 残留来自崩溃或异常退出,先恢复再进入
|
|
461
|
+
const sm = this.getOrCreateStateMachine(sessionId, session.meta.status);
|
|
462
|
+
if (!sm.canTransition('processing')) {
|
|
463
|
+
if (sm.canTransition('idle')) {
|
|
464
|
+
sm.transition('idle');
|
|
465
|
+
}
|
|
466
|
+
else {
|
|
467
|
+
sm.force('idle');
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
sm.transition('processing');
|
|
471
|
+
session.meta.status = sm.state;
|
|
472
|
+
// 6. 会话任务注入
|
|
473
|
+
let effectiveRunConfig = runConfig;
|
|
474
|
+
if (this.config.sessionTaskService) {
|
|
475
|
+
const taskInjection = renderSessionTasksInjection(session.tasks ?? []);
|
|
476
|
+
if (taskInjection) {
|
|
477
|
+
const baseInjected = runConfig.injectedContext;
|
|
478
|
+
effectiveRunConfig = {
|
|
479
|
+
...runConfig,
|
|
480
|
+
injectedContext: baseInjected ? `${baseInjected}\n\n${taskInjection}` : taskInjection,
|
|
481
|
+
};
|
|
482
|
+
}
|
|
483
|
+
}
|
|
484
|
+
// 7. 应用自主子系统的待处理注入
|
|
485
|
+
if (this._subsystemRuntime) {
|
|
486
|
+
if (this._events) {
|
|
487
|
+
this._subsystemRuntime.setMainAgentContext({
|
|
488
|
+
messages: session.messages,
|
|
489
|
+
runConfig: effectiveRunConfig,
|
|
490
|
+
events: this._events,
|
|
491
|
+
sessionLifecycle: session.lifecycle?.lifecycle ?? 'active',
|
|
492
|
+
lastInteractionAt: session.meta.lastInteractionAt,
|
|
493
|
+
idleMs: Date.now() - (session.meta.lastInteractionAt ?? Date.now()),
|
|
494
|
+
extractionStatus: 'pending',
|
|
495
|
+
});
|
|
496
|
+
// 注入指标
|
|
497
|
+
this._subsystemRuntime.metrics.update('turn.count', session.messages.filter(m => m.role === 'assistant').length);
|
|
498
|
+
}
|
|
499
|
+
this._subsystemRuntime.applyPendingInjections(session.messages);
|
|
500
|
+
// steering / escalate:当前轮次立即生效(escalate 优先,写入 injectedContext)
|
|
501
|
+
const guidance = this._subsystemRuntime.consumePendingGuidance();
|
|
502
|
+
if (guidance) {
|
|
503
|
+
const base = effectiveRunConfig.injectedContext;
|
|
504
|
+
effectiveRunConfig = {
|
|
505
|
+
...effectiveRunConfig,
|
|
506
|
+
injectedContext: base ? `${base}\n\n${guidance}` : guidance,
|
|
507
|
+
};
|
|
508
|
+
}
|
|
509
|
+
}
|
|
510
|
+
// Runtime 锚点:时间 + 工具工作目录(模型据此优先在 workspace 找文件,而非全盘扫)
|
|
511
|
+
// cwd 与下方 I5 toolRuntime.cwd 同源同构,保证 system prompt 与工具解析一致
|
|
512
|
+
{
|
|
513
|
+
const runtimeIsolationMode = effectiveRunConfig.toolIsolation
|
|
514
|
+
?? this.config.toolIsolation
|
|
515
|
+
?? DEFAULT_TOOL_ISOLATION;
|
|
516
|
+
const runtimeBaseCwd = (effectiveRunConfig.cwd?.trim() ? effectiveRunConfig.cwd.trim() : undefined)
|
|
517
|
+
?? (this.config.agentWorkspace?.trim() ? this.config.agentWorkspace.trim() : undefined);
|
|
518
|
+
const runtimeCwd = resolveToolIsolationCwd({
|
|
519
|
+
mode: runtimeIsolationMode,
|
|
520
|
+
sessionId,
|
|
521
|
+
baseCwd: runtimeBaseCwd,
|
|
522
|
+
}).cwd;
|
|
523
|
+
effectiveRunConfig = {
|
|
524
|
+
...effectiveRunConfig,
|
|
525
|
+
injectedContext: withRuntimeEnvironmentInjection(effectiveRunConfig.injectedContext, {
|
|
526
|
+
cwd: runtimeCwd,
|
|
527
|
+
}),
|
|
528
|
+
};
|
|
529
|
+
}
|
|
530
|
+
// 8. 工具运行时:setRuntime 仅作无 ALS 时的回退;权威身份在 RunScope
|
|
531
|
+
if (this.toolContextProvider) {
|
|
532
|
+
this.toolContextProvider.setRuntime(sessionId, _agentId, session.messages);
|
|
533
|
+
}
|
|
534
|
+
// 9. 本 Run 私有 AgentContext(宪法 I1)——禁止写入共享 agent.context.messages
|
|
535
|
+
const runContext = {
|
|
536
|
+
systemPrompt: '',
|
|
537
|
+
messages: session.messages,
|
|
538
|
+
tools: this.agent.tools,
|
|
539
|
+
};
|
|
540
|
+
// 播种压缩状态(E4 键 = sessionId × agentId);供 convertToLlm / 重启重建
|
|
541
|
+
this.agent.setSessionCompactState(sessionId, _agentId, readSessionCompact(session, _agentId));
|
|
542
|
+
let basePrompt = effectiveRunConfig.systemPrompt;
|
|
543
|
+
let personaFromResolver = false;
|
|
544
|
+
if (!basePrompt && this.systemPromptResolver) {
|
|
545
|
+
try {
|
|
546
|
+
const resolved = await this.systemPromptResolver();
|
|
547
|
+
const previouslyHadPersona = (this.lastCleanPersonaPrompt ?? '') !== '';
|
|
548
|
+
this.lastCleanPersonaPrompt = resolved;
|
|
549
|
+
if (resolved) {
|
|
550
|
+
// 有 persona:同步到 Agent / SecurityGuard(模板级,非「当前会话」)
|
|
551
|
+
this.agent.setSystemPrompt(resolved);
|
|
552
|
+
this.harness.security?.setSystemPrompt?.(resolved);
|
|
553
|
+
basePrompt = resolved;
|
|
554
|
+
personaFromResolver = true;
|
|
555
|
+
}
|
|
556
|
+
else if (previouslyHadPersona) {
|
|
557
|
+
// 热删除:曾有内容、现被删空 → 显式清空
|
|
558
|
+
this.agent.setSystemPrompt('');
|
|
559
|
+
this.harness.security?.setSystemPrompt?.('');
|
|
560
|
+
basePrompt = '';
|
|
561
|
+
personaFromResolver = true;
|
|
562
|
+
}
|
|
563
|
+
else {
|
|
564
|
+
// 从未有 persona 文件:保留 build 时的 fallback(如默认 tools prompt),不视为失败
|
|
565
|
+
basePrompt = '';
|
|
566
|
+
personaFromResolver = false;
|
|
567
|
+
}
|
|
568
|
+
}
|
|
569
|
+
catch (err) {
|
|
570
|
+
// 仅磁盘读失败:回退到上次成功的纯 persona,避免吃到 injectedContext 拼接结果
|
|
571
|
+
const errMsg = err instanceof Error ? err.message : String(err);
|
|
572
|
+
console.warn(`[octopi] persona resolve failed (agent=${_agentId} session=${sessionId}): ${errMsg}; falling back to last clean persona`);
|
|
573
|
+
this.emitObserved({
|
|
574
|
+
type: 'persona.resolve.failed',
|
|
575
|
+
timestamp: Date.now(),
|
|
576
|
+
agentId: _agentId,
|
|
577
|
+
sessionId,
|
|
578
|
+
data: { error: errMsg },
|
|
579
|
+
});
|
|
580
|
+
basePrompt = this.lastCleanPersonaPrompt ?? effectiveRunConfig.systemPrompt ?? '';
|
|
581
|
+
}
|
|
582
|
+
}
|
|
583
|
+
if (!basePrompt && !personaFromResolver) {
|
|
584
|
+
basePrompt = effectiveRunConfig.systemPrompt || this.agent.context.systemPrompt || '';
|
|
585
|
+
}
|
|
586
|
+
// ── Run 级模型快照:每 run 只 resolve 一次(必须在 system assembler 之前)──
|
|
587
|
+
const modelRef = this.readRunModelRef(session, effectiveRunConfig);
|
|
588
|
+
const resolvedModel = this.resolveModelOverride
|
|
589
|
+
? this.resolveModelOverride({
|
|
590
|
+
modelRef,
|
|
591
|
+
defaultProvider: effectiveRunConfig.modelProvider,
|
|
592
|
+
})
|
|
593
|
+
: null;
|
|
594
|
+
if (resolvedModel) {
|
|
595
|
+
effectiveRunConfig = {
|
|
596
|
+
...effectiveRunConfig,
|
|
597
|
+
contextWindow: resolvedModel.contextWindow,
|
|
598
|
+
model: resolvedModel.modelName,
|
|
599
|
+
};
|
|
600
|
+
}
|
|
601
|
+
// system prompt 终装:Assembler(层契约)优先,否则退回字符串拼接
|
|
602
|
+
// 结果只写入 runContext / RunScope,不作为「Agent 当前会话状态」
|
|
603
|
+
if (this.systemPromptAssembler) {
|
|
604
|
+
try {
|
|
605
|
+
const assembled = await this.systemPromptAssembler({
|
|
606
|
+
sessionId,
|
|
607
|
+
agentId: _agentId,
|
|
608
|
+
messages: session.messages,
|
|
609
|
+
persona: basePrompt,
|
|
610
|
+
injectedContext: effectiveRunConfig.injectedContext,
|
|
611
|
+
contextWindow: effectiveRunConfig.contextWindow,
|
|
612
|
+
signal,
|
|
613
|
+
});
|
|
614
|
+
runContext.systemPrompt = assembled.systemPrompt;
|
|
615
|
+
if (assembled.manifest) {
|
|
616
|
+
const assembledAt = Date.now();
|
|
617
|
+
this.emitObserved({
|
|
618
|
+
type: 'context.layers.assembled',
|
|
619
|
+
timestamp: assembledAt,
|
|
620
|
+
agentId: _agentId,
|
|
621
|
+
sessionId,
|
|
622
|
+
data: {
|
|
623
|
+
sessionId,
|
|
624
|
+
agentId: _agentId,
|
|
625
|
+
manifest: assembled.manifest,
|
|
626
|
+
enabledLayerIds: assembled.manifest.layers.map((l) => l.id),
|
|
627
|
+
query: extractLayerQuery(session.messages),
|
|
628
|
+
assembledAt,
|
|
629
|
+
},
|
|
630
|
+
});
|
|
631
|
+
}
|
|
632
|
+
}
|
|
633
|
+
catch (err) {
|
|
634
|
+
// 装配失败:回退拼接,保证本轮可跑
|
|
635
|
+
const errMsg = err instanceof Error ? err.message : String(err);
|
|
636
|
+
console.warn(`[octopi] system prompt assemble failed (session=${sessionId}): ${errMsg}; falling back to concat`);
|
|
637
|
+
runContext.systemPrompt = this.concatSystemPrompt(basePrompt, effectiveRunConfig.injectedContext, personaFromResolver);
|
|
638
|
+
this.emitObserved({
|
|
639
|
+
type: 'context.layers.assembled',
|
|
640
|
+
timestamp: Date.now(),
|
|
641
|
+
agentId: _agentId,
|
|
642
|
+
sessionId,
|
|
643
|
+
data: {
|
|
644
|
+
sessionId,
|
|
645
|
+
agentId: _agentId,
|
|
646
|
+
manifest: {
|
|
647
|
+
sessionId,
|
|
648
|
+
systemBudget: 0,
|
|
649
|
+
usedTokens: 0,
|
|
650
|
+
shares: {},
|
|
651
|
+
layers: [],
|
|
652
|
+
},
|
|
653
|
+
fallback: true,
|
|
654
|
+
fallbackError: errMsg,
|
|
655
|
+
assembledAt: Date.now(),
|
|
656
|
+
},
|
|
657
|
+
});
|
|
658
|
+
}
|
|
659
|
+
}
|
|
660
|
+
else {
|
|
661
|
+
runContext.systemPrompt = this.concatSystemPrompt(basePrompt, effectiveRunConfig.injectedContext, personaFromResolver);
|
|
662
|
+
}
|
|
663
|
+
// system prompt 终装后:turn 级 Knowledge grounding(消息侧插槽,不进 system)
|
|
664
|
+
// 先算 pack;写入 runScope / 插入消息在 runScope 创建之后
|
|
665
|
+
let pendingGrounding = null;
|
|
666
|
+
if (this.groundingAssembler) {
|
|
667
|
+
try {
|
|
668
|
+
pendingGrounding = await this.groundingAssembler({
|
|
669
|
+
sessionId,
|
|
670
|
+
agentId: _agentId,
|
|
671
|
+
messages: session.messages,
|
|
672
|
+
});
|
|
673
|
+
}
|
|
674
|
+
catch (gErr) {
|
|
675
|
+
const gMsg = gErr instanceof Error ? gErr.message : String(gErr);
|
|
676
|
+
console.warn(`[octopi] knowledge grounding failed (session=${sessionId}): ${gMsg}`);
|
|
677
|
+
pendingGrounding = null;
|
|
678
|
+
}
|
|
679
|
+
}
|
|
680
|
+
// 更新 harness 的 sessionId/agentId(checkpoint 回退;权威身份在 RunScope ALS)
|
|
681
|
+
this.harness.sessionId = sessionId;
|
|
682
|
+
this.harness.agentId = effectiveRunConfig.agentId ?? 'default';
|
|
683
|
+
// 兼容回退:无 ALS 消费方时的 contextSessionId(Map 键场景仍用显式 sessionId)
|
|
684
|
+
this.agent.setContextSessionId(sessionId);
|
|
685
|
+
// I5:工具效应 cwd —— RunConfig.cwd > agent.workspace;session-subdir 再拼 sessionId
|
|
686
|
+
const isolationMode = effectiveRunConfig.toolIsolation
|
|
687
|
+
?? this.config.toolIsolation
|
|
688
|
+
?? DEFAULT_TOOL_ISOLATION;
|
|
689
|
+
const baseCwd = (effectiveRunConfig.cwd?.trim() ? effectiveRunConfig.cwd.trim() : undefined)
|
|
690
|
+
?? (this.config.agentWorkspace?.trim() ? this.config.agentWorkspace.trim() : undefined);
|
|
691
|
+
const resolvedToolCwd = resolveToolIsolationCwd({
|
|
692
|
+
mode: isolationMode,
|
|
693
|
+
sessionId,
|
|
694
|
+
baseCwd,
|
|
695
|
+
});
|
|
696
|
+
if (isolationMode === 'session-subdir' && resolvedToolCwd.cwd) {
|
|
697
|
+
try {
|
|
698
|
+
mkdirSync(resolvedToolCwd.cwd, { recursive: true });
|
|
699
|
+
}
|
|
700
|
+
catch (err) {
|
|
701
|
+
// 目录创建失败不阻断 run:工具侧仍可能自行 mkdir;此处吞掉仅因非致命 IO
|
|
702
|
+
console.warn(`[octopi] toolIsolation session-subdir mkdir failed (session=${sessionId}, cwd=${resolvedToolCwd.cwd}): ${err instanceof Error ? err.message : String(err)}`);
|
|
703
|
+
}
|
|
704
|
+
}
|
|
705
|
+
// Run 身份与 RunScope 对齐(Observer/审计共用,不另造第二套 ID)
|
|
706
|
+
const runId = createRunId(sessionId, _agentId);
|
|
707
|
+
const attachmentRoots = this.config.sessionAttachmentsBaseDir
|
|
708
|
+
? [join(this.config.sessionAttachmentsBaseDir, toSessionFileName(sessionId), 'attachments')]
|
|
709
|
+
: undefined;
|
|
710
|
+
const runScope = {
|
|
711
|
+
sessionId,
|
|
712
|
+
agentId: _agentId,
|
|
713
|
+
runId,
|
|
714
|
+
systemPrompt: runContext.systemPrompt,
|
|
715
|
+
agentRevision: effectiveRunConfig.agentRevision,
|
|
716
|
+
toolRuntime: {
|
|
717
|
+
sessionId,
|
|
718
|
+
agentId: _agentId,
|
|
719
|
+
messages: session.messages,
|
|
720
|
+
cwd: resolvedToolCwd.cwd,
|
|
721
|
+
isolation: resolvedToolCwd.mode,
|
|
722
|
+
attachmentRoots,
|
|
723
|
+
},
|
|
724
|
+
};
|
|
725
|
+
if (pendingGrounding) {
|
|
726
|
+
runScope.grounding = {
|
|
727
|
+
query: pendingGrounding.query,
|
|
728
|
+
mode: pendingGrounding.mode,
|
|
729
|
+
hitCount: pendingGrounding.hits.length,
|
|
730
|
+
coverage: pendingGrounding.coverage,
|
|
731
|
+
tokens: pendingGrounding.tokens,
|
|
732
|
+
};
|
|
733
|
+
}
|
|
734
|
+
{
|
|
735
|
+
// turn 级:先剥历史 grounding,再视本轮 mode 决定是否插入
|
|
736
|
+
// mode=none 时不保留上轮 grounding(避免陈旧内容长期回放)
|
|
737
|
+
const baseMsgs = session.messages.filter((m) => m.metadata?.source !== 'knowledgeGrounding' &&
|
|
738
|
+
m.metadata?.source !== 'sessionAttachment');
|
|
739
|
+
// OP-15:会话附件资料块(与 Knowledge grounding 同槽位气质,source 不同)
|
|
740
|
+
let attachmentText = null;
|
|
741
|
+
if (this.config.sessionAttachmentsBaseDir) {
|
|
742
|
+
try {
|
|
743
|
+
const { SessionAttachmentService, buildAttachmentGroundingText, resolveInjectPlan, createLlmIntentResolver, } = await import('../session/attachments/index.js');
|
|
744
|
+
const attachSvc = new SessionAttachmentService({
|
|
745
|
+
sessionsDir: this.config.sessionAttachmentsBaseDir,
|
|
746
|
+
});
|
|
747
|
+
const lastUser = [...session.messages].reverse().find((m) => m.role === 'user');
|
|
748
|
+
const attachIds = Array.isArray(lastUser?.metadata?.attachmentIds)
|
|
749
|
+
? lastUser.metadata.attachmentIds.filter((x) => typeof x === 'string')
|
|
750
|
+
: [];
|
|
751
|
+
const userText = lastUser ? getTextContent(lastUser.content) : '';
|
|
752
|
+
if (attachIds.length > 0) {
|
|
753
|
+
const items = attachIds
|
|
754
|
+
.map((id) => attachSvc.get(sessionId, id))
|
|
755
|
+
.filter((x) => Boolean(x) && x.status !== 'promoted');
|
|
756
|
+
if (items.length > 0) {
|
|
757
|
+
// 意图分流:大文件 + 非空正文时走 LLM(fail-open structure)
|
|
758
|
+
const plan = await resolveInjectPlan({
|
|
759
|
+
userText,
|
|
760
|
+
attachments: items,
|
|
761
|
+
outlines: Object.fromEntries(items.map((a) => [
|
|
762
|
+
a.name,
|
|
763
|
+
(attachSvc.readExtractedText(sessionId, a.id, 200) ?? '').replace(/\s+/g, ' ').slice(0, 200),
|
|
764
|
+
])),
|
|
765
|
+
}, {
|
|
766
|
+
fullTextMaxChars: this.config.sessionAttachmentInject?.fullTextMaxChars ?? 12_000,
|
|
767
|
+
intent: this.config.sessionAttachmentInject?.intent ?? 'llm',
|
|
768
|
+
timeoutMs: this.config.sessionAttachmentInject?.intentTimeoutMs ?? 800,
|
|
769
|
+
resolver: resolvedModel?.provider
|
|
770
|
+
? createLlmIntentResolver(resolvedModel.provider)
|
|
771
|
+
: undefined,
|
|
772
|
+
});
|
|
773
|
+
attachmentText = buildAttachmentGroundingText(items, {
|
|
774
|
+
fullTextMaxChars: this.config.sessionAttachmentInject?.fullTextMaxChars ?? 12_000,
|
|
775
|
+
readText: (id, max) => attachSvc.readExtractedText(sessionId, id, max),
|
|
776
|
+
absolutePath: (id) => attachSvc.resolveAbsolutePath(sessionId, id),
|
|
777
|
+
}, plan.mode === 'full' ? 'full' : plan.mode);
|
|
778
|
+
if (plan.focus && attachmentText) {
|
|
779
|
+
attachmentText = attachmentText.replace('</session-attachments>', `\n检索焦点: ${plan.focus}\n</session-attachments>`);
|
|
780
|
+
}
|
|
781
|
+
}
|
|
782
|
+
}
|
|
783
|
+
}
|
|
784
|
+
catch (attErr) {
|
|
785
|
+
console.warn(`[octopi] attachment grounding failed (session=${sessionId}): ${attErr instanceof Error ? attErr.message : String(attErr)}`);
|
|
786
|
+
}
|
|
787
|
+
}
|
|
788
|
+
if (attachmentText) {
|
|
789
|
+
const attachMsg = {
|
|
790
|
+
role: 'user',
|
|
791
|
+
content: attachmentText,
|
|
792
|
+
timestamp: Date.now(),
|
|
793
|
+
metadata: { source: 'sessionAttachment' },
|
|
794
|
+
};
|
|
795
|
+
let insertAt = baseMsgs.length;
|
|
796
|
+
for (let i = baseMsgs.length - 1; i >= 0; i--) {
|
|
797
|
+
if (baseMsgs[i].role === 'user') {
|
|
798
|
+
insertAt = i;
|
|
799
|
+
break;
|
|
800
|
+
}
|
|
801
|
+
}
|
|
802
|
+
baseMsgs.splice(insertAt, 0, attachMsg);
|
|
803
|
+
}
|
|
804
|
+
if (pendingGrounding && pendingGrounding.mode !== 'none' && pendingGrounding.text?.trim()) {
|
|
805
|
+
const groundingMsg = {
|
|
806
|
+
role: 'user',
|
|
807
|
+
content: pendingGrounding.text,
|
|
808
|
+
timestamp: Date.now(),
|
|
809
|
+
metadata: {
|
|
810
|
+
source: 'knowledgeGrounding',
|
|
811
|
+
mode: pendingGrounding.mode,
|
|
812
|
+
query: pendingGrounding.query,
|
|
813
|
+
coverage: pendingGrounding.coverage,
|
|
814
|
+
},
|
|
815
|
+
};
|
|
816
|
+
let insertAt = baseMsgs.length;
|
|
817
|
+
for (let i = baseMsgs.length - 1; i >= 0; i--) {
|
|
818
|
+
if (baseMsgs[i].role === 'user') {
|
|
819
|
+
insertAt = i;
|
|
820
|
+
break;
|
|
821
|
+
}
|
|
822
|
+
}
|
|
823
|
+
baseMsgs.splice(insertAt, 0, groundingMsg);
|
|
824
|
+
runContext.messages = baseMsgs;
|
|
825
|
+
if (runScope.toolRuntime) {
|
|
826
|
+
runScope.toolRuntime.messages = baseMsgs;
|
|
827
|
+
}
|
|
828
|
+
}
|
|
829
|
+
else if (baseMsgs.length !== session.messages.length) {
|
|
830
|
+
runContext.messages = baseMsgs;
|
|
831
|
+
if (runScope.toolRuntime) {
|
|
832
|
+
runScope.toolRuntime.messages = baseMsgs;
|
|
833
|
+
}
|
|
834
|
+
}
|
|
835
|
+
}
|
|
836
|
+
// Observer 通道:Run 现场快照(摘要进事件;全文由 Hub/REST 提供)
|
|
837
|
+
if (this._observerHub?.isEnabled()) {
|
|
838
|
+
observerRunId =
|
|
839
|
+
this._observerHub.recordRunStart({
|
|
840
|
+
scope: runScope,
|
|
841
|
+
runId,
|
|
842
|
+
resolvedModel: resolvedModel
|
|
843
|
+
? {
|
|
844
|
+
modelName: resolvedModel.modelName,
|
|
845
|
+
providerId: resolvedModel.providerName,
|
|
846
|
+
contextWindow: resolvedModel.contextWindow,
|
|
847
|
+
}
|
|
848
|
+
: undefined,
|
|
849
|
+
messages: session.messages,
|
|
850
|
+
}) || runId;
|
|
851
|
+
if (observerRunId) {
|
|
852
|
+
const hubSnapshot = this._observerHub.getRunById(observerRunId);
|
|
853
|
+
if (hubSnapshot) {
|
|
854
|
+
this.emitObserved({
|
|
855
|
+
type: 'run.scope.ready',
|
|
856
|
+
timestamp: hubSnapshot.scope.capturedAt,
|
|
857
|
+
agentId: _agentId,
|
|
858
|
+
sessionId,
|
|
859
|
+
data: {
|
|
860
|
+
sessionId,
|
|
861
|
+
agentId: _agentId,
|
|
862
|
+
runId: observerRunId,
|
|
863
|
+
scope: hubSnapshot.scope,
|
|
864
|
+
messages: hubSnapshot.messagesSummary,
|
|
865
|
+
},
|
|
866
|
+
});
|
|
867
|
+
if (hubSnapshot.messagesSummary) {
|
|
868
|
+
this.emitObserved({
|
|
869
|
+
type: 'run.scope.messages',
|
|
870
|
+
timestamp: Date.now(),
|
|
871
|
+
agentId: _agentId,
|
|
872
|
+
sessionId,
|
|
873
|
+
data: {
|
|
874
|
+
sessionId,
|
|
875
|
+
agentId: _agentId,
|
|
876
|
+
runId: observerRunId,
|
|
877
|
+
phase: 'entry',
|
|
878
|
+
summary: hubSnapshot.messagesSummary,
|
|
879
|
+
},
|
|
880
|
+
});
|
|
881
|
+
}
|
|
882
|
+
}
|
|
883
|
+
}
|
|
884
|
+
}
|
|
885
|
+
// Token 估算器(当 LLM 不返回 usage 时用于回退估算)
|
|
886
|
+
const estimator = new HeuristicTokenEstimator();
|
|
887
|
+
// 10. 运行 Agent(Agent.run = reliability 包装;context/runScope 为本 Run 私有)
|
|
888
|
+
let streamedContent = '';
|
|
889
|
+
let lastUsage = undefined;
|
|
890
|
+
const meta = { agentId: effectiveRunConfig.agentId ?? 'default', sessionId };
|
|
891
|
+
const adaptState = { assistantContent: '', lastUserContent: '' };
|
|
892
|
+
/** 本轮起始消息下标(afterTurn 只传增量) */
|
|
893
|
+
let turnStartIndex = runContext.messages.length;
|
|
894
|
+
// resolvedModel 已在 system assembler 之前解析;此处只组装 run options
|
|
895
|
+
const agentRunOptions = {
|
|
896
|
+
resolvedModel: resolvedModel ?? undefined,
|
|
897
|
+
context: runContext,
|
|
898
|
+
runScope,
|
|
899
|
+
};
|
|
900
|
+
for await (const loopEvent of this.agent.run(signal, undefined, agentRunOptions)) {
|
|
901
|
+
// 适配事件格式(向后兼容)
|
|
902
|
+
const adapted = adaptLoopEvent(loopEvent, meta, adaptState);
|
|
903
|
+
if (adapted) {
|
|
904
|
+
// 捕获 usage 数据,并在 turn.end 事件中附加上下文信息(必须在 yield 之前,
|
|
905
|
+
// 否则 gateway 收到事件后立即广播,data 里还没有 context 字段)
|
|
906
|
+
if (adapted.type === 'turn.end') {
|
|
907
|
+
const rawUsage = adapted.data?.usage;
|
|
908
|
+
if (rawUsage) {
|
|
909
|
+
lastUsage = rawUsage;
|
|
910
|
+
}
|
|
911
|
+
adapted.data.contextTokens =
|
|
912
|
+
lastUsage?.inputReportedTokens ??
|
|
913
|
+
(lastUsage
|
|
914
|
+
? lastUsage.inputUncachedTokens + lastUsage.inputCachedTokens + lastUsage.inputCacheWriteTokens
|
|
915
|
+
: undefined) ??
|
|
916
|
+
estimator.estimateMessages(session.messages);
|
|
917
|
+
adapted.data.contextWindow = effectiveRunConfig.contextWindow;
|
|
918
|
+
}
|
|
919
|
+
yield adapted;
|
|
920
|
+
// Telemetry 旁路(含 stream delta;由 RunTelemetry 决定采样)
|
|
921
|
+
this.config.eventSink?.(adapted, meta);
|
|
922
|
+
// 事件桥:循环事件同时广播到 EventBus
|
|
923
|
+
// 跳过高频流式 delta(每 token 一次),避免 EventBus 拥塞
|
|
924
|
+
if (adapted.type !== 'llm_stream_delta') {
|
|
925
|
+
this.emitObserved(adapted);
|
|
926
|
+
}
|
|
927
|
+
}
|
|
928
|
+
// 收集流式内容
|
|
929
|
+
if (loopEvent.type === 'llm_stream_delta' && loopEvent.data?.delta) {
|
|
930
|
+
streamedContent += loopEvent.data.delta;
|
|
931
|
+
}
|
|
932
|
+
// 捕获 assistant 消息内容
|
|
933
|
+
if (loopEvent.type === 'assistant_message') {
|
|
934
|
+
adaptState.assistantContent = typeof loopEvent.message.content === 'string' ? loopEvent.message.content : '';
|
|
935
|
+
}
|
|
936
|
+
// turn_start:重置本轮增量游标(afterTurn 只传本轮消息)
|
|
937
|
+
if (loopEvent.type === 'turn_start') {
|
|
938
|
+
turnStartIndex = runContext.messages.length;
|
|
939
|
+
}
|
|
940
|
+
// turn.end → 记录 turn
|
|
941
|
+
if (loopEvent.type === 'turn_end') {
|
|
942
|
+
hasTurnEnd = true;
|
|
943
|
+
if (loopEvent.usage) {
|
|
944
|
+
lastUsage = loopEvent.usage;
|
|
945
|
+
}
|
|
946
|
+
const turnMessages = runContext.messages.slice(turnStartIndex);
|
|
947
|
+
await this.agent.notifyAfterTurn(lastUsage, turnMessages);
|
|
948
|
+
turnStartIndex = runContext.messages.length;
|
|
949
|
+
const content = adaptState.assistantContent || streamedContent;
|
|
950
|
+
if (content) {
|
|
951
|
+
session.turns.push({
|
|
952
|
+
id: `turn_${Date.now()}`,
|
|
953
|
+
input: session.messages.slice(0, -1),
|
|
954
|
+
output: { role: 'assistant', content, timestamp: Date.now(), agentId: _agentId },
|
|
955
|
+
usage: lastUsage,
|
|
956
|
+
durationMs: 0,
|
|
957
|
+
model: effectiveRunConfig.model ?? 'unknown',
|
|
958
|
+
timestamp: Date.now(),
|
|
959
|
+
});
|
|
960
|
+
}
|
|
961
|
+
}
|
|
962
|
+
}
|
|
963
|
+
// 10. 将本 Run 工作区写回 session(Loop 原地修改的是 runContext.messages)
|
|
964
|
+
// 含 Loop 注入的托管 systemPrompt(metadata.source='systemPrompt'):
|
|
965
|
+
// 落盘保留审计价值;聊天 UI 在 history 映射时过滤,不回放进对话
|
|
966
|
+
// 模型 2 归因:assistant/tool 消息补齐本 Run 的 agentId(来自 Run 身份)
|
|
967
|
+
for (const m of runContext.messages) {
|
|
968
|
+
if ((m.role === 'assistant' || m.role === 'tool') && m.agentId === undefined) {
|
|
969
|
+
m.agentId = _agentId;
|
|
970
|
+
}
|
|
971
|
+
}
|
|
972
|
+
session.messages = runContext.messages;
|
|
973
|
+
// 11. 引擎异常退出时的 session 一致性修复(须在 Observer final 采样之前)
|
|
974
|
+
if (!hasTurnEnd) {
|
|
975
|
+
const fallbackContent = streamedContent || '';
|
|
976
|
+
if (fallbackContent) {
|
|
977
|
+
session.messages.push({
|
|
978
|
+
role: 'assistant',
|
|
979
|
+
content: fallbackContent,
|
|
980
|
+
timestamp: Date.now(),
|
|
981
|
+
agentId: _agentId,
|
|
982
|
+
});
|
|
983
|
+
session.turns.push({
|
|
984
|
+
id: `turn_${Date.now()}`,
|
|
985
|
+
input: session.messages.slice(0, -1),
|
|
986
|
+
output: { role: 'assistant', content: fallbackContent, timestamp: Date.now(), agentId: _agentId },
|
|
987
|
+
usage: lastUsage,
|
|
988
|
+
durationMs: 0,
|
|
989
|
+
model: effectiveRunConfig.model ?? 'unknown',
|
|
990
|
+
timestamp: Date.now(),
|
|
991
|
+
});
|
|
992
|
+
}
|
|
993
|
+
}
|
|
994
|
+
// Observer:记录最终 messages 与 endReason(真正 close 在 finally,保证异常也闭合)
|
|
995
|
+
observerFinalMessages = session.messages;
|
|
996
|
+
// P5: 使用 stopReason 区分终态(context_stopped / behavior_stopped / policy_stopped / security_stopped / completed)
|
|
997
|
+
observerEndReason = adaptState.stopReason ?? (hasTurnEnd ? 'completed' : 'no_turn_end');
|
|
998
|
+
// 12. 持久化
|
|
999
|
+
sm.transition('idle');
|
|
1000
|
+
session.meta.status = sm.state;
|
|
1001
|
+
session.meta.updatedAt = Date.now();
|
|
1002
|
+
// 压缩状态写回 Session(E4 分桶 + primary 兼容视图)
|
|
1003
|
+
const compactSnap = this.agent.getSessionCompactState(sessionId, _agentId);
|
|
1004
|
+
writeSessionCompact(session, _agentId, compactSnap);
|
|
1005
|
+
await this.store.save(sessionId, session);
|
|
1006
|
+
// 通知子系统:本轮处理完成(保持 active,但刷新 lastInteractionAt)
|
|
1007
|
+
this._backfillTrigger?.noteActivity(sessionId, _agentId, session.meta.lastInteractionAt);
|
|
1008
|
+
this.emitObserved({
|
|
1009
|
+
type: 'session.lifecycle.updated',
|
|
1010
|
+
timestamp: Date.now(),
|
|
1011
|
+
agentId: _agentId,
|
|
1012
|
+
sessionId,
|
|
1013
|
+
data: {
|
|
1014
|
+
lifecycle: session.lifecycle?.lifecycle ?? 'active',
|
|
1015
|
+
extractionStatus: 'pending',
|
|
1016
|
+
lastInteractionAt: session.meta.lastInteractionAt,
|
|
1017
|
+
},
|
|
1018
|
+
});
|
|
1019
|
+
}
|
|
1020
|
+
catch (err) {
|
|
1021
|
+
observerEndReason = 'error';
|
|
1022
|
+
observerErrorMsg = err instanceof Error ? err.message : String(err);
|
|
1023
|
+
// 引擎出错:状态机转到 error,持久化
|
|
1024
|
+
const sm = this.stateMachines.get(sessionId);
|
|
1025
|
+
if (sm?.canTransition('error')) {
|
|
1026
|
+
sm.transition('error');
|
|
1027
|
+
const session = await this.store.load(sessionId);
|
|
1028
|
+
if (session) {
|
|
1029
|
+
session.meta.status = sm.state;
|
|
1030
|
+
session.meta.updatedAt = Date.now();
|
|
1031
|
+
if (!observerFinalMessages)
|
|
1032
|
+
observerFinalMessages = session.messages;
|
|
1033
|
+
await this.store.save(sessionId, session);
|
|
1034
|
+
this.emitObserved({
|
|
1035
|
+
type: 'engine.error',
|
|
1036
|
+
timestamp: Date.now(),
|
|
1037
|
+
agentId: _agentId,
|
|
1038
|
+
sessionId,
|
|
1039
|
+
data: { error: observerErrorMsg },
|
|
1040
|
+
});
|
|
1041
|
+
// 通知子系统:异常路径下保持生命周期可感知
|
|
1042
|
+
this.emitObserved({
|
|
1043
|
+
type: 'session.lifecycle.updated',
|
|
1044
|
+
timestamp: Date.now(),
|
|
1045
|
+
agentId: _agentId,
|
|
1046
|
+
sessionId,
|
|
1047
|
+
data: {
|
|
1048
|
+
lifecycle: 'recent',
|
|
1049
|
+
extractionStatus: 'pending',
|
|
1050
|
+
lastInteractionAt: session.meta.lastInteractionAt,
|
|
1051
|
+
},
|
|
1052
|
+
});
|
|
1053
|
+
}
|
|
1054
|
+
}
|
|
1055
|
+
throw err;
|
|
1056
|
+
}
|
|
1057
|
+
finally {
|
|
1058
|
+
// 清理 task service 的活 session 缓存(避免长时间运行进程内存泄漏)
|
|
1059
|
+
this.config.sessionTaskService?.detachSession(_agentId, sessionId);
|
|
1060
|
+
// Observer 统一收口:成功/失败都关闭 run,避免僵尸 active
|
|
1061
|
+
if (observerRunId && this._observerHub?.isEnabled()) {
|
|
1062
|
+
try {
|
|
1063
|
+
this._observerHub.recordRunEnd({
|
|
1064
|
+
runId: observerRunId,
|
|
1065
|
+
sessionId,
|
|
1066
|
+
messages: observerFinalMessages,
|
|
1067
|
+
endReason: observerEndReason ?? 'unknown',
|
|
1068
|
+
error: observerErrorMsg,
|
|
1069
|
+
});
|
|
1070
|
+
// 事件投影用 getRunById(不要求 webPanel);REST 才受 webPanel 门控
|
|
1071
|
+
const finalSnap = this._observerHub.getRunById(observerRunId);
|
|
1072
|
+
const finalSummary = finalSnap?.messagesSummary ??
|
|
1073
|
+
this._observerHub
|
|
1074
|
+
.getRunMessages(sessionId, { runId: observerRunId, phase: 'final' })?.summary;
|
|
1075
|
+
if (finalSummary) {
|
|
1076
|
+
this.emitObserved({
|
|
1077
|
+
type: 'run.scope.messages',
|
|
1078
|
+
timestamp: Date.now(),
|
|
1079
|
+
agentId: _agentId,
|
|
1080
|
+
sessionId,
|
|
1081
|
+
data: {
|
|
1082
|
+
sessionId,
|
|
1083
|
+
agentId: _agentId,
|
|
1084
|
+
runId: observerRunId,
|
|
1085
|
+
phase: 'final',
|
|
1086
|
+
summary: finalSummary,
|
|
1087
|
+
},
|
|
1088
|
+
});
|
|
1089
|
+
}
|
|
1090
|
+
}
|
|
1091
|
+
catch {
|
|
1092
|
+
// 观测收口失败不阻断锁释放
|
|
1093
|
+
}
|
|
1094
|
+
}
|
|
1095
|
+
release();
|
|
1096
|
+
gateRelease?.();
|
|
1097
|
+
}
|
|
1098
|
+
}
|
|
1099
|
+
/**
|
|
1100
|
+
* Session compact under the same session lock as handle (E1/E4).
|
|
1101
|
+
*
|
|
1102
|
+
* Authority is the runner session lock, not status==='processing'.
|
|
1103
|
+
* Compact key = (sessionId, agentId). Concurrent handle/compact on the
|
|
1104
|
+
* same sessionId queue FIFO; different sessions stay concurrent.
|
|
1105
|
+
*
|
|
1106
|
+
* @param sessionId - session id
|
|
1107
|
+
* @param agentId - compact view owner (usually session.agentId / primary)
|
|
1108
|
+
* @param options - structural compact engine callback + summarize params
|
|
1109
|
+
* @returns compact result
|
|
1110
|
+
*/
|
|
1111
|
+
async compactSession(sessionId, agentId, options) {
|
|
1112
|
+
const release = await this.acquireLock(sessionId);
|
|
1113
|
+
try {
|
|
1114
|
+
const session = await this.store.load(sessionId);
|
|
1115
|
+
if (!session) {
|
|
1116
|
+
return {
|
|
1117
|
+
ok: false,
|
|
1118
|
+
compacted: false,
|
|
1119
|
+
reason: 'session not found',
|
|
1120
|
+
tokensBefore: 0,
|
|
1121
|
+
};
|
|
1122
|
+
}
|
|
1123
|
+
const result = await options.compactStructural({
|
|
1124
|
+
sessionId,
|
|
1125
|
+
agentId,
|
|
1126
|
+
messages: session.messages,
|
|
1127
|
+
summarize: options.summarize,
|
|
1128
|
+
compactTargetTokens: options.compactTargetTokens,
|
|
1129
|
+
});
|
|
1130
|
+
if (result.ok && result.summary) {
|
|
1131
|
+
const snap = {
|
|
1132
|
+
summary: result.summary,
|
|
1133
|
+
lastProactiveMessageCount: session.messages.length,
|
|
1134
|
+
lastProactiveTokens: result.tokensAfter,
|
|
1135
|
+
};
|
|
1136
|
+
this.agent.setSessionCompactState(sessionId, agentId, snap);
|
|
1137
|
+
writeSessionCompact(session, agentId, snap);
|
|
1138
|
+
session.meta.updatedAt = Date.now();
|
|
1139
|
+
await this.store.save(sessionId, session);
|
|
1140
|
+
}
|
|
1141
|
+
return result;
|
|
1142
|
+
}
|
|
1143
|
+
finally {
|
|
1144
|
+
release();
|
|
1145
|
+
}
|
|
1146
|
+
}
|
|
1147
|
+
/**
|
|
1148
|
+
* 获取 Session 锁(经 SessionLease;E2 键 = sessionId)
|
|
1149
|
+
*
|
|
1150
|
+
* 使用 Promise 队列实现,避免 polling 开销。
|
|
1151
|
+
* 请求按 FIFO 顺序获取锁,无饥饿问题。
|
|
1152
|
+
* 分布式:注入 DistributedSessionLease;勿假设 in-process 锁全局有效(E7)。
|
|
1153
|
+
*/
|
|
1154
|
+
async acquireLock(sessionId, signal) {
|
|
1155
|
+
return this.sessionLease.acquire(sessionId, signal ? { signal } : undefined);
|
|
1156
|
+
}
|
|
1157
|
+
/**
|
|
1158
|
+
* 创建新 Session
|
|
1159
|
+
*
|
|
1160
|
+
* 模型 2:`primaryAgentId` = 创建时的 agentId(Accountability)。
|
|
1161
|
+
* 存储主键 = sessionId;agentId 只作归属/参与投影。
|
|
1162
|
+
*/
|
|
1163
|
+
createSession(sessionId, agentId) {
|
|
1164
|
+
return {
|
|
1165
|
+
id: sessionId,
|
|
1166
|
+
agentId,
|
|
1167
|
+
primaryAgentId: agentId,
|
|
1168
|
+
meta: {
|
|
1169
|
+
id: sessionId,
|
|
1170
|
+
agentId,
|
|
1171
|
+
channelId: 'unknown',
|
|
1172
|
+
peerId: 'unknown',
|
|
1173
|
+
status: 'idle',
|
|
1174
|
+
createdAt: Date.now(),
|
|
1175
|
+
sessionStartedAt: Date.now(),
|
|
1176
|
+
lastInteractionAt: Date.now(),
|
|
1177
|
+
updatedAt: Date.now(),
|
|
1178
|
+
},
|
|
1179
|
+
messages: [],
|
|
1180
|
+
turns: [],
|
|
1181
|
+
metadata: {},
|
|
1182
|
+
tasks: [],
|
|
1183
|
+
};
|
|
1184
|
+
}
|
|
1185
|
+
/** 旧路径:persona + injectedContext 字符串拼接;结果返回给 runContext,不写共享 Agent */
|
|
1186
|
+
concatSystemPrompt(basePrompt, injectedContext, personaFromResolver) {
|
|
1187
|
+
if (injectedContext) {
|
|
1188
|
+
return basePrompt
|
|
1189
|
+
? `${basePrompt}\n\n${injectedContext}`
|
|
1190
|
+
: injectedContext;
|
|
1191
|
+
}
|
|
1192
|
+
if (personaFromResolver || basePrompt) {
|
|
1193
|
+
return basePrompt;
|
|
1194
|
+
}
|
|
1195
|
+
return basePrompt;
|
|
1196
|
+
}
|
|
1197
|
+
/**
|
|
1198
|
+
* 获取或创建 Session 状态机
|
|
1199
|
+
*
|
|
1200
|
+
* 如果 session 已有状态,从该状态初始化状态机(避免重启后状态不同步)。
|
|
1201
|
+
*/
|
|
1202
|
+
getOrCreateStateMachine(sessionId, currentStatus) {
|
|
1203
|
+
let sm = this.stateMachines.get(sessionId);
|
|
1204
|
+
if (!sm) {
|
|
1205
|
+
sm = createSessionStateMachine();
|
|
1206
|
+
// 从 session 当前状态初始化(处理重启/恢复场景)
|
|
1207
|
+
if (currentStatus && currentStatus !== 'idle') {
|
|
1208
|
+
sm.force(currentStatus);
|
|
1209
|
+
}
|
|
1210
|
+
this.stateMachines.set(sessionId, sm);
|
|
1211
|
+
}
|
|
1212
|
+
return sm;
|
|
1213
|
+
}
|
|
1214
|
+
/**
|
|
1215
|
+
* 检查 Session 是否需要重置
|
|
1216
|
+
*/
|
|
1217
|
+
checkSessionReset(session) {
|
|
1218
|
+
const now = Date.now();
|
|
1219
|
+
let didReset = false;
|
|
1220
|
+
// Daily reset
|
|
1221
|
+
if (this.config.enableDailyReset) {
|
|
1222
|
+
const sessionDay = new Date(session.meta.sessionStartedAt).toDateString();
|
|
1223
|
+
const today = new Date(now).toDateString();
|
|
1224
|
+
if (sessionDay !== today) {
|
|
1225
|
+
session.messages = [];
|
|
1226
|
+
session.turns = [];
|
|
1227
|
+
session.meta.sessionStartedAt = now;
|
|
1228
|
+
didReset = true;
|
|
1229
|
+
}
|
|
1230
|
+
}
|
|
1231
|
+
// Idle reset:历史清空前把会话标为 recent+pending,供 memory extract 触发
|
|
1232
|
+
if (this.config.idleExpiryMs) {
|
|
1233
|
+
const idle = now - session.meta.lastInteractionAt;
|
|
1234
|
+
if (idle > this.config.idleExpiryMs) {
|
|
1235
|
+
this.markSessionRecent(session, now);
|
|
1236
|
+
session.messages = [];
|
|
1237
|
+
session.turns = [];
|
|
1238
|
+
session.meta.sessionStartedAt = now;
|
|
1239
|
+
didReset = true;
|
|
1240
|
+
}
|
|
1241
|
+
}
|
|
1242
|
+
if (didReset) {
|
|
1243
|
+
// 历史清空后,层指纹与压缩快照一并失效(E4:清全部 agent 桶)
|
|
1244
|
+
this.systemPromptAssemblerClear?.(session.id);
|
|
1245
|
+
writeSessionCompact(session, session.primaryAgentId ?? session.agentId, undefined);
|
|
1246
|
+
const resetAgentIds = new Set([
|
|
1247
|
+
session.primaryAgentId ?? session.agentId,
|
|
1248
|
+
session.agentId,
|
|
1249
|
+
...Object.keys(session.contextCompacts ?? {}),
|
|
1250
|
+
]);
|
|
1251
|
+
for (const aid of resetAgentIds) {
|
|
1252
|
+
this.agent.setSessionCompactState(session.id, aid, undefined);
|
|
1253
|
+
}
|
|
1254
|
+
delete session.contextCompact;
|
|
1255
|
+
delete session.contextCompacts;
|
|
1256
|
+
}
|
|
1257
|
+
}
|
|
1258
|
+
/**
|
|
1259
|
+
* 将 session 生命周期落到 recent + endedAt,并广播事件。
|
|
1260
|
+
* 状态在 SessionData.lifecycle;由后续 save 持久化(meta 索引投影)。
|
|
1261
|
+
* 不写 memoryExtraction(进度归 memory.steward);事件仍带 extractionStatus 供 Sense 感知。
|
|
1262
|
+
*/
|
|
1263
|
+
markSessionRecent(session, now) {
|
|
1264
|
+
// 补录快照:idle reset 会清空 messages,必须在清空前固化 sessionText
|
|
1265
|
+
const sessionText = (session.messages ?? [])
|
|
1266
|
+
.filter((m) => {
|
|
1267
|
+
const kind = m.metadata?.kind;
|
|
1268
|
+
return kind !== 'command' && kind !== 'command_result';
|
|
1269
|
+
})
|
|
1270
|
+
.map((m) => `[${m.role}] ${typeof m.content === 'string' ? m.content : JSON.stringify(m.content ?? '')}`)
|
|
1271
|
+
.join('\n')
|
|
1272
|
+
.slice(0, 8000);
|
|
1273
|
+
session.lifecycle = {
|
|
1274
|
+
lifecycle: 'recent',
|
|
1275
|
+
endedAt: now,
|
|
1276
|
+
};
|
|
1277
|
+
this.emitObserved({
|
|
1278
|
+
type: 'session.lifecycle.updated',
|
|
1279
|
+
timestamp: now,
|
|
1280
|
+
agentId: session.agentId,
|
|
1281
|
+
sessionId: session.id,
|
|
1282
|
+
data: {
|
|
1283
|
+
lifecycle: 'recent',
|
|
1284
|
+
extractionStatus: 'pending',
|
|
1285
|
+
lastInteractionAt: session.meta.lastInteractionAt,
|
|
1286
|
+
sessionText,
|
|
1287
|
+
},
|
|
1288
|
+
});
|
|
1289
|
+
}
|
|
1290
|
+
}
|