pi-braid 0.0.0-stage → 0.40.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/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
// Generate structured hypotheses about root causes using the session model.
|
|
2
|
+
import { Type } from "typebox";
|
|
3
|
+
import { StringEnum } from "@earendil-works/pi-ai";
|
|
4
|
+
import { resolveUtilityModel, tryModelChain } from "../../../../lib/ai/model-resolver.js";
|
|
5
|
+
import { criticGate } from "../../../../lib/ai/critic-gate.js";
|
|
6
|
+
import { classify } from "../../../../lib/ai/text-classifier.js";
|
|
7
|
+
import { CRITICS } from "../../../../lib/ai/critic-registry.js";
|
|
8
|
+
import { scoreHypothesisOutput } from "./scoring.js";
|
|
9
|
+
import { withMeta } from "../../../../lib/types/standard-result.js";
|
|
10
|
+
import { createLogger } from "../../../../lib/core/logger.js";
|
|
11
|
+
const log = createLogger("hypothesize");
|
|
12
|
+
/**
|
|
13
|
+
* B-class: preserve the 4 regex dimension checks as the Tier 1 fallback
|
|
14
|
+
* for hypothesis signal detection. The LLM path enhances when the heuristic
|
|
15
|
+
* returns "none" or when the agent needs richer signal analysis.
|
|
16
|
+
*/
|
|
17
|
+
function hypothesisSignalFallback(text) {
|
|
18
|
+
const signals = [];
|
|
19
|
+
if (/verify|check|test|confirm|reproduce/i.test(text))
|
|
20
|
+
signals.push("verification-plan");
|
|
21
|
+
if (/because|caused by|due to|root cause|underlying/i.test(text))
|
|
22
|
+
signals.push("causal-reasoning");
|
|
23
|
+
if (/proper|maintainable|clean|refactor|fix.*properly/i.test(text))
|
|
24
|
+
signals.push("proper-solution");
|
|
25
|
+
if (/edge case|boundary|corner case|failure mode/i.test(text))
|
|
26
|
+
signals.push("edge-case-aware");
|
|
27
|
+
return signals.length > 0 ? signals.join(", ") : "none";
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Empty-response retry decision (pure, unit-testable without model
|
|
31
|
+
* plumbing): given the final error text of a tryModelChain attempt,
|
|
32
|
+
* return the options for a single mechanical regeneration retry — or
|
|
33
|
+
* null when the error is not empty-class (rate limits, aborts, auth
|
|
34
|
+
* failures already exhausted the provider-side retry ladder in
|
|
35
|
+
* llm-call and must not be re-driven here).
|
|
36
|
+
*
|
|
37
|
+
* reasoning: "off" — per llm-call.ts docs, reasoning tokens count
|
|
38
|
+
* against max_tokens for most providers, so a reasoning-enabled call
|
|
39
|
+
* can burn its entire budget thinking and produce 0 output tokens (the
|
|
40
|
+
* empty-string symptom). pi-ai's clampThinkingLevel accepts "off" at
|
|
41
|
+
* runtime and clamps per model, so "off" is safe for every provider.
|
|
42
|
+
*/
|
|
43
|
+
export function emptyResponseRetryOptions(lastError) {
|
|
44
|
+
if (!/empty response/i.test(lastError ?? ""))
|
|
45
|
+
return null;
|
|
46
|
+
return { temperature: 0.3, maxTokens: 4000, reasoning: "off" };
|
|
47
|
+
}
|
|
48
|
+
const FORMAT_OPTIONS = ["ranked", "tree", "list"];
|
|
49
|
+
const hypothesizeSchema = Type.Object({
|
|
50
|
+
problem: Type.String({ description: "The problem or issue to generate hypotheses about" }),
|
|
51
|
+
evidence: Type.String({ description: "Relevant evidence, error messages, or observations" }),
|
|
52
|
+
maxHypotheses: Type.Optional(Type.Number({ description: "Maximum number of hypotheses to generate (default: 3)" })),
|
|
53
|
+
format: Type.Optional(StringEnum([...FORMAT_OPTIONS], {
|
|
54
|
+
description: "Output format: ranked (default), tree (causal chain), or list",
|
|
55
|
+
})),
|
|
56
|
+
verificationPlan: Type.Optional(Type.String({ description: "Specific action plan for verifying which hypothesis is correct" })),
|
|
57
|
+
});
|
|
58
|
+
function buildPrompt(params) {
|
|
59
|
+
const formatInstructions = {
|
|
60
|
+
ranked: "Rank hypotheses by likelihood (most likely first). Use numbered headings (Hypothesis 1, Hypothesis 2, etc.).",
|
|
61
|
+
tree: "Present hypotheses as a causal tree showing root cause relationships. " +
|
|
62
|
+
"Use indentation: Level-A causes -> Level-B causes -> Level-C hypotheses. " +
|
|
63
|
+
"Label each node with its causal chain.",
|
|
64
|
+
list: "Present hypotheses as a flat numbered list. Each hypothesis is independent. " +
|
|
65
|
+
"Use bullet points under each for details.",
|
|
66
|
+
};
|
|
67
|
+
const formatLine = formatInstructions[params.format] ?? formatInstructions.ranked;
|
|
68
|
+
const verificationSection = params.verificationPlan
|
|
69
|
+
? `
|
|
70
|
+
|
|
71
|
+
## Verification Plan
|
|
72
|
+
|
|
73
|
+
The following plan should be followed to verify which hypothesis is correct:
|
|
74
|
+
${params.verificationPlan}
|
|
75
|
+
|
|
76
|
+
For each hypothesis above, explicitly state whether the verification plan confirms or rules it out.`
|
|
77
|
+
: "";
|
|
78
|
+
return `Analyze this problem and generate ${params.maxHypotheses} testable hypotheses about the root cause.
|
|
79
|
+
|
|
80
|
+
Problem: ${params.problem}
|
|
81
|
+
|
|
82
|
+
Evidence:
|
|
83
|
+
${params.evidence}
|
|
84
|
+
|
|
85
|
+
For each hypothesis:
|
|
86
|
+
1. State the hypothesis clearly
|
|
87
|
+
2. Explain WHY this could be the root cause (mechanism, not correlation)
|
|
88
|
+
3. What evidence would CONFIRM this hypothesis?
|
|
89
|
+
4. What evidence would DISPROVE this hypothesis?
|
|
90
|
+
5. How to fix it (proper solution, not a workaround)
|
|
91
|
+
|
|
92
|
+
${formatLine}
|
|
93
|
+
You aim for proper, well-designed solutions - not quick patches or workarounds.${verificationSection}`;
|
|
94
|
+
}
|
|
95
|
+
export function createHypothesizeTool() {
|
|
96
|
+
return {
|
|
97
|
+
name: "hypothesize",
|
|
98
|
+
label: "Hypothesize",
|
|
99
|
+
promptSnippet: "Generate hypotheses about root causes of a problem",
|
|
100
|
+
description: "Generate root-cause hypotheses when a first fix attempt fails, using fresh-eyes debugging analysis.",
|
|
101
|
+
parameters: hypothesizeSchema,
|
|
102
|
+
execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {
|
|
103
|
+
const { problem, evidence, maxHypotheses = 3, format = "ranked", verificationPlan } = params;
|
|
104
|
+
if (!ctx?.model) {
|
|
105
|
+
throw new Error(`hypothesize: no model available for session model analysis. ` +
|
|
106
|
+
`Problem: "${problem.slice(0, 50)}..." | Evidence: "${evidence.slice(0, 50)}..."`);
|
|
107
|
+
}
|
|
108
|
+
// Pre-check: is this problem worth deep analysis?
|
|
109
|
+
const gate = await criticGate(ctx, {
|
|
110
|
+
name: "hypothesis-precheck",
|
|
111
|
+
criteria: {
|
|
112
|
+
systemPrompt: "You are a triage classifier. Determine if the given problem has enough " +
|
|
113
|
+
"specific evidence for meaningful root-cause hypothesis generation. " +
|
|
114
|
+
"Answer 'yes' if there is concrete evidence (error messages, code diffs, " +
|
|
115
|
+
"stack traces, specific observations). Answer 'no' if the problem is vague, " +
|
|
116
|
+
"has no evidence, or is purely speculative. Answer 'deep' if the evidence " +
|
|
117
|
+
"is detailed enough to warrant multi-hypothesis analysis. " +
|
|
118
|
+
"Answer with exactly one word: 'yes', 'no', or 'deep'. Do not explain.",
|
|
119
|
+
userPrompt: "Problem: {{problem}}\nEvidence: {{evidence}}",
|
|
120
|
+
},
|
|
121
|
+
input: { problem, evidence: evidence || "(none provided)" },
|
|
122
|
+
fallback: () => (problem.length > 50 && (evidence?.length ?? 0) > 30 ? "deep" : "yes"),
|
|
123
|
+
timeoutMs: 60_000,
|
|
124
|
+
// B-class: length-based heuristic is a poor proxy for
|
|
125
|
+
// "needs deep analysis" (a short problem with rich evidence can
|
|
126
|
+
// need deep; a long problem with no evidence doesn't).
|
|
127
|
+
// tierPolicy: fallback-only downweights to 0.5 confidence so
|
|
128
|
+
// the Tier 2 LLM has the final say.
|
|
129
|
+
tierPolicy: "fallback-only",
|
|
130
|
+
modelPreference: "quality",
|
|
131
|
+
});
|
|
132
|
+
if (!gate.shouldProceed) {
|
|
133
|
+
return {
|
|
134
|
+
content: [
|
|
135
|
+
{
|
|
136
|
+
type: "text",
|
|
137
|
+
text: `[?] **Problem**: ${problem.slice(0, 200)}${problem.length > 200 ? "..." : ""}\n\n` +
|
|
138
|
+
(evidence
|
|
139
|
+
? `**Evidence**: ${evidence.slice(0, 200)}${evidence.length > 200 ? "..." : ""}\n\n`
|
|
140
|
+
: "") +
|
|
141
|
+
`**Gate decision**: ${gate.message}\n\n` +
|
|
142
|
+
`**Hypothesis generation skipped** - the input lacks sufficient specific evidence for meaningful root-cause analysis. ` +
|
|
143
|
+
`Provide concrete evidence (error messages, code diffs, test failures) for better results.`,
|
|
144
|
+
},
|
|
145
|
+
],
|
|
146
|
+
details: { problem, evidence: evidence ?? "", skipped: true, reason: gate.message },
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
// Proceed with generative LLM call (normal or deep depth)
|
|
150
|
+
try {
|
|
151
|
+
const prompt = buildPrompt({
|
|
152
|
+
problem,
|
|
153
|
+
evidence,
|
|
154
|
+
maxHypotheses: gate.suggestedDepth === "deep" ? Math.max(maxHypotheses, 5) : maxHypotheses,
|
|
155
|
+
format,
|
|
156
|
+
verificationPlan,
|
|
157
|
+
});
|
|
158
|
+
// Try the merged role first (accuracy-critical), then the session
|
|
159
|
+
// model. maxTokens 4000 + reasoning "low": reasoning tokens count
|
|
160
|
+
// against max_tokens for most providers (see llm-call.ts), so default
|
|
161
|
+
// reasoning can consume the whole budget thinking and return empty
|
|
162
|
+
// text — the owner-visible "Empty response from model" failure.
|
|
163
|
+
// The resolver list is shared so the empty-class retry below runs
|
|
164
|
+
// the identical chain.
|
|
165
|
+
const resolvers = [() => resolveUtilityModel(ctx), () => ctx.model];
|
|
166
|
+
let llmResult = await tryModelChain(ctx, resolvers, "You are an expert debugging assistant that analyzes problems and generates testable hypotheses.", prompt, { temperature: 0.3, signal, maxTokens: 4000, reasoning: "low" });
|
|
167
|
+
if ("error" in llmResult) {
|
|
168
|
+
// Live failure path: tryModelChain never returns empty text as
|
|
169
|
+
// success — on empty/error from every resolver it returns
|
|
170
|
+
// { error }. Empty-class errors (reasoning consumed the token
|
|
171
|
+
// budget) get ONE mechanical regeneration retry with reasoning
|
|
172
|
+
// off. Attempt-number logging only — no error dumps.
|
|
173
|
+
const retryOptions = emptyResponseRetryOptions(llmResult.error);
|
|
174
|
+
if (retryOptions) {
|
|
175
|
+
log.debug("hypothesize: attempt 1 hit the empty-response class, retrying with reasoning off (attempt 2)");
|
|
176
|
+
llmResult = await tryModelChain(ctx, resolvers, "You are an expert debugging assistant that analyzes problems and generates testable hypotheses.", prompt, { ...retryOptions, signal });
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
if ("error" in llmResult) {
|
|
180
|
+
// Graceful degradation: all models in chain failed (including the
|
|
181
|
+
// empty-class retry when one ran). The fallback carries the FINAL
|
|
182
|
+
// error text so the owner sees the true last state.
|
|
183
|
+
log.debug(`hypothesize: all models failed: ${llmResult.error}`);
|
|
184
|
+
return withMeta({
|
|
185
|
+
content: [
|
|
186
|
+
{
|
|
187
|
+
type: "text",
|
|
188
|
+
text: `## Hypothesis Generation Unavailable\n\n` +
|
|
189
|
+
`All available models failed to generate hypotheses for this problem.\n` +
|
|
190
|
+
`**Error:** ${llmResult.error}\n\n` +
|
|
191
|
+
`Try again later, or provide more specific evidence to narrow the search space.`,
|
|
192
|
+
},
|
|
193
|
+
],
|
|
194
|
+
details: {
|
|
195
|
+
problem,
|
|
196
|
+
evidence: evidence ?? "",
|
|
197
|
+
skipped: true,
|
|
198
|
+
reason: llmResult.error,
|
|
199
|
+
},
|
|
200
|
+
}, { confidence: 0, alternativesConsidered: 0 });
|
|
201
|
+
}
|
|
202
|
+
const text = llmResult.text.trim();
|
|
203
|
+
if (!text) {
|
|
204
|
+
// Graceful degradation: model returned empty text.
|
|
205
|
+
// This is a transient model issue (overload, content rejection, timeout).
|
|
206
|
+
// Return a fallback instead of crashing the tool.
|
|
207
|
+
log.debug(`hypothesize: model returned empty text (model=${ctx.model.id})`);
|
|
208
|
+
return withMeta({
|
|
209
|
+
content: [
|
|
210
|
+
{
|
|
211
|
+
type: "text",
|
|
212
|
+
text: `## Hypothesis Generation Returned Empty\n\n` +
|
|
213
|
+
`The model (${ctx.model.id}) returned an empty response. ` +
|
|
214
|
+
`This is usually a transient issue (model overload, content policy, or timeout).\n\n` +
|
|
215
|
+
`**Suggestions:**\n` +
|
|
216
|
+
`1. Try again — the model may be recovering from a transient error\n` +
|
|
217
|
+
`2. Narrow the problem statement to reduce token count\n` +
|
|
218
|
+
`3. Use \`think()\` to manually reason about root causes`,
|
|
219
|
+
},
|
|
220
|
+
],
|
|
221
|
+
details: {
|
|
222
|
+
problem,
|
|
223
|
+
evidence: evidence ?? "",
|
|
224
|
+
skipped: true,
|
|
225
|
+
reason: "empty_response",
|
|
226
|
+
},
|
|
227
|
+
}, { confidence: 0, alternativesConsidered: 0 });
|
|
228
|
+
}
|
|
229
|
+
// Score hypotheses with heuristic signals + evidence pool
|
|
230
|
+
const { scored, annotated } = scoreHypothesisOutput(text, evidence, ctx ?? undefined);
|
|
231
|
+
// B-class: enhance signal detection with LLM when heuristic fails
|
|
232
|
+
// (tierPolicy: fallback-only means the heuristic fires first with 0.5 confidence,
|
|
233
|
+
// and the LLM path covers edge cases the regexes miss).
|
|
234
|
+
try {
|
|
235
|
+
const signalResult = await classify(ctx, CRITICS.hypothesisSignals.criteria, { hypothesisText: text }, {
|
|
236
|
+
label: CRITICS.hypothesisSignals.label,
|
|
237
|
+
fallback: () => hypothesisSignalFallback(text),
|
|
238
|
+
tierPolicy: "fallback-only",
|
|
239
|
+
});
|
|
240
|
+
if (signalResult.label && signalResult.label !== "none") {
|
|
241
|
+
const llmSignals = signalResult.label.split(",").map((s) => s.trim());
|
|
242
|
+
for (const s of scored) {
|
|
243
|
+
for (const ls of llmSignals) {
|
|
244
|
+
if (!s.signals.includes(ls)) {
|
|
245
|
+
s.signals.push(ls);
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
// Swallow: signal enhancement is best-effort, heuristic results are sufficient
|
|
253
|
+
}
|
|
254
|
+
return withMeta({
|
|
255
|
+
content: [{ type: "text", text: annotated }],
|
|
256
|
+
details: {
|
|
257
|
+
problem,
|
|
258
|
+
hypotheses: maxHypotheses,
|
|
259
|
+
format,
|
|
260
|
+
verificationPlan: verificationPlan ?? null,
|
|
261
|
+
modelUsed: ctx.model.id,
|
|
262
|
+
scores: scored.map((s) => ({
|
|
263
|
+
rank: s.index,
|
|
264
|
+
title: s.title,
|
|
265
|
+
score: s.score,
|
|
266
|
+
signals: s.signals,
|
|
267
|
+
evidenceMatches: s.evidenceMatches.map((m) => ({
|
|
268
|
+
claim: m.claim.slice(0, 200),
|
|
269
|
+
source: m.source,
|
|
270
|
+
overlap: m.overlap,
|
|
271
|
+
})),
|
|
272
|
+
evidenceFor: s.evidenceFor ?? [],
|
|
273
|
+
evidenceAgainst: s.evidenceAgainst ?? [],
|
|
274
|
+
})),
|
|
275
|
+
},
|
|
276
|
+
}, {
|
|
277
|
+
confidence: Math.max(...scored.map((s) => s.score), 0.5),
|
|
278
|
+
alternativesConsidered: scored.length,
|
|
279
|
+
suggestedNextTool: scored.some((s) => s.evidenceMatches.length)
|
|
280
|
+
? "explore_paths"
|
|
281
|
+
: undefined,
|
|
282
|
+
});
|
|
283
|
+
}
|
|
284
|
+
catch (err) {
|
|
285
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
286
|
+
throw new Error(`hypothesize: model analysis failed - ${message}`, { cause: err });
|
|
287
|
+
}
|
|
288
|
+
},
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
//# sourceMappingURL=hypothesize.js.map
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
export interface ScoredHypothesis {
|
|
3
|
+
index: number;
|
|
4
|
+
title: string;
|
|
5
|
+
score: number;
|
|
6
|
+
heuristicScore: number;
|
|
7
|
+
evidenceScore: number;
|
|
8
|
+
signals: string[];
|
|
9
|
+
evidenceMatches: Array<{
|
|
10
|
+
claim: string;
|
|
11
|
+
source: string;
|
|
12
|
+
reliability: number;
|
|
13
|
+
overlap: number;
|
|
14
|
+
}>;
|
|
15
|
+
/** Parsed "What evidence would CONFIRM" lines from hypotheses output. */
|
|
16
|
+
evidenceFor?: string[];
|
|
17
|
+
/** Parsed "What evidence would DISPROVE" lines from hypotheses output. */
|
|
18
|
+
evidenceAgainst?: string[];
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Score an entire LLM hypothesis output (may contain multiple hypotheses).
|
|
22
|
+
* Returns scored hypotheses re-ranked by combined score, plus annotated text.
|
|
23
|
+
*/
|
|
24
|
+
export declare function scoreHypothesisOutput(llmOutput: string, evidence: string, ctx?: ExtensionContext): {
|
|
25
|
+
scored: ScoredHypothesis[];
|
|
26
|
+
annotated: string;
|
|
27
|
+
};
|
|
28
|
+
//# sourceMappingURL=scoring.d.ts.map
|
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
// Hypothesis scoring: heuristic + evidence-pool scoring for ranking hypotheses.
|
|
2
|
+
import { tokenOverlap } from "../../../../lib/store/evidence-pool.js";
|
|
3
|
+
import { getEvidence } from "../../../../lib/store/evidence-pool.js";
|
|
4
|
+
// Heuristic signals
|
|
5
|
+
/** Score a single hypothesis block against evidence using heuristic signals. */
|
|
6
|
+
function scoreHeuristic(llmOutput, evidence) {
|
|
7
|
+
const signals = [];
|
|
8
|
+
let score = 0.5; // baseline
|
|
9
|
+
// Signal: mentions specific file or function
|
|
10
|
+
const fileRefs = llmOutput.match(/\b[\w/.-]+\.(ts|js|json|py|rs|go)\b/g) ?? [];
|
|
11
|
+
if (fileRefs.length > 0) {
|
|
12
|
+
score += 0.1;
|
|
13
|
+
signals.push("specific-files");
|
|
14
|
+
}
|
|
15
|
+
// Signal: references evidence in reasoning
|
|
16
|
+
const evidenceTokens = evidence.split(/\s+/).slice(0, 3).join(" ").toLowerCase().slice(0, 30);
|
|
17
|
+
if (evidence && llmOutput.toLowerCase().includes(evidenceTokens)) {
|
|
18
|
+
score += 0.15;
|
|
19
|
+
signals.push("evidence-cited");
|
|
20
|
+
}
|
|
21
|
+
// Signal: proposes verification steps
|
|
22
|
+
if (/verify|check|test|confirm|reproduce/i.test(llmOutput)) {
|
|
23
|
+
score += 0.1;
|
|
24
|
+
signals.push("verification-plan");
|
|
25
|
+
}
|
|
26
|
+
// Signal: explains root cause mechanism
|
|
27
|
+
if (/because|caused by|due to|root cause|underlying/i.test(llmOutput)) {
|
|
28
|
+
score += 0.05;
|
|
29
|
+
signals.push("causal-reasoning");
|
|
30
|
+
}
|
|
31
|
+
// Signal: proper solution (not workaround)
|
|
32
|
+
if (/proper|maintainable|clean|refactor|fix.*properly/i.test(llmOutput)) {
|
|
33
|
+
score += 0.05;
|
|
34
|
+
signals.push("proper-solution");
|
|
35
|
+
}
|
|
36
|
+
// Signal: considers edge cases
|
|
37
|
+
if (/edge case|boundary|corner case|failure mode/i.test(llmOutput)) {
|
|
38
|
+
score += 0.05;
|
|
39
|
+
signals.push("edge-case-aware");
|
|
40
|
+
}
|
|
41
|
+
return { heuristicScore: Math.min(score, 1), signals };
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Score a hypothesis block against the evidence pool.
|
|
45
|
+
*
|
|
46
|
+
* Scoring dimensions:
|
|
47
|
+
* 1. Evidence overlap - token overlap between hypothesis and evidence items
|
|
48
|
+
* 2. Source reliability - evidence from code/docs outweighs memory/web
|
|
49
|
+
* 3. Recency - recent evidence (within 5 min) gets +0.1 weight boost
|
|
50
|
+
*/
|
|
51
|
+
function scoreEvidencePool(hypothesisText, ctx) {
|
|
52
|
+
if (!ctx) {
|
|
53
|
+
return { score: 0, matches: [] };
|
|
54
|
+
}
|
|
55
|
+
const matches = [];
|
|
56
|
+
let totalEvidenceScore = 0;
|
|
57
|
+
let evidenceCount = 0;
|
|
58
|
+
const allEvidence = getEvidence(ctx);
|
|
59
|
+
if (allEvidence.length === 0) {
|
|
60
|
+
return { score: 0, matches: [] };
|
|
61
|
+
}
|
|
62
|
+
for (const evidence of allEvidence) {
|
|
63
|
+
const overlap = tokenOverlap(hypothesisText, evidence.claim);
|
|
64
|
+
if (overlap < 0.2)
|
|
65
|
+
continue; // Only meaningful overlap
|
|
66
|
+
// Recency boost: evidence from the last 5 minutes gets +0.1 weight
|
|
67
|
+
const ageMs = Date.now() - (evidence.timestamp ?? 0);
|
|
68
|
+
const recencyBoost = ageMs < 5 * 60 * 1000 ? 0.1 : 0;
|
|
69
|
+
// Source reliability weight
|
|
70
|
+
const sourceWeights = {
|
|
71
|
+
code: 1.0,
|
|
72
|
+
docs: 0.85,
|
|
73
|
+
memory: 0.7,
|
|
74
|
+
web: 0.6,
|
|
75
|
+
session: 0.5,
|
|
76
|
+
unknown: 0.4,
|
|
77
|
+
};
|
|
78
|
+
const sourceWeight = sourceWeights[evidence.source] ?? 0.5;
|
|
79
|
+
// Evidence score: overlap x reliability x recency boost
|
|
80
|
+
const evidenceScore = overlap * sourceWeight * evidence.reliability + recencyBoost;
|
|
81
|
+
totalEvidenceScore += evidenceScore;
|
|
82
|
+
evidenceCount++;
|
|
83
|
+
matches.push({
|
|
84
|
+
claim: evidence.claim,
|
|
85
|
+
source: evidence.source,
|
|
86
|
+
reliability: evidence.reliability,
|
|
87
|
+
overlap: Math.round(overlap * 100),
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
const rawScore = evidenceCount > 0 ? totalEvidenceScore / evidenceCount : 0;
|
|
91
|
+
const score = Math.min(rawScore * 2, 1); // Diminishing returns, capped at 1.0
|
|
92
|
+
return { score, matches };
|
|
93
|
+
}
|
|
94
|
+
/** Parse confirm/disprove evidence from a hypothesis block. */
|
|
95
|
+
function extractEvidences(block) {
|
|
96
|
+
const evidenceFor = [];
|
|
97
|
+
const evidenceAgainst = [];
|
|
98
|
+
const forMatch = block.match(/(?:What evidence would CONFIRM|Evidence.*confirm|To confirm|Confirm).*?\n?([\s\S]*?)(?=\d+\.\s|What evidence would DISPROVE|Evidence.*disprove|To disprove|How to fix|$)/i);
|
|
99
|
+
if (forMatch) {
|
|
100
|
+
forMatch[1]
|
|
101
|
+
.split(/\n/)
|
|
102
|
+
.map((l) => l.replace(/^[-**]\s*/, "").trim())
|
|
103
|
+
.filter((l) => l.length > 5)
|
|
104
|
+
.forEach((l) => evidenceFor.push(l));
|
|
105
|
+
}
|
|
106
|
+
const againstMatch = block.match(/(?:What evidence would DISPROVE|Evidence.*disprove|To disprove).*?\n?([\s\S]*?)(?=\d+\.\s|How to fix|$)/i);
|
|
107
|
+
if (againstMatch) {
|
|
108
|
+
againstMatch[1]
|
|
109
|
+
.split(/\n/)
|
|
110
|
+
.map((l) => l.replace(/^[-**]\s*/, "").trim())
|
|
111
|
+
.filter((l) => l.length > 5)
|
|
112
|
+
.forEach((l) => evidenceAgainst.push(l));
|
|
113
|
+
}
|
|
114
|
+
return { evidenceFor, evidenceAgainst };
|
|
115
|
+
}
|
|
116
|
+
function scoreHypothesisBlock(llmOutput, evidence, ctx) {
|
|
117
|
+
const title = llmOutput.split("\n")[0]?.slice(0, 80) ?? "Untitled hypothesis";
|
|
118
|
+
const heuristic = scoreHeuristic(llmOutput, evidence);
|
|
119
|
+
const { score: evidenceScore, matches } = scoreEvidencePool(llmOutput, ctx);
|
|
120
|
+
const { evidenceFor, evidenceAgainst } = extractEvidences(llmOutput);
|
|
121
|
+
// Combined weighted score: 60% heuristic, 40% evidence pool
|
|
122
|
+
const score = heuristic.heuristicScore * 0.6 + evidenceScore * 0.4;
|
|
123
|
+
return {
|
|
124
|
+
index: -1,
|
|
125
|
+
title,
|
|
126
|
+
score: Math.min(score, 1),
|
|
127
|
+
heuristicScore: heuristic.heuristicScore,
|
|
128
|
+
evidenceScore,
|
|
129
|
+
signals: heuristic.signals,
|
|
130
|
+
evidenceMatches: matches,
|
|
131
|
+
evidenceFor: evidenceFor.length > 0 ? evidenceFor : undefined,
|
|
132
|
+
evidenceAgainst: evidenceAgainst.length > 0 ? evidenceAgainst : undefined,
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* Score an entire LLM hypothesis output (may contain multiple hypotheses).
|
|
137
|
+
* Returns scored hypotheses re-ranked by combined score, plus annotated text.
|
|
138
|
+
*/
|
|
139
|
+
export function scoreHypothesisOutput(llmOutput, evidence, ctx) {
|
|
140
|
+
const blocks = llmOutput.split(/(?=Hypothesis\s+\d+)/i).filter((b) => b.trim());
|
|
141
|
+
if (blocks.length <= 1) {
|
|
142
|
+
const s = scoreHypothesisBlock(llmOutput, evidence, ctx);
|
|
143
|
+
s.index = 0;
|
|
144
|
+
const annotated = `${llmOutput}\n\n---\n**Analysis Score: ${(s.score * 100).toFixed(0)}%** (heuristic: ${(s.heuristicScore * 100).toFixed(0)}% | evidence: ${(s.evidenceScore * 100).toFixed(0)}%)\nSignals: ${s.signals.join(", ") || "none"}${s.evidenceMatches.length ? "\nEvidence matches: " + s.evidenceMatches.map((m) => `[${m.source}:${m.overlap}%] "${m.claim}"`).join(", ") : ""}`;
|
|
145
|
+
return { scored: [s], annotated };
|
|
146
|
+
}
|
|
147
|
+
const scored = blocks.map((block) => scoreHypothesisBlock(block, evidence, ctx));
|
|
148
|
+
// Re-rank by combined score (descending)
|
|
149
|
+
scored.sort((a, b) => b.score - a.score);
|
|
150
|
+
scored.forEach((s, i) => {
|
|
151
|
+
s.index = i;
|
|
152
|
+
});
|
|
153
|
+
let annotated = "";
|
|
154
|
+
for (const s of scored) {
|
|
155
|
+
const rankEmoji = s.index === 0 ? "🥇" : s.index === 1 ? "🥈" : s.index === 2 ? "🥉" : ` ${s.index + 1}.`;
|
|
156
|
+
const badge = s.evidenceMatches.length > 0 ? " [📊evidence-matched]" : "";
|
|
157
|
+
const evidenceLine = s.evidenceMatches.length > 0
|
|
158
|
+
? `\n Evidence: ${s.evidenceMatches.map((m) => `${m.source}:${m.overlap}%`).join(", ")}`
|
|
159
|
+
: "";
|
|
160
|
+
const forLine = s.evidenceFor && s.evidenceFor.length > 0
|
|
161
|
+
? `\n [ok] Confirm: ${s.evidenceFor.slice(0, 2).join("; ")}`
|
|
162
|
+
: "";
|
|
163
|
+
const againstLine = s.evidenceAgainst && s.evidenceAgainst.length > 0
|
|
164
|
+
? `\n [fail] Disprove: ${s.evidenceAgainst.slice(0, 2).join("; ")}`
|
|
165
|
+
: "";
|
|
166
|
+
annotated +=
|
|
167
|
+
`${rankEmoji} ${s.title}${badge}\n` +
|
|
168
|
+
` Score: ${(s.score * 100).toFixed(0)}% (heuristic: ${(s.heuristicScore * 100).toFixed(0)}% | evidence: ${(s.evidenceScore * 100).toFixed(0)}%)${forLine}${againstLine}\n` +
|
|
169
|
+
` Signals: ${s.signals.join(", ") || "none"}${evidenceLine}\n\n`;
|
|
170
|
+
}
|
|
171
|
+
return { scored, annotated };
|
|
172
|
+
}
|
|
173
|
+
//# sourceMappingURL=scoring.js.map
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ODAR (Optimal Depth Allocation Routing) and budget helpers.
|
|
3
|
+
*
|
|
4
|
+
* ODAR maps a task description to a complexity score (0-1) and a depth
|
|
5
|
+
* level (quick | standard | deep). The depth level is then mapped to
|
|
6
|
+
* a per-step token budget + guidance via DEPTH_BUDGETS.
|
|
7
|
+
*
|
|
8
|
+
* The complexity score uses keyword counting (high/medium technical
|
|
9
|
+
* terms), length signal, multi-step indicators, and question count.
|
|
10
|
+
* Not a learned routing algorithm -- heuristic. Saves 30-60% tokens on
|
|
11
|
+
* simple tasks by routing to the fast system.
|
|
12
|
+
*
|
|
13
|
+
* Calibration helpers track prediction error: how far our confidence
|
|
14
|
+
* (0-1) is from actual outcome (success/failure). Used to detect
|
|
15
|
+
* overconfidence patterns and adjust the calibration score per session.
|
|
16
|
+
*/
|
|
17
|
+
export interface CalibrationSample {
|
|
18
|
+
thoughtId: string;
|
|
19
|
+
predictedConfidence: number;
|
|
20
|
+
actualOutcome: "success" | "failure";
|
|
21
|
+
calibrationError: number;
|
|
22
|
+
createdAt: number;
|
|
23
|
+
}
|
|
24
|
+
interface CalibrationStateSlice {
|
|
25
|
+
calibrationSamples: CalibrationSample[];
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Estimate complexity score (0-1) from a task description.
|
|
29
|
+
* 0-0.3: simple (quick depth)
|
|
30
|
+
* 0.3-0.7: medium (medium depth)
|
|
31
|
+
* 0.7-1.0: complex (deep depth)
|
|
32
|
+
*/
|
|
33
|
+
export declare function estimateComplexity(taskText: string): number;
|
|
34
|
+
/**
|
|
35
|
+
* Allowed values for the think tool's `type` field.
|
|
36
|
+
*
|
|
37
|
+
* Single source of truth -- both the schema enum (think.ts) and any
|
|
38
|
+
* internal default reference this const. Add a value here and it
|
|
39
|
+
* becomes accepted by the schema automatically.
|
|
40
|
+
*/
|
|
41
|
+
export declare const THINK_TYPES: readonly ["observation", "planning", "execution", "reflection", "conclusion", "debugging", "design", "analysis", "insight", "research"];
|
|
42
|
+
export type ThinkType = (typeof THINK_TYPES)[number];
|
|
43
|
+
/** Default `type` when the agent omits it. Must be a member of THINK_TYPES. */
|
|
44
|
+
export declare const DEFAULT_THINK_TYPE: ThinkType;
|
|
45
|
+
/**
|
|
46
|
+
* Allowed values for the think tool's `depth` field.
|
|
47
|
+
*
|
|
48
|
+
* Note: `quick`, `medium`, `deep` are the ODAR-aligned levels; the
|
|
49
|
+
* earlier `minimal`/`low`/`high`/`max` entries exist for explicit
|
|
50
|
+
* fine-grained control. The two vocabularies coexist deliberately --
|
|
51
|
+
* removing the legacy entries would break callers that pass them.
|
|
52
|
+
*/
|
|
53
|
+
export declare const DEPTH_LEVELS: readonly ["minimal", "low", "medium", "high", "max", "quick", "deep"];
|
|
54
|
+
/**
|
|
55
|
+
* Depth levels reachable via ODAR complexity -> depth routing.
|
|
56
|
+
*
|
|
57
|
+
* NOTE: vocabulary is aligned with `think.ts`'s depth enum and
|
|
58
|
+
* `DEPTH_BUDGETS` — the value must be a member of both, or `getBudget`
|
|
59
|
+
* silently falls back to "quick".
|
|
60
|
+
*/
|
|
61
|
+
export declare const ODAR_DEPTH_LEVELS: readonly ["quick", "medium", "deep"];
|
|
62
|
+
export type OdarDepthLevel = (typeof ODAR_DEPTH_LEVELS)[number];
|
|
63
|
+
/**
|
|
64
|
+
* Map complexity score to ODAR depth level.
|
|
65
|
+
*/
|
|
66
|
+
export declare function complexityToDepth(score: number): OdarDepthLevel;
|
|
67
|
+
/**
|
|
68
|
+
* Compute calibration error: |predicted confidence - actual outcome|
|
|
69
|
+
* actual outcome = 1.0 for success, 0.0 for failure
|
|
70
|
+
*/
|
|
71
|
+
export declare function computeCalibrationError(predicted: number, actual: "success" | "failure"): number;
|
|
72
|
+
/**
|
|
73
|
+
* Get calibration statistics for this session.
|
|
74
|
+
*/
|
|
75
|
+
export declare function getCalibrationStats(state: CalibrationStateSlice): {
|
|
76
|
+
error: number;
|
|
77
|
+
n: number;
|
|
78
|
+
bias: string;
|
|
79
|
+
};
|
|
80
|
+
export declare function getBudget(depth: string): {
|
|
81
|
+
tokens: number;
|
|
82
|
+
guidance: string;
|
|
83
|
+
};
|
|
84
|
+
export {};
|
|
85
|
+
//# sourceMappingURL=think-budget.d.ts.map
|