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,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated Claim Critic -- single LLM call for all 3 claim-verification checks.
|
|
3
|
+
*
|
|
4
|
+
* Replaces 3+ parallel classify() calls (claimContradiction, claimSupported,
|
|
5
|
+
* claimOverconfidence) with one structured-output LLM call that returns all
|
|
6
|
+
* three verdicts as JSON. Falls back to individual classify() calls on failure.
|
|
7
|
+
*
|
|
8
|
+
* Benefits:
|
|
9
|
+
* - 3x fewer LLM calls -> ~66% latency reduction for verify_claim
|
|
10
|
+
* - Single system prompt shared across all three dimensions
|
|
11
|
+
* - Model can cross-reference (e.g., contradiction vs support)
|
|
12
|
+
* - Same return interface -- drop-in replacement for claim-verification.ts
|
|
13
|
+
*
|
|
14
|
+
* Output budget: the answer is ~40 tokens of JSON, but thinking tokens count
|
|
15
|
+
* against max_tokens on every reasoning model braid routes to, and the
|
|
16
|
+
* channel cannot be switched off for a model whose thinkingLevelMap declares
|
|
17
|
+
* no "off" level (pi-ai clamps "off" to the lowest declared level). The
|
|
18
|
+
* mechanism that answers this - first completion with no maxTokens, one
|
|
19
|
+
* enlarged-budget retry when a completion ends at its ceiling without a
|
|
20
|
+
* verdict - is shared with the other two consolidated judges and lives in
|
|
21
|
+
* lib/ai/judge-budget.ts. What stays here is the domain half: the prompt, the
|
|
22
|
+
* reader that decides what counts as a verdict, and the fall-through.
|
|
23
|
+
*
|
|
24
|
+
* A null return means the caller runs the three-call fallback path; the
|
|
25
|
+
* null is counted and announced once per process.
|
|
26
|
+
*/
|
|
27
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
28
|
+
import { type JudgeFailureReason } from "./judge-budget.js";
|
|
29
|
+
/**
|
|
30
|
+
* Why a consolidated call produced no verdict. The vocabulary is the shared
|
|
31
|
+
* one (judge-budget.ts) under this module's existing name, so the counters and
|
|
32
|
+
* the warning keep their words.
|
|
33
|
+
*/
|
|
34
|
+
export type ClaimCriticFailureReason = JudgeFailureReason;
|
|
35
|
+
export interface ClaimCriticStats {
|
|
36
|
+
/** consolidatedClaimCritique calls. */
|
|
37
|
+
invocations: number;
|
|
38
|
+
/** Calls that produced a verdict (the caller skips the three-call fallback). */
|
|
39
|
+
verdicts: number;
|
|
40
|
+
/** Calls that returned null (the caller runs the three-call fallback path). */
|
|
41
|
+
fallthroughs: number;
|
|
42
|
+
/** Terminal reason per fall-through. */
|
|
43
|
+
fallthroughReasons: Record<ClaimCriticFailureReason, number>;
|
|
44
|
+
/** Judge completions attempted (one per model tier, +1 when a retry fired). */
|
|
45
|
+
modelCalls: number;
|
|
46
|
+
/** Completions that ended at their output ceiling without a verdict. */
|
|
47
|
+
budgetExhausted: number;
|
|
48
|
+
/** Enlarged-budget retries issued. */
|
|
49
|
+
retries: number;
|
|
50
|
+
/** Retries that produced a verdict. */
|
|
51
|
+
retryRecoveries: number;
|
|
52
|
+
}
|
|
53
|
+
/** Snapshot of this critic's call outcomes since the module was loaded. */
|
|
54
|
+
export declare function getConsolidatedClaimStats(): ClaimCriticStats;
|
|
55
|
+
/** @internal Test helper: clear the counters and the warning latch. */
|
|
56
|
+
export declare function __resetConsolidatedClaimStatsForTest(): void;
|
|
57
|
+
export interface ConsolidatedClaimVerdict {
|
|
58
|
+
/** true = claim directly contradicts context */
|
|
59
|
+
contradiction: boolean;
|
|
60
|
+
/** true = claim is supported by context */
|
|
61
|
+
supported: boolean;
|
|
62
|
+
/** true = claim contains overconfident language */
|
|
63
|
+
overconfidence: boolean;
|
|
64
|
+
}
|
|
65
|
+
export interface ConsolidatedClaimResult {
|
|
66
|
+
contradiction: boolean;
|
|
67
|
+
supported: boolean;
|
|
68
|
+
overconfidence: boolean;
|
|
69
|
+
classifierDown: boolean;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Consolidated claim critique -- single LLM call for all 3 dimensions.
|
|
73
|
+
*
|
|
74
|
+
* Model tier strategy (modelPreference: "quality"):
|
|
75
|
+
* 1. Try session model (cheap, may already be powerful)
|
|
76
|
+
* 2. If session fails, try utility model
|
|
77
|
+
* 3. If all fail, return null so caller falls through to individual calls
|
|
78
|
+
*
|
|
79
|
+
* Each tier gets at most two completions: its call, plus one enlarged-budget
|
|
80
|
+
* retry when that call ended at its output ceiling. The walk itself is bounded
|
|
81
|
+
* by the tier list, so the worst case is four completions, not a retry loop.
|
|
82
|
+
*/
|
|
83
|
+
export declare function consolidatedClaimCritique(claim: string, context: string, ctx: ExtensionContext): Promise<ConsolidatedClaimResult | null>;
|
|
84
|
+
//# sourceMappingURL=consolidated-claim-critic.d.ts.map
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated Claim Critic -- single LLM call for all 3 claim-verification checks.
|
|
3
|
+
*
|
|
4
|
+
* Replaces 3+ parallel classify() calls (claimContradiction, claimSupported,
|
|
5
|
+
* claimOverconfidence) with one structured-output LLM call that returns all
|
|
6
|
+
* three verdicts as JSON. Falls back to individual classify() calls on failure.
|
|
7
|
+
*
|
|
8
|
+
* Benefits:
|
|
9
|
+
* - 3x fewer LLM calls -> ~66% latency reduction for verify_claim
|
|
10
|
+
* - Single system prompt shared across all three dimensions
|
|
11
|
+
* - Model can cross-reference (e.g., contradiction vs support)
|
|
12
|
+
* - Same return interface -- drop-in replacement for claim-verification.ts
|
|
13
|
+
*
|
|
14
|
+
* Output budget: the answer is ~40 tokens of JSON, but thinking tokens count
|
|
15
|
+
* against max_tokens on every reasoning model braid routes to, and the
|
|
16
|
+
* channel cannot be switched off for a model whose thinkingLevelMap declares
|
|
17
|
+
* no "off" level (pi-ai clamps "off" to the lowest declared level). The
|
|
18
|
+
* mechanism that answers this - first completion with no maxTokens, one
|
|
19
|
+
* enlarged-budget retry when a completion ends at its ceiling without a
|
|
20
|
+
* verdict - is shared with the other two consolidated judges and lives in
|
|
21
|
+
* lib/ai/judge-budget.ts. What stays here is the domain half: the prompt, the
|
|
22
|
+
* reader that decides what counts as a verdict, and the fall-through.
|
|
23
|
+
*
|
|
24
|
+
* A null return means the caller runs the three-call fallback path; the
|
|
25
|
+
* null is counted and announced once per process.
|
|
26
|
+
*/
|
|
27
|
+
import { extractJson } from "../utils/extract-json.js";
|
|
28
|
+
import { createLogger } from "../core/logger.js";
|
|
29
|
+
import { recordCriticCall } from "./critic-stats.js";
|
|
30
|
+
import { judgeAcrossTiers, } from "./judge-budget.js";
|
|
31
|
+
const log = createLogger("consolidated-claim-critic");
|
|
32
|
+
function emptyStats() {
|
|
33
|
+
return {
|
|
34
|
+
invocations: 0,
|
|
35
|
+
verdicts: 0,
|
|
36
|
+
fallthroughs: 0,
|
|
37
|
+
fallthroughReasons: {
|
|
38
|
+
"budget-exhausted": 0,
|
|
39
|
+
"unparseable": 0,
|
|
40
|
+
"invalid-fields": 0,
|
|
41
|
+
"call-error": 0,
|
|
42
|
+
},
|
|
43
|
+
modelCalls: 0,
|
|
44
|
+
budgetExhausted: 0,
|
|
45
|
+
retries: 0,
|
|
46
|
+
retryRecoveries: 0,
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Counters and the once-per-process warning latch, in one `const` holder (no
|
|
51
|
+
* module-level `let`). Both are process-scoped in the same sense as
|
|
52
|
+
* llm-call.ts's reportedUnusableModels: they live until the module is
|
|
53
|
+
* re-evaluated, which /reload does.
|
|
54
|
+
*/
|
|
55
|
+
const state = { stats: emptyStats(), fallthroughWarned: false };
|
|
56
|
+
/** Snapshot of this critic's call outcomes since the module was loaded. */
|
|
57
|
+
export function getConsolidatedClaimStats() {
|
|
58
|
+
return { ...state.stats, fallthroughReasons: { ...state.stats.fallthroughReasons } };
|
|
59
|
+
}
|
|
60
|
+
/** @internal Test helper: clear the counters and the warning latch. */
|
|
61
|
+
export function __resetConsolidatedClaimStatsForTest() {
|
|
62
|
+
state.stats = emptyStats();
|
|
63
|
+
state.fallthroughWarned = false;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Announce the fall-through exactly once per process, naming what went wrong.
|
|
67
|
+
* Later fall-throughs stay silent in the log but keep counting; the per-reason
|
|
68
|
+
* totals - and the rate - are readable through getConsolidatedClaimStats().
|
|
69
|
+
*/
|
|
70
|
+
function warnFallthroughOnce(reason, detail) {
|
|
71
|
+
if (state.fallthroughWarned)
|
|
72
|
+
return;
|
|
73
|
+
state.fallthroughWarned = true;
|
|
74
|
+
const next = reason === "budget-exhausted"
|
|
75
|
+
? "The model's output budget is being consumed before it can answer, even " +
|
|
76
|
+
"after the enlarged-budget retry: raise the budget for this call or " +
|
|
77
|
+
"lower the prompt's thinking burden."
|
|
78
|
+
: "The judge's answer is not in the shape this critic reads.";
|
|
79
|
+
log.warn(`[consolidated-claim] no verdict (${reason}: ${detail}); the caller falls ` +
|
|
80
|
+
`through to its three individual classify() calls. ${next} Further ` +
|
|
81
|
+
`fall-throughs are counted silently - see getConsolidatedClaimStats().`);
|
|
82
|
+
}
|
|
83
|
+
// ── Consolidated Prompt ──────────────────────────────────────────────────────
|
|
84
|
+
const SYSTEM_PROMPT = "You are a claim verification analyzer. You do one thing: " +
|
|
85
|
+
"read a claim and context inside XML tags, and rate the claim on three " +
|
|
86
|
+
"binary dimensions. Respond with a valid JSON object containing exactly " +
|
|
87
|
+
"these three fields. No explanation, no markdown, no other text.";
|
|
88
|
+
const USER_PROMPT = "Analyze the claim against the context. Respond with valid JSON only:\n" +
|
|
89
|
+
"{\n" +
|
|
90
|
+
' "contradiction": true|false, // Does the claim directly contradict the context? ' +
|
|
91
|
+
"(true = yes, they conflict)\n" +
|
|
92
|
+
' "supported": true|false, // Is the claim supported by the context? ' +
|
|
93
|
+
"(true = yes, context backs it up)\n" +
|
|
94
|
+
' "overconfidence": true|false // Does the claim contain unwarranted certainty ' +
|
|
95
|
+
'("always", "never", "guaranteed", "definitely", etc.)?\n' +
|
|
96
|
+
"}\n\n" +
|
|
97
|
+
"<claim>\n{{claim}}\n</claim>\n\n" +
|
|
98
|
+
"<context>\n{{context}}\n</context>";
|
|
99
|
+
// ── Main Function ────────────────────────────────────────────────────────────
|
|
100
|
+
/**
|
|
101
|
+
* Consolidated claim critique -- single LLM call for all 3 dimensions.
|
|
102
|
+
*
|
|
103
|
+
* Model tier strategy (modelPreference: "quality"):
|
|
104
|
+
* 1. Try session model (cheap, may already be powerful)
|
|
105
|
+
* 2. If session fails, try utility model
|
|
106
|
+
* 3. If all fail, return null so caller falls through to individual calls
|
|
107
|
+
*
|
|
108
|
+
* Each tier gets at most two completions: its call, plus one enlarged-budget
|
|
109
|
+
* retry when that call ended at its output ceiling. The walk itself is bounded
|
|
110
|
+
* by the tier list, so the worst case is four completions, not a retry loop.
|
|
111
|
+
*/
|
|
112
|
+
export async function consolidatedClaimCritique(claim, context, ctx) {
|
|
113
|
+
const truncatedClaim = claim.length > 2000 ? claim.slice(0, 2000) + "..." : claim;
|
|
114
|
+
const truncatedContext = context.length > 3000 ? context.slice(0, 3000) + "..." : context;
|
|
115
|
+
const start = Date.now();
|
|
116
|
+
state.stats.invocations++;
|
|
117
|
+
// ── Attempt consolidated LLM call ──────────────────────────────────────
|
|
118
|
+
const outcome = await tryConsolidatedCall(truncatedClaim, truncatedContext, ctx);
|
|
119
|
+
const latency = Date.now() - start;
|
|
120
|
+
if (outcome.ok) {
|
|
121
|
+
state.stats.verdicts++;
|
|
122
|
+
recordCriticCall("consolidated-claim", "utility", latency);
|
|
123
|
+
log.debug(`[consolidated-claim] OK ${latency}ms: ${JSON.stringify(outcome.verdict)}`);
|
|
124
|
+
return {
|
|
125
|
+
contradiction: outcome.verdict.contradiction,
|
|
126
|
+
supported: outcome.verdict.supported,
|
|
127
|
+
overconfidence: outcome.verdict.overconfidence,
|
|
128
|
+
classifierDown: false,
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
// ── Fallback: return null so caller falls through to individual calls ──
|
|
132
|
+
state.stats.fallthroughs++;
|
|
133
|
+
state.stats.fallthroughReasons[outcome.reason]++;
|
|
134
|
+
recordCriticCall("consolidated-claim", "failed", latency);
|
|
135
|
+
log.debug(`[consolidated-claim] no verdict (${outcome.reason}), returning null for fallback`);
|
|
136
|
+
warnFallthroughOnce(outcome.reason, outcome.detail);
|
|
137
|
+
return null;
|
|
138
|
+
}
|
|
139
|
+
// ── Internal Helpers ─────────────────────────────────────────────────────────
|
|
140
|
+
/**
|
|
141
|
+
* The consolidated judge, across the model tiers, on the shared output-budget
|
|
142
|
+
* contract (lib/ai/judge-budget.ts): session model first, then utility, each
|
|
143
|
+
* with at most one enlarged-budget retry.
|
|
144
|
+
*/
|
|
145
|
+
async function tryConsolidatedCall(claim, context, ctx) {
|
|
146
|
+
const userMessage = USER_PROMPT.replace("{{claim}}", claim).replace("{{context}}", context);
|
|
147
|
+
return judgeAcrossTiers({
|
|
148
|
+
ctx,
|
|
149
|
+
systemPrompt: SYSTEM_PROMPT,
|
|
150
|
+
userMessage,
|
|
151
|
+
read: readClaimVerdict,
|
|
152
|
+
label: "consolidated-claim",
|
|
153
|
+
counters: state.stats,
|
|
154
|
+
});
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Read one completion as a claim verdict. The mapping from "what the model
|
|
158
|
+
* said" to "why there is no verdict" is this judge's business; the retry
|
|
159
|
+
* decision above it is not.
|
|
160
|
+
*/
|
|
161
|
+
function readClaimVerdict(view) {
|
|
162
|
+
const jsonStr = extractJson(view.text);
|
|
163
|
+
if (!jsonStr) {
|
|
164
|
+
log.debug(`[consolidated-claim] No JSON found in response from ${view.model.id} ${view.elapsedMs}ms: ${view.text.slice(0, 100)}`);
|
|
165
|
+
return {
|
|
166
|
+
ok: false,
|
|
167
|
+
reason: view.atCeiling ? "budget-exhausted" : "unparseable",
|
|
168
|
+
detail: `${view.text.length} chars of response, no JSON`,
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
let parsed;
|
|
172
|
+
try {
|
|
173
|
+
parsed = JSON.parse(jsonStr);
|
|
174
|
+
}
|
|
175
|
+
catch {
|
|
176
|
+
log.debug(`[consolidated-claim] Unparseable JSON from ${view.model.id}: ${jsonStr.slice(0, 100)}`);
|
|
177
|
+
return {
|
|
178
|
+
ok: false,
|
|
179
|
+
reason: view.atCeiling ? "budget-exhausted" : "unparseable",
|
|
180
|
+
detail: `enclosed object is not parseable JSON`,
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
if (typeof parsed.contradiction === "boolean" &&
|
|
184
|
+
typeof parsed.supported === "boolean" &&
|
|
185
|
+
typeof parsed.overconfidence === "boolean") {
|
|
186
|
+
return { ok: true, verdict: parsed };
|
|
187
|
+
}
|
|
188
|
+
log.debug(`[consolidated-claim] Invalid fields from ${view.model.id}: ${jsonStr}`);
|
|
189
|
+
return { ok: false, reason: "invalid-fields", detail: `JSON without the three boolean fields` };
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=consolidated-claim-critic.js.map
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cost Report - aggregate token-usage stats into USD cost estimates.
|
|
3
|
+
*
|
|
4
|
+
* The critic-stats pipeline logs token counts; the heartbeat analytics
|
|
5
|
+
* formatting path (extensions/heartbeat/analytics/format.ts) consumes this
|
|
6
|
+
* module in production. Given a `CriticStats` snapshot and a
|
|
7
|
+
* `CriticPricing` rate table, it computes a structured `CriticCostReport`
|
|
8
|
+
* that breaks down spend per critic, per tier, and per direction (input
|
|
9
|
+
* vs. output). Cache-hit savings are estimated using the average LLM-tier
|
|
10
|
+
* cost per call.
|
|
11
|
+
*
|
|
12
|
+
* Foundational cost-analysis layer for tier-2 LLM call budgeting; enables
|
|
13
|
+
* drift-classifier cache sizing to choose a TTL from actual spend.
|
|
14
|
+
*
|
|
15
|
+
* Defaults are rough Sonnet-tier averages ($3/M input, $15/M output).
|
|
16
|
+
* Override `CriticPricing` per-model when the LLM mix differs (e.g.,
|
|
17
|
+
* GPT-4o, Haiku). The defaults err on the conservative side; users tuning
|
|
18
|
+
* for cost should pass a tighter `inputPer1kUsd` for utility-tier calls.
|
|
19
|
+
*/
|
|
20
|
+
import type { CriticStats, CriticTier } from "./critic-stats.js";
|
|
21
|
+
export interface CriticPricing {
|
|
22
|
+
/** USD per 1K input tokens (across all LLM tiers). */
|
|
23
|
+
inputPer1kUsd: number;
|
|
24
|
+
/** USD per 1K output tokens (across all LLM tiers). */
|
|
25
|
+
outputPer1kUsd: number;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Sonnet-class defaults (~$3/M input, ~$15/M output).
|
|
29
|
+
* Override for cheaper or more expensive models.
|
|
30
|
+
*/
|
|
31
|
+
export declare const DEFAULT_PRICING: CriticPricing;
|
|
32
|
+
export interface CriticTierCost {
|
|
33
|
+
count: number;
|
|
34
|
+
inputTokens: number;
|
|
35
|
+
outputTokens: number;
|
|
36
|
+
costUsd: number;
|
|
37
|
+
}
|
|
38
|
+
export interface CriticCostBreakdown {
|
|
39
|
+
/** Cost per tier within this critic (heuristic/utility/session/failed/cache). */
|
|
40
|
+
byTier: Partial<Record<CriticTier, CriticTierCost>>;
|
|
41
|
+
/** Total USD spent on this critic across all tiers. */
|
|
42
|
+
totalCostUsd: number;
|
|
43
|
+
}
|
|
44
|
+
export interface CriticCostReport {
|
|
45
|
+
perCritic: Record<string, CriticCostBreakdown>;
|
|
46
|
+
totals: {
|
|
47
|
+
inputTokens: number;
|
|
48
|
+
outputTokens: number;
|
|
49
|
+
/** Sum of per-critic costs. */
|
|
50
|
+
costUsd: number;
|
|
51
|
+
/**
|
|
52
|
+
* Estimated savings from cache hits. Computed as
|
|
53
|
+
* `cacheCount x averageLLMCallCost`, where the average is taken
|
|
54
|
+
* over all non-cache LLM tiers in the report. This is an
|
|
55
|
+
* approximation: a cache hit avoids whatever the average LLM
|
|
56
|
+
* call would have cost, regardless of which specific critic
|
|
57
|
+
* produced the hit.
|
|
58
|
+
*/
|
|
59
|
+
cacheSavingsUsd: number;
|
|
60
|
+
/** Number of cache hits across all critics. */
|
|
61
|
+
cacheHits: number;
|
|
62
|
+
};
|
|
63
|
+
/** The pricing rates used to produce this report. */
|
|
64
|
+
pricing: CriticPricing;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Compute a cost report from critic stats. Pure function: takes a
|
|
68
|
+
* `CriticStats` snapshot (e.g., from `getCriticStats()`) and returns
|
|
69
|
+
* a fresh report object. Does not mutate `stats`.
|
|
70
|
+
*
|
|
71
|
+
* Cache savings are estimated by assuming each cache hit replaced an
|
|
72
|
+
* average-cost LLM call. The average is taken over all non-cache,
|
|
73
|
+
* non-failed, non-heuristic LLM tiers (utility + session) in the
|
|
74
|
+
* report. If no LLM tiers have fired, `cacheSavingsUsd` is 0.
|
|
75
|
+
*/
|
|
76
|
+
export declare function computeCriticCost(stats: CriticStats, pricing?: CriticPricing): CriticCostReport;
|
|
77
|
+
/**
|
|
78
|
+
* Format a `CriticCostReport` as a human-readable Markdown table.
|
|
79
|
+
* Used by the analytics extension to surface cost in `get_session_metrics`.
|
|
80
|
+
*/
|
|
81
|
+
export declare function formatCriticCostReport(report: CriticCostReport): string;
|
|
82
|
+
export { getCriticStats, resetCriticStats } from "./critic-stats.js";
|
|
83
|
+
//# sourceMappingURL=cost-report.d.ts.map
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cost Report - aggregate token-usage stats into USD cost estimates.
|
|
3
|
+
*
|
|
4
|
+
* The critic-stats pipeline logs token counts; the heartbeat analytics
|
|
5
|
+
* formatting path (extensions/heartbeat/analytics/format.ts) consumes this
|
|
6
|
+
* module in production. Given a `CriticStats` snapshot and a
|
|
7
|
+
* `CriticPricing` rate table, it computes a structured `CriticCostReport`
|
|
8
|
+
* that breaks down spend per critic, per tier, and per direction (input
|
|
9
|
+
* vs. output). Cache-hit savings are estimated using the average LLM-tier
|
|
10
|
+
* cost per call.
|
|
11
|
+
*
|
|
12
|
+
* Foundational cost-analysis layer for tier-2 LLM call budgeting; enables
|
|
13
|
+
* drift-classifier cache sizing to choose a TTL from actual spend.
|
|
14
|
+
*
|
|
15
|
+
* Defaults are rough Sonnet-tier averages ($3/M input, $15/M output).
|
|
16
|
+
* Override `CriticPricing` per-model when the LLM mix differs (e.g.,
|
|
17
|
+
* GPT-4o, Haiku). The defaults err on the conservative side; users tuning
|
|
18
|
+
* for cost should pass a tighter `inputPer1kUsd` for utility-tier calls.
|
|
19
|
+
*/
|
|
20
|
+
/**
|
|
21
|
+
* Sonnet-class defaults (~$3/M input, ~$15/M output).
|
|
22
|
+
* Override for cheaper or more expensive models.
|
|
23
|
+
*/
|
|
24
|
+
export const DEFAULT_PRICING = {
|
|
25
|
+
inputPer1kUsd: 0.003,
|
|
26
|
+
outputPer1kUsd: 0.015,
|
|
27
|
+
};
|
|
28
|
+
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
29
|
+
function tierCostUsd(inputTokens, outputTokens, pricing) {
|
|
30
|
+
// Pricing is per 1K tokens; divide by 1000 then multiply.
|
|
31
|
+
return ((inputTokens / 1000) * pricing.inputPer1kUsd + (outputTokens / 1000) * pricing.outputPer1kUsd);
|
|
32
|
+
}
|
|
33
|
+
// ── Main entry point ─────────────────────────────────────────────────────────
|
|
34
|
+
/**
|
|
35
|
+
* Compute a cost report from critic stats. Pure function: takes a
|
|
36
|
+
* `CriticStats` snapshot (e.g., from `getCriticStats()`) and returns
|
|
37
|
+
* a fresh report object. Does not mutate `stats`.
|
|
38
|
+
*
|
|
39
|
+
* Cache savings are estimated by assuming each cache hit replaced an
|
|
40
|
+
* average-cost LLM call. The average is taken over all non-cache,
|
|
41
|
+
* non-failed, non-heuristic LLM tiers (utility + session) in the
|
|
42
|
+
* report. If no LLM tiers have fired, `cacheSavingsUsd` is 0.
|
|
43
|
+
*/
|
|
44
|
+
export function computeCriticCost(stats, pricing = DEFAULT_PRICING) {
|
|
45
|
+
const perCritic = {};
|
|
46
|
+
let totalInputTokens = 0;
|
|
47
|
+
let totalOutputTokens = 0;
|
|
48
|
+
let totalCacheHits = 0;
|
|
49
|
+
let llmCallCount = 0;
|
|
50
|
+
let llmTotalCostUsd = 0;
|
|
51
|
+
// First pass: per-critic breakdown + accumulate LLM call cost for cache baseline.
|
|
52
|
+
for (const [label, byTier] of Object.entries(stats.perCritic)) {
|
|
53
|
+
const breakdown = { byTier: {}, totalCostUsd: 0 };
|
|
54
|
+
for (const [tier, entry] of Object.entries(byTier)) {
|
|
55
|
+
const cost = tierCostUsd(entry.totalInputTokens, entry.totalOutputTokens, pricing);
|
|
56
|
+
breakdown.byTier[tier] = {
|
|
57
|
+
count: entry.count,
|
|
58
|
+
inputTokens: entry.totalInputTokens,
|
|
59
|
+
outputTokens: entry.totalOutputTokens,
|
|
60
|
+
costUsd: cost,
|
|
61
|
+
};
|
|
62
|
+
breakdown.totalCostUsd += cost;
|
|
63
|
+
totalInputTokens += entry.totalInputTokens;
|
|
64
|
+
totalOutputTokens += entry.totalOutputTokens;
|
|
65
|
+
if (tier === "cache") {
|
|
66
|
+
totalCacheHits += entry.count;
|
|
67
|
+
}
|
|
68
|
+
else if (tier === "utility" || tier === "session") {
|
|
69
|
+
// LLM tiers contribute to the cache-baseline average.
|
|
70
|
+
llmCallCount += entry.count;
|
|
71
|
+
llmTotalCostUsd += cost;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
perCritic[label] = breakdown;
|
|
75
|
+
}
|
|
76
|
+
const avgLlmCostUsd = llmCallCount > 0 ? llmTotalCostUsd / llmCallCount : 0;
|
|
77
|
+
const cacheSavingsUsd = totalCacheHits * avgLlmCostUsd;
|
|
78
|
+
return {
|
|
79
|
+
perCritic,
|
|
80
|
+
totals: {
|
|
81
|
+
inputTokens: totalInputTokens,
|
|
82
|
+
outputTokens: totalOutputTokens,
|
|
83
|
+
costUsd: Object.values(perCritic).reduce((sum, b) => sum + b.totalCostUsd, 0),
|
|
84
|
+
cacheSavingsUsd,
|
|
85
|
+
cacheHits: totalCacheHits,
|
|
86
|
+
},
|
|
87
|
+
pricing,
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Format a `CriticCostReport` as a human-readable Markdown table.
|
|
92
|
+
* Used by the analytics extension to surface cost in `get_session_metrics`.
|
|
93
|
+
*/
|
|
94
|
+
export function formatCriticCostReport(report) {
|
|
95
|
+
const lines = [];
|
|
96
|
+
lines.push("## Critic Cost Report");
|
|
97
|
+
lines.push("");
|
|
98
|
+
lines.push(`Pricing: $${report.pricing.inputPer1kUsd.toFixed(4)}/1K input, $${report.pricing.outputPer1kUsd.toFixed(4)}/1K output`);
|
|
99
|
+
lines.push("");
|
|
100
|
+
lines.push("| Critic | Calls | Input | Output | Cost (USD) |");
|
|
101
|
+
lines.push("|---|---:|---:|---:|---:|");
|
|
102
|
+
const sortedCritics = Object.entries(report.perCritic).sort(([, a], [, b]) => b.totalCostUsd - a.totalCostUsd);
|
|
103
|
+
for (const [label, breakdown] of sortedCritics) {
|
|
104
|
+
const totalCount = Object.values(breakdown.byTier).reduce((s, t) => s + (t?.count ?? 0), 0);
|
|
105
|
+
const totalIn = Object.values(breakdown.byTier).reduce((s, t) => s + (t?.inputTokens ?? 0), 0);
|
|
106
|
+
const totalOut = Object.values(breakdown.byTier).reduce((s, t) => s + (t?.outputTokens ?? 0), 0);
|
|
107
|
+
lines.push(`| ${label} | ${totalCount} | ${totalIn.toLocaleString()} | ${totalOut.toLocaleString()} | $${breakdown.totalCostUsd.toFixed(4)} |`);
|
|
108
|
+
}
|
|
109
|
+
lines.push(`| **TOTAL** | | ${report.totals.inputTokens.toLocaleString()} | ${report.totals.outputTokens.toLocaleString()} | **$${report.totals.costUsd.toFixed(4)}** |`);
|
|
110
|
+
lines.push("");
|
|
111
|
+
lines.push(`Cache hits: ${report.totals.cacheHits} (estimated savings: $${report.totals.cacheSavingsUsd.toFixed(4)})`);
|
|
112
|
+
return lines.join("\n");
|
|
113
|
+
}
|
|
114
|
+
// Re-export for convenience so callers can `import { computeCriticCost, getCriticStats } from "./cost-report.js"`.
|
|
115
|
+
export { getCriticStats, resetCriticStats } from "./critic-stats.js";
|
|
116
|
+
//# sourceMappingURL=cost-report.js.map
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Critic Cache - short-window LRU cache for classify() results.
|
|
3
|
+
*
|
|
4
|
+
* ROADMAP: avoid redundant LLM calls when the same critic receives
|
|
5
|
+
* the same (systemPrompt, userPrompt) within a short window.
|
|
6
|
+
*
|
|
7
|
+
* Most useful for the topic-drift 3-call fanout where 2 of the 3 calls
|
|
8
|
+
* often receive identical inputs across consecutive turns. Also helps
|
|
9
|
+
* the consolidation-channel hint-quality critic and other LLM judges
|
|
10
|
+
* that fire every turn with the same prompt template.
|
|
11
|
+
*
|
|
12
|
+
* Design:
|
|
13
|
+
* - Bounded by LRU eviction (default 1000 entries)
|
|
14
|
+
* - Time-bounded by TTL (default 60 seconds)
|
|
15
|
+
* - Module-level, so it outlives a session in the same process: nothing calls
|
|
16
|
+
* resetCriticCache(), and TTL expiry is what bounds reuse across sessions
|
|
17
|
+
* - Cache key is fnv-1a hash of (label, systemPrompt, userPrompt) -
|
|
18
|
+
* fast, well-distributed, no crypto overhead
|
|
19
|
+
*
|
|
20
|
+
* Stats:
|
|
21
|
+
* - Cache hits surface as a new "cache" tier in recordCriticCall
|
|
22
|
+
* so analytics can distinguish "fast free result" (heuristic) from
|
|
23
|
+
* "fast free result via caching" (cache).
|
|
24
|
+
*
|
|
25
|
+
* NOT thread-safe (Node.js single-threaded; module-level Map is safe
|
|
26
|
+
* within a single agent session).
|
|
27
|
+
*/
|
|
28
|
+
import type { ClassificationResult } from "./text-classifier.js";
|
|
29
|
+
/** Maximum entries before LRU eviction kicks in. */
|
|
30
|
+
export declare const CACHE_MAX_ENTRIES = 1000;
|
|
31
|
+
/** Default TTL in ms. Short enough to bound memory, long enough to dedup repeats within a session. */
|
|
32
|
+
export declare const CACHE_DEFAULT_TTL_MS = 60000;
|
|
33
|
+
/**
|
|
34
|
+
* Compute the cache key for a classify() call. The key is a hash of
|
|
35
|
+
* the label (so different critics don't share entries), the system
|
|
36
|
+
* prompt, and the post-substitution user message.
|
|
37
|
+
*
|
|
38
|
+
* Public so tests can verify the hash function is stable.
|
|
39
|
+
*/
|
|
40
|
+
export declare function getCacheKey(label: string, systemPrompt: string, userPrompt: string): string;
|
|
41
|
+
/**
|
|
42
|
+
* Look up a cached ClassificationResult. Returns null on miss or
|
|
43
|
+
* expiry. On hit, the entry is moved to the end of the LRU order
|
|
44
|
+
* (most recently used) so it doesn't get evicted.
|
|
45
|
+
*/
|
|
46
|
+
export declare function getCachedResult(key: string): ClassificationResult | null;
|
|
47
|
+
/**
|
|
48
|
+
* Store a ClassificationResult in the cache. If the cache is at
|
|
49
|
+
* capacity, the oldest entry (first in iteration order) is evicted.
|
|
50
|
+
*/
|
|
51
|
+
export declare function setCachedResult(key: string, result: ClassificationResult, ttlMs?: number): void;
|
|
52
|
+
/**
|
|
53
|
+
* Clear all cached entries. No caller today: session boundaries do not reset
|
|
54
|
+
* the cache, so TTL expiry is the only thing that retires an entry.
|
|
55
|
+
*/
|
|
56
|
+
export declare function resetCriticCache(): void;
|
|
57
|
+
//# sourceMappingURL=critic-cache.d.ts.map
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Critic Cache - short-window LRU cache for classify() results.
|
|
3
|
+
*
|
|
4
|
+
* ROADMAP: avoid redundant LLM calls when the same critic receives
|
|
5
|
+
* the same (systemPrompt, userPrompt) within a short window.
|
|
6
|
+
*
|
|
7
|
+
* Most useful for the topic-drift 3-call fanout where 2 of the 3 calls
|
|
8
|
+
* often receive identical inputs across consecutive turns. Also helps
|
|
9
|
+
* the consolidation-channel hint-quality critic and other LLM judges
|
|
10
|
+
* that fire every turn with the same prompt template.
|
|
11
|
+
*
|
|
12
|
+
* Design:
|
|
13
|
+
* - Bounded by LRU eviction (default 1000 entries)
|
|
14
|
+
* - Time-bounded by TTL (default 60 seconds)
|
|
15
|
+
* - Module-level, so it outlives a session in the same process: nothing calls
|
|
16
|
+
* resetCriticCache(), and TTL expiry is what bounds reuse across sessions
|
|
17
|
+
* - Cache key is fnv-1a hash of (label, systemPrompt, userPrompt) -
|
|
18
|
+
* fast, well-distributed, no crypto overhead
|
|
19
|
+
*
|
|
20
|
+
* Stats:
|
|
21
|
+
* - Cache hits surface as a new "cache" tier in recordCriticCall
|
|
22
|
+
* so analytics can distinguish "fast free result" (heuristic) from
|
|
23
|
+
* "fast free result via caching" (cache).
|
|
24
|
+
*
|
|
25
|
+
* NOT thread-safe (Node.js single-threaded; module-level Map is safe
|
|
26
|
+
* within a single agent session).
|
|
27
|
+
*/
|
|
28
|
+
// ── Cache store ──────────────────────────────────────────────────────────────
|
|
29
|
+
const cache = new Map();
|
|
30
|
+
/** Maximum entries before LRU eviction kicks in. */
|
|
31
|
+
export const CACHE_MAX_ENTRIES = 1000;
|
|
32
|
+
/** Default TTL in ms. Short enough to bound memory, long enough to dedup repeats within a session. */
|
|
33
|
+
export const CACHE_DEFAULT_TTL_MS = 60_000;
|
|
34
|
+
// ── Hash function ────────────────────────────────────────────────────────────
|
|
35
|
+
/**
|
|
36
|
+
* FNV-1a 32-bit hash. Fast (no crypto API), well-distributed, good
|
|
37
|
+
* enough for cache key uniqueness within a session. We accept the
|
|
38
|
+
* theoretical collision risk: a collision would cause a wrong cache
|
|
39
|
+
* hit, which is a non-fatal degradation (the agent gets an old
|
|
40
|
+
* answer, not garbage).
|
|
41
|
+
*/
|
|
42
|
+
function fnv1aHash(s) {
|
|
43
|
+
let hash = 0x811c9dc5; // FNV offset basis (32-bit)
|
|
44
|
+
for (let i = 0; i < s.length; i++) {
|
|
45
|
+
hash ^= s.charCodeAt(i);
|
|
46
|
+
hash = Math.imul(hash, 0x01000193); // FNV prime (32-bit)
|
|
47
|
+
}
|
|
48
|
+
return (hash >>> 0).toString(16).padStart(8, "0");
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Compute the cache key for a classify() call. The key is a hash of
|
|
52
|
+
* the label (so different critics don't share entries), the system
|
|
53
|
+
* prompt, and the post-substitution user message.
|
|
54
|
+
*
|
|
55
|
+
* Public so tests can verify the hash function is stable.
|
|
56
|
+
*/
|
|
57
|
+
export function getCacheKey(label, systemPrompt, userPrompt) {
|
|
58
|
+
return fnv1aHash(`${label}\0${systemPrompt}\0${userPrompt}`);
|
|
59
|
+
}
|
|
60
|
+
// ── API ──────────────────────────────────────────────────────────────────────
|
|
61
|
+
/**
|
|
62
|
+
* Look up a cached ClassificationResult. Returns null on miss or
|
|
63
|
+
* expiry. On hit, the entry is moved to the end of the LRU order
|
|
64
|
+
* (most recently used) so it doesn't get evicted.
|
|
65
|
+
*/
|
|
66
|
+
export function getCachedResult(key) {
|
|
67
|
+
const entry = cache.get(key);
|
|
68
|
+
if (!entry)
|
|
69
|
+
return null;
|
|
70
|
+
if (Date.now() > entry.expiresAt) {
|
|
71
|
+
cache.delete(key);
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
// LRU: move to end. Map preserves insertion order; delete+set
|
|
75
|
+
// re-inserts at the tail.
|
|
76
|
+
cache.delete(key);
|
|
77
|
+
cache.set(key, entry);
|
|
78
|
+
return entry.result;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Store a ClassificationResult in the cache. If the cache is at
|
|
82
|
+
* capacity, the oldest entry (first in iteration order) is evicted.
|
|
83
|
+
*/
|
|
84
|
+
export function setCachedResult(key, result, ttlMs = CACHE_DEFAULT_TTL_MS) {
|
|
85
|
+
// LRU eviction: if at max, remove oldest (first key in iteration)
|
|
86
|
+
if (cache.size >= CACHE_MAX_ENTRIES) {
|
|
87
|
+
const oldestKey = cache.keys().next().value;
|
|
88
|
+
if (oldestKey !== undefined)
|
|
89
|
+
cache.delete(oldestKey);
|
|
90
|
+
}
|
|
91
|
+
cache.set(key, { result, expiresAt: Date.now() + ttlMs });
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Clear all cached entries. No caller today: session boundaries do not reset
|
|
95
|
+
* the cache, so TTL expiry is the only thing that retires an entry.
|
|
96
|
+
*/
|
|
97
|
+
export function resetCriticCache() {
|
|
98
|
+
cache.clear();
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=critic-cache.js.map
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Heuristic fallback functions for critics.
|
|
3
|
+
*
|
|
4
|
+
* Each function is a Tier 1 fallback used when the LLM is unavailable.
|
|
5
|
+
* Pure functions with no dependencies on the CRITICS object (CODE_CHARS
|
|
6
|
+
* is a sibling constant in critic-helpers.ts). A CRITICS entry wires one
|
|
7
|
+
* in as:
|
|
8
|
+
*
|
|
9
|
+
* import { topicDriftFallback } from "./critic-fallbacks.js";
|
|
10
|
+
* fallback: () => topicDriftFallback()
|
|
11
|
+
*/
|
|
12
|
+
/** Conservative: assume no drift when LLM unavailable. */
|
|
13
|
+
export declare function topicDriftFallback(): string;
|
|
14
|
+
/** Conservative fallback for tool loop detection. Returns "no" - LLM tier handles actual detection. */
|
|
15
|
+
export declare function toolLoopFallback(_toolSequences: string): string;
|
|
16
|
+
/** Conservative fallback for evidence conflict detection. Returns "no" - LLM tier handles actual detection. */
|
|
17
|
+
export declare function evidenceConflictFallback(_a: string, _b: string): string;
|
|
18
|
+
/** Conservative fallback for hint quality. Returns "yes" (allow through) - LLM tier handles filtering. */
|
|
19
|
+
export declare function hintQualityFallback(_task: string, _steps: string[]): string;
|
|
20
|
+
/**
|
|
21
|
+
* Heuristic fallback for compression urgency: the static-threshold logic
|
|
22
|
+
* from compression-strategy.ts.
|
|
23
|
+
*/
|
|
24
|
+
export declare function compressionUrgencyFallback(opts: {
|
|
25
|
+
turnsSinceCompression: number;
|
|
26
|
+
totalTurns: number;
|
|
27
|
+
consecutiveFailures: number;
|
|
28
|
+
reasoningDepth: number;
|
|
29
|
+
messageCount: number;
|
|
30
|
+
}): string;
|
|
31
|
+
/** Heuristic fallback for error type classification. */
|
|
32
|
+
export declare function errorTypeFallback(errorMsg: string): string;
|
|
33
|
+
/** Heuristic fallback for instruction strength. */
|
|
34
|
+
export declare function instructionStrengthFallback(body: string): string;
|
|
35
|
+
/** Heuristic fallback: reject very short hints and obvious generic templates. */
|
|
36
|
+
export declare function hintRelevanceFallback(hint: string, _currentTask: string): string;
|
|
37
|
+
//# sourceMappingURL=critic-fallbacks.d.ts.map
|