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,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Critic Stats - lightweight runtime observability for LLM judge calls.
|
|
3
|
+
*
|
|
4
|
+
* Tracks per-critic call counts by tier (heuristic/utility/session/failed),
|
|
5
|
+
* latency, and token usage (for cost analysis). Module-level counters
|
|
6
|
+
* are safe within a single-agent session; call `resetCriticStats()` on
|
|
7
|
+
* session boundaries.
|
|
8
|
+
*
|
|
9
|
+
* Integrates with heartbeat/analytics to surface in `get_session_metrics`.
|
|
10
|
+
*/
|
|
11
|
+
export type CriticTier = "heuristic" | "utility" | "session" | "failed" | "cache" | "gate";
|
|
12
|
+
export interface CriticCallEntry {
|
|
13
|
+
tier: CriticTier;
|
|
14
|
+
/** Total calls to this critic resolved at this tier. */
|
|
15
|
+
count: number;
|
|
16
|
+
/** Total latency across all calls (ms) - for average calculation. */
|
|
17
|
+
totalLatencyMs: number;
|
|
18
|
+
/**
|
|
19
|
+
* Total input tokens across all LLM-tier calls. Heuristic and
|
|
20
|
+
* failed tiers do not consume tokens (heuristic is local; failed means
|
|
21
|
+
* we never got a successful LLM response). Use this + totalOutputTokens
|
|
22
|
+
* to compute cost = (input * $in/1k) + (output * $out/1k) at report time.
|
|
23
|
+
*/
|
|
24
|
+
totalInputTokens: number;
|
|
25
|
+
/**
|
|
26
|
+
* Total output tokens across all LLM-tier calls. See
|
|
27
|
+
* `totalInputTokens` for cost formula.
|
|
28
|
+
*/
|
|
29
|
+
totalOutputTokens: number;
|
|
30
|
+
}
|
|
31
|
+
export interface CriticStats {
|
|
32
|
+
/** Per-critic stats, keyed by critic label. */
|
|
33
|
+
perCritic: Record<string, Record<CriticTier, CriticCallEntry>>;
|
|
34
|
+
/** Aggregate across all critics. */
|
|
35
|
+
totals: Record<CriticTier, number>;
|
|
36
|
+
/**
|
|
37
|
+
* Aggregate input tokens across all LLM-tier calls. Heuristic and
|
|
38
|
+
* failed tiers contribute 0.
|
|
39
|
+
*/
|
|
40
|
+
totalsInputTokens: number;
|
|
41
|
+
/** Aggregate output tokens across all LLM-tier calls. */
|
|
42
|
+
totalsOutputTokens: number;
|
|
43
|
+
/** Labels in insertion order. */
|
|
44
|
+
criticLabels: string[];
|
|
45
|
+
/** Total critic calls tracked. */
|
|
46
|
+
totalCalls: number;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Optional token usage passed by callers that have access to the
|
|
50
|
+
* LLM result. `input` and `output` are provider-reported token counts
|
|
51
|
+
* (typically from `result.usage` on the LLM response). Both are optional
|
|
52
|
+
* because some providers omit them, and the heuristic/failed paths never
|
|
53
|
+
* have a successful LLM response.
|
|
54
|
+
*/
|
|
55
|
+
export interface CriticUsage {
|
|
56
|
+
input?: number;
|
|
57
|
+
output?: number;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Record a single critic classification result.
|
|
61
|
+
*
|
|
62
|
+
* @param label - Human-readable critic label (e.g. "Topic Coverage")
|
|
63
|
+
* @param tier - Which tier produced the result
|
|
64
|
+
* @param latencyMs - Duration of the classification call
|
|
65
|
+
* @param usage - Optional LLM token usage (input/output). Heuristic
|
|
66
|
+
* and failed tiers should omit this; LLM tiers should pass the usage
|
|
67
|
+
* from the LLM response.
|
|
68
|
+
*/
|
|
69
|
+
export declare function recordCriticCall(label: string, tier: CriticTier, latencyMs: number, usage?: CriticUsage): void;
|
|
70
|
+
/**
|
|
71
|
+
* Return aggregated critic stats since last reset.
|
|
72
|
+
*/
|
|
73
|
+
export declare function getCriticStats(): CriticStats;
|
|
74
|
+
/**
|
|
75
|
+
* Reset all counters. Call on session boundaries (`session_start` handler).
|
|
76
|
+
*/
|
|
77
|
+
export declare function resetCriticStats(): void;
|
|
78
|
+
//# sourceMappingURL=critic-stats.d.ts.map
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Critic Stats - lightweight runtime observability for LLM judge calls.
|
|
3
|
+
*
|
|
4
|
+
* Tracks per-critic call counts by tier (heuristic/utility/session/failed),
|
|
5
|
+
* latency, and token usage (for cost analysis). Module-level counters
|
|
6
|
+
* are safe within a single-agent session; call `resetCriticStats()` on
|
|
7
|
+
* session boundaries.
|
|
8
|
+
*
|
|
9
|
+
* Integrates with heartbeat/analytics to surface in `get_session_metrics`.
|
|
10
|
+
*/
|
|
11
|
+
// ── Module-level counter store ───────────────────────────────────────────────
|
|
12
|
+
const perCritic = new Map();
|
|
13
|
+
// ── API ──────────────────────────────────────────────────────────────────────
|
|
14
|
+
/**
|
|
15
|
+
* Record a single critic classification result.
|
|
16
|
+
*
|
|
17
|
+
* @param label - Human-readable critic label (e.g. "Topic Coverage")
|
|
18
|
+
* @param tier - Which tier produced the result
|
|
19
|
+
* @param latencyMs - Duration of the classification call
|
|
20
|
+
* @param usage - Optional LLM token usage (input/output). Heuristic
|
|
21
|
+
* and failed tiers should omit this; LLM tiers should pass the usage
|
|
22
|
+
* from the LLM response.
|
|
23
|
+
*/
|
|
24
|
+
export function recordCriticCall(label, tier, latencyMs, usage) {
|
|
25
|
+
let byTier = perCritic.get(label);
|
|
26
|
+
if (!byTier) {
|
|
27
|
+
byTier = new Map();
|
|
28
|
+
perCritic.set(label, byTier);
|
|
29
|
+
}
|
|
30
|
+
let entry = byTier.get(tier);
|
|
31
|
+
if (!entry) {
|
|
32
|
+
entry = {
|
|
33
|
+
tier,
|
|
34
|
+
count: 0,
|
|
35
|
+
totalLatencyMs: 0,
|
|
36
|
+
totalInputTokens: 0,
|
|
37
|
+
totalOutputTokens: 0,
|
|
38
|
+
};
|
|
39
|
+
byTier.set(tier, entry);
|
|
40
|
+
}
|
|
41
|
+
entry.count++;
|
|
42
|
+
entry.totalLatencyMs += latencyMs;
|
|
43
|
+
entry.totalInputTokens += usage?.input ?? 0;
|
|
44
|
+
entry.totalOutputTokens += usage?.output ?? 0;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Return aggregated critic stats since last reset.
|
|
48
|
+
*/
|
|
49
|
+
export function getCriticStats() {
|
|
50
|
+
const perCriticOut = {};
|
|
51
|
+
const totals = {
|
|
52
|
+
heuristic: 0,
|
|
53
|
+
utility: 0,
|
|
54
|
+
session: 0,
|
|
55
|
+
failed: 0,
|
|
56
|
+
cache: 0,
|
|
57
|
+
gate: 0,
|
|
58
|
+
};
|
|
59
|
+
let totalsInputTokens = 0;
|
|
60
|
+
let totalsOutputTokens = 0;
|
|
61
|
+
const criticLabels = [];
|
|
62
|
+
let totalCalls = 0;
|
|
63
|
+
for (const [label, byTier] of perCritic) {
|
|
64
|
+
const tierMap = {};
|
|
65
|
+
for (const [tier, entry] of byTier) {
|
|
66
|
+
tierMap[tier] = entry;
|
|
67
|
+
totals[tier] += entry.count;
|
|
68
|
+
totalsInputTokens += entry.totalInputTokens;
|
|
69
|
+
totalsOutputTokens += entry.totalOutputTokens;
|
|
70
|
+
totalCalls += entry.count;
|
|
71
|
+
}
|
|
72
|
+
perCriticOut[label] = tierMap;
|
|
73
|
+
criticLabels.push(label);
|
|
74
|
+
}
|
|
75
|
+
return {
|
|
76
|
+
perCritic: perCriticOut,
|
|
77
|
+
totals,
|
|
78
|
+
totalsInputTokens,
|
|
79
|
+
totalsOutputTokens,
|
|
80
|
+
criticLabels,
|
|
81
|
+
totalCalls,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Reset all counters. Call on session boundaries (`session_start` handler).
|
|
86
|
+
*/
|
|
87
|
+
export function resetCriticStats() {
|
|
88
|
+
perCritic.clear();
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=critic-stats.js.map
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Judge Budget - one implementation of the output-budget contract every
|
|
3
|
+
* consolidated judge shares.
|
|
4
|
+
*
|
|
5
|
+
* A consolidated judge asks the model for a few booleans as JSON. Thinking
|
|
6
|
+
* tokens count against max_tokens on every reasoning model braid routes to,
|
|
7
|
+
* and the channel cannot be switched off for a model whose pi-ai
|
|
8
|
+
* thinkingLevelMap declares no "off" level (clampThinkingLevel then maps "off"
|
|
9
|
+
* up to the lowest level the model does declare). So a small explicit ceiling
|
|
10
|
+
* is a ceiling on thinking, and the JSON body never gets written: the
|
|
11
|
+
* completion stops at its own ceiling with nothing to parse.
|
|
12
|
+
*
|
|
13
|
+
* The invariant, in one place:
|
|
14
|
+
*
|
|
15
|
+
* The first completion is issued with no maxTokens, so callLlm sizes a budget
|
|
16
|
+
* from the prompt (1000-4000) - the path judges that are not
|
|
17
|
+
* length-stop-prone already take. A completion that ends at its own output
|
|
18
|
+
* ceiling without yielding a verdict gets exactly one retry at
|
|
19
|
+
* min(ENLARGED_BUDGET_TOKENS, model.maxTokens).
|
|
20
|
+
*
|
|
21
|
+
* 8_192 is the budget lib/ai/text-classifier.ts settled on for the same failure
|
|
22
|
+
* signature; the clamp to the model's own ceiling is there because a budget
|
|
23
|
+
* above it is a client-side error, not a bigger answer. The retry is bounded by
|
|
24
|
+
* construction: one per model, and the walk is bounded by its tier list (session,
|
|
25
|
+
* utility), so the worst case is four completions per invocation.
|
|
26
|
+
*
|
|
27
|
+
* What this module deliberately does not know: what a verdict looks like, and
|
|
28
|
+
* what a fall-through means. Each judge supplies its own reader (extractJson,
|
|
29
|
+
* field validation, its own debug lines) and maps the returned outcome to its
|
|
30
|
+
* own fall-through - null, heuristics, conservative defaults, or a counted
|
|
31
|
+
* warning.
|
|
32
|
+
*
|
|
33
|
+
* No module-level mutable state: the mechanism counters live in the caller's
|
|
34
|
+
* own stats holder, passed in as a sink.
|
|
35
|
+
*/
|
|
36
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
37
|
+
import type { Api, Model } from "@earendil-works/pi-ai";
|
|
38
|
+
/**
|
|
39
|
+
* Budget for the one-shot retry after a completion ends at its output ceiling
|
|
40
|
+
* without yielding a verdict. Sizing rationale in the file header.
|
|
41
|
+
*/
|
|
42
|
+
export declare const ENLARGED_BUDGET_TOKENS = 8192;
|
|
43
|
+
/** Why a judge completion produced no verdict. */
|
|
44
|
+
export type JudgeFailureReason =
|
|
45
|
+
/** Ended at the output ceiling with nothing parseable, retry included. */
|
|
46
|
+
"budget-exhausted"
|
|
47
|
+
/** Answered, but no JSON object was found in the response. */
|
|
48
|
+
| "unparseable"
|
|
49
|
+
/** Answered with JSON, but not the fields this judge needs. */
|
|
50
|
+
| "invalid-fields"
|
|
51
|
+
/** No API key, transport error, or a thrown call. */
|
|
52
|
+
| "call-error";
|
|
53
|
+
/** One judge attempt: a verdict, or the reason there is none. */
|
|
54
|
+
export type JudgeOutcome<T> = {
|
|
55
|
+
ok: true;
|
|
56
|
+
verdict: T;
|
|
57
|
+
atCeiling: boolean;
|
|
58
|
+
} | {
|
|
59
|
+
ok: false;
|
|
60
|
+
reason: JudgeFailureReason;
|
|
61
|
+
detail: string;
|
|
62
|
+
atCeiling: boolean;
|
|
63
|
+
};
|
|
64
|
+
/**
|
|
65
|
+
* The mechanism counters, for a caller that keeps a stats surface. A judge's
|
|
66
|
+
* own stats object satisfies this structurally: the extra fields (invocations,
|
|
67
|
+
* verdicts, fall-throughs) are the caller's business, these four are the
|
|
68
|
+
* mechanism's.
|
|
69
|
+
*/
|
|
70
|
+
export interface JudgeBudgetCounters {
|
|
71
|
+
/** Completions attempted (one per call, +1 when a retry fires). */
|
|
72
|
+
modelCalls: number;
|
|
73
|
+
/** Completions that ended at their output ceiling without a verdict. */
|
|
74
|
+
budgetExhausted: number;
|
|
75
|
+
/** Enlarged-budget retries issued. */
|
|
76
|
+
retries: number;
|
|
77
|
+
/** Retries that produced a verdict. */
|
|
78
|
+
retryRecoveries: number;
|
|
79
|
+
}
|
|
80
|
+
/** One completion as the judge's reader sees it. */
|
|
81
|
+
export interface JudgeCompletionView {
|
|
82
|
+
/** The completion's text, trimmed. */
|
|
83
|
+
text: string;
|
|
84
|
+
/** The model ended at its own output ceiling (stopReason "length"). */
|
|
85
|
+
atCeiling: boolean;
|
|
86
|
+
/** The model that produced it. */
|
|
87
|
+
model: Model<Api>;
|
|
88
|
+
/** Milliseconds since the tier walk started. */
|
|
89
|
+
elapsedMs: number;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* The judge's reading of one completion: a verdict, or why there is none.
|
|
93
|
+
* `atCeiling` is handed to the reader so it can label the failure honestly
|
|
94
|
+
* ("budget-exhausted" when the completion was cut off and nothing was
|
|
95
|
+
* parseable, "unparseable"/"invalid-fields" when the answer itself was wrong).
|
|
96
|
+
*/
|
|
97
|
+
export type JudgeReading<T> = {
|
|
98
|
+
ok: true;
|
|
99
|
+
verdict: T;
|
|
100
|
+
} | {
|
|
101
|
+
ok: false;
|
|
102
|
+
reason: JudgeFailureReason;
|
|
103
|
+
detail: string;
|
|
104
|
+
};
|
|
105
|
+
export type JudgeReader<T> = (view: JudgeCompletionView) => JudgeReading<T>;
|
|
106
|
+
/** Everything a judge supplies: its prompts, its reader, its counters. */
|
|
107
|
+
export interface JudgeArgs<T> {
|
|
108
|
+
ctx: ExtensionContext;
|
|
109
|
+
systemPrompt: string;
|
|
110
|
+
userMessage: string;
|
|
111
|
+
read: JudgeReader<T>;
|
|
112
|
+
/** Debug label, e.g. "consolidated-topic". */
|
|
113
|
+
label: string;
|
|
114
|
+
/** Where the mechanism counters accumulate; omit when the judge keeps none. */
|
|
115
|
+
counters?: JudgeBudgetCounters;
|
|
116
|
+
/** Per-completion timeout. Default 60_000 (the consolidated judges' own). */
|
|
117
|
+
timeoutMs?: number;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Walk the model tiers a consolidated judge prefers - session, then utility -
|
|
121
|
+
* each with the bounded budget retry. The last attempt's outcome is returned
|
|
122
|
+
* when every tier fails, so the caller keeps the terminal reason and its
|
|
123
|
+
* diagnostic.
|
|
124
|
+
*/
|
|
125
|
+
export declare function judgeAcrossTiers<T>(args: JudgeArgs<T>): Promise<JudgeOutcome<T>>;
|
|
126
|
+
/**
|
|
127
|
+
* The invariant: one completion, and - only when it ended at its own output
|
|
128
|
+
* ceiling without yielding a verdict - exactly one retry at an enlarged budget.
|
|
129
|
+
*/
|
|
130
|
+
export declare function judgeWithBudgetRetry<T>(args: JudgeArgs<T>, model: Model<Api>, startedAt: number): Promise<JudgeOutcome<T>>;
|
|
131
|
+
/**
|
|
132
|
+
* One judge completion.
|
|
133
|
+
*
|
|
134
|
+
* No maxTokens on the first attempt: callLlm sizes a budget from the prompt
|
|
135
|
+
* (1000-4000). The retry passes the enlarged budget explicitly.
|
|
136
|
+
*/
|
|
137
|
+
export declare function judgeCompletion<T>(args: JudgeArgs<T>, model: Model<Api>, startedAt: number, maxTokens?: number): Promise<JudgeOutcome<T>>;
|
|
138
|
+
//# sourceMappingURL=judge-budget.d.ts.map
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Judge Budget - one implementation of the output-budget contract every
|
|
3
|
+
* consolidated judge shares.
|
|
4
|
+
*
|
|
5
|
+
* A consolidated judge asks the model for a few booleans as JSON. Thinking
|
|
6
|
+
* tokens count against max_tokens on every reasoning model braid routes to,
|
|
7
|
+
* and the channel cannot be switched off for a model whose pi-ai
|
|
8
|
+
* thinkingLevelMap declares no "off" level (clampThinkingLevel then maps "off"
|
|
9
|
+
* up to the lowest level the model does declare). So a small explicit ceiling
|
|
10
|
+
* is a ceiling on thinking, and the JSON body never gets written: the
|
|
11
|
+
* completion stops at its own ceiling with nothing to parse.
|
|
12
|
+
*
|
|
13
|
+
* The invariant, in one place:
|
|
14
|
+
*
|
|
15
|
+
* The first completion is issued with no maxTokens, so callLlm sizes a budget
|
|
16
|
+
* from the prompt (1000-4000) - the path judges that are not
|
|
17
|
+
* length-stop-prone already take. A completion that ends at its own output
|
|
18
|
+
* ceiling without yielding a verdict gets exactly one retry at
|
|
19
|
+
* min(ENLARGED_BUDGET_TOKENS, model.maxTokens).
|
|
20
|
+
*
|
|
21
|
+
* 8_192 is the budget lib/ai/text-classifier.ts settled on for the same failure
|
|
22
|
+
* signature; the clamp to the model's own ceiling is there because a budget
|
|
23
|
+
* above it is a client-side error, not a bigger answer. The retry is bounded by
|
|
24
|
+
* construction: one per model, and the walk is bounded by its tier list (session,
|
|
25
|
+
* utility), so the worst case is four completions per invocation.
|
|
26
|
+
*
|
|
27
|
+
* What this module deliberately does not know: what a verdict looks like, and
|
|
28
|
+
* what a fall-through means. Each judge supplies its own reader (extractJson,
|
|
29
|
+
* field validation, its own debug lines) and maps the returned outcome to its
|
|
30
|
+
* own fall-through - null, heuristics, conservative defaults, or a counted
|
|
31
|
+
* warning.
|
|
32
|
+
*
|
|
33
|
+
* No module-level mutable state: the mechanism counters live in the caller's
|
|
34
|
+
* own stats holder, passed in as a sink.
|
|
35
|
+
*/
|
|
36
|
+
import { callLlm } from "./llm-call.js";
|
|
37
|
+
import { resolveUtilityModel } from "./model-resolver.js";
|
|
38
|
+
import { createLogger } from "../core/logger.js";
|
|
39
|
+
const log = createLogger("judge-budget");
|
|
40
|
+
// ── Output budget ────────────────────────────────────────────────────────────
|
|
41
|
+
/**
|
|
42
|
+
* Budget for the one-shot retry after a completion ends at its output ceiling
|
|
43
|
+
* without yielding a verdict. Sizing rationale in the file header.
|
|
44
|
+
*/
|
|
45
|
+
export const ENLARGED_BUDGET_TOKENS = 8_192;
|
|
46
|
+
// ── The walk ─────────────────────────────────────────────────────────────────
|
|
47
|
+
/**
|
|
48
|
+
* Walk the model tiers a consolidated judge prefers - session, then utility -
|
|
49
|
+
* each with the bounded budget retry. The last attempt's outcome is returned
|
|
50
|
+
* when every tier fails, so the caller keeps the terminal reason and its
|
|
51
|
+
* diagnostic.
|
|
52
|
+
*/
|
|
53
|
+
export async function judgeAcrossTiers(args) {
|
|
54
|
+
const startedAt = Date.now();
|
|
55
|
+
let last = {
|
|
56
|
+
ok: false,
|
|
57
|
+
reason: "call-error",
|
|
58
|
+
detail: "no model was available to try",
|
|
59
|
+
atCeiling: false,
|
|
60
|
+
};
|
|
61
|
+
const tiers = [args.ctx.model, resolveUtilityModel(args.ctx)];
|
|
62
|
+
for (const model of tiers) {
|
|
63
|
+
if (!model)
|
|
64
|
+
continue;
|
|
65
|
+
last = await judgeWithBudgetRetry(args, model, startedAt);
|
|
66
|
+
if (last.ok)
|
|
67
|
+
return last;
|
|
68
|
+
}
|
|
69
|
+
return last;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* The invariant: one completion, and - only when it ended at its own output
|
|
73
|
+
* ceiling without yielding a verdict - exactly one retry at an enlarged budget.
|
|
74
|
+
*/
|
|
75
|
+
export async function judgeWithBudgetRetry(args, model, startedAt) {
|
|
76
|
+
const first = await judgeCompletion(args, model, startedAt);
|
|
77
|
+
if (first.ok || !first.atCeiling)
|
|
78
|
+
return first;
|
|
79
|
+
// The completion was cut off by its own output ceiling. Since thinking
|
|
80
|
+
// tokens count against max_tokens and the channel cannot be disabled for
|
|
81
|
+
// every model braid routes to, the repair is room to finish: exactly one
|
|
82
|
+
// retry, at an enlarged budget, and only for this signature.
|
|
83
|
+
const retryMaxTokens = Math.min(ENLARGED_BUDGET_TOKENS, model.maxTokens ?? Number.POSITIVE_INFINITY);
|
|
84
|
+
if (args.counters)
|
|
85
|
+
args.counters.retries++;
|
|
86
|
+
log.debug(`[${args.label}] ${model.id} ${first.detail}; ` +
|
|
87
|
+
`retrying once with maxTokens=${retryMaxTokens}`);
|
|
88
|
+
const retry = await judgeCompletion(args, model, startedAt, retryMaxTokens);
|
|
89
|
+
if (retry.ok) {
|
|
90
|
+
if (args.counters)
|
|
91
|
+
args.counters.retryRecoveries++;
|
|
92
|
+
return retry;
|
|
93
|
+
}
|
|
94
|
+
// Prefer the retry's reason either way: its diagnostic names the budget.
|
|
95
|
+
return { ...retry, detail: `${retry.detail} (after retry at ${retryMaxTokens})` };
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* One judge completion.
|
|
99
|
+
*
|
|
100
|
+
* No maxTokens on the first attempt: callLlm sizes a budget from the prompt
|
|
101
|
+
* (1000-4000). The retry passes the enlarged budget explicitly.
|
|
102
|
+
*/
|
|
103
|
+
export async function judgeCompletion(args, model, startedAt, maxTokens) {
|
|
104
|
+
let atCeiling = false;
|
|
105
|
+
const failed = (reason, detail) => {
|
|
106
|
+
if (atCeiling && args.counters)
|
|
107
|
+
args.counters.budgetExhausted++;
|
|
108
|
+
return { ok: false, reason, detail, atCeiling };
|
|
109
|
+
};
|
|
110
|
+
try {
|
|
111
|
+
const apiKey = await args.ctx.modelRegistry.getApiKeyForProvider(model.provider);
|
|
112
|
+
if (!apiKey) {
|
|
113
|
+
log.debug(`[${args.label}] No API key for ${model.provider}/${model.id}`);
|
|
114
|
+
return failed("call-error", `no API key for ${model.provider}`);
|
|
115
|
+
}
|
|
116
|
+
if (args.counters)
|
|
117
|
+
args.counters.modelCalls++;
|
|
118
|
+
const result = await callLlm(model, apiKey, args.systemPrompt, args.userMessage, {
|
|
119
|
+
...(maxTokens !== undefined ? { maxTokens } : {}),
|
|
120
|
+
timeoutMs: args.timeoutMs ?? 60_000,
|
|
121
|
+
...(args.ctx.signal ? { signal: args.ctx.signal } : {}),
|
|
122
|
+
});
|
|
123
|
+
if ("error" in result) {
|
|
124
|
+
log.debug(`[${args.label}] Model ${model.id} error: ${result.error}`);
|
|
125
|
+
return failed("call-error", result.error);
|
|
126
|
+
}
|
|
127
|
+
const text = result.text.trim();
|
|
128
|
+
// "length" is the model spending its whole output budget. Whether it left
|
|
129
|
+
// partial text or none, the answer was cut off, and that is the one
|
|
130
|
+
// failure a larger budget can fix.
|
|
131
|
+
atCeiling = result.stopReason === "length";
|
|
132
|
+
const reading = args.read({ text, atCeiling, model, elapsedMs: Date.now() - startedAt });
|
|
133
|
+
if (!reading.ok)
|
|
134
|
+
return failed(reading.reason, reading.detail);
|
|
135
|
+
return { ok: true, verdict: reading.verdict, atCeiling };
|
|
136
|
+
}
|
|
137
|
+
catch (err) {
|
|
138
|
+
const elapsed = Date.now() - startedAt;
|
|
139
|
+
log.debug(`[${args.label}] Model ${model.id} failed ${elapsed}ms: ${err}`);
|
|
140
|
+
return failed("call-error", `threw: ${err}`);
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=judge-budget.js.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Language hint module - tracks detected language for reply instructions.
|
|
3
|
+
*
|
|
4
|
+
* Session-scoped via ExtensionContext. All stateful functions take ctx.
|
|
5
|
+
*
|
|
6
|
+
* Flow:
|
|
7
|
+
* 1. Enforcement's input handler detects the language of a new user message
|
|
8
|
+
* (extensions/enforcement/handlers/register-input-handler.ts) -> setLanguage.
|
|
9
|
+
* 2. getReplyInstruction(ctx) renders the reply-language instruction for a
|
|
10
|
+
* system prompt. Nothing calls it today, so detection is recorded but no
|
|
11
|
+
* reply-language section reaches the prompt.
|
|
12
|
+
*/
|
|
13
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
14
|
+
export declare function setLanguage(ctx: ExtensionContext, code: string, name: string): void;
|
|
15
|
+
export declare function getReplyInstruction(ctx: ExtensionContext): string;
|
|
16
|
+
/** Script-based language detection for short/unknown texts */
|
|
17
|
+
export declare function detectLanguage(text: string): {
|
|
18
|
+
code: string;
|
|
19
|
+
name: string;
|
|
20
|
+
};
|
|
21
|
+
//# sourceMappingURL=language-hint.d.ts.map
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Language hint module - tracks detected language for reply instructions.
|
|
3
|
+
*
|
|
4
|
+
* Session-scoped via ExtensionContext. All stateful functions take ctx.
|
|
5
|
+
*
|
|
6
|
+
* Flow:
|
|
7
|
+
* 1. Enforcement's input handler detects the language of a new user message
|
|
8
|
+
* (extensions/enforcement/handlers/register-input-handler.ts) -> setLanguage.
|
|
9
|
+
* 2. getReplyInstruction(ctx) renders the reply-language instruction for a
|
|
10
|
+
* system prompt. Nothing calls it today, so detection is recorded but no
|
|
11
|
+
* reply-language section reaches the prompt.
|
|
12
|
+
*/
|
|
13
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
14
|
+
function getState(ctx) {
|
|
15
|
+
return getExtensionState(ctx, "language-hint", () => ({
|
|
16
|
+
currentLanguage: "English",
|
|
17
|
+
currentLanguageCode: "EN",
|
|
18
|
+
}));
|
|
19
|
+
}
|
|
20
|
+
// ── Stateful API (session-scoped) ─────────────────────────────────────────────
|
|
21
|
+
export function setLanguage(ctx, code, name) {
|
|
22
|
+
getState(ctx).currentLanguage = name;
|
|
23
|
+
getState(ctx).currentLanguageCode = code;
|
|
24
|
+
}
|
|
25
|
+
export function getReplyInstruction(ctx) {
|
|
26
|
+
const { currentLanguageCode, currentLanguage } = getState(ctx);
|
|
27
|
+
if (currentLanguageCode === "EN")
|
|
28
|
+
return "";
|
|
29
|
+
return `\n\n### Reply Language\nRespond entirely in ${currentLanguage} unless the user writes in English.`;
|
|
30
|
+
}
|
|
31
|
+
// ── Pure API (no session state) ───────────────────────────────────────────────
|
|
32
|
+
/** Script-based language detection for short/unknown texts */
|
|
33
|
+
export function detectLanguage(text) {
|
|
34
|
+
if (!text || text.trim().length === 0)
|
|
35
|
+
return { code: "EN", name: "English" };
|
|
36
|
+
// Check for Cyrillic (Russian, Ukrainian, Bulgarian, etc.)
|
|
37
|
+
if (/[\u0400-\u04FF]/.test(text))
|
|
38
|
+
return { code: "RU", name: "Russian" };
|
|
39
|
+
if (/[\u0600-\u06FF]/.test(text))
|
|
40
|
+
return { code: "AR", name: "Arabic" };
|
|
41
|
+
if (/[\u4E00-\u9FFF]/.test(text))
|
|
42
|
+
return { code: "ZH", name: "Chinese" };
|
|
43
|
+
// Check for Japanese (Hiragana + Katakana + Kanji)
|
|
44
|
+
if (/[\u3040-\u30FF\u4E00-\u9FFF]/.test(text))
|
|
45
|
+
return { code: "JA", name: "Japanese" };
|
|
46
|
+
if (/[\uAC00-\uD7AF\u1100-\u11FF]/.test(text))
|
|
47
|
+
return { code: "KO", name: "Korean" };
|
|
48
|
+
if (/[\u0900-\u097F]/.test(text))
|
|
49
|
+
return { code: "HI", name: "Hindi" };
|
|
50
|
+
if (/[\u0E00-\u0E7F]/.test(text))
|
|
51
|
+
return { code: "TH", name: "Thai" };
|
|
52
|
+
if (/[\u0590-\u05FF]/.test(text))
|
|
53
|
+
return { code: "HE", name: "Hebrew" };
|
|
54
|
+
if (/[\u0370-\u03FF]/.test(text))
|
|
55
|
+
return { code: "EL", name: "Greek" };
|
|
56
|
+
return { code: "EN", name: "English" };
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=language-hint.js.map
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [stakes-invariant]: this module and the rest of lib/ai/ must never
|
|
3
|
+
* include downstream-stakes signals in the LLM call context. The judge
|
|
4
|
+
* (whether human, LLM-as-judge, or programmatic) evaluates pure
|
|
5
|
+
* correctness; the agent being judged sees no signal about what the
|
|
6
|
+
* judgment is for, and the prompt carries no stakes-awareness block.
|
|
7
|
+
* The test-arxiv-citations.mjs and test-prompt-builder-directive.mjs
|
|
8
|
+
* suites verify the agent-side invariant.
|
|
9
|
+
*
|
|
10
|
+
* Dispatches auxiliary LLM calls through the session's model registry
|
|
11
|
+
* (ctx.modelRegistry.streamSimple, read from the published extension context)
|
|
12
|
+
* with a two-tier retry strategy:
|
|
13
|
+
*
|
|
14
|
+
* Tier 1 - Provider SDK: Handles fast transient blips (quick network drops)
|
|
15
|
+
* via the registry call's maxRetries (default: 3 SDK-level retries).
|
|
16
|
+
* Tier 2 - This module: Handles sustained rate limits with longer backoff
|
|
17
|
+
* (5s -> 15s -> 30s -> 60s) so the provider gets real cooldown time.
|
|
18
|
+
*
|
|
19
|
+
* When no context has been published, the call degrades to pi-ai's compat
|
|
20
|
+
* transport (credential only, no session id or configured headers) so an
|
|
21
|
+
* auxiliary role keeps working; one warning per process announces it. See
|
|
22
|
+
* completeAuxCall.
|
|
23
|
+
*
|
|
24
|
+
* A rate-limit circuit breaker skips calls for 60s after a 429 to avoid
|
|
25
|
+
* cascading failures during provider congestion.
|
|
26
|
+
*
|
|
27
|
+
* Usage:
|
|
28
|
+
* callLlm(model, apiKey, systemPrompt, userPrompt, options)
|
|
29
|
+
* Returns { text } on success or { error } on failure (discriminated union).
|
|
30
|
+
* const text = result.text;
|
|
31
|
+
*/
|
|
32
|
+
import type { Api, AssistantMessage, Context, Model, ModelThinkingLevel, ModelsSimpleStreamOptions } from "@earendil-works/pi-ai";
|
|
33
|
+
/** One provider-neutral completion call. */
|
|
34
|
+
type CompletionFn = (model: Model<Api>, context: Context, options: ModelsSimpleStreamOptions) => Promise<AssistantMessage>;
|
|
35
|
+
/**
|
|
36
|
+
* @internal Test-only: override the completion call for behavioral testing.
|
|
37
|
+
* Pass `null` to reset to the production implementation. NOT for use
|
|
38
|
+
* in production code paths.
|
|
39
|
+
*/
|
|
40
|
+
export declare function __setCompleteSimpleForTest(fn: CompletionFn | null): void;
|
|
41
|
+
/**
|
|
42
|
+
* @internal Test-only: clear the rate-limit circuit-breaker cooldown so
|
|
43
|
+
* behavioral tests don't inherit it from a prior rate-limited stub call
|
|
44
|
+
* (the cooldown is process-global and shared across tests in one file).
|
|
45
|
+
* NOT for production use.
|
|
46
|
+
*/
|
|
47
|
+
export declare function __resetRateLimitCooldownForTest(): void;
|
|
48
|
+
import { setLlmCallListeners, type LlmErrorListener, type LlmSuccessListener } from "../state/global-state.js";
|
|
49
|
+
export { setLlmCallListeners };
|
|
50
|
+
export type { LlmErrorListener, LlmSuccessListener };
|
|
51
|
+
export interface LlmCallOptions {
|
|
52
|
+
/** Temperature for generation. Default: 0.1 */
|
|
53
|
+
temperature?: number;
|
|
54
|
+
/** Max output tokens. Default: auto from prompt length (1000-4000) */
|
|
55
|
+
maxTokens?: number;
|
|
56
|
+
/**
|
|
57
|
+
* Reasoning effort level - the SDK's own thinking-level union, so every
|
|
58
|
+
* level pi-ai defines is nameable here: "off" through "max". Pass "off"
|
|
59
|
+
* to disable thinking entirely for short mechanical tasks (yes/no
|
|
60
|
+
* classification, polishing). Pass "high" / "xhigh" / "max" for tasks
|
|
61
|
+
* that benefit from extended thinking (e.g. the think tool's review pass).
|
|
62
|
+
*
|
|
63
|
+
* Reasoning tokens count against max_tokens for most providers, so a
|
|
64
|
+
* yes/no classifier with default reasoning enabled will burn its entire
|
|
65
|
+
* budget on thinking and produce 0 output tokens (the empty-string
|
|
66
|
+
* symptom).
|
|
67
|
+
*
|
|
68
|
+
* "off" is not part of the SDK's stream-options `ThinkingLevel` union;
|
|
69
|
+
* pi-ai's clampThinkingLevel takes it and maps it anyway:
|
|
70
|
+
* - Models with "off" in their thinkingLevelMap: thinking disabled
|
|
71
|
+
* entirely (most efficient)
|
|
72
|
+
* - Models without "off" support: clamped to the lowest available level
|
|
73
|
+
* (e.g. "minimal")
|
|
74
|
+
* The value therefore crosses the stream-options boundary through the
|
|
75
|
+
* single cast in toSimpleStreamOptions.
|
|
76
|
+
*
|
|
77
|
+
* Default: undefined (provider default).
|
|
78
|
+
*/
|
|
79
|
+
reasoning?: ModelThinkingLevel;
|
|
80
|
+
/** Per-attempt timeout in ms. Default: 600000 (10 min) */
|
|
81
|
+
timeoutMs?: number;
|
|
82
|
+
/** Outer retry attempts. Default: 5 */
|
|
83
|
+
maxRetries?: number;
|
|
84
|
+
/** Inner SDK retries per attempt. Default: 3 */
|
|
85
|
+
sdkRetries?: number;
|
|
86
|
+
/** Optional AbortSignal for cancellation */
|
|
87
|
+
signal?: AbortSignal;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Make an LLM call with two-tier retry, backoff, and rate-limit circuit breaker.
|
|
91
|
+
*
|
|
92
|
+
* Uses AbortSignal for timeout to avoid orphaned Promise.race timeouts.
|
|
93
|
+
*
|
|
94
|
+
* @param model - pi-ai Model to call
|
|
95
|
+
* @param apiKey - API key for the provider
|
|
96
|
+
* @param systemPrompt - System prompt text
|
|
97
|
+
* @param userPrompt - User message text
|
|
98
|
+
* @param options - Optional configuration
|
|
99
|
+
* @returns `{ text }` on success or `{ error }` on failure
|
|
100
|
+
*/
|
|
101
|
+
export declare function callLlm(model: Model<Api>, apiKey: string | undefined, systemPrompt: string, userPrompt: string, options?: LlmCallOptions): Promise<{
|
|
102
|
+
text: string;
|
|
103
|
+
stopReason?: string;
|
|
104
|
+
usage?: {
|
|
105
|
+
input?: number;
|
|
106
|
+
output?: number;
|
|
107
|
+
totalTokens?: number;
|
|
108
|
+
};
|
|
109
|
+
} | {
|
|
110
|
+
error: string;
|
|
111
|
+
}>;
|
|
112
|
+
/**
|
|
113
|
+
* The one yes/no question core asks the providers seam before re-using a
|
|
114
|
+
* (provider, model) pair for an auxiliary call: can this pair serve a request
|
|
115
|
+
* right now? The handler owns the answer, so core learns no route vocabulary:
|
|
116
|
+
* it asks and skips, it does not interpret.
|
|
117
|
+
*
|
|
118
|
+
* Fail-open by construction: with nothing published, no query method, or a
|
|
119
|
+
* throwing query, the answer is true, so auxiliary calls behave exactly as they
|
|
120
|
+
* did before the seam existed. A false answer is reported once.
|
|
121
|
+
*/
|
|
122
|
+
export declare function isModelRouteUsable(model: {
|
|
123
|
+
id: string;
|
|
124
|
+
provider?: string;
|
|
125
|
+
}): boolean;
|
|
126
|
+
/**
|
|
127
|
+
* Combine two AbortSignals into one. When either signal aborts, the combined signal aborts.
|
|
128
|
+
*
|
|
129
|
+
* If either parent signal is already aborted, returns just the *other* signal unmodified
|
|
130
|
+
* rather than creating an immediately-aborted controller. This prevents stale external
|
|
131
|
+
* signals (e.g. from timed-out tool executions) from instant-killing the combined signal
|
|
132
|
+
* on retry.
|
|
133
|
+
*
|
|
134
|
+
* Cleans up event listeners after the combined signal fires to prevent memory leaks
|
|
135
|
+
* across repeated calls (e.g. retry loops creating new combined signals).
|
|
136
|
+
*
|
|
137
|
+
* @internal Exported for behavioral testing (test-call-llm-behavior.mjs).
|
|
138
|
+
* Production code should not call this directly.
|
|
139
|
+
*/
|
|
140
|
+
export declare function combineSignals(s1: AbortSignal, s2: AbortSignal): AbortSignal;
|
|
141
|
+
//# sourceMappingURL=llm-call.d.ts.map
|