@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,659 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* file_search 工具 — 跨文件内容搜索
|
|
3
|
+
*
|
|
4
|
+
* 在文件系统中搜索文本或正则模式,返回文件路径 + 行号 + 上下文行。
|
|
5
|
+
* 等效于 grep/rg,但输出结构化,便于 LLM 解析。
|
|
6
|
+
*
|
|
7
|
+
* 特性:
|
|
8
|
+
* - pattern_mode: auto(默认)/ literal / regex;`patterns[]` 多词任一命中
|
|
9
|
+
* - auto 仅认强信号(锚点/转义类/`.*`/`{n}`/词式 `a|b`),代码字面量保持 literal
|
|
10
|
+
* - 路径感知 glob(支持 `**` / `*` / `?` / `{a,b}`,匹配 root 相对路径;`\` 转义)
|
|
11
|
+
* - 逐行流式扫描;`max_file_bytes` 安全阀(默认 50MB)跳过异常巨文件
|
|
12
|
+
* - 上下文行(before/after)
|
|
13
|
+
* - 结果数量限制
|
|
14
|
+
* - 忽略常见无关目录(node_modules, .git 等)
|
|
15
|
+
* - 零结果时返回 diagnostics + hints,便于调用方自纠
|
|
16
|
+
*/
|
|
17
|
+
import { resolveToolPath } from './platform.js';
|
|
18
|
+
/** 需要忽略的目录 */
|
|
19
|
+
const IGNORED_DIRS = new Set([
|
|
20
|
+
'node_modules', '.git', '.svn', '.hg', 'dist', 'build',
|
|
21
|
+
'.next', '.nuxt', '__pycache__', '.cache', '.DS_Store',
|
|
22
|
+
]);
|
|
23
|
+
/** 单文件读取安全阀默认值(50MB;可经 max_file_bytes 调整) */
|
|
24
|
+
const DEFAULT_MAX_FILE_BYTES = 50_000_000;
|
|
25
|
+
/**
|
|
26
|
+
* 创建 file_search 工具
|
|
27
|
+
*
|
|
28
|
+
* @returns RegisteredTool
|
|
29
|
+
*/
|
|
30
|
+
export function createFileSearchTool() {
|
|
31
|
+
return {
|
|
32
|
+
definition: {
|
|
33
|
+
name: 'file_search',
|
|
34
|
+
description: 'Search file contents (like grep/rg) with structured results. ' +
|
|
35
|
+
'Provide `pattern` (one term) or `patterns` (any-of literals). ' +
|
|
36
|
+
'Default pattern_mode=auto compiles as regex only on strong signals: ' +
|
|
37
|
+
'anchors (^…$), escapes (\\d \\w \\s), `.*`/`.+`, `{n}` quantifiers, or word alternation (`foo|bar`). ' +
|
|
38
|
+
'Code tokens stay literal: `arr[0]`, `useState()`, `a+b`, `C++`, `foo.bar`, `memory*`. ' +
|
|
39
|
+
'Set pattern_mode="regex" or "literal" to force. ' +
|
|
40
|
+
"Glob filters by root-relative path (always case-insensitive): '*.md' (any depth), 'src/**/*.ts', '**/memory*.md'. " +
|
|
41
|
+
"`**` crosses directories, `*` does not. " +
|
|
42
|
+
'Empty results include diagnostics.hints for how to retry. ' +
|
|
43
|
+
'Default case-insensitive content match; set case_sensitive=true for exact case. ' +
|
|
44
|
+
'Files are read as line streams; max_file_bytes (default 50MB) skips oversized files.',
|
|
45
|
+
parameters: {
|
|
46
|
+
pattern: {
|
|
47
|
+
type: 'string',
|
|
48
|
+
description: 'Single search term. Auto: regex only for ^ $ \\d .* {n} or word `a|b`; everything else is literal text.',
|
|
49
|
+
},
|
|
50
|
+
patterns: {
|
|
51
|
+
type: 'array',
|
|
52
|
+
description: 'Multiple terms; a line matches if ANY term matches. Prefer this over `a|b` for OR-of-literals.',
|
|
53
|
+
items: { type: 'string', description: 'search term' },
|
|
54
|
+
minItems: 1,
|
|
55
|
+
},
|
|
56
|
+
path: {
|
|
57
|
+
type: 'string',
|
|
58
|
+
description: 'Root directory to search from (default: current directory)',
|
|
59
|
+
},
|
|
60
|
+
glob: {
|
|
61
|
+
type: 'string',
|
|
62
|
+
description: "Path glob relative to root (case-insensitive), e.g. '*.md', 'src/**/*.ts', '**/memory*.md'. " +
|
|
63
|
+
'Matches relative path; bare `*` does not cross directories.',
|
|
64
|
+
},
|
|
65
|
+
pattern_mode: {
|
|
66
|
+
type: 'string',
|
|
67
|
+
description: 'How to compile pattern/patterns (default: auto)',
|
|
68
|
+
enum: ['auto', 'literal', 'regex'],
|
|
69
|
+
},
|
|
70
|
+
regex: {
|
|
71
|
+
type: 'boolean',
|
|
72
|
+
description: 'Deprecated alias: true → pattern_mode=regex, false → literal. Prefer pattern_mode.',
|
|
73
|
+
},
|
|
74
|
+
case_sensitive: {
|
|
75
|
+
type: 'boolean',
|
|
76
|
+
description: 'Case sensitive search (default: false)',
|
|
77
|
+
},
|
|
78
|
+
context_lines: {
|
|
79
|
+
type: 'number',
|
|
80
|
+
description: 'Number of context lines before/after each match (default: 0, max: 5)',
|
|
81
|
+
minimum: 0,
|
|
82
|
+
maximum: 5,
|
|
83
|
+
},
|
|
84
|
+
max_results: {
|
|
85
|
+
type: 'number',
|
|
86
|
+
description: 'Maximum number of matches to return (default: 50, max: 200)',
|
|
87
|
+
minimum: 1,
|
|
88
|
+
maximum: 200,
|
|
89
|
+
},
|
|
90
|
+
max_file_bytes: {
|
|
91
|
+
type: 'number',
|
|
92
|
+
description: 'Skip files larger than this many bytes (default: 50000000 ≈ 50MB). ' +
|
|
93
|
+
'Files are scanned as a line stream; raise this for huge text corpora.',
|
|
94
|
+
minimum: 1,
|
|
95
|
+
},
|
|
96
|
+
},
|
|
97
|
+
timeoutMs: 30_000,
|
|
98
|
+
},
|
|
99
|
+
handler: async (args, context) => {
|
|
100
|
+
const { readdir, stat } = await import('node:fs/promises');
|
|
101
|
+
const { join, relative, extname } = await import('node:path');
|
|
102
|
+
const rawRoot = args.path;
|
|
103
|
+
const rootPath = rawRoot
|
|
104
|
+
? resolveToolPath(rawRoot, context.cwd ?? process.cwd())
|
|
105
|
+
: (context.cwd ?? process.cwd());
|
|
106
|
+
const terms = collectPatternTerms(args);
|
|
107
|
+
const patternMode = resolvePatternMode(args);
|
|
108
|
+
const caseSensitive = args.case_sensitive ?? false;
|
|
109
|
+
const contextLines = Math.min(args.context_lines ?? 0, 5);
|
|
110
|
+
const maxResults = Math.min(args.max_results ?? 50, 200);
|
|
111
|
+
const maxFileBytes = resolveMaxFileBytes(args);
|
|
112
|
+
const glob = args.glob;
|
|
113
|
+
const content = compileContentMatchers(terms, patternMode, caseSensitive);
|
|
114
|
+
let fileFilter = null;
|
|
115
|
+
let compiledGlob;
|
|
116
|
+
if (glob) {
|
|
117
|
+
try {
|
|
118
|
+
fileFilter = globToPathRegex(glob);
|
|
119
|
+
compiledGlob = fileFilter.source;
|
|
120
|
+
}
|
|
121
|
+
catch (error) {
|
|
122
|
+
throw new Error(`Invalid glob "${glob}": ${error instanceof Error ? error.message : String(error)}`);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
const allMatches = [];
|
|
126
|
+
let filesSeen = 0;
|
|
127
|
+
let filesMatchedByGlob = 0;
|
|
128
|
+
let filesSearched = 0;
|
|
129
|
+
let filesSkipped = 0;
|
|
130
|
+
let filesSkippedOversize = 0;
|
|
131
|
+
let truncated = false;
|
|
132
|
+
async function walk(dir) {
|
|
133
|
+
if (truncated)
|
|
134
|
+
return;
|
|
135
|
+
let entries;
|
|
136
|
+
try {
|
|
137
|
+
entries = await readdir(dir, { withFileTypes: true });
|
|
138
|
+
}
|
|
139
|
+
catch {
|
|
140
|
+
return; // 无权限/目录消失 → 跳过该目录
|
|
141
|
+
}
|
|
142
|
+
for (const entry of entries) {
|
|
143
|
+
if (truncated)
|
|
144
|
+
return;
|
|
145
|
+
const fullPath = join(dir, entry.name);
|
|
146
|
+
if (entry.isDirectory()) {
|
|
147
|
+
if (!IGNORED_DIRS.has(entry.name)) {
|
|
148
|
+
await walk(fullPath);
|
|
149
|
+
}
|
|
150
|
+
continue;
|
|
151
|
+
}
|
|
152
|
+
if (!entry.isFile())
|
|
153
|
+
continue;
|
|
154
|
+
filesSeen += 1;
|
|
155
|
+
// 统一为 `/`,保证 Windows 相对路径也能过 glob
|
|
156
|
+
const relPath = relative(rootPath, fullPath).split('\\').join('/');
|
|
157
|
+
// glob 过滤:root 相对路径(无 `/` 的模式等价于任意深度 globstar)
|
|
158
|
+
if (fileFilter && !fileFilter.test(relPath))
|
|
159
|
+
continue;
|
|
160
|
+
filesMatchedByGlob += 1;
|
|
161
|
+
// 扩展名粗判二进制,避免把不可读内容塞进结果
|
|
162
|
+
const ext = extname(entry.name).toLowerCase();
|
|
163
|
+
if (BINARY_EXTENSIONS.has(ext)) {
|
|
164
|
+
filesSkipped += 1;
|
|
165
|
+
continue;
|
|
166
|
+
}
|
|
167
|
+
let size = 0;
|
|
168
|
+
try {
|
|
169
|
+
size = (await stat(fullPath)).size;
|
|
170
|
+
}
|
|
171
|
+
catch {
|
|
172
|
+
// stat 失败(竞态删除/无权限)→ 跳过该文件
|
|
173
|
+
filesSkipped += 1;
|
|
174
|
+
continue;
|
|
175
|
+
}
|
|
176
|
+
if (size > maxFileBytes) {
|
|
177
|
+
filesSkipped += 1;
|
|
178
|
+
filesSkippedOversize += 1;
|
|
179
|
+
continue;
|
|
180
|
+
}
|
|
181
|
+
filesSearched += 1;
|
|
182
|
+
await searchFileLines({
|
|
183
|
+
fullPath,
|
|
184
|
+
relPath,
|
|
185
|
+
matchers: content.matchers,
|
|
186
|
+
contextLines,
|
|
187
|
+
onMatch: (match) => {
|
|
188
|
+
allMatches.push(match);
|
|
189
|
+
if (allMatches.length >= maxResults) {
|
|
190
|
+
truncated = true;
|
|
191
|
+
}
|
|
192
|
+
},
|
|
193
|
+
shouldStop: () => truncated,
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
await walk(rootPath);
|
|
198
|
+
const diagnostics = {
|
|
199
|
+
patternMode: content.mode,
|
|
200
|
+
patterns: content.sources,
|
|
201
|
+
compiledPatterns: content.compiled,
|
|
202
|
+
glob,
|
|
203
|
+
compiledGlob,
|
|
204
|
+
filesSeen,
|
|
205
|
+
filesMatchedByGlob,
|
|
206
|
+
filesSearched,
|
|
207
|
+
filesSkipped,
|
|
208
|
+
filesSkippedOversize,
|
|
209
|
+
maxFileBytes,
|
|
210
|
+
};
|
|
211
|
+
const hints = buildHints({
|
|
212
|
+
totalMatches: allMatches.length,
|
|
213
|
+
content,
|
|
214
|
+
patternModeRequested: patternMode,
|
|
215
|
+
glob,
|
|
216
|
+
filesSeen,
|
|
217
|
+
filesMatchedByGlob,
|
|
218
|
+
filesSearched,
|
|
219
|
+
filesSkipped,
|
|
220
|
+
filesSkippedOversize,
|
|
221
|
+
maxFileBytes,
|
|
222
|
+
});
|
|
223
|
+
return {
|
|
224
|
+
matches: allMatches,
|
|
225
|
+
totalMatches: allMatches.length,
|
|
226
|
+
truncated,
|
|
227
|
+
searchedFiles: filesSearched,
|
|
228
|
+
diagnostics,
|
|
229
|
+
hints,
|
|
230
|
+
};
|
|
231
|
+
},
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
// ── pattern 编译 ──
|
|
235
|
+
/**
|
|
236
|
+
* 收集 pattern / patterns 术语列表
|
|
237
|
+
*
|
|
238
|
+
* @param args - 工具入参
|
|
239
|
+
* @returns 非空搜索词数组
|
|
240
|
+
*/
|
|
241
|
+
function collectPatternTerms(args) {
|
|
242
|
+
const terms = [];
|
|
243
|
+
const single = args.pattern;
|
|
244
|
+
if (typeof single === 'string' && single.trim())
|
|
245
|
+
terms.push(single);
|
|
246
|
+
const multi = args.patterns;
|
|
247
|
+
if (Array.isArray(multi)) {
|
|
248
|
+
for (const item of multi) {
|
|
249
|
+
const s = typeof item === 'string' ? item : String(item ?? '');
|
|
250
|
+
if (s.trim())
|
|
251
|
+
terms.push(s);
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
if (terms.length === 0) {
|
|
255
|
+
throw new Error('Provide pattern (string) or patterns (non-empty string[])');
|
|
256
|
+
}
|
|
257
|
+
return terms;
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* 解析 pattern 编译模式:pattern_mode 优先,regex 布尔为兼容别名
|
|
261
|
+
*
|
|
262
|
+
* @param args - 工具入参
|
|
263
|
+
* @returns 请求的模式
|
|
264
|
+
*/
|
|
265
|
+
function resolvePatternMode(args) {
|
|
266
|
+
const explicit = args.pattern_mode;
|
|
267
|
+
if (explicit === 'auto' || explicit === 'literal' || explicit === 'regex') {
|
|
268
|
+
return explicit;
|
|
269
|
+
}
|
|
270
|
+
const legacy = args.regex;
|
|
271
|
+
if (legacy === true)
|
|
272
|
+
return 'regex';
|
|
273
|
+
if (legacy === false)
|
|
274
|
+
return 'literal';
|
|
275
|
+
return 'auto';
|
|
276
|
+
}
|
|
277
|
+
/**
|
|
278
|
+
* 解析单文件字节安全阀
|
|
279
|
+
*
|
|
280
|
+
* @param args - 工具入参
|
|
281
|
+
* @returns 正整数字节上限
|
|
282
|
+
*/
|
|
283
|
+
function resolveMaxFileBytes(args) {
|
|
284
|
+
const raw = args.max_file_bytes;
|
|
285
|
+
if (typeof raw === 'number' && Number.isFinite(raw) && raw >= 1) {
|
|
286
|
+
return Math.floor(raw);
|
|
287
|
+
}
|
|
288
|
+
return DEFAULT_MAX_FILE_BYTES;
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* 判断 auto 模式下术语是否应按正则编译
|
|
292
|
+
*
|
|
293
|
+
* 只认强信号。代码字面量保持 literal:
|
|
294
|
+
* `arr[0]` / `useState()` / `a+b` / `C++` / `foo.bar` / `memory*` 均不为正则。
|
|
295
|
+
* 词式交替(`foo|bar`)视为 OR 正则,对应模型常见写法。
|
|
296
|
+
*
|
|
297
|
+
* @param term - 搜索词
|
|
298
|
+
* @returns 是否像正则
|
|
299
|
+
*/
|
|
300
|
+
function looksLikeRegex(term) {
|
|
301
|
+
if (term.startsWith('^') || term.endsWith('$'))
|
|
302
|
+
return true;
|
|
303
|
+
// 转义类(\d \w …)或转义元字符(\[ \( …)→ 显式正则意图
|
|
304
|
+
if (/\\[dDwWsSbBnrptfv0-9.*+?^${}()|[\]\\]/.test(term))
|
|
305
|
+
return true;
|
|
306
|
+
if (/\.\*|\.\+/.test(term))
|
|
307
|
+
return true;
|
|
308
|
+
if (/\{\d+(?:,\d*)?\}/.test(term))
|
|
309
|
+
return true;
|
|
310
|
+
if (term.includes('|')) {
|
|
311
|
+
const branches = term.split('|');
|
|
312
|
+
return branches.length >= 2 && branches.every(isWordLikeBranch);
|
|
313
|
+
}
|
|
314
|
+
return false;
|
|
315
|
+
}
|
|
316
|
+
/**
|
|
317
|
+
* 交替分支是否为词式(可安全当作 OR 字面量正则)
|
|
318
|
+
*
|
|
319
|
+
* @param branch - `a|b` 的单个分支
|
|
320
|
+
* @returns 是否不含正则元字符
|
|
321
|
+
*/
|
|
322
|
+
function isWordLikeBranch(branch) {
|
|
323
|
+
return branch.length > 0 && /^[\w.\- /:']+$/.test(branch);
|
|
324
|
+
}
|
|
325
|
+
/**
|
|
326
|
+
* 转义正则特殊字符
|
|
327
|
+
*
|
|
328
|
+
* @param str - 字面量
|
|
329
|
+
* @returns 正则安全的字面量
|
|
330
|
+
*/
|
|
331
|
+
function escapeRegex(str) {
|
|
332
|
+
return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
333
|
+
}
|
|
334
|
+
/**
|
|
335
|
+
* 编译内容匹配器(多词 OR)
|
|
336
|
+
*
|
|
337
|
+
* @param terms - 搜索词列表
|
|
338
|
+
* @param requested - 请求的 pattern 模式
|
|
339
|
+
* @param caseSensitive - 是否区分大小写
|
|
340
|
+
* @returns 编译结果
|
|
341
|
+
*/
|
|
342
|
+
function compileContentMatchers(terms, requested, caseSensitive) {
|
|
343
|
+
// 无需 `g`:.test() 不用 lastIndex 扫描
|
|
344
|
+
const flags = caseSensitive ? '' : 'i';
|
|
345
|
+
const matchers = [];
|
|
346
|
+
const sources = [];
|
|
347
|
+
const compiled = [];
|
|
348
|
+
const kinds = [];
|
|
349
|
+
let autoForcedLiteral = false;
|
|
350
|
+
for (const term of terms) {
|
|
351
|
+
sources.push(term);
|
|
352
|
+
let asRegex;
|
|
353
|
+
if (requested === 'regex')
|
|
354
|
+
asRegex = true;
|
|
355
|
+
else if (requested === 'literal')
|
|
356
|
+
asRegex = false;
|
|
357
|
+
else
|
|
358
|
+
asRegex = looksLikeRegex(term);
|
|
359
|
+
let re = null;
|
|
360
|
+
if (asRegex) {
|
|
361
|
+
try {
|
|
362
|
+
re = new RegExp(term, flags);
|
|
363
|
+
}
|
|
364
|
+
catch (error) {
|
|
365
|
+
if (requested === 'regex') {
|
|
366
|
+
throw new Error(`Invalid pattern: ${error instanceof Error ? error.message : String(error)}`);
|
|
367
|
+
}
|
|
368
|
+
// auto 下像正则但编译失败 → 回退字面量
|
|
369
|
+
autoForcedLiteral = true;
|
|
370
|
+
asRegex = false;
|
|
371
|
+
}
|
|
372
|
+
}
|
|
373
|
+
if (!re) {
|
|
374
|
+
re = new RegExp(escapeRegex(term), flags);
|
|
375
|
+
}
|
|
376
|
+
matchers.push(re);
|
|
377
|
+
compiled.push(re.source);
|
|
378
|
+
kinds.push(asRegex ? 'regex' : 'literal');
|
|
379
|
+
}
|
|
380
|
+
const usedRegex = kinds.some((k) => k === 'regex');
|
|
381
|
+
const usedLiteral = kinds.some((k) => k === 'literal');
|
|
382
|
+
return {
|
|
383
|
+
mode: usedRegex && usedLiteral ? 'mixed' : usedRegex ? 'regex' : 'literal',
|
|
384
|
+
matchers,
|
|
385
|
+
sources,
|
|
386
|
+
compiled,
|
|
387
|
+
kinds,
|
|
388
|
+
autoForcedLiteral,
|
|
389
|
+
};
|
|
390
|
+
}
|
|
391
|
+
/**
|
|
392
|
+
* 判断一行是否命中任一匹配器
|
|
393
|
+
*
|
|
394
|
+
* @param line - 文本行
|
|
395
|
+
* @param matchers - 已编译匹配器
|
|
396
|
+
* @returns 是否命中
|
|
397
|
+
*/
|
|
398
|
+
function lineMatches(line, matchers) {
|
|
399
|
+
for (const re of matchers) {
|
|
400
|
+
if (re.test(line))
|
|
401
|
+
return true;
|
|
402
|
+
}
|
|
403
|
+
return false;
|
|
404
|
+
}
|
|
405
|
+
/**
|
|
406
|
+
* 流式扫描单文件:逐行匹配,环形缓冲 before,挂起 after 收齐后再回调
|
|
407
|
+
*
|
|
408
|
+
* @param options - 路径 / 匹配器 / 上下文行数 / 回调
|
|
409
|
+
* @returns 无
|
|
410
|
+
*/
|
|
411
|
+
async function searchFileLines(options) {
|
|
412
|
+
const { createReadStream } = await import('node:fs');
|
|
413
|
+
const { createInterface } = await import('node:readline');
|
|
414
|
+
const { fullPath, relPath, matchers, contextLines, onMatch, shouldStop } = options;
|
|
415
|
+
let stream;
|
|
416
|
+
try {
|
|
417
|
+
stream = createReadStream(fullPath, { encoding: 'utf8' });
|
|
418
|
+
}
|
|
419
|
+
catch {
|
|
420
|
+
// 同步打开失败(权限/路径失效)→ 本文件无匹配
|
|
421
|
+
return;
|
|
422
|
+
}
|
|
423
|
+
const rl = createInterface({ input: stream, crlfDelay: Infinity });
|
|
424
|
+
const beforeRing = [];
|
|
425
|
+
const pending = [];
|
|
426
|
+
let lineNo = 0;
|
|
427
|
+
const flushReady = (final) => {
|
|
428
|
+
while (pending.length > 0) {
|
|
429
|
+
const head = pending[0];
|
|
430
|
+
if (!final && head.after.length < contextLines)
|
|
431
|
+
break;
|
|
432
|
+
pending.shift();
|
|
433
|
+
const match = {
|
|
434
|
+
file: relPath,
|
|
435
|
+
line: head.line,
|
|
436
|
+
content: head.content,
|
|
437
|
+
};
|
|
438
|
+
if (contextLines > 0) {
|
|
439
|
+
match.before = head.before;
|
|
440
|
+
match.after = head.after;
|
|
441
|
+
}
|
|
442
|
+
onMatch(match);
|
|
443
|
+
if (shouldStop())
|
|
444
|
+
return;
|
|
445
|
+
}
|
|
446
|
+
};
|
|
447
|
+
try {
|
|
448
|
+
for await (const line of rl) {
|
|
449
|
+
if (shouldStop())
|
|
450
|
+
break;
|
|
451
|
+
lineNo += 1;
|
|
452
|
+
for (const p of pending) {
|
|
453
|
+
if (p.after.length < contextLines)
|
|
454
|
+
p.after.push(line);
|
|
455
|
+
}
|
|
456
|
+
flushReady(false);
|
|
457
|
+
if (shouldStop())
|
|
458
|
+
break;
|
|
459
|
+
if (lineMatches(line, matchers)) {
|
|
460
|
+
pending.push({
|
|
461
|
+
line: lineNo,
|
|
462
|
+
content: line,
|
|
463
|
+
before: contextLines > 0 ? beforeRing.slice(-contextLines) : [],
|
|
464
|
+
after: [],
|
|
465
|
+
});
|
|
466
|
+
}
|
|
467
|
+
if (contextLines > 0) {
|
|
468
|
+
beforeRing.push(line);
|
|
469
|
+
if (beforeRing.length > contextLines)
|
|
470
|
+
beforeRing.shift();
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
flushReady(true);
|
|
474
|
+
}
|
|
475
|
+
catch {
|
|
476
|
+
// 流中断(读错误)→ 丢弃未完成上下文,已回调的保留
|
|
477
|
+
}
|
|
478
|
+
finally {
|
|
479
|
+
rl.close();
|
|
480
|
+
stream.destroy();
|
|
481
|
+
}
|
|
482
|
+
}
|
|
483
|
+
// ── glob 编译 ──
|
|
484
|
+
/**
|
|
485
|
+
* 将路径 glob 编译为正则(匹配 root 相对路径)
|
|
486
|
+
*
|
|
487
|
+
* 语义对齐 rg/git:
|
|
488
|
+
* - `**` 跨目录;`*` / `?` 不跨 `/`
|
|
489
|
+
* - 无 `/` 的模式(如 `*.md`)等价于任意深度的 globstar 匹配
|
|
490
|
+
* - 支持 `{a,b}` 花括号(可多组)
|
|
491
|
+
*
|
|
492
|
+
* @param glob - glob 模式
|
|
493
|
+
* @returns 整串匹配相对路径的正则(大小写不敏感)
|
|
494
|
+
*/
|
|
495
|
+
function globToPathRegex(glob) {
|
|
496
|
+
const trimmed = glob.trim();
|
|
497
|
+
if (!trimmed)
|
|
498
|
+
throw new Error('glob must be non-empty');
|
|
499
|
+
const normalized = trimmed.includes('/') ? trimmed : `**/${trimmed}`;
|
|
500
|
+
const source = globToSource(normalized);
|
|
501
|
+
return new RegExp(`^${source}$`, 'i');
|
|
502
|
+
}
|
|
503
|
+
/**
|
|
504
|
+
* 将(已规范化)glob 片段编译为正则源
|
|
505
|
+
*
|
|
506
|
+
* @param glob - 含路径分隔符的 glob
|
|
507
|
+
* @returns 正则源片段(无首尾锚点)
|
|
508
|
+
*/
|
|
509
|
+
function globToSource(glob) {
|
|
510
|
+
let out = '';
|
|
511
|
+
let i = 0;
|
|
512
|
+
while (i < glob.length) {
|
|
513
|
+
const ch = glob[i];
|
|
514
|
+
// `\*` `\?` 等 → 字面量
|
|
515
|
+
if (ch === '\\' && i + 1 < glob.length && '*?[]{}\\/!'.includes(glob[i + 1])) {
|
|
516
|
+
out += escapeRegex(glob[i + 1]);
|
|
517
|
+
i += 2;
|
|
518
|
+
continue;
|
|
519
|
+
}
|
|
520
|
+
if (ch === '*' && glob[i + 1] === '*') {
|
|
521
|
+
i += 2;
|
|
522
|
+
if (glob[i] === '/') {
|
|
523
|
+
i += 1;
|
|
524
|
+
// `**/` → 任意深度前缀(含零层)
|
|
525
|
+
out += '(?:.*/)?';
|
|
526
|
+
}
|
|
527
|
+
else {
|
|
528
|
+
out += '.*';
|
|
529
|
+
}
|
|
530
|
+
continue;
|
|
531
|
+
}
|
|
532
|
+
if (ch === '*') {
|
|
533
|
+
i += 1;
|
|
534
|
+
out += '[^/]*';
|
|
535
|
+
continue;
|
|
536
|
+
}
|
|
537
|
+
if (ch === '?') {
|
|
538
|
+
i += 1;
|
|
539
|
+
out += '[^/]';
|
|
540
|
+
continue;
|
|
541
|
+
}
|
|
542
|
+
if (ch === '{') {
|
|
543
|
+
const end = findBraceEnd(glob, i);
|
|
544
|
+
if (end === -1) {
|
|
545
|
+
out += '\\{';
|
|
546
|
+
i += 1;
|
|
547
|
+
continue;
|
|
548
|
+
}
|
|
549
|
+
const alts = splitBraceAlts(glob.slice(i + 1, end));
|
|
550
|
+
out += `(?:${alts.map((alt) => globToSource(alt)).join('|')})`;
|
|
551
|
+
i = end + 1;
|
|
552
|
+
continue;
|
|
553
|
+
}
|
|
554
|
+
if ('.+^$()|[]'.includes(ch)) {
|
|
555
|
+
out += `\\${ch}`;
|
|
556
|
+
}
|
|
557
|
+
else {
|
|
558
|
+
out += ch;
|
|
559
|
+
}
|
|
560
|
+
i += 1;
|
|
561
|
+
}
|
|
562
|
+
return out;
|
|
563
|
+
}
|
|
564
|
+
/**
|
|
565
|
+
* 找到配对的 `}`(跳过嵌套 `{}`)
|
|
566
|
+
*
|
|
567
|
+
* @param glob - glob 字符串
|
|
568
|
+
* @param openIndex - `{` 下标
|
|
569
|
+
* @returns 配对 `}` 下标;无则 -1
|
|
570
|
+
*/
|
|
571
|
+
function findBraceEnd(glob, openIndex) {
|
|
572
|
+
let depth = 0;
|
|
573
|
+
for (let i = openIndex; i < glob.length; i++) {
|
|
574
|
+
if (glob[i] === '{')
|
|
575
|
+
depth += 1;
|
|
576
|
+
else if (glob[i] === '}') {
|
|
577
|
+
depth -= 1;
|
|
578
|
+
if (depth === 0)
|
|
579
|
+
return i;
|
|
580
|
+
}
|
|
581
|
+
}
|
|
582
|
+
return -1;
|
|
583
|
+
}
|
|
584
|
+
/**
|
|
585
|
+
* 拆分花括号内的顶层逗号备选
|
|
586
|
+
*
|
|
587
|
+
* @param body - `{}` 内部
|
|
588
|
+
* @returns 备选列表
|
|
589
|
+
*/
|
|
590
|
+
function splitBraceAlts(body) {
|
|
591
|
+
const alts = [];
|
|
592
|
+
let depth = 0;
|
|
593
|
+
let current = '';
|
|
594
|
+
for (const ch of body) {
|
|
595
|
+
if (ch === '{')
|
|
596
|
+
depth += 1;
|
|
597
|
+
if (ch === '}')
|
|
598
|
+
depth -= 1;
|
|
599
|
+
if (ch === ',' && depth === 0) {
|
|
600
|
+
alts.push(current);
|
|
601
|
+
current = '';
|
|
602
|
+
continue;
|
|
603
|
+
}
|
|
604
|
+
current += ch;
|
|
605
|
+
}
|
|
606
|
+
alts.push(current);
|
|
607
|
+
return alts;
|
|
608
|
+
}
|
|
609
|
+
// ── hints ──
|
|
610
|
+
/**
|
|
611
|
+
* 构建零结果 / 异常检索的自纠提示
|
|
612
|
+
*
|
|
613
|
+
* @param input - 诊断输入
|
|
614
|
+
* @returns 提示列表
|
|
615
|
+
*/
|
|
616
|
+
function buildHints(input) {
|
|
617
|
+
const hints = [];
|
|
618
|
+
if (input.totalMatches > 0)
|
|
619
|
+
return hints;
|
|
620
|
+
if (input.glob && input.filesMatchedByGlob === 0) {
|
|
621
|
+
hints.push(`glob ${JSON.stringify(input.glob)} matched 0 files (seen ${input.filesSeen}). ` +
|
|
622
|
+
"Patterns match root-relative paths: use '*.md' for any depth, 'src/**/*.ts' for nested. " +
|
|
623
|
+
'Bare `*` does not cross directories; `**` does.');
|
|
624
|
+
}
|
|
625
|
+
if (input.filesSkippedOversize > 0) {
|
|
626
|
+
hints.push(`${input.filesSkippedOversize} file(s) exceeded max_file_bytes=${input.maxFileBytes} and were skipped. ` +
|
|
627
|
+
'Raise max_file_bytes to search huge text files.');
|
|
628
|
+
}
|
|
629
|
+
if (input.filesMatchedByGlob > 0 && input.filesSearched === 0) {
|
|
630
|
+
hints.push(`glob matched ${input.filesMatchedByGlob} files but searched 0 ` +
|
|
631
|
+
`(${input.filesSkipped} skipped as binary/oversize/unreadable). Try a narrower path or text extensions.`);
|
|
632
|
+
}
|
|
633
|
+
if (input.content.autoForcedLiteral) {
|
|
634
|
+
hints.push('Some terms look like regex but failed to compile; they were searched as literal text. Fix the regex or set pattern_mode="literal".');
|
|
635
|
+
}
|
|
636
|
+
const wantsRegex = input.content.sources.some((s) => s.includes('|') || s.startsWith('^') || s.endsWith('$') || s.includes('\\d') || s.includes('.*'));
|
|
637
|
+
if (input.patternModeRequested === 'literal' && wantsRegex) {
|
|
638
|
+
hints.push('pattern/patterns contain regex metacharacters but were forced to literal. Set pattern_mode="regex" (or omit it for auto).');
|
|
639
|
+
}
|
|
640
|
+
if (input.patternModeRequested === 'auto' && input.content.mode !== 'literal' && input.filesSearched > 0) {
|
|
641
|
+
hints.push(`Compiled as ${input.content.mode} matching: ${input.content.compiled.map((c) => JSON.stringify(c)).join(', ')}. ` +
|
|
642
|
+
'If you meant literal code text (e.g. arr[0], useState()), set pattern_mode="literal".');
|
|
643
|
+
}
|
|
644
|
+
if (input.filesSearched > 0 && hints.length === 0) {
|
|
645
|
+
hints.push(`Searched ${input.filesSearched} files with ${input.content.mode} matching and found 0 lines. ` +
|
|
646
|
+
'Try broader terms, a wider path/glob, or patterns:["a","b"] for OR-of-literals.');
|
|
647
|
+
}
|
|
648
|
+
return hints;
|
|
649
|
+
}
|
|
650
|
+
/** 常见二进制文件扩展名(svg 为可检索文本,不在此列) */
|
|
651
|
+
const BINARY_EXTENSIONS = new Set([
|
|
652
|
+
'.png', '.jpg', '.jpeg', '.gif', '.bmp', '.ico', '.webp',
|
|
653
|
+
'.mp3', '.mp4', '.wav', '.avi', '.mov', '.mkv', '.flv',
|
|
654
|
+
'.zip', '.tar', '.gz', '.bz2', '.7z', '.rar',
|
|
655
|
+
'.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
|
|
656
|
+
'.exe', '.dll', '.so', '.dylib', '.o', '.a',
|
|
657
|
+
'.woff', '.woff2', '.ttf', '.eot',
|
|
658
|
+
'.sqlite', '.db',
|
|
659
|
+
]);
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* http_request 工具 — HTTP 请求
|
|
3
|
+
*
|
|
4
|
+
* 让 Agent 能够主动发起 HTTP 请求,调用 REST API、获取网页内容。
|
|
5
|
+
* 使用 Node.js 20+ 内置 fetch,零额外依赖。
|
|
6
|
+
*
|
|
7
|
+
* 超长响应:经 capabilities SummaryPort 做 L2 软净化 + L1 硬顶(见 arch/summary-compact.md §3.6)。
|
|
8
|
+
*
|
|
9
|
+
* 安全注意事项:
|
|
10
|
+
* - 生产环境应通过 ToolPolicy 限制可访问的域名
|
|
11
|
+
* - 内网访问默认允许,可通过 security guard 拦截
|
|
12
|
+
*/
|
|
13
|
+
import type { RegisteredTool } from '@octopi-agent/core/types.js';
|
|
14
|
+
import { type ToolSummarySupport } from '../../../context/capabilities/summary/index.js';
|
|
15
|
+
import type { CredentialStore } from '../../../governance/credentials/store.js';
|
|
16
|
+
export interface HttpRequestToolOptions {
|
|
17
|
+
/** Summary L1/L2 支持;未提供时仅使用内置 L1 binding */
|
|
18
|
+
summary?: ToolSummarySupport;
|
|
19
|
+
/** 凭证库(credential 参数按名注入 header,模型不见明文) */
|
|
20
|
+
credentials?: CredentialStore | null;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* 创建 http_request 工具
|
|
24
|
+
*
|
|
25
|
+
* @param options - 可选 SummaryPort / binding 配置注入
|
|
26
|
+
* @returns RegisteredTool
|
|
27
|
+
*/
|
|
28
|
+
export declare function createHttpRequestTool(options?: HttpRequestToolOptions): RegisteredTool;
|