@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,277 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AgentDatabase — Per-agent SQLite 数据库管理
|
|
3
|
+
*
|
|
4
|
+
* 每个 agent 拥有独立的 SQLite 数据库文件(agent.db),
|
|
5
|
+
* 存储 Memory、Cognition、Wisdom、Knowledge 注册表数据。
|
|
6
|
+
*
|
|
7
|
+
* 路径约定:由宿主通过 `dbPath` 传入。推荐放在 agent home 下
|
|
8
|
+
* (例如 `<agentHome>/agent.db`);init **不会**预建 `memory/`、`wisdom/`
|
|
9
|
+
* 目录——那两层已不是文件目录,而是本库中的表。
|
|
10
|
+
* 未传 `dbPath` 时默认 `:memory:`(仅开发/测试)。
|
|
11
|
+
*
|
|
12
|
+
* @module
|
|
13
|
+
*/
|
|
14
|
+
import { randomUUID } from 'node:crypto';
|
|
15
|
+
import { mkdir } from 'node:fs/promises';
|
|
16
|
+
import { dirname } from 'node:path';
|
|
17
|
+
import { ensureMemoryVecTable, tryLoadSqliteVec } from './sqlite-vec.js';
|
|
18
|
+
export class AgentDatabase {
|
|
19
|
+
db;
|
|
20
|
+
_sqliteVec = false;
|
|
21
|
+
_vecDimensions = null;
|
|
22
|
+
constructor(db) {
|
|
23
|
+
this.db = db;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* 异步工厂方法(内置 node:sqlite,需 Node.js >= 24)
|
|
27
|
+
*/
|
|
28
|
+
static async create(options) {
|
|
29
|
+
let DatabaseSyncCtor;
|
|
30
|
+
try {
|
|
31
|
+
const mod = await import('node:sqlite');
|
|
32
|
+
DatabaseSyncCtor = mod.DatabaseSync;
|
|
33
|
+
}
|
|
34
|
+
catch {
|
|
35
|
+
throw new Error(`AgentDatabase requires Node.js >= 24 built-in "node:sqlite". Current process.version=${process.version}`);
|
|
36
|
+
}
|
|
37
|
+
const dbPath = options?.dbPath ?? ':memory:';
|
|
38
|
+
// 确保目录存在
|
|
39
|
+
if (dbPath !== ':memory:') {
|
|
40
|
+
await mkdir(dirname(dbPath), { recursive: true });
|
|
41
|
+
}
|
|
42
|
+
const wantVec = Boolean(options?.sqliteVec);
|
|
43
|
+
// timeout 独立于 WAL:对齐 better-sqlite3 默认 busy_timeout=5000
|
|
44
|
+
// FK 保持关闭以对齐 better-sqlite3 默认行为(concept_edges 旧数据兼容)
|
|
45
|
+
// allowExtension 仅在请求 sqlite-vec 时打开(Node 构造后无法补开)
|
|
46
|
+
const db = new DatabaseSyncCtor(dbPath, {
|
|
47
|
+
timeout: options?.busyTimeoutMs ?? 5000,
|
|
48
|
+
allowExtension: wantVec,
|
|
49
|
+
enableForeignKeyConstraints: false,
|
|
50
|
+
});
|
|
51
|
+
if (options?.wal !== false) {
|
|
52
|
+
db.exec('PRAGMA journal_mode = WAL');
|
|
53
|
+
}
|
|
54
|
+
const agentDb = new AgentDatabase(db);
|
|
55
|
+
agentDb.createTables();
|
|
56
|
+
// 可选:sqlite-vec + memory_vec 虚拟表
|
|
57
|
+
const vecOpt = options?.sqliteVec;
|
|
58
|
+
if (vecOpt) {
|
|
59
|
+
const extensionPath = typeof vecOpt === 'object' ? vecOpt.extensionPath : undefined;
|
|
60
|
+
const loaded = await tryLoadSqliteVec(db, extensionPath);
|
|
61
|
+
agentDb._sqliteVec = loaded;
|
|
62
|
+
if (loaded && options?.vectorDimensions) {
|
|
63
|
+
const ok = ensureMemoryVecTable(db, options.vectorDimensions);
|
|
64
|
+
agentDb._vecDimensions = ok ? options.vectorDimensions : null;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return agentDb;
|
|
68
|
+
}
|
|
69
|
+
/** sqlite-vec 扩展是否已加载 */
|
|
70
|
+
get sqliteVecEnabled() {
|
|
71
|
+
return this._sqliteVec;
|
|
72
|
+
}
|
|
73
|
+
/** 已创建的 vec 表维度;未启用时为 null */
|
|
74
|
+
get vectorDimensions() {
|
|
75
|
+
return this._vecDimensions;
|
|
76
|
+
}
|
|
77
|
+
/** 旧库升级:补齐 memories 治理列 + 旧类型映射(必须在依赖新列的 INDEX 之前) */
|
|
78
|
+
migrateMemoryColumns() {
|
|
79
|
+
const cols = [
|
|
80
|
+
["status", "TEXT NOT NULL DEFAULT 'active'"],
|
|
81
|
+
['channel', 'TEXT'],
|
|
82
|
+
['future_use', 'TEXT'],
|
|
83
|
+
["anchors", "TEXT NOT NULL DEFAULT '[]'"],
|
|
84
|
+
['evidence', 'TEXT'],
|
|
85
|
+
['reinforced_at', 'INTEGER'],
|
|
86
|
+
['deleted', 'INTEGER NOT NULL DEFAULT 0'],
|
|
87
|
+
['deleted_at', 'INTEGER'],
|
|
88
|
+
['deleted_by', 'TEXT'],
|
|
89
|
+
['deleted_reason', 'TEXT'],
|
|
90
|
+
['deleted_meta', 'TEXT'],
|
|
91
|
+
];
|
|
92
|
+
for (const [name, ddl] of cols) {
|
|
93
|
+
try {
|
|
94
|
+
this.db.exec(`ALTER TABLE memories ADD COLUMN ${name} ${ddl}`);
|
|
95
|
+
}
|
|
96
|
+
catch {
|
|
97
|
+
// column already exists
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
// 旧 MemoryType → fact/method/norm(一次数据迁移,幂等)
|
|
101
|
+
this.db.exec(`
|
|
102
|
+
UPDATE memories SET type = CASE type
|
|
103
|
+
WHEN 'preference' THEN 'norm'
|
|
104
|
+
WHEN 'decision' THEN 'norm'
|
|
105
|
+
WHEN 'lesson' THEN 'method'
|
|
106
|
+
WHEN 'discovery' THEN 'fact'
|
|
107
|
+
WHEN 'context' THEN 'fact'
|
|
108
|
+
WHEN 'relationship' THEN 'fact'
|
|
109
|
+
ELSE type
|
|
110
|
+
END
|
|
111
|
+
WHERE type IN ('preference','decision','lesson','discovery','context','relationship')
|
|
112
|
+
`);
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* 创建所有表结构
|
|
116
|
+
*
|
|
117
|
+
* 顺序:CREATE TABLE IF NOT EXISTS → migrate 旧库列 → CREATE INDEX。
|
|
118
|
+
* 否则旧 agent.db 上对 `deleted` 建索引会直接 SQLITE_ERROR,导致 memoryStore 无法注入。
|
|
119
|
+
*/
|
|
120
|
+
createTables() {
|
|
121
|
+
this.db.exec(`
|
|
122
|
+
-- ── Memory 表 ──
|
|
123
|
+
CREATE TABLE IF NOT EXISTS memories (
|
|
124
|
+
id TEXT PRIMARY KEY,
|
|
125
|
+
type TEXT NOT NULL,
|
|
126
|
+
content TEXT NOT NULL,
|
|
127
|
+
source TEXT NOT NULL,
|
|
128
|
+
confidence REAL NOT NULL DEFAULT 0.5,
|
|
129
|
+
importance REAL NOT NULL DEFAULT 0.5,
|
|
130
|
+
access_count INTEGER NOT NULL DEFAULT 0,
|
|
131
|
+
last_accessed_at INTEGER NOT NULL,
|
|
132
|
+
created_at INTEGER NOT NULL,
|
|
133
|
+
decay_factor REAL NOT NULL DEFAULT 1.0,
|
|
134
|
+
tags TEXT NOT NULL DEFAULT '[]',
|
|
135
|
+
embedding TEXT,
|
|
136
|
+
status TEXT NOT NULL DEFAULT 'active',
|
|
137
|
+
channel TEXT,
|
|
138
|
+
future_use TEXT,
|
|
139
|
+
anchors TEXT NOT NULL DEFAULT '[]',
|
|
140
|
+
evidence TEXT,
|
|
141
|
+
reinforced_at INTEGER,
|
|
142
|
+
deleted INTEGER NOT NULL DEFAULT 0,
|
|
143
|
+
deleted_at INTEGER,
|
|
144
|
+
deleted_by TEXT,
|
|
145
|
+
deleted_reason TEXT,
|
|
146
|
+
deleted_meta TEXT
|
|
147
|
+
);
|
|
148
|
+
`);
|
|
149
|
+
// 旧库可能仍是无 deleted/status 的 schema —— 先补列再建索引
|
|
150
|
+
this.migrateMemoryColumns();
|
|
151
|
+
this.db.exec(`
|
|
152
|
+
CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
|
|
153
|
+
CREATE INDEX IF NOT EXISTS idx_memories_confidence ON memories(confidence);
|
|
154
|
+
CREATE INDEX IF NOT EXISTS idx_memories_importance ON memories(importance);
|
|
155
|
+
CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
|
|
156
|
+
CREATE INDEX IF NOT EXISTS idx_memories_deleted ON memories(deleted);
|
|
157
|
+
|
|
158
|
+
-- ── Concept 表 ──
|
|
159
|
+
CREATE TABLE IF NOT EXISTS concepts (
|
|
160
|
+
id TEXT PRIMARY KEY,
|
|
161
|
+
name TEXT NOT NULL,
|
|
162
|
+
description TEXT,
|
|
163
|
+
frequency INTEGER NOT NULL DEFAULT 1,
|
|
164
|
+
memory_ids TEXT NOT NULL DEFAULT '[]',
|
|
165
|
+
properties TEXT NOT NULL DEFAULT '[]',
|
|
166
|
+
embedding TEXT,
|
|
167
|
+
created_at INTEGER NOT NULL,
|
|
168
|
+
updated_at INTEGER NOT NULL
|
|
169
|
+
);
|
|
170
|
+
|
|
171
|
+
CREATE UNIQUE INDEX IF NOT EXISTS idx_concepts_name ON concepts(name);
|
|
172
|
+
|
|
173
|
+
-- ── Concept Edge 表 ──
|
|
174
|
+
CREATE TABLE IF NOT EXISTS concept_edges (
|
|
175
|
+
id TEXT PRIMARY KEY,
|
|
176
|
+
source_id TEXT NOT NULL REFERENCES concepts(id),
|
|
177
|
+
target_id TEXT NOT NULL REFERENCES concepts(id),
|
|
178
|
+
relation_type TEXT NOT NULL,
|
|
179
|
+
strength REAL NOT NULL DEFAULT 0.5,
|
|
180
|
+
description TEXT,
|
|
181
|
+
constraints TEXT NOT NULL DEFAULT '[]',
|
|
182
|
+
created_at INTEGER NOT NULL,
|
|
183
|
+
UNIQUE(source_id, target_id, relation_type)
|
|
184
|
+
);
|
|
185
|
+
|
|
186
|
+
CREATE INDEX IF NOT EXISTS idx_edges_source ON concept_edges(source_id);
|
|
187
|
+
CREATE INDEX IF NOT EXISTS idx_edges_target ON concept_edges(target_id);
|
|
188
|
+
CREATE INDEX IF NOT EXISTS idx_edges_type ON concept_edges(relation_type);
|
|
189
|
+
|
|
190
|
+
-- ── Wisdom 表 ──
|
|
191
|
+
CREATE TABLE IF NOT EXISTS wisdom (
|
|
192
|
+
id TEXT PRIMARY KEY,
|
|
193
|
+
content TEXT NOT NULL,
|
|
194
|
+
derived_from TEXT NOT NULL DEFAULT '[]',
|
|
195
|
+
priority INTEGER NOT NULL DEFAULT 0,
|
|
196
|
+
confidence REAL NOT NULL DEFAULT 0.5,
|
|
197
|
+
applicable_scenarios TEXT NOT NULL DEFAULT '[]',
|
|
198
|
+
status TEXT NOT NULL DEFAULT 'active',
|
|
199
|
+
created_at INTEGER NOT NULL,
|
|
200
|
+
updated_at INTEGER NOT NULL
|
|
201
|
+
);
|
|
202
|
+
|
|
203
|
+
-- ── Knowledge Sources 注册表 ──
|
|
204
|
+
CREATE TABLE IF NOT EXISTS knowledge_sources (
|
|
205
|
+
id TEXT PRIMARY KEY,
|
|
206
|
+
type TEXT NOT NULL,
|
|
207
|
+
location TEXT NOT NULL,
|
|
208
|
+
scope TEXT NOT NULL,
|
|
209
|
+
metadata TEXT NOT NULL DEFAULT '{}',
|
|
210
|
+
created_at INTEGER NOT NULL
|
|
211
|
+
);
|
|
212
|
+
|
|
213
|
+
-- ── 补录覆盖表(steward 进度;可重建) ──
|
|
214
|
+
CREATE TABLE IF NOT EXISTS memory_backfill (
|
|
215
|
+
session_id TEXT PRIMARY KEY,
|
|
216
|
+
agent_id TEXT,
|
|
217
|
+
fingerprint TEXT NOT NULL,
|
|
218
|
+
status TEXT NOT NULL,
|
|
219
|
+
reason TEXT,
|
|
220
|
+
accepted INTEGER,
|
|
221
|
+
trigger TEXT,
|
|
222
|
+
attempted_at INTEGER NOT NULL
|
|
223
|
+
);
|
|
224
|
+
CREATE INDEX IF NOT EXISTS idx_memory_backfill_status ON memory_backfill(status);
|
|
225
|
+
`);
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* 获取原始数据库实例(供子模块使用)
|
|
229
|
+
*/
|
|
230
|
+
get raw() {
|
|
231
|
+
return this.db;
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* 确保 memory_vec 虚拟表维度匹配(store 侧在已知 dimensions 后调用)。
|
|
235
|
+
*
|
|
236
|
+
* @returns 是否可用
|
|
237
|
+
*/
|
|
238
|
+
ensureMemoryVec(dimensions) {
|
|
239
|
+
if (!this._sqliteVec)
|
|
240
|
+
return false;
|
|
241
|
+
if (this._vecDimensions === dimensions)
|
|
242
|
+
return true;
|
|
243
|
+
const ok = ensureMemoryVecTable(this.db, dimensions);
|
|
244
|
+
this._vecDimensions = ok ? dimensions : null;
|
|
245
|
+
return ok;
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* 生成短 ID
|
|
249
|
+
*/
|
|
250
|
+
static generateId(prefix) {
|
|
251
|
+
const id = randomUUID().slice(0, 12);
|
|
252
|
+
return prefix ? `${prefix}_${id}` : id;
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* 关闭数据库
|
|
256
|
+
*/
|
|
257
|
+
close() {
|
|
258
|
+
this.db.close();
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* 统计信息
|
|
262
|
+
*/
|
|
263
|
+
stats() {
|
|
264
|
+
const tables = ['memories', 'concepts', 'concept_edges', 'wisdom', 'knowledge_sources'];
|
|
265
|
+
const result = {};
|
|
266
|
+
for (const table of tables) {
|
|
267
|
+
try {
|
|
268
|
+
const row = this.db.prepare(`SELECT COUNT(*) as count FROM ${table}`).get();
|
|
269
|
+
result[table] = row.count;
|
|
270
|
+
}
|
|
271
|
+
catch {
|
|
272
|
+
result[table] = 0;
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
return result;
|
|
276
|
+
}
|
|
277
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite 覆盖表 — `memory_backfill`(agent.db)
|
|
3
|
+
*/
|
|
4
|
+
import type { AgentDatabase } from './agent-db.js';
|
|
5
|
+
import type { BackfillCoverageRecord, BackfillCoverageStore } from '../backfill-coverage.js';
|
|
6
|
+
export declare class SqliteBackfillCoverageStore implements BackfillCoverageStore {
|
|
7
|
+
private readonly db;
|
|
8
|
+
constructor(db: AgentDatabase);
|
|
9
|
+
get(sessionId: string): Promise<BackfillCoverageRecord | null>;
|
|
10
|
+
put(record: BackfillCoverageRecord): Promise<void>;
|
|
11
|
+
listGaps(limit?: number): Promise<BackfillCoverageRecord[]>;
|
|
12
|
+
listAll(limit?: number): Promise<BackfillCoverageRecord[]>;
|
|
13
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SQLite 覆盖表 — `memory_backfill`(agent.db)
|
|
3
|
+
*/
|
|
4
|
+
function rowToRecord(r) {
|
|
5
|
+
return {
|
|
6
|
+
sessionId: r.session_id,
|
|
7
|
+
agentId: r.agent_id ?? undefined,
|
|
8
|
+
fingerprint: r.fingerprint,
|
|
9
|
+
status: r.status,
|
|
10
|
+
reason: r.reason ?? undefined,
|
|
11
|
+
accepted: r.accepted ?? undefined,
|
|
12
|
+
trigger: r.trigger ?? undefined,
|
|
13
|
+
attemptedAt: r.attempted_at,
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
export class SqliteBackfillCoverageStore {
|
|
17
|
+
db;
|
|
18
|
+
constructor(db) {
|
|
19
|
+
this.db = db;
|
|
20
|
+
}
|
|
21
|
+
async get(sessionId) {
|
|
22
|
+
const row = this.db.raw
|
|
23
|
+
.prepare('SELECT * FROM memory_backfill WHERE session_id = ?')
|
|
24
|
+
.get(sessionId);
|
|
25
|
+
return row ? rowToRecord(row) : null;
|
|
26
|
+
}
|
|
27
|
+
async put(record) {
|
|
28
|
+
this.db.raw
|
|
29
|
+
.prepare(`INSERT INTO memory_backfill
|
|
30
|
+
(session_id, agent_id, fingerprint, status, reason, accepted, trigger, attempted_at)
|
|
31
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
32
|
+
ON CONFLICT(session_id) DO UPDATE SET
|
|
33
|
+
agent_id = excluded.agent_id,
|
|
34
|
+
fingerprint = excluded.fingerprint,
|
|
35
|
+
status = excluded.status,
|
|
36
|
+
reason = excluded.reason,
|
|
37
|
+
accepted = excluded.accepted,
|
|
38
|
+
trigger = excluded.trigger,
|
|
39
|
+
attempted_at = excluded.attempted_at`)
|
|
40
|
+
.run(record.sessionId, record.agentId ?? null, record.fingerprint, record.status, record.reason ?? null, record.accepted ?? null, record.trigger ?? null, record.attemptedAt);
|
|
41
|
+
}
|
|
42
|
+
async listGaps(limit = 50) {
|
|
43
|
+
const rows = this.db.raw
|
|
44
|
+
.prepare(`SELECT * FROM memory_backfill
|
|
45
|
+
WHERE status IN ('failed', 'pending')
|
|
46
|
+
ORDER BY attempted_at DESC
|
|
47
|
+
LIMIT ?`)
|
|
48
|
+
.all(limit);
|
|
49
|
+
return rows.map(rowToRecord);
|
|
50
|
+
}
|
|
51
|
+
async listAll(limit = 200) {
|
|
52
|
+
const rows = this.db.raw
|
|
53
|
+
.prepare('SELECT * FROM memory_backfill ORDER BY attempted_at DESC LIMIT ?')
|
|
54
|
+
.all(limit);
|
|
55
|
+
return rows.map(rowToRecord);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SqliteConceptGraph — SQLite 认知图谱
|
|
3
|
+
*
|
|
4
|
+
* @module
|
|
5
|
+
*/
|
|
6
|
+
import type { ConceptGraphStore, ConceptNode, ConceptEdge, ConceptGraph } from '../cognition-types.js';
|
|
7
|
+
import { AgentDatabase } from './agent-db.js';
|
|
8
|
+
import type { EmbeddingProvider } from './embedding.js';
|
|
9
|
+
export interface SqliteConceptGraphOptions {
|
|
10
|
+
embeddingProvider?: EmbeddingProvider | null;
|
|
11
|
+
/** 自动合并的 cosine distance 阈值(默认 0.25) */
|
|
12
|
+
mergeThreshold?: number;
|
|
13
|
+
}
|
|
14
|
+
export declare class SqliteConceptGraph implements ConceptGraphStore {
|
|
15
|
+
private db;
|
|
16
|
+
private embedding;
|
|
17
|
+
private mergeThreshold;
|
|
18
|
+
constructor(db: AgentDatabase, options?: SqliteConceptGraphOptions);
|
|
19
|
+
addConcept(concept: Omit<ConceptNode, 'id' | 'frequency' | 'memoryIds'>): Promise<string>;
|
|
20
|
+
addEdge(edge: ConceptEdge): Promise<void>;
|
|
21
|
+
queryRelated(conceptName: string, depth?: number): Promise<ConceptGraph>;
|
|
22
|
+
extractFromText(text: string, memoryId: string): Promise<void>;
|
|
23
|
+
getFullGraph(): Promise<ConceptGraph>;
|
|
24
|
+
/**
|
|
25
|
+
* 查找语义相似的概念(用于去重)
|
|
26
|
+
*/
|
|
27
|
+
private findSimilarConcept;
|
|
28
|
+
/**
|
|
29
|
+
* 关联记忆到概念(从外部调用)
|
|
30
|
+
*/
|
|
31
|
+
linkMemory(conceptId: string, memoryId: string): void;
|
|
32
|
+
private rowToNode;
|
|
33
|
+
private rowToEdge;
|
|
34
|
+
}
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SqliteConceptGraph — SQLite 认知图谱
|
|
3
|
+
*
|
|
4
|
+
* @module
|
|
5
|
+
*/
|
|
6
|
+
import { AgentDatabase } from './agent-db.js';
|
|
7
|
+
import { cosineDistance, parseEmbedding, serializeEmbedding } from './vector-search.js';
|
|
8
|
+
export class SqliteConceptGraph {
|
|
9
|
+
db;
|
|
10
|
+
embedding;
|
|
11
|
+
mergeThreshold;
|
|
12
|
+
constructor(db, options) {
|
|
13
|
+
this.db = db;
|
|
14
|
+
this.embedding = options?.embeddingProvider ?? null;
|
|
15
|
+
this.mergeThreshold = options?.mergeThreshold ?? 0.25;
|
|
16
|
+
}
|
|
17
|
+
async addConcept(concept) {
|
|
18
|
+
// 1. 精确匹配
|
|
19
|
+
const existing = this.db.raw.prepare('SELECT id, frequency FROM concepts WHERE LOWER(name) = LOWER(?)').get(concept.name);
|
|
20
|
+
if (existing) {
|
|
21
|
+
this.db.raw.prepare('UPDATE concepts SET frequency = frequency + 1, updated_at = ? WHERE id = ?').run(Date.now(), existing.id);
|
|
22
|
+
return existing.id;
|
|
23
|
+
}
|
|
24
|
+
// 2. 语义匹配(需要 embedding)
|
|
25
|
+
if (this.embedding) {
|
|
26
|
+
const vec = await this.embedding.embed(concept.name);
|
|
27
|
+
const similarId = await this.findSimilarConcept(vec);
|
|
28
|
+
if (similarId) {
|
|
29
|
+
// 合并:更新 frequency
|
|
30
|
+
this.db.raw.prepare('UPDATE concepts SET frequency = frequency + 1, updated_at = ? WHERE id = ?').run(Date.now(), similarId);
|
|
31
|
+
return similarId;
|
|
32
|
+
}
|
|
33
|
+
// 新概念(带 embedding)
|
|
34
|
+
const id = AgentDatabase.generateId('cpt');
|
|
35
|
+
const now = Date.now();
|
|
36
|
+
this.db.raw.prepare(`
|
|
37
|
+
INSERT INTO concepts (id, name, description, frequency, memory_ids, properties, embedding, created_at, updated_at)
|
|
38
|
+
VALUES (?, ?, ?, 1, '[]', '[]', ?, ?, ?)
|
|
39
|
+
`).run(id, concept.name, concept.description ?? null, serializeEmbedding(vec), now, now);
|
|
40
|
+
return id;
|
|
41
|
+
}
|
|
42
|
+
// 新概念(无 embedding)
|
|
43
|
+
const id = AgentDatabase.generateId('cpt');
|
|
44
|
+
const now = Date.now();
|
|
45
|
+
this.db.raw.prepare(`
|
|
46
|
+
INSERT INTO concepts (id, name, description, frequency, memory_ids, properties, embedding, created_at, updated_at)
|
|
47
|
+
VALUES (?, ?, ?, 1, '[]', '[]', NULL, ?, ?)
|
|
48
|
+
`).run(id, concept.name, concept.description ?? null, now, now);
|
|
49
|
+
return id;
|
|
50
|
+
}
|
|
51
|
+
async addEdge(edge) {
|
|
52
|
+
const id = AgentDatabase.generateId('edge');
|
|
53
|
+
this.db.raw.prepare(`
|
|
54
|
+
INSERT OR IGNORE INTO concept_edges (id, source_id, target_id, relation_type, strength, description, constraints, created_at)
|
|
55
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
56
|
+
`).run(id, edge.sourceId, edge.targetId, edge.relationType, edge.strength, edge.description ?? null, JSON.stringify([]), Date.now());
|
|
57
|
+
}
|
|
58
|
+
async queryRelated(conceptName, depth = 1) {
|
|
59
|
+
// 找到起始概念
|
|
60
|
+
const start = this.db.raw.prepare('SELECT id FROM concepts WHERE LOWER(name) LIKE LOWER(?)').get(`%${conceptName}%`);
|
|
61
|
+
if (!start)
|
|
62
|
+
return { nodes: [], edges: [] };
|
|
63
|
+
// 递归 CTE 图遍历
|
|
64
|
+
const rows = this.db.raw.prepare(`
|
|
65
|
+
WITH RECURSIVE graph_walk(node_id, depth) AS (
|
|
66
|
+
SELECT ?, 0
|
|
67
|
+
UNION
|
|
68
|
+
SELECT DISTINCT
|
|
69
|
+
CASE WHEN e.source_id = gw.node_id THEN e.target_id ELSE e.source_id END,
|
|
70
|
+
gw.depth + 1
|
|
71
|
+
FROM graph_walk gw
|
|
72
|
+
JOIN concept_edges e ON (e.source_id = gw.node_id OR e.target_id = gw.node_id)
|
|
73
|
+
WHERE gw.depth < ?
|
|
74
|
+
)
|
|
75
|
+
SELECT DISTINCT c.*, gw.depth
|
|
76
|
+
FROM graph_walk gw
|
|
77
|
+
JOIN concepts c ON c.id = gw.node_id
|
|
78
|
+
ORDER BY gw.depth, c.frequency DESC
|
|
79
|
+
LIMIT 20
|
|
80
|
+
`).all(start.id, depth);
|
|
81
|
+
const nodes = rows.map(r => this.rowToNode(r));
|
|
82
|
+
const nodeIds = new Set(nodes.map(n => n.id));
|
|
83
|
+
// 获取相关的边
|
|
84
|
+
const allEdges = this.db.raw.prepare(`
|
|
85
|
+
SELECT * FROM concept_edges
|
|
86
|
+
WHERE source_id IN (${nodes.map(() => '?').join(',')})
|
|
87
|
+
OR target_id IN (${nodes.map(() => '?').join(',')})
|
|
88
|
+
`).all(...nodeIds, ...nodeIds);
|
|
89
|
+
const edges = allEdges
|
|
90
|
+
.filter((e) => nodeIds.has(e.source_id) && nodeIds.has(e.target_id))
|
|
91
|
+
.map((e) => this.rowToEdge(e));
|
|
92
|
+
return { nodes, edges };
|
|
93
|
+
}
|
|
94
|
+
async extractFromText(text, memoryId) {
|
|
95
|
+
// P0 简单实现:正则提取大写开头的词 + 共现分析
|
|
96
|
+
const conceptPattern = /[A-Z][a-z]+(?:\s+[A-Z][a-z]+)*/g;
|
|
97
|
+
const matches = text.match(conceptPattern) ?? [];
|
|
98
|
+
const conceptIds = [];
|
|
99
|
+
for (const match of new Set(matches)) {
|
|
100
|
+
if (match.length < 3 || match.length > 50)
|
|
101
|
+
continue;
|
|
102
|
+
const id = await this.addConcept({ name: match });
|
|
103
|
+
// 关联记忆
|
|
104
|
+
const row = this.db.raw.prepare('SELECT memory_ids FROM concepts WHERE id = ?').get(id);
|
|
105
|
+
if (row) {
|
|
106
|
+
const memoryIds = JSON.parse(row.memory_ids);
|
|
107
|
+
if (!memoryIds.includes(memoryId)) {
|
|
108
|
+
memoryIds.push(memoryId);
|
|
109
|
+
this.db.raw.prepare('UPDATE concepts SET memory_ids = ?, updated_at = ? WHERE id = ?')
|
|
110
|
+
.run(JSON.stringify(memoryIds), Date.now(), id);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
conceptIds.push(id);
|
|
114
|
+
}
|
|
115
|
+
// 共现关系
|
|
116
|
+
for (let i = 0; i < conceptIds.length; i++) {
|
|
117
|
+
for (let j = i + 1; j < conceptIds.length; j++) {
|
|
118
|
+
await this.addEdge({
|
|
119
|
+
sourceId: conceptIds[i],
|
|
120
|
+
targetId: conceptIds[j],
|
|
121
|
+
relationType: 'related',
|
|
122
|
+
strength: 0.5,
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
async getFullGraph() {
|
|
128
|
+
const nodes = this.db.raw.prepare('SELECT * FROM concepts').all()
|
|
129
|
+
.map(r => this.rowToNode(r));
|
|
130
|
+
const edges = this.db.raw.prepare('SELECT * FROM concept_edges').all()
|
|
131
|
+
.map(r => this.rowToEdge(r));
|
|
132
|
+
return { nodes, edges };
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* 查找语义相似的概念(用于去重)
|
|
136
|
+
*/
|
|
137
|
+
async findSimilarConcept(embedding) {
|
|
138
|
+
const rows = this.db.raw.prepare('SELECT id, embedding FROM concepts WHERE embedding IS NOT NULL').all();
|
|
139
|
+
let bestId = null;
|
|
140
|
+
let bestDistance = Infinity;
|
|
141
|
+
for (const row of rows) {
|
|
142
|
+
const vec = parseEmbedding(row.embedding);
|
|
143
|
+
if (!vec)
|
|
144
|
+
continue;
|
|
145
|
+
const distance = cosineDistance(embedding, vec);
|
|
146
|
+
if (distance < bestDistance) {
|
|
147
|
+
bestDistance = distance;
|
|
148
|
+
bestId = row.id;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
if (bestDistance <= this.mergeThreshold) {
|
|
152
|
+
return bestId;
|
|
153
|
+
}
|
|
154
|
+
return null;
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* 关联记忆到概念(从外部调用)
|
|
158
|
+
*/
|
|
159
|
+
linkMemory(conceptId, memoryId) {
|
|
160
|
+
const row = this.db.raw.prepare('SELECT memory_ids FROM concepts WHERE id = ?').get(conceptId);
|
|
161
|
+
if (!row)
|
|
162
|
+
return;
|
|
163
|
+
const memoryIds = JSON.parse(row.memory_ids);
|
|
164
|
+
if (!memoryIds.includes(memoryId)) {
|
|
165
|
+
memoryIds.push(memoryId);
|
|
166
|
+
this.db.raw.prepare('UPDATE concepts SET memory_ids = ?, updated_at = ? WHERE id = ?')
|
|
167
|
+
.run(JSON.stringify(memoryIds), Date.now(), conceptId);
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
rowToNode(row) {
|
|
171
|
+
return {
|
|
172
|
+
id: row.id,
|
|
173
|
+
name: row.name,
|
|
174
|
+
description: row.description ?? undefined,
|
|
175
|
+
frequency: row.frequency,
|
|
176
|
+
memoryIds: JSON.parse(row.memory_ids),
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
rowToEdge(row) {
|
|
180
|
+
return {
|
|
181
|
+
sourceId: row.source_id,
|
|
182
|
+
targetId: row.target_id,
|
|
183
|
+
relationType: row.relation_type,
|
|
184
|
+
strength: row.strength,
|
|
185
|
+
description: row.description ?? undefined,
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 从 ModelsConfig.embedding 创建 EmbeddingProvider
|
|
3
|
+
*
|
|
4
|
+
* 配置放在 models 下:memory / knowledge / plugin 共用。
|
|
5
|
+
* 未配置或 enabled=false 时返回 null,调用方走关键词检索。
|
|
6
|
+
*
|
|
7
|
+
* 鉴权语义:
|
|
8
|
+
* - `embedding.apiKey` 为 `""`:强制无鉴权(即使 provider 有 key)
|
|
9
|
+
* - `embedding.apiKey` 未写出且配置了 `provider`:继承该 provider 的 apiKey
|
|
10
|
+
* - 两者都没有:无鉴权
|
|
11
|
+
*/
|
|
12
|
+
import type { EmbeddingModelConfig, ModelsConfig, ModelProviderConfig } from '../../../config.js';
|
|
13
|
+
import { type EmbeddingProvider } from './embedding.js';
|
|
14
|
+
import type { VectorEngineChoice } from '../../../config.js';
|
|
15
|
+
/** 解析后的 embedding 运行时选项(供 SqliteMemoryStore / AgentDatabase) */
|
|
16
|
+
export interface ResolvedEmbeddingRuntime {
|
|
17
|
+
provider: EmbeddingProvider | null;
|
|
18
|
+
vectorEngine: VectorEngineChoice;
|
|
19
|
+
sqliteVecExtensionPath?: string;
|
|
20
|
+
dimensions?: number;
|
|
21
|
+
model: string;
|
|
22
|
+
type: NonNullable<EmbeddingModelConfig['type']>;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* 从 models.embedding 解析 baseUrl / apiKey(可引用 models.providers)。
|
|
26
|
+
*
|
|
27
|
+
* apiKey:写出(含 "")以 embedding 为准;未写出时才继承 provider。
|
|
28
|
+
*/
|
|
29
|
+
export declare function resolveEmbeddingEndpoint(embedding: EmbeddingModelConfig, providers?: Record<string, ModelProviderConfig>): {
|
|
30
|
+
baseUrl?: string;
|
|
31
|
+
apiKey?: string;
|
|
32
|
+
type: NonNullable<EmbeddingModelConfig['type']>;
|
|
33
|
+
};
|
|
34
|
+
/**
|
|
35
|
+
* 判断 models.embedding 是否启用向量路径。
|
|
36
|
+
*/
|
|
37
|
+
export declare function isEmbeddingEnabled(models?: ModelsConfig | null): boolean;
|
|
38
|
+
/**
|
|
39
|
+
* 解析完整 embedding 运行时配置。
|
|
40
|
+
*
|
|
41
|
+
* @returns 未启用时 provider 为 null
|
|
42
|
+
*/
|
|
43
|
+
export declare function resolveEmbeddingRuntime(models?: ModelsConfig | null): ResolvedEmbeddingRuntime | null;
|
|
44
|
+
/**
|
|
45
|
+
* 仅创建 EmbeddingProvider(便捷入口)。
|
|
46
|
+
*/
|
|
47
|
+
export declare function createEmbeddingProviderFromModels(models?: ModelsConfig | null): EmbeddingProvider | null;
|