@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,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ConnectorFetcher — 将 KnowledgeConnector 适配为 SourceFetcher
|
|
3
|
+
*/
|
|
4
|
+
export class ConnectorFetcher {
|
|
5
|
+
registry;
|
|
6
|
+
constructor(registry) {
|
|
7
|
+
this.registry = registry;
|
|
8
|
+
}
|
|
9
|
+
async discover(source, cred) {
|
|
10
|
+
const connector = this.registry.resolve(source);
|
|
11
|
+
return connector.discover({
|
|
12
|
+
location: source.location,
|
|
13
|
+
auth: cred,
|
|
14
|
+
network: source.network,
|
|
15
|
+
maxPages: source.discover?.maxPages,
|
|
16
|
+
}, source);
|
|
17
|
+
}
|
|
18
|
+
async fetch(source, ref, cred) {
|
|
19
|
+
const connector = this.registry.resolve(source);
|
|
20
|
+
return connector.fetch({
|
|
21
|
+
location: source.location,
|
|
22
|
+
auth: cred,
|
|
23
|
+
network: source.network,
|
|
24
|
+
maxPages: source.discover?.maxPages,
|
|
25
|
+
}, source, ref);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* KnowledgeConnector — 文档型外源连接器插件面
|
|
3
|
+
*
|
|
4
|
+
* 边界:只同步「文档快照」;活系统 live query 归 Tool,不入 Knowledge。
|
|
5
|
+
* 密钥经 CredentialStore(authRef)注入,配置不进 knowledge.db 明文。
|
|
6
|
+
*/
|
|
7
|
+
import type { ResolvedCredential } from '../governance/credentials/types.js';
|
|
8
|
+
import type { DiscoveredDocRef, VirtualDocument } from './fetchers.js';
|
|
9
|
+
import type { KnowledgeSource, KnowledgeSourceNetwork } from './types.js';
|
|
10
|
+
export interface ConnectorContext {
|
|
11
|
+
/** 源 location(list 入口或配置引用) */
|
|
12
|
+
location: string;
|
|
13
|
+
/** 已解析凭证(可空) */
|
|
14
|
+
auth?: ResolvedCredential | null;
|
|
15
|
+
network?: KnowledgeSourceNetwork;
|
|
16
|
+
maxPages?: number;
|
|
17
|
+
}
|
|
18
|
+
export interface KnowledgeConnector {
|
|
19
|
+
id: string;
|
|
20
|
+
discover(ctx: ConnectorContext, source: KnowledgeSource): Promise<DiscoveredDocRef[]>;
|
|
21
|
+
fetch(ctx: ConnectorContext, source: KnowledgeSource, ref: DiscoveredDocRef): Promise<VirtualDocument | null>;
|
|
22
|
+
}
|
|
23
|
+
/** generic REST list+get 配置(location 可为 JSON 串,或纯 listUrl) */
|
|
24
|
+
export interface RestConnectorConfig {
|
|
25
|
+
type?: 'rest';
|
|
26
|
+
/** 列表接口 URL(location 为纯 URL 时即此) */
|
|
27
|
+
listUrl: string;
|
|
28
|
+
/** JSON 路径到数组,如 `results` / `data.items`;空则根数组或常见信封 */
|
|
29
|
+
itemsPath?: string;
|
|
30
|
+
/** 逻辑 path 字段(缺省 url 的 pathname 或 id) */
|
|
31
|
+
pathField?: string;
|
|
32
|
+
/** 展示/描述用标题字段 */
|
|
33
|
+
titleField?: string;
|
|
34
|
+
/** 正文字段(HTML/文本);与 urlField 二选一 */
|
|
35
|
+
contentField?: string;
|
|
36
|
+
/** 有此字段则按 URL 再拉正文 */
|
|
37
|
+
urlField?: string;
|
|
38
|
+
maxPages?: number;
|
|
39
|
+
}
|
|
40
|
+
/** generic REST list + content/get */
|
|
41
|
+
export declare class RestConnector implements KnowledgeConnector {
|
|
42
|
+
readonly id = "rest";
|
|
43
|
+
discover(ctx: ConnectorContext, source: KnowledgeSource): Promise<DiscoveredDocRef[]>;
|
|
44
|
+
fetch(ctx: ConnectorContext, source: KnowledgeSource, ref: DiscoveredDocRef): Promise<VirtualDocument | null>;
|
|
45
|
+
}
|
|
46
|
+
export declare class ConnectorRegistry {
|
|
47
|
+
private byId;
|
|
48
|
+
constructor(connectors?: KnowledgeConnector[]);
|
|
49
|
+
register(connector: KnowledgeConnector): void;
|
|
50
|
+
get(id: string): KnowledgeConnector | null;
|
|
51
|
+
/**
|
|
52
|
+
* 由 source 推断 connector:location JSON 的 type,或默认 rest
|
|
53
|
+
*/
|
|
54
|
+
resolve(source: KnowledgeSource): KnowledgeConnector;
|
|
55
|
+
}
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* KnowledgeConnector — 文档型外源连接器插件面
|
|
3
|
+
*
|
|
4
|
+
* 边界:只同步「文档快照」;活系统 live query 归 Tool,不入 Knowledge。
|
|
5
|
+
* 密钥经 CredentialStore(authRef)注入,配置不进 knowledge.db 明文。
|
|
6
|
+
*/
|
|
7
|
+
import { createHash } from 'node:crypto';
|
|
8
|
+
import { htmlToStructuredText, looksLikeHtml } from './html.js';
|
|
9
|
+
import { guardedFetch } from './network-guard.js';
|
|
10
|
+
function dig(obj, path) {
|
|
11
|
+
if (!path)
|
|
12
|
+
return obj;
|
|
13
|
+
let cur = obj;
|
|
14
|
+
for (const part of path.split('.')) {
|
|
15
|
+
if (cur == null || typeof cur !== 'object')
|
|
16
|
+
return undefined;
|
|
17
|
+
cur = cur[part];
|
|
18
|
+
}
|
|
19
|
+
return cur;
|
|
20
|
+
}
|
|
21
|
+
function parseRestConfig(location) {
|
|
22
|
+
const trimmed = location.trim();
|
|
23
|
+
if (trimmed.startsWith('{')) {
|
|
24
|
+
const parsed = JSON.parse(trimmed);
|
|
25
|
+
if (!parsed.listUrl)
|
|
26
|
+
throw new Error('rest connector config requires listUrl');
|
|
27
|
+
return parsed;
|
|
28
|
+
}
|
|
29
|
+
return { listUrl: trimmed };
|
|
30
|
+
}
|
|
31
|
+
function pickItems(body, itemsPath) {
|
|
32
|
+
if (itemsPath) {
|
|
33
|
+
const v = dig(body, itemsPath);
|
|
34
|
+
return Array.isArray(v) ? v : [];
|
|
35
|
+
}
|
|
36
|
+
if (Array.isArray(body))
|
|
37
|
+
return body;
|
|
38
|
+
for (const key of ['items', 'results', 'data', 'entries', 'pages', 'value']) {
|
|
39
|
+
const v = dig(body, key);
|
|
40
|
+
if (Array.isArray(v))
|
|
41
|
+
return v;
|
|
42
|
+
if (v && typeof v === 'object' && Array.isArray(v.items)) {
|
|
43
|
+
return v.items;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return [];
|
|
47
|
+
}
|
|
48
|
+
function itemPath(item, cfg, index) {
|
|
49
|
+
if (cfg.pathField) {
|
|
50
|
+
const p = dig(item, cfg.pathField);
|
|
51
|
+
if (p != null)
|
|
52
|
+
return String(p);
|
|
53
|
+
}
|
|
54
|
+
const url = cfg.urlField ? dig(item, cfg.urlField) : undefined;
|
|
55
|
+
if (url != null) {
|
|
56
|
+
try {
|
|
57
|
+
return decodeURIComponent(new URL(String(url)).pathname.replace(/^\//, '')) || `item-${index}`;
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
// fall through
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
const id = item.id ?? item.slug ?? item.key;
|
|
64
|
+
if (id != null)
|
|
65
|
+
return String(id);
|
|
66
|
+
// 无稳定业务键:用内容 hash,避免纯下标随列表顺序漂移
|
|
67
|
+
return `item-${createHash('sha1').update(JSON.stringify(item)).digest('hex').slice(0, 12)}`;
|
|
68
|
+
}
|
|
69
|
+
/** generic REST list + content/get */
|
|
70
|
+
export class RestConnector {
|
|
71
|
+
id = 'rest';
|
|
72
|
+
async discover(ctx, source) {
|
|
73
|
+
const cfg = parseRestConfig(ctx.location);
|
|
74
|
+
const maxPages = ctx.maxPages ?? cfg.maxPages ?? 50;
|
|
75
|
+
const res = await guardedFetch(cfg.listUrl, networkFrom(ctx, source), {
|
|
76
|
+
headers: { ...(ctx.auth?.headers ?? {}), accept: 'application/json' },
|
|
77
|
+
});
|
|
78
|
+
const body = JSON.parse(res.body);
|
|
79
|
+
const items = pickItems(body, cfg.itemsPath).slice(0, maxPages);
|
|
80
|
+
const out = [];
|
|
81
|
+
items.forEach((raw, index) => {
|
|
82
|
+
if (!raw || typeof raw !== 'object')
|
|
83
|
+
return;
|
|
84
|
+
const item = raw;
|
|
85
|
+
const path = itemPath(item, cfg, index);
|
|
86
|
+
const externalUrl = cfg.urlField
|
|
87
|
+
? String(dig(item, cfg.urlField) ?? cfg.listUrl)
|
|
88
|
+
: cfg.listUrl;
|
|
89
|
+
out.push({ path, externalUrl });
|
|
90
|
+
});
|
|
91
|
+
return out;
|
|
92
|
+
}
|
|
93
|
+
async fetch(ctx, source, ref) {
|
|
94
|
+
const cfg = parseRestConfig(ctx.location);
|
|
95
|
+
const maxPages = ctx.maxPages ?? cfg.maxPages ?? 50;
|
|
96
|
+
// 列表即内容:重新拉列表找该 path(小规模可接受;后续可缓存)
|
|
97
|
+
const res = await guardedFetch(cfg.listUrl, networkFrom(ctx, source), {
|
|
98
|
+
headers: { ...(ctx.auth?.headers ?? {}), accept: 'application/json' },
|
|
99
|
+
});
|
|
100
|
+
const body = JSON.parse(res.body);
|
|
101
|
+
const items = pickItems(body, cfg.itemsPath).slice(0, maxPages);
|
|
102
|
+
let hit = null;
|
|
103
|
+
items.forEach((raw, index) => {
|
|
104
|
+
if (hit || !raw || typeof raw !== 'object')
|
|
105
|
+
return;
|
|
106
|
+
const item = raw;
|
|
107
|
+
if (itemPath(item, cfg, index) === ref.path)
|
|
108
|
+
hit = item;
|
|
109
|
+
});
|
|
110
|
+
if (!hit)
|
|
111
|
+
return null;
|
|
112
|
+
const item = hit;
|
|
113
|
+
let content = '';
|
|
114
|
+
let externalUrl = ref.externalUrl ?? cfg.listUrl;
|
|
115
|
+
if (cfg.contentField) {
|
|
116
|
+
const raw = dig(item, cfg.contentField);
|
|
117
|
+
content = raw == null ? '' : String(raw);
|
|
118
|
+
if (looksLikeHtml(content))
|
|
119
|
+
content = htmlToStructuredText(content);
|
|
120
|
+
}
|
|
121
|
+
else if (cfg.urlField) {
|
|
122
|
+
const pageUrl = String(dig(item, cfg.urlField) ?? '');
|
|
123
|
+
if (!pageUrl)
|
|
124
|
+
return null;
|
|
125
|
+
externalUrl = pageUrl;
|
|
126
|
+
const page = await guardedFetch(pageUrl, networkFrom(ctx, source), {
|
|
127
|
+
headers: ctx.auth?.headers,
|
|
128
|
+
});
|
|
129
|
+
content = looksLikeHtml(page.body, page.contentType)
|
|
130
|
+
? htmlToStructuredText(page.body)
|
|
131
|
+
: page.body;
|
|
132
|
+
}
|
|
133
|
+
else {
|
|
134
|
+
// 整个 item JSON 文本化
|
|
135
|
+
content = JSON.stringify(item, null, 2);
|
|
136
|
+
}
|
|
137
|
+
return {
|
|
138
|
+
path: ref.path,
|
|
139
|
+
externalUrl,
|
|
140
|
+
content,
|
|
141
|
+
contentType: 'text/plain',
|
|
142
|
+
size: Buffer.byteLength(content, 'utf8'),
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
function networkFrom(ctx, source) {
|
|
147
|
+
return {
|
|
148
|
+
allowPrivateNetwork: source.network?.allowPrivateNetwork === true,
|
|
149
|
+
maxResponseBytes: source.network?.maxResponseBytes,
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
export class ConnectorRegistry {
|
|
153
|
+
byId = new Map();
|
|
154
|
+
constructor(connectors = [new RestConnector()]) {
|
|
155
|
+
for (const c of connectors)
|
|
156
|
+
this.register(c);
|
|
157
|
+
}
|
|
158
|
+
register(connector) {
|
|
159
|
+
this.byId.set(connector.id, connector);
|
|
160
|
+
}
|
|
161
|
+
get(id) {
|
|
162
|
+
return this.byId.get(id) ?? null;
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* 由 source 推断 connector:location JSON 的 type,或默认 rest
|
|
166
|
+
*/
|
|
167
|
+
resolve(source) {
|
|
168
|
+
const loc = source.location.trim();
|
|
169
|
+
if (loc.startsWith('{')) {
|
|
170
|
+
const type = JSON.parse(loc).type ?? 'rest';
|
|
171
|
+
const hit = this.byId.get(type);
|
|
172
|
+
if (!hit)
|
|
173
|
+
throw new Error(`unknown connector type: ${type}`);
|
|
174
|
+
return hit;
|
|
175
|
+
}
|
|
176
|
+
const rest = this.byId.get('rest');
|
|
177
|
+
if (!rest)
|
|
178
|
+
throw new Error('rest connector not registered');
|
|
179
|
+
return rest;
|
|
180
|
+
}
|
|
181
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* KnowledgeDatabase — OCTOPI_HOME/knowledge/knowledge.db
|
|
3
|
+
*
|
|
4
|
+
* 全 scope Source 权威 + Project 挂载 + Global 屏蔽。
|
|
5
|
+
* 不存 chunk/vector(Index 可重建投影,P2+)。
|
|
6
|
+
*/
|
|
7
|
+
import type { DatabaseSync } from 'node:sqlite';
|
|
8
|
+
export interface KnowledgeDatabaseOptions {
|
|
9
|
+
dbPath?: string;
|
|
10
|
+
wal?: boolean;
|
|
11
|
+
busyTimeoutMs?: number;
|
|
12
|
+
}
|
|
13
|
+
export declare class KnowledgeDatabase {
|
|
14
|
+
private db;
|
|
15
|
+
private constructor();
|
|
16
|
+
/**
|
|
17
|
+
* 打开/创建 knowledge.db(Node >= 24 node:sqlite)
|
|
18
|
+
*/
|
|
19
|
+
static create(options?: KnowledgeDatabaseOptions): Promise<KnowledgeDatabase>;
|
|
20
|
+
private createTables;
|
|
21
|
+
/** 幂等迁移:外源 ingest / 凭证引用列 */
|
|
22
|
+
private migrate;
|
|
23
|
+
get raw(): DatabaseSync;
|
|
24
|
+
close(): void;
|
|
25
|
+
stats(): Record<string, number>;
|
|
26
|
+
}
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* KnowledgeDatabase — OCTOPI_HOME/knowledge/knowledge.db
|
|
3
|
+
*
|
|
4
|
+
* 全 scope Source 权威 + Project 挂载 + Global 屏蔽。
|
|
5
|
+
* 不存 chunk/vector(Index 可重建投影,P2+)。
|
|
6
|
+
*/
|
|
7
|
+
import { mkdir } from 'node:fs/promises';
|
|
8
|
+
import { dirname } from 'node:path';
|
|
9
|
+
export class KnowledgeDatabase {
|
|
10
|
+
db;
|
|
11
|
+
constructor(db) {
|
|
12
|
+
this.db = db;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* 打开/创建 knowledge.db(Node >= 24 node:sqlite)
|
|
16
|
+
*/
|
|
17
|
+
static async create(options) {
|
|
18
|
+
let DatabaseSyncCtor;
|
|
19
|
+
try {
|
|
20
|
+
const mod = await import('node:sqlite');
|
|
21
|
+
DatabaseSyncCtor = mod.DatabaseSync;
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
throw new Error(`KnowledgeDatabase requires Node.js >= 24 built-in "node:sqlite". process.version=${process.version}`);
|
|
25
|
+
}
|
|
26
|
+
const dbPath = options?.dbPath ?? ':memory:';
|
|
27
|
+
if (dbPath !== ':memory:') {
|
|
28
|
+
await mkdir(dirname(dbPath), { recursive: true });
|
|
29
|
+
}
|
|
30
|
+
const db = new DatabaseSyncCtor(dbPath, {
|
|
31
|
+
timeout: options?.busyTimeoutMs ?? 5000,
|
|
32
|
+
enableForeignKeyConstraints: false,
|
|
33
|
+
});
|
|
34
|
+
if (options?.wal !== false) {
|
|
35
|
+
db.exec('PRAGMA journal_mode = WAL');
|
|
36
|
+
}
|
|
37
|
+
const kdb = new KnowledgeDatabase(db);
|
|
38
|
+
kdb.createTables();
|
|
39
|
+
return kdb;
|
|
40
|
+
}
|
|
41
|
+
createTables() {
|
|
42
|
+
this.db.exec(`
|
|
43
|
+
CREATE TABLE IF NOT EXISTS knowledge_sources (
|
|
44
|
+
id TEXT PRIMARY KEY,
|
|
45
|
+
kind TEXT NOT NULL,
|
|
46
|
+
location TEXT NOT NULL,
|
|
47
|
+
scope_level TEXT NOT NULL,
|
|
48
|
+
scope_key TEXT NOT NULL,
|
|
49
|
+
sync_json TEXT NOT NULL DEFAULT '{}',
|
|
50
|
+
status TEXT NOT NULL DEFAULT 'pending',
|
|
51
|
+
coverage REAL,
|
|
52
|
+
errors_json TEXT NOT NULL DEFAULT '[]',
|
|
53
|
+
display_name TEXT NOT NULL,
|
|
54
|
+
description TEXT,
|
|
55
|
+
generated_description TEXT,
|
|
56
|
+
catalog_priority INTEGER,
|
|
57
|
+
hidden_from_catalog INTEGER NOT NULL DEFAULT 0,
|
|
58
|
+
created_at INTEGER NOT NULL,
|
|
59
|
+
updated_at INTEGER NOT NULL
|
|
60
|
+
);
|
|
61
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_sources_scope
|
|
62
|
+
ON knowledge_sources(scope_level, scope_key);
|
|
63
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_sources_status
|
|
64
|
+
ON knowledge_sources(status);
|
|
65
|
+
|
|
66
|
+
-- Project 显式挂载(默认拒绝):project_key + agent_id
|
|
67
|
+
CREATE TABLE IF NOT EXISTS knowledge_projects (
|
|
68
|
+
project_key TEXT PRIMARY KEY,
|
|
69
|
+
display_name TEXT,
|
|
70
|
+
created_at INTEGER NOT NULL,
|
|
71
|
+
updated_at INTEGER NOT NULL
|
|
72
|
+
);
|
|
73
|
+
|
|
74
|
+
CREATE TABLE IF NOT EXISTS knowledge_project_agents (
|
|
75
|
+
project_key TEXT NOT NULL,
|
|
76
|
+
agent_id TEXT NOT NULL,
|
|
77
|
+
created_at INTEGER NOT NULL,
|
|
78
|
+
PRIMARY KEY (project_key, agent_id)
|
|
79
|
+
);
|
|
80
|
+
|
|
81
|
+
-- Global 源对 agent 的屏蔽
|
|
82
|
+
CREATE TABLE IF NOT EXISTS knowledge_agent_hidden (
|
|
83
|
+
agent_id TEXT NOT NULL,
|
|
84
|
+
source_id TEXT NOT NULL,
|
|
85
|
+
created_at INTEGER NOT NULL,
|
|
86
|
+
PRIMARY KEY (agent_id, source_id)
|
|
87
|
+
);
|
|
88
|
+
|
|
89
|
+
-- 会话可见视图 overlay(资产归属不变;只改本场 effective view)
|
|
90
|
+
CREATE TABLE IF NOT EXISTS knowledge_session_visibility (
|
|
91
|
+
session_id TEXT NOT NULL,
|
|
92
|
+
target_type TEXT NOT NULL CHECK (target_type IN ('project', 'source')),
|
|
93
|
+
target_id TEXT NOT NULL,
|
|
94
|
+
op TEXT NOT NULL CHECK (op IN ('include', 'exclude')),
|
|
95
|
+
created_at INTEGER NOT NULL,
|
|
96
|
+
PRIMARY KEY (session_id, target_type, target_id)
|
|
97
|
+
);
|
|
98
|
+
|
|
99
|
+
-- ── Index 投影(可重建;P2 Phase A)──
|
|
100
|
+
CREATE TABLE IF NOT EXISTS knowledge_files (
|
|
101
|
+
id TEXT PRIMARY KEY,
|
|
102
|
+
source_id TEXT NOT NULL,
|
|
103
|
+
path TEXT NOT NULL,
|
|
104
|
+
content_hash TEXT NOT NULL,
|
|
105
|
+
size INTEGER NOT NULL DEFAULT 0,
|
|
106
|
+
mtime INTEGER NOT NULL DEFAULT 0,
|
|
107
|
+
adapter_id TEXT,
|
|
108
|
+
status TEXT NOT NULL DEFAULT 'indexed',
|
|
109
|
+
error TEXT,
|
|
110
|
+
chunk_count INTEGER NOT NULL DEFAULT 0,
|
|
111
|
+
indexed_at INTEGER NOT NULL,
|
|
112
|
+
UNIQUE (source_id, path)
|
|
113
|
+
);
|
|
114
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_files_source ON knowledge_files(source_id);
|
|
115
|
+
|
|
116
|
+
CREATE TABLE IF NOT EXISTS knowledge_chunks (
|
|
117
|
+
id TEXT PRIMARY KEY,
|
|
118
|
+
file_id TEXT NOT NULL,
|
|
119
|
+
source_id TEXT NOT NULL,
|
|
120
|
+
path TEXT NOT NULL,
|
|
121
|
+
ordinal INTEGER NOT NULL,
|
|
122
|
+
text TEXT NOT NULL,
|
|
123
|
+
start_line INTEGER NOT NULL DEFAULT 1,
|
|
124
|
+
end_line INTEGER NOT NULL DEFAULT 1
|
|
125
|
+
);
|
|
126
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_chunks_source ON knowledge_chunks(source_id);
|
|
127
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_chunks_file ON knowledge_chunks(file_id);
|
|
128
|
+
|
|
129
|
+
-- Phase B 向量(可关;未配 embedding 则不写)
|
|
130
|
+
CREATE TABLE IF NOT EXISTS knowledge_chunk_embeddings (
|
|
131
|
+
chunk_id TEXT PRIMARY KEY,
|
|
132
|
+
dimensions INTEGER NOT NULL,
|
|
133
|
+
embedding_json TEXT NOT NULL,
|
|
134
|
+
created_at INTEGER NOT NULL
|
|
135
|
+
);
|
|
136
|
+
|
|
137
|
+
-- 使用痕迹(P5;提升候选计量,非权威)
|
|
138
|
+
CREATE TABLE IF NOT EXISTS knowledge_hits (
|
|
139
|
+
id TEXT PRIMARY KEY,
|
|
140
|
+
source_id TEXT NOT NULL,
|
|
141
|
+
chunk_id TEXT,
|
|
142
|
+
path TEXT NOT NULL,
|
|
143
|
+
agent_id TEXT,
|
|
144
|
+
session_id TEXT,
|
|
145
|
+
query TEXT NOT NULL,
|
|
146
|
+
mode TEXT NOT NULL DEFAULT 'inject',
|
|
147
|
+
created_at INTEGER NOT NULL
|
|
148
|
+
);
|
|
149
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_hits_path ON knowledge_hits(path);
|
|
150
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_hits_source ON knowledge_hits(source_id);
|
|
151
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_hits_created ON knowledge_hits(created_at);
|
|
152
|
+
|
|
153
|
+
-- ingest 任务队列(背压排队,不丢任务)
|
|
154
|
+
CREATE TABLE IF NOT EXISTS knowledge_jobs (
|
|
155
|
+
id TEXT PRIMARY KEY,
|
|
156
|
+
source_id TEXT NOT NULL,
|
|
157
|
+
kind TEXT NOT NULL,
|
|
158
|
+
path TEXT,
|
|
159
|
+
priority INTEGER NOT NULL DEFAULT 2,
|
|
160
|
+
status TEXT NOT NULL DEFAULT 'queued',
|
|
161
|
+
attempts INTEGER NOT NULL DEFAULT 0,
|
|
162
|
+
last_error TEXT,
|
|
163
|
+
created_at INTEGER NOT NULL,
|
|
164
|
+
updated_at INTEGER NOT NULL
|
|
165
|
+
);
|
|
166
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_jobs_status
|
|
167
|
+
ON knowledge_jobs(status, priority, created_at);
|
|
168
|
+
CREATE INDEX IF NOT EXISTS idx_knowledge_jobs_source ON knowledge_jobs(source_id);
|
|
169
|
+
`);
|
|
170
|
+
this.migrate();
|
|
171
|
+
}
|
|
172
|
+
/** 幂等迁移:外源 ingest / 凭证引用列 */
|
|
173
|
+
migrate() {
|
|
174
|
+
const cols = this.db
|
|
175
|
+
.prepare(`PRAGMA table_info(knowledge_files)`)
|
|
176
|
+
.all();
|
|
177
|
+
const names = new Set(cols.map((c) => c.name));
|
|
178
|
+
if (!names.has('external_url')) {
|
|
179
|
+
this.db.exec(`ALTER TABLE knowledge_files ADD COLUMN external_url TEXT`);
|
|
180
|
+
}
|
|
181
|
+
if (!names.has('etag')) {
|
|
182
|
+
this.db.exec(`ALTER TABLE knowledge_files ADD COLUMN etag TEXT`);
|
|
183
|
+
}
|
|
184
|
+
if (!names.has('last_modified')) {
|
|
185
|
+
this.db.exec(`ALTER TABLE knowledge_files ADD COLUMN last_modified TEXT`);
|
|
186
|
+
}
|
|
187
|
+
const srcCols = this.db
|
|
188
|
+
.prepare(`PRAGMA table_info(knowledge_sources)`)
|
|
189
|
+
.all();
|
|
190
|
+
const srcNames = new Set(srcCols.map((c) => c.name));
|
|
191
|
+
if (!srcNames.has('auth_ref')) {
|
|
192
|
+
this.db.exec(`ALTER TABLE knowledge_sources ADD COLUMN auth_ref TEXT`);
|
|
193
|
+
}
|
|
194
|
+
if (!srcNames.has('network_json')) {
|
|
195
|
+
this.db.exec(`ALTER TABLE knowledge_sources ADD COLUMN network_json TEXT`);
|
|
196
|
+
}
|
|
197
|
+
if (!srcNames.has('last_polled_at')) {
|
|
198
|
+
this.db.exec(`ALTER TABLE knowledge_sources ADD COLUMN last_polled_at INTEGER`);
|
|
199
|
+
}
|
|
200
|
+
if (!srcNames.has('discover_json')) {
|
|
201
|
+
this.db.exec(`ALTER TABLE knowledge_sources ADD COLUMN discover_json TEXT`);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
get raw() {
|
|
205
|
+
return this.db;
|
|
206
|
+
}
|
|
207
|
+
close() {
|
|
208
|
+
this.db.close();
|
|
209
|
+
}
|
|
210
|
+
stats() {
|
|
211
|
+
const counts = {
|
|
212
|
+
sources: 'SELECT COUNT(*) AS count FROM knowledge_sources',
|
|
213
|
+
projectAgents: 'SELECT COUNT(*) AS count FROM knowledge_project_agents',
|
|
214
|
+
agentHidden: 'SELECT COUNT(*) AS count FROM knowledge_agent_hidden',
|
|
215
|
+
sessionVisibility: 'SELECT COUNT(*) AS count FROM knowledge_session_visibility',
|
|
216
|
+
files: 'SELECT COUNT(*) AS count FROM knowledge_files',
|
|
217
|
+
chunks: 'SELECT COUNT(*) AS count FROM knowledge_chunks',
|
|
218
|
+
embeddings: 'SELECT COUNT(*) AS count FROM knowledge_chunk_embeddings',
|
|
219
|
+
hits: 'SELECT COUNT(*) AS count FROM knowledge_hits',
|
|
220
|
+
jobsQueued: "SELECT COUNT(*) AS count FROM knowledge_jobs WHERE status = 'queued'",
|
|
221
|
+
jobsRunning: "SELECT COUNT(*) AS count FROM knowledge_jobs WHERE status = 'running'",
|
|
222
|
+
};
|
|
223
|
+
const result = {};
|
|
224
|
+
for (const [key, sql] of Object.entries(counts)) {
|
|
225
|
+
try {
|
|
226
|
+
const row = this.db.prepare(sql).get();
|
|
227
|
+
result[key] = row.count;
|
|
228
|
+
}
|
|
229
|
+
catch {
|
|
230
|
+
result[key] = 0;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
return result;
|
|
234
|
+
}
|
|
235
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* auto-describe — catalog `generatedDescription`
|
|
3
|
+
*
|
|
4
|
+
* 只服务 Tier 0;抽样必须过密钥扫描;可关外发。
|
|
5
|
+
*/
|
|
6
|
+
import type { KnowledgeSource } from './types.js';
|
|
7
|
+
/** LLM 描述端口(宿主注入;未注入则启发式) */
|
|
8
|
+
export type KnowledgeDescribePort = (input: {
|
|
9
|
+
displayName: string;
|
|
10
|
+
kind: string;
|
|
11
|
+
location: string;
|
|
12
|
+
sample: string;
|
|
13
|
+
}) => Promise<string>;
|
|
14
|
+
export interface KnowledgeDescribeOptions {
|
|
15
|
+
/** 是否允许调用 describePort(默认 true) */
|
|
16
|
+
enabled?: boolean;
|
|
17
|
+
describePort?: KnowledgeDescribePort;
|
|
18
|
+
/** 抽样最大字符(默认 2000) */
|
|
19
|
+
sampleChars?: number;
|
|
20
|
+
}
|
|
21
|
+
export interface KnowledgeDescribeResult {
|
|
22
|
+
description: string;
|
|
23
|
+
source: 'llm' | 'heuristic' | 'blocked_secret' | 'disabled';
|
|
24
|
+
secretHits?: string[];
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* 生成 generatedDescription
|
|
28
|
+
*
|
|
29
|
+
* @param source - 源元数据
|
|
30
|
+
* @param sampleText - 目录树/文件头抽样(调用方提供;P2 起由 ingest 采集)
|
|
31
|
+
*/
|
|
32
|
+
export declare function generateKnowledgeDescription(source: Pick<KnowledgeSource, 'displayName' | 'kind' | 'location'>, sampleText: string, options?: KnowledgeDescribeOptions): Promise<KnowledgeDescribeResult>;
|
|
33
|
+
/**
|
|
34
|
+
* 启发式一行描述(不能当正确描述,仅 fallback)
|
|
35
|
+
*/
|
|
36
|
+
export declare function heuristicDescription(source: {
|
|
37
|
+
displayName: string;
|
|
38
|
+
kind: string;
|
|
39
|
+
location: string;
|
|
40
|
+
}): string;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* auto-describe — catalog `generatedDescription`
|
|
3
|
+
*
|
|
4
|
+
* 只服务 Tier 0;抽样必须过密钥扫描;可关外发。
|
|
5
|
+
*/
|
|
6
|
+
import { scanSecretShapes } from './secret-scan.js';
|
|
7
|
+
/**
|
|
8
|
+
* 生成 generatedDescription
|
|
9
|
+
*
|
|
10
|
+
* @param source - 源元数据
|
|
11
|
+
* @param sampleText - 目录树/文件头抽样(调用方提供;P2 起由 ingest 采集)
|
|
12
|
+
*/
|
|
13
|
+
export async function generateKnowledgeDescription(source, sampleText, options) {
|
|
14
|
+
const enabled = options?.enabled !== false;
|
|
15
|
+
const sample = (sampleText ?? '').slice(0, options?.sampleChars ?? 2000);
|
|
16
|
+
const secretHits = scanSecretShapes(sample);
|
|
17
|
+
if (secretHits.length > 0) {
|
|
18
|
+
return {
|
|
19
|
+
description: heuristicDescription(source),
|
|
20
|
+
source: 'blocked_secret',
|
|
21
|
+
secretHits,
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
if (!enabled || !options?.describePort) {
|
|
25
|
+
return {
|
|
26
|
+
description: heuristicDescription(source),
|
|
27
|
+
source: options?.describePort ? 'disabled' : 'heuristic',
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
try {
|
|
31
|
+
const text = await options.describePort({
|
|
32
|
+
displayName: source.displayName,
|
|
33
|
+
kind: source.kind,
|
|
34
|
+
location: source.location,
|
|
35
|
+
sample,
|
|
36
|
+
});
|
|
37
|
+
const trimmed = text?.trim();
|
|
38
|
+
if (!trimmed) {
|
|
39
|
+
return { description: heuristicDescription(source), source: 'heuristic' };
|
|
40
|
+
}
|
|
41
|
+
return { description: trimmed.slice(0, 300), source: 'llm' };
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
return { description: heuristicDescription(source), source: 'heuristic' };
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* 启发式一行描述(不能当正确描述,仅 fallback)
|
|
49
|
+
*/
|
|
50
|
+
export function heuristicDescription(source) {
|
|
51
|
+
return `${source.kind} source at ${source.location}`;
|
|
52
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SourceFetcher — 本地 / URL 外源取回缝
|
|
3
|
+
*
|
|
4
|
+
* 只负责 discover + 取回 VirtualDocument(已规范化可 chunk 文本);
|
|
5
|
+
* 切块/索引仍走 FormatAdapter + KnowledgeIndexStore。
|
|
6
|
+
*/
|
|
7
|
+
import type { ResolvedCredential } from '../governance/credentials/types.js';
|
|
8
|
+
import { type NetworkGuardOptions } from './network-guard.js';
|
|
9
|
+
import type { KnowledgeSource } from './types.js';
|
|
10
|
+
export interface DiscoveredDocRef {
|
|
11
|
+
/** 稳定逻辑键 */
|
|
12
|
+
path: string;
|
|
13
|
+
externalUrl?: string;
|
|
14
|
+
etag?: string;
|
|
15
|
+
lastModified?: string;
|
|
16
|
+
}
|
|
17
|
+
export interface VirtualDocument {
|
|
18
|
+
path: string;
|
|
19
|
+
externalUrl?: string;
|
|
20
|
+
/** 已规范化 UTF-8 文本 */
|
|
21
|
+
content: string;
|
|
22
|
+
contentType?: string;
|
|
23
|
+
etag?: string;
|
|
24
|
+
lastModified?: string;
|
|
25
|
+
size: number;
|
|
26
|
+
}
|
|
27
|
+
export interface SourceFetcher {
|
|
28
|
+
discover(source: KnowledgeSource, cred?: ResolvedCredential | null): Promise<DiscoveredDocRef[]>;
|
|
29
|
+
fetch(source: KnowledgeSource, ref: DiscoveredDocRef, cred?: ResolvedCredential | null): Promise<VirtualDocument | null>;
|
|
30
|
+
}
|
|
31
|
+
/** 本地目录/文件 — 收拢原 walk 语义 */
|
|
32
|
+
export declare class LocalFsFetcher implements SourceFetcher {
|
|
33
|
+
private readonly shouldSkipPath;
|
|
34
|
+
/**
|
|
35
|
+
* @param shouldSkipPath - 噪音/二进制路径过滤
|
|
36
|
+
*/
|
|
37
|
+
constructor(shouldSkipPath: (path: string) => boolean);
|
|
38
|
+
discover(source: KnowledgeSource): Promise<DiscoveredDocRef[]>;
|
|
39
|
+
fetch(source: KnowledgeSource, ref: DiscoveredDocRef): Promise<VirtualDocument | null>;
|
|
40
|
+
}
|
|
41
|
+
/** URL 单页 / sitemap / 同域有限 crawl */
|
|
42
|
+
export declare class UrlFetcher implements SourceFetcher {
|
|
43
|
+
private readonly network?;
|
|
44
|
+
/** crawl discover 期间缓存已拉页面,避免 discover+fetch 双下载 */
|
|
45
|
+
private readonly docCache;
|
|
46
|
+
constructor(network?: (NetworkGuardOptions & {
|
|
47
|
+
maxDocumentBytes?: number;
|
|
48
|
+
}) | undefined);
|
|
49
|
+
/**
|
|
50
|
+
* 由 URL 推导稳定逻辑键(非完整 URL)
|
|
51
|
+
*
|
|
52
|
+
* - 相对 base 去公共前缀
|
|
53
|
+
* - 跨 origin 时加 host 前缀,防 pathname 碰撞
|
|
54
|
+
* - 有意义的 query 进短 hash 后缀,防 `?a`/`?b` 折叠
|
|
55
|
+
*/
|
|
56
|
+
static pathFromUrl(url: string, base?: string): string;
|
|
57
|
+
/** 从 sitemap/sitemapindex XML 抽取 <loc> */
|
|
58
|
+
static parseSitemapLocs(xml: string): string[];
|
|
59
|
+
/** 从 HTML 抽取同源 a[href] */
|
|
60
|
+
static extractLinks(html: string, baseUrl: string): string[];
|
|
61
|
+
private networkOpts;
|
|
62
|
+
discover(source: KnowledgeSource, cred?: ResolvedCredential | null): Promise<DiscoveredDocRef[]>;
|
|
63
|
+
private discoverSitemap;
|
|
64
|
+
private discoverCrawl;
|
|
65
|
+
fetch(source: KnowledgeSource, ref: DiscoveredDocRef, cred?: ResolvedCredential | null): Promise<VirtualDocument | null>;
|
|
66
|
+
}
|