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,548 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text Classifier - lightweight classification with a configurable role model.
|
|
3
|
+
*
|
|
4
|
+
* Four-tier fallback (logit-probe first):
|
|
5
|
+
* Tier 0 (binary gate): Ultra-cheap yes/no pre-check via maxTokens=1, temperature=0.
|
|
6
|
+
* Cost: 1 output token. Returns the model's argmax prediction for yes/no.
|
|
7
|
+
* Falls through on any non-yes/no response. Enabled via binaryGate: true.
|
|
8
|
+
* Tier 1: Heuristic fallback callback (caller-provided). Fast, free.
|
|
9
|
+
* If it returns a clear "yes"/"no", use it with 0.7 confidence.
|
|
10
|
+
* Tier 2: Merged role model (utilityModel, via /utility-model or settings.json)
|
|
11
|
+
* Tier 3: Session model (ctx.model)
|
|
12
|
+
*
|
|
13
|
+
* The merged role is the one auxiliary role: "quality" puts the session model
|
|
14
|
+
* first, every other preference puts the role first, and a model configured
|
|
15
|
+
* once can no longer appear as two tiers.
|
|
16
|
+
*
|
|
17
|
+
* The heuristic tier is preferred over LLM because it's instant and costs nothing.
|
|
18
|
+
* The binary gate is preferred over heuristic because it costs 1 token and gives
|
|
19
|
+
* a calibrated LLM judgment (not a fragile regex).
|
|
20
|
+
*/
|
|
21
|
+
import { callLlm } from "../ai/llm-call.js";
|
|
22
|
+
import { resolveUtilityModel } from "../ai/model-resolver.js";
|
|
23
|
+
import { createLogger } from "../core/logger.js";
|
|
24
|
+
import { recordCriticCall } from "./critic-stats.js";
|
|
25
|
+
import { getCacheKey, getCachedResult, setCachedResult } from "./critic-cache.js";
|
|
26
|
+
const log = createLogger("text-classifier");
|
|
27
|
+
/**
|
|
28
|
+
* Build the ordered list of LLM tiers based on the modelPreference strategy.
|
|
29
|
+
*
|
|
30
|
+
* The merged role supplies the one auxiliary model: "quality" keeps the
|
|
31
|
+
* session model first, every other preference puts the role first. Tiers that
|
|
32
|
+
* resolve to the same provider/model pair are deduped, so a role configured
|
|
33
|
+
* to the session model does not cost two attempts.
|
|
34
|
+
*
|
|
35
|
+
* The heuristic (tier 1) is always evaluated before this function is called.
|
|
36
|
+
*/
|
|
37
|
+
function buildTierOrder(modelPreference, ctx) {
|
|
38
|
+
const utility = resolveUtilityModel(ctx);
|
|
39
|
+
const session = ctx.model;
|
|
40
|
+
const roleTier = utility
|
|
41
|
+
? { name: "utility", model: utility, confidence: 0.9 }
|
|
42
|
+
: undefined;
|
|
43
|
+
const sessionTier = session
|
|
44
|
+
? { name: "session", model: session, confidence: 0.6 }
|
|
45
|
+
: undefined;
|
|
46
|
+
const ordered = modelPreference === "quality" ? [sessionTier, roleTier] : [roleTier, sessionTier];
|
|
47
|
+
const seen = new Set();
|
|
48
|
+
const tiers = [];
|
|
49
|
+
for (const tier of ordered) {
|
|
50
|
+
if (!tier)
|
|
51
|
+
continue;
|
|
52
|
+
const key = `${tier.model.provider ?? "unknown"}/${tier.model.id}`;
|
|
53
|
+
if (seen.has(key))
|
|
54
|
+
continue;
|
|
55
|
+
seen.add(key);
|
|
56
|
+
tiers.push(tier);
|
|
57
|
+
}
|
|
58
|
+
return tiers;
|
|
59
|
+
}
|
|
60
|
+
// ── Binary Gate (Tier 0) ─────────────────────────────────────────────────────
|
|
61
|
+
/**
|
|
62
|
+
* Tier 0: Binary gate — ultra-cheap yes/no pre-check.
|
|
63
|
+
*
|
|
64
|
+
* For binary classification, the model's first-token logits already encode the
|
|
65
|
+
* full decision. We don't need 30-50 tokens of structured output — just 1 token
|
|
66
|
+
* at temperature=0 gives the model's argmax prediction.
|
|
67
|
+
*
|
|
68
|
+
* Based on research:
|
|
69
|
+
* - "Calibrated Large Language Models for Binary Question Answering" (2407.01122)
|
|
70
|
+
* - Logit probing / logprob-based classification (arcturus-labs.com 2025)
|
|
71
|
+
* - Token-level probability estimation (ericjinks.com 2025)
|
|
72
|
+
*
|
|
73
|
+
* Strategy:
|
|
74
|
+
* 1. Try the utility model first (cheapest available)
|
|
75
|
+
* 2. Fall back to the session model
|
|
76
|
+
* 3. If neither produces a clear yes/no, return null → falls through to existing cascade
|
|
77
|
+
*
|
|
78
|
+
* Cost: 1 output token on success (vs ~30-50 for full cascade).
|
|
79
|
+
* Timeout: 10s per model (fast failure is better than waiting).
|
|
80
|
+
*/
|
|
81
|
+
async function binaryGate(ctx, systemPrompt, userMessage, signal) {
|
|
82
|
+
const utilityModel = resolveUtilityModel(ctx);
|
|
83
|
+
const models = [
|
|
84
|
+
{ name: "utility", model: utilityModel },
|
|
85
|
+
{ name: "session", model: ctx.model },
|
|
86
|
+
].filter((m) => m.model !== undefined);
|
|
87
|
+
for (const { name, model } of models) {
|
|
88
|
+
try {
|
|
89
|
+
const apiKey = await ctx.modelRegistry.getApiKeyForProvider(model.provider);
|
|
90
|
+
if (!apiKey)
|
|
91
|
+
continue;
|
|
92
|
+
const result = await callLlm(model, apiKey, systemPrompt, userMessage, {
|
|
93
|
+
maxTokens: 1,
|
|
94
|
+
temperature: 0,
|
|
95
|
+
reasoning: "off",
|
|
96
|
+
timeoutMs: 10_000,
|
|
97
|
+
...(signal ? { signal } : {}),
|
|
98
|
+
});
|
|
99
|
+
if ("error" in result) {
|
|
100
|
+
log.debug(`[text-classifier] binary gate (${name}) error: ${result.error}`);
|
|
101
|
+
continue;
|
|
102
|
+
}
|
|
103
|
+
const raw = result.text.trim().toLowerCase();
|
|
104
|
+
if (raw === "yes" || raw === "no") {
|
|
105
|
+
log.debug(`[text-classifier] binary gate (${name}): "${raw}" (1 token)`);
|
|
106
|
+
return raw;
|
|
107
|
+
}
|
|
108
|
+
log.debug(`[text-classifier] binary gate (${name}) ambiguous: "${raw}"`);
|
|
109
|
+
}
|
|
110
|
+
catch (e) {
|
|
111
|
+
log.debug(`[text-classifier] binary gate (${name}) threw: ${e.message}`);
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
return null;
|
|
115
|
+
}
|
|
116
|
+
// ── Classify ─────────────────────────────────────────────────────────────────
|
|
117
|
+
/**
|
|
118
|
+
* Classify text using the four-tier fallback system (heuristic-first).
|
|
119
|
+
*
|
|
120
|
+
* Tier 1 (heuristic) runs first - it's fast and free. Only if the heuristic
|
|
121
|
+
* returns something ambiguous or isn't provided do we consult LLM tiers.
|
|
122
|
+
*
|
|
123
|
+
* Tier flow by modelPreference (see ClassifierOptions for details):
|
|
124
|
+
* "balanced" (default): heuristic -> role -> session
|
|
125
|
+
* "quality": heuristic -> session -> role
|
|
126
|
+
* "speed" / "max": heuristic -> role -> session (same as balanced)
|
|
127
|
+
*
|
|
128
|
+
* @param ctx - Extension context for model resolution + API keys.
|
|
129
|
+
* @param criteria - Prompt templates (system + user with {{key}} placeholders).
|
|
130
|
+
* @param substitutions - Key-value pairs to replace `{{key}}` in prompts.
|
|
131
|
+
* @param options - Optional: maxTokens, timeoutMs, heuristic fallback, modelPreference.
|
|
132
|
+
* @returns ClassificationResult with label, confidence, tier, and latency.
|
|
133
|
+
*/
|
|
134
|
+
export async function classify(ctx, criteria, substitutions, options) {
|
|
135
|
+
const start = Date.now();
|
|
136
|
+
// Default maxTokens: undefined (was 64, was 16, was 10).
|
|
137
|
+
//
|
|
138
|
+
// Why we removed the default entirely:
|
|
139
|
+
// 1. Yes/no answers are 1-2 tokens. The model can stop early
|
|
140
|
+
// without us capping it.
|
|
141
|
+
// 2. Setting maxTokens too LOW (10, 16) caused the empty-string
|
|
142
|
+
// bug for reasoning-capable models (mistral-small,
|
|
143
|
+
// minimax-m3) - thinking tokens ate the budget and
|
|
144
|
+
// produced 0 output tokens.
|
|
145
|
+
// 3. Setting maxTokens too HIGH (64, 1000) is a no-op for
|
|
146
|
+
// classification - the model uses 1-2 tokens either way.
|
|
147
|
+
//
|
|
148
|
+
// Undefined does NOT mean "no cap": callLlm sizes a default from the
|
|
149
|
+
// prompt length (1000-4000 tokens). A reasoning-capable model that
|
|
150
|
+
// ignores `reasoning: "off"` can burn that entire budget on its
|
|
151
|
+
// thinking channel and return no text at all (stopReason=length, the
|
|
152
|
+
// empty-label symptom). tryModelCall's one-shot enlarged-budget retry
|
|
153
|
+
// covers that signature.
|
|
154
|
+
//
|
|
155
|
+
// Callers can still pass `maxTokens` explicitly if they need a
|
|
156
|
+
// hard cap (e.g., for a custom reason).
|
|
157
|
+
const maxTokens = options?.maxTokens;
|
|
158
|
+
// 10-minute default per tier (was 8s; bestEffort was 3s). Aborts
|
|
159
|
+
// should be signal-driven (ESC, session shutdown), not
|
|
160
|
+
// timeout-driven. A timeout here is a fallback for orphaned calls
|
|
161
|
+
// (caller crashed, signal never fired) - not the normal
|
|
162
|
+
// cancellation path. Slow models (minimax-m3, mistral-small)
|
|
163
|
+
// regularly take 3-5s for a single classification, but worst-case
|
|
164
|
+
// paths (large prompts, network jitter, session-end backpressure)
|
|
165
|
+
// can take 30s+. Callers can still pass a tighter timeoutMs if
|
|
166
|
+
// they want a hard ceiling.
|
|
167
|
+
//
|
|
168
|
+
// The bestEffort flag no longer affects the timeout - it now only
|
|
169
|
+
// demotes failure logs to debug. Both modes get the same 10-min
|
|
170
|
+
// default; the difference is just whether aborts are noisy.
|
|
171
|
+
const timeoutMs = options?.timeoutMs ?? 600_000;
|
|
172
|
+
// Demote the per-tier failure warns and the "ALL TIERS FAILED" warn
|
|
173
|
+
// to debug when bestEffort is set OR the failure was an abort.
|
|
174
|
+
// Aborts at session end are expected behavior (the session signal
|
|
175
|
+
// cascades to in-flight calls), not real failures.
|
|
176
|
+
const logTierFailure = (reason) => {
|
|
177
|
+
if (options?.bestEffort || /abort/i.test(reason)) {
|
|
178
|
+
log.debug(`[text-classifier] ${reason}`);
|
|
179
|
+
}
|
|
180
|
+
else {
|
|
181
|
+
log.warn(`[text-classifier] ${reason}`);
|
|
182
|
+
}
|
|
183
|
+
};
|
|
184
|
+
// Build prompts (needed early for LLM tiers)
|
|
185
|
+
const userMessage = replacePlaceholders(criteria.userPrompt, substitutions);
|
|
186
|
+
// ── Tier 0: Binary gate (ultra-cheap, 1 token) ───────────────────────────
|
|
187
|
+
// For binary yes/no classifiers, the model's first-token logits at
|
|
188
|
+
// temperature=0 give the argmax prediction for the cost of 1 output token.
|
|
189
|
+
// Falls through to the heuristic + LLM cascade on any non-yes/no response.
|
|
190
|
+
//
|
|
191
|
+
// Default: enabled for all binary (yes/no) classifiers. Disabled for
|
|
192
|
+
// multi-class classifiers (those with validLabels) since the gate only
|
|
193
|
+
// handles yes/no. Callers can explicitly set binaryGate: false to opt out.
|
|
194
|
+
const opts = options;
|
|
195
|
+
const useBinaryGate = opts?.binaryGate ?? (!opts?.validLabels || (opts.validLabels?.length ?? 0) === 0);
|
|
196
|
+
if (useBinaryGate && opts?.tierPolicy !== "always-llm") {
|
|
197
|
+
const gateLabel = await binaryGate(ctx, criteria.systemPrompt, userMessage, ctx.signal);
|
|
198
|
+
if (gateLabel) {
|
|
199
|
+
const latency = Date.now() - start;
|
|
200
|
+
log.debug(`[text-classifier] TIER 0 (binary gate): "${gateLabel}" ${latency}ms (1 token)`);
|
|
201
|
+
if (opts?.label)
|
|
202
|
+
recordCriticCall(opts.label, "gate", latency);
|
|
203
|
+
// Cache the binary gate result so subsequent identical calls
|
|
204
|
+
// skip the gate entirely (cache hit returns instantly).
|
|
205
|
+
if (opts?.label) {
|
|
206
|
+
setCachedResult(getCacheKey(opts.label, criteria.systemPrompt, userMessage), {
|
|
207
|
+
label: gateLabel,
|
|
208
|
+
confidence: 0.5,
|
|
209
|
+
raw: gateLabel,
|
|
210
|
+
tier: "gate",
|
|
211
|
+
latencyMs: latency,
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
return {
|
|
215
|
+
label: gateLabel,
|
|
216
|
+
confidence: 0.5,
|
|
217
|
+
raw: gateLabel,
|
|
218
|
+
tier: "gate",
|
|
219
|
+
latencyMs: latency,
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
log.debug("[text-classifier] TIER 0 (binary gate) ambiguous, falling to TIER 1");
|
|
223
|
+
}
|
|
224
|
+
// ── Tier 1: Heuristic fallback (fast, no LLM cost) ──────────────────────
|
|
225
|
+
// Skipped entirely when tierPolicy === "always-llm" (accuracy-critical
|
|
226
|
+
// classifiers where a wrong heuristic answer is worse than LLM cost).
|
|
227
|
+
if (options?.fallback && options?.tierPolicy !== "always-llm") {
|
|
228
|
+
const heuristicLabel = await options.fallback();
|
|
229
|
+
const lower = heuristicLabel?.trim().toLowerCase();
|
|
230
|
+
// Accept any non-empty short string as a valid fallback label.
|
|
231
|
+
// Previously the check was `=== "yes" || === "no"` which silently
|
|
232
|
+
// dropped fallbacks returning labels like "positive"/"negative",
|
|
233
|
+
// "rate_limit"/"server_error", "SHALL"/"MUST"/"SHOULD"/"MAY",
|
|
234
|
+
// "STABLE"/"DEGRADED", "pipeline"/"loop"/"info"/"edit" -- and
|
|
235
|
+
// consulted the LLM anyway, defeating the "fast and free" promise
|
|
236
|
+
// of tier 1 for ~30% of critics.
|
|
237
|
+
//
|
|
238
|
+
// Sanity cap at 20 chars: a real classification label is short;
|
|
239
|
+
// anything longer is probably a verbose error message and should
|
|
240
|
+
// fall through to the LLM.
|
|
241
|
+
if (lower && lower.length > 0 && lower.length <= 20) {
|
|
242
|
+
// If a validLabels whitelist is set, the heuristic's answer must
|
|
243
|
+
// match. Otherwise fall through to LLM. This prevents the
|
|
244
|
+
// tier-1 widening bug from silently accepting wrong categories.
|
|
245
|
+
const inValidSet = !options.validLabels || options.validLabels.includes(lower);
|
|
246
|
+
if (inValidSet) {
|
|
247
|
+
// tierPolicy === "fallback-only" reduces confidence to 0.5 to
|
|
248
|
+
// signal the heuristic is known-fragile; downstream code can
|
|
249
|
+
// treat this as "trust but verify".
|
|
250
|
+
const confidence = options.tierPolicy === "fallback-only" ? 0.5 : 0.7;
|
|
251
|
+
const latency = Date.now() - start;
|
|
252
|
+
log.debug(`[text-classifier] TIER 1 (heuristic): "${lower}" ${latency}ms`);
|
|
253
|
+
if (options.label)
|
|
254
|
+
recordCriticCall(options.label, "heuristic", latency);
|
|
255
|
+
return {
|
|
256
|
+
label: lower,
|
|
257
|
+
confidence,
|
|
258
|
+
raw: heuristicLabel,
|
|
259
|
+
tier: "heuristic",
|
|
260
|
+
latencyMs: latency,
|
|
261
|
+
};
|
|
262
|
+
}
|
|
263
|
+
log.debug(`[text-classifier] TIER 1 heuristic "${lower}" not in validLabels, falling to TIER 2`);
|
|
264
|
+
}
|
|
265
|
+
// Heuristic was ambiguous - fall through to LLM
|
|
266
|
+
log.debug("[text-classifier] Heuristic ambiguous, falling to TIER 2");
|
|
267
|
+
}
|
|
268
|
+
else if (options?.tierPolicy === "always-llm") {
|
|
269
|
+
log.debug("[text-classifier] TIER 1 skipped (tierPolicy=always-llm)");
|
|
270
|
+
}
|
|
271
|
+
// ── Cache check: between Tier 1 (heuristic) and Tier 2 (LLM) ─────────────
|
|
272
|
+
// Skip the cache for tierPolicy=always-llm (the caller explicitly wants
|
|
273
|
+
// an LLM call, not a cached or heuristic result). Also skip when no
|
|
274
|
+
// label is provided (we have nothing to record the cache hit against
|
|
275
|
+
// and the caller doesn't care about analytics).
|
|
276
|
+
if (options?.label && options?.tierPolicy !== "always-llm") {
|
|
277
|
+
const cacheKey = getCacheKey(options.label, criteria.systemPrompt, userMessage);
|
|
278
|
+
const cached = getCachedResult(cacheKey);
|
|
279
|
+
if (cached) {
|
|
280
|
+
const latency = Date.now() - start;
|
|
281
|
+
log.debug(`[text-classifier] CACHE HIT for "${options.label}" ${latency}ms (was ${cached.tier})`);
|
|
282
|
+
// Record as "cache" tier with the cached usage (0 tokens since the
|
|
283
|
+
// result was from cache, not an LLM call) so analytics can
|
|
284
|
+
// distinguish cache hits from heuristic wins.
|
|
285
|
+
recordCriticCall(options.label, "cache", latency, {
|
|
286
|
+
input: 0,
|
|
287
|
+
output: 0,
|
|
288
|
+
});
|
|
289
|
+
return {
|
|
290
|
+
label: cached.label,
|
|
291
|
+
confidence: cached.confidence,
|
|
292
|
+
raw: cached.raw,
|
|
293
|
+
tier: "cache",
|
|
294
|
+
latencyMs: latency,
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
// ── LLM Tier loop: strategy-driven ordering ─────────────────────────────
|
|
299
|
+
// Build the ordered list of model tiers based on modelPreference strategy.
|
|
300
|
+
// Each tier is tried in sequence; the first success wins.
|
|
301
|
+
const tierOrder = buildTierOrder(options?.modelPreference ?? "balanced", ctx);
|
|
302
|
+
const failureReasons = [];
|
|
303
|
+
for (const [tierIndex, tier] of tierOrder.entries()) {
|
|
304
|
+
const tierNum = tierIndex + 2; // LLM tiers start at 2 (tier 1 = heuristic)
|
|
305
|
+
const result = await tryModelCall(ctx, tier.model, criteria.systemPrompt, userMessage, maxTokens, timeoutMs, 0, // maxRetries: 0 - classify calls should fail fast, not retry
|
|
306
|
+
options?.validLabels);
|
|
307
|
+
if (result && result.ok) {
|
|
308
|
+
const latency = Date.now() - start;
|
|
309
|
+
log.debug(`[text-classifier] TIER ${tierNum} (${tier.name} -> ${tier.model.id}): "${result.label}" ${latency}ms`);
|
|
310
|
+
if (options?.label)
|
|
311
|
+
recordCriticCall(options.label, tier.name, latency, result.usage);
|
|
312
|
+
// Cache the result for future identical calls within TTL
|
|
313
|
+
if (options?.label) {
|
|
314
|
+
setCachedResult(getCacheKey(options.label, criteria.systemPrompt, userMessage), {
|
|
315
|
+
label: result.label,
|
|
316
|
+
confidence: tier.confidence,
|
|
317
|
+
raw: result.raw,
|
|
318
|
+
tier: tier.name,
|
|
319
|
+
latencyMs: latency,
|
|
320
|
+
});
|
|
321
|
+
}
|
|
322
|
+
return {
|
|
323
|
+
label: result.label,
|
|
324
|
+
confidence: tier.confidence,
|
|
325
|
+
raw: result.raw,
|
|
326
|
+
tier: tier.name,
|
|
327
|
+
latencyMs: latency,
|
|
328
|
+
};
|
|
329
|
+
}
|
|
330
|
+
const reason = result && !result.ok ? result.reason : "unknown failure";
|
|
331
|
+
failureReasons.push(`TIER ${tierNum} (${tier.name} '${tier.model.id}'): ${reason}`);
|
|
332
|
+
logTierFailure(`TIER ${tierNum} failed (${tier.name} model '${tier.model.id}'): ${reason}.`);
|
|
333
|
+
}
|
|
334
|
+
const latency = Date.now() - start;
|
|
335
|
+
const allFailedMsg = `ALL TIERS FAILED - returning "unknown" ${latency}ms. ` + failureReasons.join(" ");
|
|
336
|
+
logTierFailure(allFailedMsg);
|
|
337
|
+
if (options?.label)
|
|
338
|
+
recordCriticCall(options.label, "failed", latency);
|
|
339
|
+
return { label: "unknown", confidence: 0, raw: "", tier: "failed", latencyMs: latency };
|
|
340
|
+
}
|
|
341
|
+
// ── Internals ────────────────────────────────────────────────────────────────
|
|
342
|
+
/**
|
|
343
|
+
* Normalize a model response to a valid label.
|
|
344
|
+
*
|
|
345
|
+
* - If `validLabels` is provided, accept any label in that set
|
|
346
|
+
* (case-insensitive exact match). This is the multi-class path used by
|
|
347
|
+
* critics like `trajectoryPattern` that return hyphenated pattern names
|
|
348
|
+
* like "Read-Edit-Bash" instead of yes/no.
|
|
349
|
+
* - Otherwise fall back to binary yes/no (the default for ~30 critics).
|
|
350
|
+
*
|
|
351
|
+
* Returns null if the response doesn't match. The classifier then falls
|
|
352
|
+
* through to the next tier, rather than silently defaulting to "no" which
|
|
353
|
+
* would mask the underlying prompt/model issue.
|
|
354
|
+
*
|
|
355
|
+
* Exported for testing.
|
|
356
|
+
*/
|
|
357
|
+
export function normalizeLabel(raw, validLabels) {
|
|
358
|
+
const trimmed = raw.trim();
|
|
359
|
+
// Empty or whitespace-only response: the model returned nothing.
|
|
360
|
+
// Some smaller models (mistral-small, Venice-routed) do this when
|
|
361
|
+
// uncertain or when the prompt format confuses them. We treat this
|
|
362
|
+
// as unparseable (return null) so the classifier falls through to
|
|
363
|
+
// the next tier, rather than silently defaulting to "no" which
|
|
364
|
+
// would mask the underlying prompt/model issue.
|
|
365
|
+
if (trimmed.length === 0)
|
|
366
|
+
return null;
|
|
367
|
+
const lower = trimmed.toLowerCase();
|
|
368
|
+
// Multi-class path: any label in the whitelist is accepted verbatim.
|
|
369
|
+
// We compare case-insensitively because some models (mistral-small
|
|
370
|
+
// in particular) return "read-edit-bash" instead of "Read-Edit-Bash".
|
|
371
|
+
if (validLabels && validLabels.length > 0) {
|
|
372
|
+
const validSet = new Set(validLabels.map((l) => l.toLowerCase()));
|
|
373
|
+
if (validSet.has(lower))
|
|
374
|
+
return lower;
|
|
375
|
+
// Don't return null yet - fall through to the yes/no check below
|
|
376
|
+
// in case the critic's validLabels is a small whitelist and the
|
|
377
|
+
// model produced a "yes"/"no" answer (e.g. when uncertain about
|
|
378
|
+
// which pattern fits). This is a defensive fallback.
|
|
379
|
+
}
|
|
380
|
+
// Binary yes/no path (default for the majority of critics).
|
|
381
|
+
if (/^yes\b/.test(lower) || lower === "yes")
|
|
382
|
+
return "yes";
|
|
383
|
+
if (/^no\b/.test(lower) || lower === "no")
|
|
384
|
+
return "no";
|
|
385
|
+
return null;
|
|
386
|
+
}
|
|
387
|
+
/**
|
|
388
|
+
* Budget for the one-shot retry after a model exhausts its output budget
|
|
389
|
+
* without emitting text. Thinking spurts of ~3.3k tokens were observed for
|
|
390
|
+
* deepseek-v4-1-flash on a hard classification prompt; 8k leaves headroom
|
|
391
|
+
* while still bounding the worst-case burn of a single retry.
|
|
392
|
+
*/
|
|
393
|
+
const RETRY_BUDGET_TOKENS = 8_192;
|
|
394
|
+
/**
|
|
395
|
+
* Attempt a single classification model call, plus a one-shot
|
|
396
|
+
* enlarged-budget retry when the model exhausted its budget on reasoning.
|
|
397
|
+
*
|
|
398
|
+
* Retry rationale: `reasoning: "off"` is advisory. Providers that do not
|
|
399
|
+
* honor it (venice-routed deepseek-v4-1-flash defaults to thinking when no
|
|
400
|
+
* explicit effort is sent) let the thinking channel count against the
|
|
401
|
+
* output budget; if it consumes the whole budget the response is
|
|
402
|
+
* stopReason=length with no text at all. That is recoverable by giving the
|
|
403
|
+
* model room to finish. Exactly one retry, only on that signature and only
|
|
404
|
+
* on the default-budget path: an explicit maxTokens is the caller's hard
|
|
405
|
+
* cap, and a non-empty unparseable answer is a prompt-format problem a
|
|
406
|
+
* larger budget will not fix.
|
|
407
|
+
*
|
|
408
|
+
* Returns the full trimmed lowercase response on success, null on any failure.
|
|
409
|
+
* The caller should use normalizeLabel() to parse the result.
|
|
410
|
+
*
|
|
411
|
+
* Signal handling:
|
|
412
|
+
* Threads `ctx.signal` (when present) through to callLlm. Without this,
|
|
413
|
+
* pressing ESC during the user's main turn only aborts the turn's LLM
|
|
414
|
+
* call - braid's parallel classify() / consolidation / sop-extractor
|
|
415
|
+
* calls keep running until their own internal timeouts fire, producing
|
|
416
|
+
* misleading "Request was aborted" error logs long after the user
|
|
417
|
+
* already moved.
|
|
418
|
+
*
|
|
419
|
+
* ctx.signal is defined when the agent is streaming OR when its session
|
|
420
|
+
* signal is still active. For post-loop best-effort callers (e.g.
|
|
421
|
+
* detectPatternWithLLM from agent_end), ctx.signal is typically undefined
|
|
422
|
+
* because the agent is idle - in that case the internal timeout is the
|
|
423
|
+
* only abort path. That's the right behavior: post-loop work shouldn't
|
|
424
|
+
* abort when the agent goes idle.
|
|
425
|
+
*/
|
|
426
|
+
async function tryModelCall(ctx, model, systemPrompt, userMessage, maxTokens, timeoutMs, maxRetries = 0, validLabels) {
|
|
427
|
+
const first = await attemptModelCall(ctx, model, systemPrompt, userMessage, maxTokens, timeoutMs, maxRetries, validLabels);
|
|
428
|
+
if (!first || first.ok || !first.budgetExhausted)
|
|
429
|
+
return first;
|
|
430
|
+
// An explicit budget is the caller's hard cap - never exceed it. The
|
|
431
|
+
// retry exists for the default path, where callLlm sizes a budget
|
|
432
|
+
// (1000-4000) without knowing the model thinks past it.
|
|
433
|
+
if (maxTokens !== undefined)
|
|
434
|
+
return first;
|
|
435
|
+
const retryMaxTokens = Math.min(RETRY_BUDGET_TOKENS,
|
|
436
|
+
// Never exceed the model's own output ceiling - a budget above it is a
|
|
437
|
+
// client-side error, not a bigger answer.
|
|
438
|
+
model.maxTokens ?? Number.POSITIVE_INFINITY);
|
|
439
|
+
log.debug(`[text-classifier] ${model.id} exhausted its output budget with no text; ` +
|
|
440
|
+
`retrying once with maxTokens=${retryMaxTokens}`);
|
|
441
|
+
const retry = await attemptModelCall(ctx, model, systemPrompt, userMessage, retryMaxTokens, timeoutMs, maxRetries, validLabels);
|
|
442
|
+
// Prefer the retry's outcome either way: on success it carries the label,
|
|
443
|
+
// on failure its reason contains the enlarged-budget diagnostic.
|
|
444
|
+
return retry ?? first;
|
|
445
|
+
}
|
|
446
|
+
/**
|
|
447
|
+
* A single model call. Returns the parsed label on success, a failure
|
|
448
|
+
* reason otherwise. `budgetExhausted` marks the stopReason=length + empty
|
|
449
|
+
* response signature that tryModelCall retries with an enlarged budget.
|
|
450
|
+
*/
|
|
451
|
+
async function attemptModelCall(ctx, model, systemPrompt, userMessage, maxTokens, timeoutMs, maxRetries = 0, validLabels) {
|
|
452
|
+
try {
|
|
453
|
+
const apiKey = await ctx.modelRegistry.getApiKeyForProvider(model.provider);
|
|
454
|
+
if (!apiKey)
|
|
455
|
+
return { ok: false, reason: `no API key for provider ${model.provider}` };
|
|
456
|
+
const result = await callLlm(model, apiKey, systemPrompt, userMessage, {
|
|
457
|
+
// maxTokens is conditionally included so undefined defaults
|
|
458
|
+
// (let the provider / pi-ai decide) take effect. Passing
|
|
459
|
+
// `undefined` explicitly would be a no-op in TypeScript but
|
|
460
|
+
// the spread pattern is clearer at the call site.
|
|
461
|
+
...(maxTokens !== undefined ? { maxTokens } : {}),
|
|
462
|
+
temperature: 0,
|
|
463
|
+
// Disable reasoning for yes/no classification.
|
|
464
|
+
// Many modern models (mistral-small, minimax-m3, ...) have
|
|
465
|
+
// `reasoning: true` by default. Thinking tokens count
|
|
466
|
+
// against max_tokens, so even a generous budget can burn
|
|
467
|
+
// entirely on thinking and produce 0 output tokens - the
|
|
468
|
+
// 'unparseable label: ""' symptom. pi-ai's clampThinkingLevel
|
|
469
|
+
// accepts "off" and gracefully maps it:
|
|
470
|
+
// - Models with "off" in their thinkingLevelMap: thinking
|
|
471
|
+
// disabled entirely (most efficient)
|
|
472
|
+
// - Models without "off" support: clamped to the lowest
|
|
473
|
+
// available level (e.g. "minimal")
|
|
474
|
+
// For classification, "off" is the right choice - yes/no
|
|
475
|
+
// is mechanical, no thinking needed.
|
|
476
|
+
reasoning: "off",
|
|
477
|
+
timeoutMs,
|
|
478
|
+
maxRetries,
|
|
479
|
+
// Thread the session signal so ESC + session-shutdown aborts
|
|
480
|
+
// braid's parallel LLM calls cleanly instead of letting them
|
|
481
|
+
// run until the internal timeout fires. ctx.signal is undefined
|
|
482
|
+
// when the agent is idle (e.g. detectPatternWithLLM from agent_end),
|
|
483
|
+
// so the spread skips cleanly and only the timeout-based abort
|
|
484
|
+
// path remains.
|
|
485
|
+
...(ctx.signal ? { signal: ctx.signal } : {}),
|
|
486
|
+
});
|
|
487
|
+
if ("error" in result) {
|
|
488
|
+
// Surface the actual error to the caller's log so the operator
|
|
489
|
+
// can diagnose why the classifier is failing. The classify()
|
|
490
|
+
// function threads this into the TIER 2/3 failed warn so the
|
|
491
|
+
// user sees the actual underlying error in the TUI without
|
|
492
|
+
// having to dig into /logs.
|
|
493
|
+
log.debug(`[text-classifier] ${model.id} callLlm error: ${result.error}`);
|
|
494
|
+
return { ok: false, reason: result.error };
|
|
495
|
+
}
|
|
496
|
+
const raw = result.text.trim();
|
|
497
|
+
const label = normalizeLabel(raw, validLabels);
|
|
498
|
+
if (!label) {
|
|
499
|
+
// Model responded but with unparseable text. Distinguish the
|
|
500
|
+
// "stopReason=length" case (model hit the output ceiling) from the
|
|
501
|
+
// "model returned a wrong-format answer" case. Only the former is
|
|
502
|
+
// recoverable - the caller retries it once at a larger budget; the
|
|
503
|
+
// latter is a prompt-format issue and benefits from a clear
|
|
504
|
+
// diagnostic in the user-facing warn.
|
|
505
|
+
const stopReason = result.stopReason;
|
|
506
|
+
// The retryable signature: the model spent its whole budget without
|
|
507
|
+
// emitting any text at all (thinking-channel burn). A non-empty
|
|
508
|
+
// answer that fails to parse is NOT retried.
|
|
509
|
+
const budgetExhausted = stopReason === "length" && raw.length === 0;
|
|
510
|
+
// When maxTokens is undefined (the new default for classifier
|
|
511
|
+
// calls), we don't show the limit - the provider decides.
|
|
512
|
+
const limitInfo = maxTokens !== undefined ? `/${maxTokens}` : "";
|
|
513
|
+
const usageInfo = result.usage
|
|
514
|
+
? `, used ${result.usage.output ?? "?"}${limitInfo} tokens`
|
|
515
|
+
: "";
|
|
516
|
+
log.debug(`[text-classifier] ${model.id} returned unparseable label: ` +
|
|
517
|
+
`${JSON.stringify(raw).slice(0, 200)} (stopReason=${stopReason ?? "?"}${usageInfo})`);
|
|
518
|
+
return {
|
|
519
|
+
ok: false,
|
|
520
|
+
reason: `unparseable label: ${JSON.stringify(raw).slice(0, 80)}` +
|
|
521
|
+
(stopReason
|
|
522
|
+
? ` (stopReason=${stopReason}` +
|
|
523
|
+
(result.usage?.output !== undefined
|
|
524
|
+
? `, used ${result.usage.output}${limitInfo} tokens`
|
|
525
|
+
: "") +
|
|
526
|
+
")"
|
|
527
|
+
: ""),
|
|
528
|
+
budgetExhausted,
|
|
529
|
+
};
|
|
530
|
+
}
|
|
531
|
+
return { ok: true, raw, label, usage: result.usage };
|
|
532
|
+
}
|
|
533
|
+
catch (e) {
|
|
534
|
+
const message = e.message;
|
|
535
|
+
log.debug(`[text-classifier] ${model.id} threw: ${message}`);
|
|
536
|
+
return { ok: false, reason: `threw: ${message}` };
|
|
537
|
+
}
|
|
538
|
+
}
|
|
539
|
+
/**
|
|
540
|
+
* Replace `{{key}}` placeholders with values from the substitutions map.
|
|
541
|
+
* Uses single-pass regex to prevent cross-key injection:
|
|
542
|
+
* if a substitution value contains `{{otherKey}}`, it won't be re-processed.
|
|
543
|
+
* Exported for testing.
|
|
544
|
+
*/
|
|
545
|
+
export function replacePlaceholders(template, substitutions) {
|
|
546
|
+
return template.replace(/\{\{(\w+)\}\}/g, (_, key) => substitutions[key] ?? `{{${key}}}`);
|
|
547
|
+
}
|
|
548
|
+
//# sourceMappingURL=text-classifier.js.map
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated hints pipeline.
|
|
3
|
+
*
|
|
4
|
+
* Loads hints from the consolidated-hints.jsonl file, filters by
|
|
5
|
+
* utility-model relevance, and delivers the relevant ones as
|
|
6
|
+
* per-hint whispers. All work is best-effort: any failure is swallowed
|
|
7
|
+
* because hints are supplemental and should never block the main prompt.
|
|
8
|
+
*
|
|
9
|
+
* Delivery model: WHISPER. Each relevant hint is sent as a separate
|
|
10
|
+
* `hint` custom message (steer, no trigger). The agent sees them in
|
|
11
|
+
* the next turn but they do NOT live in the system prompt.
|
|
12
|
+
*
|
|
13
|
+
* Cross-project deprioritization (matches episodic memory policy in
|
|
14
|
+
* `three-memory-stores`): same-project hints are kept; cross-project
|
|
15
|
+
* hints must score >= 80 to be considered.
|
|
16
|
+
*
|
|
17
|
+
* Heuristic fallback: if the LLM tier is unavailable, a small regex-based
|
|
18
|
+
* filter rejects obviously-generic patterns. Semantic matching is left
|
|
19
|
+
* to the LLM tier - keyword-overlap scoring (Jaccard) produces too many
|
|
20
|
+
* false positives and false negatives, so it is not used.
|
|
21
|
+
*/
|
|
22
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
23
|
+
/**
|
|
24
|
+
* Deliver relevant hints as whispers (one whisper per relevant hint).
|
|
25
|
+
* Best-effort: any failure (missing file, LLM timeout, send error) is swallowed.
|
|
26
|
+
*
|
|
27
|
+
* Pass `pi`, `ctx` and the current working directory. The function:
|
|
28
|
+
* 1. Loads hints from the consolidated-hints file.
|
|
29
|
+
* 2. Filters by utility-model relevance against the current task.
|
|
30
|
+
* 3. Sends each relevant hint as a separate `hint` custom message.
|
|
31
|
+
*/
|
|
32
|
+
export declare function deliverRelevantHints(cwd: string, pi: ExtensionAPI, ctx: ExtensionContext): Promise<void>;
|
|
33
|
+
//# sourceMappingURL=hints.d.ts.map
|