pi-braid 0.0.0-stage → 0.40.1
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 +266 -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 +166 -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 +502 -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,745 @@
|
|
|
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
|
+
// Degraded transport only: see completeAuxCall below. Compat resolves the
|
|
33
|
+
// credential from the model and the apiKey argument and nothing else, which is
|
|
34
|
+
// exactly the case it is reserved for (no published context, so no registry to
|
|
35
|
+
// resolve headers or the session id through).
|
|
36
|
+
import { completeSimple } from "@earendil-works/pi-ai/compat";
|
|
37
|
+
// Auxiliary calls dispatch through the session's model registry (see the
|
|
38
|
+
// completion-dispatch block below): pi-ai's compat entrypoint resolves an api
|
|
39
|
+
// key from the model and nothing else, so registry-resolved headers, configured
|
|
40
|
+
// provider headers, and the session id never reach a compat request. Compat is
|
|
41
|
+
// kept only as the degraded fallback for the no-context case. The registry is
|
|
42
|
+
// also where braid's own providers are registered (pi.registerProvider), so it
|
|
43
|
+
// is the one handle that reaches both built-in and custom providers.
|
|
44
|
+
import { createLogger } from "../core/logger.js";
|
|
45
|
+
import { isRateLimitText } from "../errors/llm-error.js";
|
|
46
|
+
import { isContextWindowErrorText } from "../errors/llm-error.js";
|
|
47
|
+
import { sanitizeLlmErrorForLog, sanitizeLlmRequestText } from "./payload-hygiene.js";
|
|
48
|
+
import { getContextEmergencyOffloadRunner, getExtensionCtxProvider, hasWarnedAuxDegradedTransport, markAuxDegradedTransportWarned, } from "../state/global-state.js";
|
|
49
|
+
const log = createLogger("llm-call");
|
|
50
|
+
/** Read the published extension context, or null when none was published. */
|
|
51
|
+
function readAuxContext() {
|
|
52
|
+
const provider = getExtensionCtxProvider();
|
|
53
|
+
if (!provider)
|
|
54
|
+
return null;
|
|
55
|
+
try {
|
|
56
|
+
return provider() ?? null;
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return null;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Session id for the request (per-conversation routing and prompt-cache
|
|
64
|
+
* affinity). Undefined when no session manager is readable, never a sentinel:
|
|
65
|
+
* an invented id would route the request to a conversation that does not
|
|
66
|
+
* exist. Which header the id becomes is the provider's own business.
|
|
67
|
+
*/
|
|
68
|
+
function resolveSessionId() {
|
|
69
|
+
try {
|
|
70
|
+
const id = readAuxContext()?.sessionManager?.getSessionId?.();
|
|
71
|
+
return typeof id === "string" && id.length > 0 ? id : undefined;
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
return undefined;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Production completion. Primary path: the session's model registry, the same
|
|
79
|
+
* path the session's own requests take, so pi-core resolves the credential,
|
|
80
|
+
* the configured and provider-declared headers, the session id (which a
|
|
81
|
+
* provider may turn into a routing header), and the transport.
|
|
82
|
+
*
|
|
83
|
+
* Degraded path: pi-ai's compat entrypoint, used only when nothing has
|
|
84
|
+
* published a context. Compat resolves the credential from the model and the
|
|
85
|
+
* apiKey argument and carries nothing else: no session id, no configured
|
|
86
|
+
* provider headers. Auxiliary calls must still complete when the publisher
|
|
87
|
+
* never ran (the publisher is the enforcement extension's session-start
|
|
88
|
+
* handler, and enforcement is disableable), but the degradation is announced
|
|
89
|
+
* once per process by warnDegradedTransportOnce so it is never mistaken for
|
|
90
|
+
* the full path.
|
|
91
|
+
*/
|
|
92
|
+
async function completeAuxCall(model, context, options) {
|
|
93
|
+
const registry = readAuxContext()?.modelRegistry;
|
|
94
|
+
if (registry) {
|
|
95
|
+
return registry.streamSimple(model, context, options).result();
|
|
96
|
+
}
|
|
97
|
+
warnDegradedTransportOnce();
|
|
98
|
+
return completeSimple(model, context, options);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Announce the degraded transport exactly once per process, naming the
|
|
102
|
+
* publisher that did not run and what the fallback does not carry. Silence
|
|
103
|
+
* after the first line keeps a degraded session from flooding the log; the
|
|
104
|
+
* latch is process-global (global-state.ts) so it survives session boundaries
|
|
105
|
+
* and module re-evaluation on /reload.
|
|
106
|
+
*/
|
|
107
|
+
function warnDegradedTransportOnce() {
|
|
108
|
+
if (hasWarnedAuxDegradedTransport())
|
|
109
|
+
return;
|
|
110
|
+
markAuxDegradedTransportWarned();
|
|
111
|
+
log.warn("No session context published for auxiliary LLM calls (the enforcement " +
|
|
112
|
+
"extension publishes it at session_start; enforcement is disableable). " +
|
|
113
|
+
"Falling back to pi-ai's compat transport: the request carries the " +
|
|
114
|
+
"model's credential only, without the session id or configured provider " +
|
|
115
|
+
"headers. Auxiliary calls are degraded until the publisher runs.");
|
|
116
|
+
}
|
|
117
|
+
// The override slot is for test injection only; production uses the registry.
|
|
118
|
+
let _completionOverride = null;
|
|
119
|
+
function _resolveCompletion() {
|
|
120
|
+
return _completionOverride ?? completeAuxCall;
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* @internal Test-only: override the completion call for behavioral testing.
|
|
124
|
+
* Pass `null` to reset to the production implementation. NOT for use
|
|
125
|
+
* in production code paths.
|
|
126
|
+
*/
|
|
127
|
+
export function __setCompleteSimpleForTest(fn) {
|
|
128
|
+
_completionOverride = fn ?? null;
|
|
129
|
+
}
|
|
130
|
+
/** Track the cooldown expiration deadline. */
|
|
131
|
+
let rateLimitCooldownUntil = 0;
|
|
132
|
+
/**
|
|
133
|
+
* @internal Test-only: clear the rate-limit circuit-breaker cooldown so
|
|
134
|
+
* behavioral tests don't inherit it from a prior rate-limited stub call
|
|
135
|
+
* (the cooldown is process-global and shared across tests in one file).
|
|
136
|
+
* NOT for production use.
|
|
137
|
+
*/
|
|
138
|
+
export function __resetRateLimitCooldownForTest() {
|
|
139
|
+
rateLimitCooldownUntil = 0;
|
|
140
|
+
}
|
|
141
|
+
// ── Constants ──────────────────────────────────────────────────────────────────
|
|
142
|
+
/** Default outer retry attempts (each may trigger SDK inner retries). */
|
|
143
|
+
const DEFAULT_MAX_RETRIES = 5;
|
|
144
|
+
/** SDK-level retries per attempt. */
|
|
145
|
+
const DEFAULT_SDK_RETRIES = 3;
|
|
146
|
+
/** Cooldown after a rate-limit hit before attempting calls again. */
|
|
147
|
+
const RATE_LIMIT_COOLDOWN_MS = 60_000;
|
|
148
|
+
/**
|
|
149
|
+
* Hard ceiling on any single retry backoff. During the network
|
|
150
|
+
* outage a retry ladder was observed live sleeping ~9.2 HOURS on one attempt
|
|
151
|
+
* ("Retrying (14/15) in 33033s") — the agent sat wedged silently with no
|
|
152
|
+
* signal that anything was wrong. Whatever the ladder computes (exponential
|
|
153
|
+
* growth, jitter, or future edits that raise the per-step base), the
|
|
154
|
+
* per-attempt backoff must stay bounded, so both retry sites clamp the
|
|
155
|
+
* computed delay to this ceiling. Attempt counts, SDK retries,
|
|
156
|
+
* circuit-breaker logic, and abort handling are intentionally untouched.
|
|
157
|
+
*/
|
|
158
|
+
const MAX_RETRY_BACKOFF_MS = 120_000;
|
|
159
|
+
// ── Per-model concurrency limiter ────────────────────────────────────────────
|
|
160
|
+
/** Max concurrent in-flight LLM calls per model. Provider-side rate
|
|
161
|
+
* limits are typically expressed as requests-per-second or concurrent-
|
|
162
|
+
* connections; serializing bursts through a small pool prevents a
|
|
163
|
+
* 4-way Promise.allSettled batch of classify() calls from triggering
|
|
164
|
+
* rate-limits. The default of 2 means at most 2 calls
|
|
165
|
+
* to a given model are in-flight at any time; the rest queue. */
|
|
166
|
+
const MAX_CONCURRENT_PER_MODEL = 2;
|
|
167
|
+
const _modelLocks = new Map();
|
|
168
|
+
// ── LLM call listeners (Layer 2 wiring) ─────────────────────────────────────
|
|
169
|
+
//
|
|
170
|
+
// The session-recovery proposal routes every LLM call outcome
|
|
171
|
+
// through SessionHealthState. To avoid forcing every call site to pass a
|
|
172
|
+
// callback, we expose a process-wide listener registration. The enforcement
|
|
173
|
+
// extension registers listeners at session_start with a closure over the
|
|
174
|
+
// current ctx; calls go to whichever listener is currently registered.
|
|
175
|
+
//
|
|
176
|
+
// Single-listener design: only one consumer is expected (the enforcement
|
|
177
|
+
// extension). Multi-session / multi-consumer scenarios are a future concern.
|
|
178
|
+
//
|
|
179
|
+
// Listener slots live in `lib/state/global-state.ts` to satisfy the
|
|
180
|
+
// no-module-level-let contract; this file uses getter/setter wrappers.
|
|
181
|
+
import { setLlmCallListeners, getLlmErrorListener, getLlmSuccessListener, getKeyRingFeedbackHandler, } from "../state/global-state.js";
|
|
182
|
+
// Re-export the setter so existing callers (enforcement extension) keep
|
|
183
|
+
// working without changes.
|
|
184
|
+
export { setLlmCallListeners };
|
|
185
|
+
async function acquireModelSlot(modelId) {
|
|
186
|
+
let lock = _modelLocks.get(modelId);
|
|
187
|
+
if (!lock) {
|
|
188
|
+
lock = { active: 0, waiters: [] };
|
|
189
|
+
_modelLocks.set(modelId, lock);
|
|
190
|
+
}
|
|
191
|
+
if (lock.active < MAX_CONCURRENT_PER_MODEL) {
|
|
192
|
+
lock.active++;
|
|
193
|
+
return;
|
|
194
|
+
}
|
|
195
|
+
return new Promise((resolve) => {
|
|
196
|
+
lock.waiters.push(() => {
|
|
197
|
+
lock.active++;
|
|
198
|
+
resolve();
|
|
199
|
+
});
|
|
200
|
+
});
|
|
201
|
+
}
|
|
202
|
+
function releaseModelSlot(modelId) {
|
|
203
|
+
const lock = _modelLocks.get(modelId);
|
|
204
|
+
if (!lock)
|
|
205
|
+
return;
|
|
206
|
+
lock.active = Math.max(0, lock.active - 1);
|
|
207
|
+
const next = lock.waiters.shift();
|
|
208
|
+
if (next)
|
|
209
|
+
next();
|
|
210
|
+
}
|
|
211
|
+
// ── Public API ─────────────────────────────────────────────────────────────────
|
|
212
|
+
/**
|
|
213
|
+
* Make an LLM call with two-tier retry, backoff, and rate-limit circuit breaker.
|
|
214
|
+
*
|
|
215
|
+
* Uses AbortSignal for timeout to avoid orphaned Promise.race timeouts.
|
|
216
|
+
*
|
|
217
|
+
* @param model - pi-ai Model to call
|
|
218
|
+
* @param apiKey - API key for the provider
|
|
219
|
+
* @param systemPrompt - System prompt text
|
|
220
|
+
* @param userPrompt - User message text
|
|
221
|
+
* @param options - Optional configuration
|
|
222
|
+
* @returns `{ text }` on success or `{ error }` on failure
|
|
223
|
+
*/
|
|
224
|
+
export async function callLlm(model, apiKey, systemPrompt, userPrompt, options = {}) {
|
|
225
|
+
// Circuit breaker: skip while a recent 429 cooldown is active ───────
|
|
226
|
+
const now = Date.now();
|
|
227
|
+
if (rateLimitCooldownUntil > 0 && now < rateLimitCooldownUntil) {
|
|
228
|
+
const remaining = rateLimitCooldownUntil - now;
|
|
229
|
+
log.debug(`Skipping LLM call - rate-limit cooldown ${remaining}ms remaining`);
|
|
230
|
+
return { error: "Rate-limit cooldown active" };
|
|
231
|
+
}
|
|
232
|
+
const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
|
|
233
|
+
const maxTokens = options.maxTokens ?? Math.min(Math.max(1000, Math.floor(userPrompt.length / 8)), 4000);
|
|
234
|
+
// 10-minute default (was 30s). Aborts should be signal-driven (ESC,
|
|
235
|
+
// session shutdown), not timeout-driven. A timeout here is a fallback
|
|
236
|
+
// for orphaned calls (caller crashed, signal never fired) -- not the
|
|
237
|
+
// normal cancellation path. Callers can still pass a tighter
|
|
238
|
+
// timeoutMs if they want a hard ceiling.
|
|
239
|
+
const timeoutMs = options.timeoutMs ?? 600_000;
|
|
240
|
+
const temperature = options.temperature ?? 0.1;
|
|
241
|
+
const sdkMaxRetries = options.sdkRetries ?? DEFAULT_SDK_RETRIES;
|
|
242
|
+
const signal = options.signal;
|
|
243
|
+
// Internal-call body hygiene: redact raw edge/WAF page dumps, asset-sized
|
|
244
|
+
// base64 runs, and the edge filter's own request trigger before they are
|
|
245
|
+
// sent — a re-sent page fragment can trigger the same edge block that
|
|
246
|
+
// produced it. No-op for normal prompts (identity).
|
|
247
|
+
const systemSafe = sanitizeLlmRequestText(systemPrompt);
|
|
248
|
+
const userSafe = sanitizeLlmRequestText(userPrompt);
|
|
249
|
+
const requestRedactions = systemSafe.redactions + userSafe.redactions;
|
|
250
|
+
if (requestRedactions > 0) {
|
|
251
|
+
log.warn(`LLM request body sanitized before send (${requestRedactions} fragment(s) rewritten; edge/WAF hygiene)`);
|
|
252
|
+
}
|
|
253
|
+
const context = {
|
|
254
|
+
systemPrompt: systemSafe.text,
|
|
255
|
+
messages: [{ role: "user", content: userSafe.text, timestamp: Date.now() }],
|
|
256
|
+
};
|
|
257
|
+
// ── per-model concurrency limiter: acquire ONCE at function entry, release in finally ──
|
|
258
|
+
// (One slot per callLlm invocation, not per retry - otherwise retries could
|
|
259
|
+
// pile up beyond MAX_CONCURRENT_PER_MODEL.)
|
|
260
|
+
await acquireModelSlot(model.id);
|
|
261
|
+
// Emergency retry bookkeeping. A context_window (413) error
|
|
262
|
+
// means the payload is too big — retrying the same payload is the quota
|
|
263
|
+
// burn this fixes. On the FIRST such error we run the published emergency
|
|
264
|
+
// offloader (deterministic size-driven shrink of the live session's largest
|
|
265
|
+
// toolResults) and retry EXACTLY ONCE with the shrunk context. Never a
|
|
266
|
+
// second emergency retry in one callLlm invocation: if the shrunk payload
|
|
267
|
+
// still 413s, the error propagates (compaction/rotation owns the next move).
|
|
268
|
+
let emergencyRetryUsed = false;
|
|
269
|
+
try {
|
|
270
|
+
for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
|
|
271
|
+
// ── circuit breaker re-check inside retry loop ──
|
|
272
|
+
if (rateLimitCooldownUntil > 0 && Date.now() < rateLimitCooldownUntil) {
|
|
273
|
+
log.warn(`Skipping retry ${attempt} - rate-limit cooldown active`);
|
|
274
|
+
return { error: "Rate-limit cooldown active" };
|
|
275
|
+
}
|
|
276
|
+
// ── ESC check: if the external signal already fired (e.g. during
|
|
277
|
+
// backoff sleep), don't attempt another call. Without this, the
|
|
278
|
+
// retry loop continues after abortable sleep resolves early, but
|
|
279
|
+
// combineSignals returns only the timeout signal (s1 already
|
|
280
|
+
// aborted -> returns s2), so the next attempt hangs until timeout.
|
|
281
|
+
if (signal?.aborted) {
|
|
282
|
+
log.debug("LLM call aborted (signal fired before retry attempt)");
|
|
283
|
+
return { error: "Request was aborted" };
|
|
284
|
+
}
|
|
285
|
+
// Use AbortSignal for timeout instead of Promise.race - avoids orphaned timer
|
|
286
|
+
const timeoutController = new AbortController();
|
|
287
|
+
const timeoutId = setTimeout(() => timeoutController.abort(new Error("LLM call timeout")), timeoutMs);
|
|
288
|
+
// Combine external signal with timeout signal
|
|
289
|
+
const combinedSignal = signal
|
|
290
|
+
? combineSignals(signal, timeoutController.signal)
|
|
291
|
+
: timeoutController.signal;
|
|
292
|
+
// Helper: clean up timeout + combined signal listeners after
|
|
293
|
+
// each attempt. Aborting timeoutController triggers combineSignals'
|
|
294
|
+
// built-in listener removal (onAbort removes itself from both
|
|
295
|
+
// parent signals). Without this, stale listeners accumulate on
|
|
296
|
+
// the external signal across retries -- a listener leak.
|
|
297
|
+
const cleanupAttempt = () => {
|
|
298
|
+
clearTimeout(timeoutId);
|
|
299
|
+
// Abort the timeout controller to trigger combineSignals cleanup.
|
|
300
|
+
// The combined controller is already abandoned (we have the result),
|
|
301
|
+
// so aborting it is harmless.
|
|
302
|
+
if (!timeoutController.signal.aborted) {
|
|
303
|
+
timeoutController.abort();
|
|
304
|
+
}
|
|
305
|
+
};
|
|
306
|
+
try {
|
|
307
|
+
// Build the options object explicitly: `reasoning` is typed as the
|
|
308
|
+
// SDK's ModelThinkingLevel (which includes "off") and crosses into
|
|
309
|
+
// the registry's streamSimple through the single cast in
|
|
310
|
+
// toSimpleStreamOptions.
|
|
311
|
+
//
|
|
312
|
+
// We always pass the reasoning value when set, including "off" -
|
|
313
|
+
// pi-ai's clampThinkingLevel takes "off" and maps it (off if the
|
|
314
|
+
// model supports it, else the lowest available level like "minimal").
|
|
315
|
+
const simpleOptions = {
|
|
316
|
+
apiKey,
|
|
317
|
+
maxTokens,
|
|
318
|
+
temperature,
|
|
319
|
+
maxRetries: sdkMaxRetries,
|
|
320
|
+
signal: combinedSignal,
|
|
321
|
+
};
|
|
322
|
+
if (options.reasoning !== undefined) {
|
|
323
|
+
simpleOptions.reasoning = options.reasoning;
|
|
324
|
+
}
|
|
325
|
+
const sessionId = resolveSessionId();
|
|
326
|
+
if (sessionId !== undefined) {
|
|
327
|
+
simpleOptions.sessionId = sessionId;
|
|
328
|
+
}
|
|
329
|
+
const result = await _resolveCompletion()(model, context, toSimpleStreamOptions(simpleOptions));
|
|
330
|
+
cleanupAttempt();
|
|
331
|
+
if (result.errorMessage) {
|
|
332
|
+
// Raw text drives classification and the key-ring feed-back below;
|
|
333
|
+
// the sanitized copy is what log lines and the caller see, so raw
|
|
334
|
+
// HTTP block pages never reach either. See payload-hygiene.ts.
|
|
335
|
+
const rawError = result.errorMessage;
|
|
336
|
+
const safeError = sanitizeLlmErrorForLog(rawError);
|
|
337
|
+
// ── emergency size-driven offload on 413 ──
|
|
338
|
+
// The error classifier says context_window → the payload is too
|
|
339
|
+
// big and shrinking it is the ONLY useful action. Run the
|
|
340
|
+
// published emergency offloader (bypasses the health-gate by
|
|
341
|
+
// construction: this path never consults SessionHealthState) and
|
|
342
|
+
// retry exactly once. Consumer without the context-manager loaded
|
|
343
|
+
// (runner or ctx provider absent) → fall through to the normal
|
|
344
|
+
// error path, lossy-safe.
|
|
345
|
+
if (!emergencyRetryUsed && isContextWindowErrorText(rawError)) {
|
|
346
|
+
emergencyRetryUsed = true;
|
|
347
|
+
const offloadResult = await runEmergencyOffloadForCall();
|
|
348
|
+
if (offloadResult > 0) {
|
|
349
|
+
log.warn(`LLM context-window error (413); emergency offload shrank the ` +
|
|
350
|
+
`context (${offloadResult} oversized toolResult(s) stubbed) — ` +
|
|
351
|
+
`retrying once with the shrunken payload`);
|
|
352
|
+
cleanupAttempt();
|
|
353
|
+
attempt--; // do not burn a retry-ladder slot on the shrink
|
|
354
|
+
continue;
|
|
355
|
+
}
|
|
356
|
+
emergencyRetryUsed = false; // nothing shrank — do not block a later retry
|
|
357
|
+
}
|
|
358
|
+
if (attempt <= maxRetries && isTransientError(rawError)) {
|
|
359
|
+
const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
|
|
360
|
+
log.warn(`LLM transient error (attempt ${attempt}/${maxRetries + 1}), ` +
|
|
361
|
+
`retrying in ${delay}ms: ${safeError}`);
|
|
362
|
+
if (isRateLimitError(rawError)) {
|
|
363
|
+
rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
|
|
364
|
+
}
|
|
365
|
+
// Pass signal so ESC during backoff aborts the retry
|
|
366
|
+
// instead of letting it fire after the delay.
|
|
367
|
+
await sleep(delay, signal);
|
|
368
|
+
continue;
|
|
369
|
+
}
|
|
370
|
+
// Non-retryable or exhausted - log and return
|
|
371
|
+
if (isRateLimitError(rawError)) {
|
|
372
|
+
rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
|
|
373
|
+
log.warn(`LLM rate-limited, giving up (cooldown ${RATE_LIMIT_COOLDOWN_MS}ms): ${safeError}`);
|
|
374
|
+
}
|
|
375
|
+
else if (
|
|
376
|
+
// Demote "Request was aborted" to debug when caused by the
|
|
377
|
+
// caller's external signal (ESC, session shutdown). These
|
|
378
|
+
// are expected cancellations, not real errors. Without
|
|
379
|
+
// this gate, the user sees an ERROR line every time they
|
|
380
|
+
// press ESC during a turn that had braid LLM calls in
|
|
381
|
+
// flight (consolidation, classify, sop-extract, etc.).
|
|
382
|
+
//
|
|
383
|
+
// The distinguishing signal is `signal.aborted` - it becomes
|
|
384
|
+
// true when EITHER the timeout fires OR the external signal
|
|
385
|
+
// fires. We can't tell them apart from `result.errorMessage`
|
|
386
|
+
// alone (pi-ai returns "Request was aborted" for both), so
|
|
387
|
+
// we check the original external signal: if it was set and
|
|
388
|
+
// is now aborted, this is a user-driven cancellation.
|
|
389
|
+
//
|
|
390
|
+
// Universal fallback: if the error message contains
|
|
391
|
+
// "abort" (any case) we also demote to debug. This covers
|
|
392
|
+
// post-loop callers (heartbeat, context-hygiene) where
|
|
393
|
+
// ctx.signal is undefined and the only abort source is
|
|
394
|
+
// the timeout itself firing under session-end load - the
|
|
395
|
+
// user didn't ask for that to be logged at ERROR.
|
|
396
|
+
signal?.aborted === true ||
|
|
397
|
+
/abort/i.test(rawError)) {
|
|
398
|
+
log.debug(`LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeError})`);
|
|
399
|
+
}
|
|
400
|
+
else {
|
|
401
|
+
log.error("LLM error:", safeError);
|
|
402
|
+
}
|
|
403
|
+
// Notify listener (Layer 2 wiring) - non-fatal if it throws.
|
|
404
|
+
try {
|
|
405
|
+
// The session-health listener classifies the RAW text — a
|
|
406
|
+
// sanitized page would lose its rate-limit/edge category.
|
|
407
|
+
getLlmErrorListener()?.(rawError);
|
|
408
|
+
}
|
|
409
|
+
catch {
|
|
410
|
+
// non-fatal
|
|
411
|
+
}
|
|
412
|
+
// Feed the failure back into the key ring that owns this model so a
|
|
413
|
+
// direct (non-message_end) 429/403 exhausts + rotates the same way
|
|
414
|
+
// handleMessageEnd does. No-op when providers hasn't
|
|
415
|
+
// published a handler or the model is foreign (lossy-safe).
|
|
416
|
+
// Same for the key ring: its WAF/rotation classifier needs the raw
|
|
417
|
+
// markup markers ("cf-ray", "<html", …) the sanitizer removes.
|
|
418
|
+
reportLlmFailureToKeyRing(model, rawError);
|
|
419
|
+
return { error: safeError };
|
|
420
|
+
}
|
|
421
|
+
// Success - extract text content
|
|
422
|
+
const textContent = result.content.filter((c) => c.type === "text");
|
|
423
|
+
const text = textContent.length > 0 ? textContent[0].text : "";
|
|
424
|
+
// Notify listener (Layer 2 wiring) - non-fatal if the listener throws.
|
|
425
|
+
try {
|
|
426
|
+
getLlmSuccessListener()?.();
|
|
427
|
+
}
|
|
428
|
+
catch {
|
|
429
|
+
// non-fatal
|
|
430
|
+
}
|
|
431
|
+
// Feed the success back so the serving key's backoff is healed.
|
|
432
|
+
reportLlmSuccessToKeyRing(model);
|
|
433
|
+
// Surface stopReason and usage so callers can diagnose empty
|
|
434
|
+
// responses (e.g. "stopReason=length" means the model hit the
|
|
435
|
+
// max_tokens ceiling, which is why the response is empty).
|
|
436
|
+
// pi-ai's Usage has fields { input, output, totalTokens, ... }
|
|
437
|
+
// (not { inputTokens, outputTokens }) - the field names below
|
|
438
|
+
// mirror the upstream type.
|
|
439
|
+
//
|
|
440
|
+
// Telemetry note (investigation): direct calls never pass
|
|
441
|
+
// through pi-core's message pipeline, so this usage is returned
|
|
442
|
+
// to the caller and has NO session-JSONL feed — all-zero usage
|
|
443
|
+
// entries in session files are error-path zero-fills from failed
|
|
444
|
+
// agent-loop requests (stopReason: "error", e.g. "Connection
|
|
445
|
+
// error."), not unparsed direct-call usage. Verified:
|
|
446
|
+
// 94/94 zero-usage entries across 22 sessions were error markers.
|
|
447
|
+
return {
|
|
448
|
+
text,
|
|
449
|
+
stopReason: result.stopReason,
|
|
450
|
+
usage: result.usage
|
|
451
|
+
? {
|
|
452
|
+
input: result.usage.input,
|
|
453
|
+
output: result.usage.output,
|
|
454
|
+
totalTokens: result.usage.totalTokens,
|
|
455
|
+
}
|
|
456
|
+
: undefined,
|
|
457
|
+
};
|
|
458
|
+
}
|
|
459
|
+
catch (err) {
|
|
460
|
+
cleanupAttempt();
|
|
461
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
462
|
+
const safeMessage = sanitizeLlmErrorForLog(message);
|
|
463
|
+
const isTimeout = message.includes("timeout") ||
|
|
464
|
+
message.includes("Timed") ||
|
|
465
|
+
(err instanceof Error && err.name === "AbortError");
|
|
466
|
+
// ── same emergency-offload exception as the
|
|
467
|
+
// result.errorMessage path above — provider SDKs that THROW on 413
|
|
468
|
+
// (instead of returning errorMessage) must get the same one-time
|
|
469
|
+
// shrink + retry, or the quota-burn loop survives in that shape.
|
|
470
|
+
if (!emergencyRetryUsed && isContextWindowErrorText(message)) {
|
|
471
|
+
emergencyRetryUsed = true;
|
|
472
|
+
const offloadResult = await runEmergencyOffloadForCall();
|
|
473
|
+
if (offloadResult > 0) {
|
|
474
|
+
log.warn(`LLM context-window error (413); emergency offload shrank the ` +
|
|
475
|
+
`context (${offloadResult} oversized toolResult(s) stubbed) — ` +
|
|
476
|
+
`retrying once with the shrunken payload`);
|
|
477
|
+
attempt--; // do not burn a retry-ladder slot on the shrink
|
|
478
|
+
continue;
|
|
479
|
+
}
|
|
480
|
+
emergencyRetryUsed = false; // nothing shrank — do not block a later retry
|
|
481
|
+
}
|
|
482
|
+
if (attempt <= maxRetries && (isTimeout || isTransientError(message))) {
|
|
483
|
+
const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
|
|
484
|
+
log.warn(`LLM error (attempt ${attempt}/${maxRetries + 1}), ` +
|
|
485
|
+
`retrying in ${delay}ms: ${safeMessage}`);
|
|
486
|
+
// Pass signal so ESC during backoff aborts the retry.
|
|
487
|
+
await sleep(delay, signal);
|
|
488
|
+
continue;
|
|
489
|
+
}
|
|
490
|
+
// Demote to debug when an external signal (ESC / session shutdown)
|
|
491
|
+
// caused the abort, OR when the message is itself an abort
|
|
492
|
+
// (covered by the universal /abort/i fallback in the
|
|
493
|
+
// result.errorMessage branch above). This matches the
|
|
494
|
+
// demotion there. Without this, the catch path still emits
|
|
495
|
+
// ERROR lines for expected cancellations and post-loop
|
|
496
|
+
// timeouts fired under session-end load.
|
|
497
|
+
if (signal?.aborted === true || /abort/i.test(message)) {
|
|
498
|
+
log.debug(`LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeMessage})`);
|
|
499
|
+
}
|
|
500
|
+
else {
|
|
501
|
+
log.error(isTimeout
|
|
502
|
+
? `LLM call timed out after ${maxRetries + 1} attempts`
|
|
503
|
+
: `LLM call failed: ${safeMessage}`);
|
|
504
|
+
}
|
|
505
|
+
// Notify listener (Layer 2 wiring) - non-fatal if it throws.
|
|
506
|
+
try {
|
|
507
|
+
getLlmErrorListener()?.(message);
|
|
508
|
+
}
|
|
509
|
+
catch {
|
|
510
|
+
// non-fatal
|
|
511
|
+
}
|
|
512
|
+
// Feed the failure back into the key ring — same seam as the
|
|
513
|
+
// result.errorMessage path above (raw text for the same reason).
|
|
514
|
+
reportLlmFailureToKeyRing(model, message);
|
|
515
|
+
return { error: safeMessage };
|
|
516
|
+
}
|
|
517
|
+
}
|
|
518
|
+
return { error: `LLM call failed after ${maxRetries + 1} attempts` };
|
|
519
|
+
}
|
|
520
|
+
finally {
|
|
521
|
+
releaseModelSlot(model.id);
|
|
522
|
+
}
|
|
523
|
+
}
|
|
524
|
+
// ── Helpers ────────────────────────────────────────────────────────────────────
|
|
525
|
+
/**
|
|
526
|
+
* Run the published emergency offloader (context-manager's
|
|
527
|
+
* context-emergency.ts) against the current session context. Lossy-safe:
|
|
528
|
+
* when the runner or ctx provider has not been published (extension not
|
|
529
|
+
* loaded), or either throws, this returns 0 — the caller then takes the
|
|
530
|
+
* normal error path. Returns the number of oversized toolResults stubbed
|
|
531
|
+
* (0 = nothing shrank — the caller must NOT retry).
|
|
532
|
+
*/
|
|
533
|
+
function runEmergencyOffloadForCall() {
|
|
534
|
+
const runner = getContextEmergencyOffloadRunner();
|
|
535
|
+
const provider = getExtensionCtxProvider();
|
|
536
|
+
if (!runner || !provider)
|
|
537
|
+
return Promise.resolve(0);
|
|
538
|
+
let ctx;
|
|
539
|
+
try {
|
|
540
|
+
ctx = provider();
|
|
541
|
+
}
|
|
542
|
+
catch {
|
|
543
|
+
return Promise.resolve(0);
|
|
544
|
+
}
|
|
545
|
+
if (!ctx)
|
|
546
|
+
return Promise.resolve(0);
|
|
547
|
+
return Promise.resolve(runner(ctx, "llm-retry")).then((r) => (r && r.offloaded > 0 ? r.offloaded : 0), () => 0);
|
|
548
|
+
}
|
|
549
|
+
/**
|
|
550
|
+
* Feed a failed callLlm back into the key ring that owns this model, so a
|
|
551
|
+
* direct (non-message_end) 429/403 exhausts + rotates instead of leaving no
|
|
552
|
+
* trace in the ring. The providers extension publishes a handler
|
|
553
|
+
* into a process-global slot at load; with no handler registered (e.g. the
|
|
554
|
+
* providers extension isn't loaded) this is a silent no-op — lossy-safe.
|
|
555
|
+
* Attribution is per-call (this model's own id/provider); the handler resolves
|
|
556
|
+
* the owning ring, so two providers' rings can never be confused.
|
|
557
|
+
*/
|
|
558
|
+
function reportLlmFailureToKeyRing(model, errText) {
|
|
559
|
+
const handler = getKeyRingFeedbackHandler();
|
|
560
|
+
if (!handler)
|
|
561
|
+
return;
|
|
562
|
+
try {
|
|
563
|
+
handler.reportFailure(model.id, model.provider, String(errText ?? ""));
|
|
564
|
+
}
|
|
565
|
+
catch {
|
|
566
|
+
// non-fatal — the ring must never break an LLM call
|
|
567
|
+
}
|
|
568
|
+
}
|
|
569
|
+
/**
|
|
570
|
+
* Feed a successful callLlm back so the serving key's backoff is healed
|
|
571
|
+
* (mirrors handleMessageEnd's success path). No-op when no handler is
|
|
572
|
+
* published, and the handler itself skips foreign models / healthy keys.
|
|
573
|
+
*/
|
|
574
|
+
function reportLlmSuccessToKeyRing(model) {
|
|
575
|
+
const handler = getKeyRingFeedbackHandler();
|
|
576
|
+
if (!handler)
|
|
577
|
+
return;
|
|
578
|
+
try {
|
|
579
|
+
handler.reportSuccess(model.id, model.provider);
|
|
580
|
+
}
|
|
581
|
+
catch {
|
|
582
|
+
// non-fatal
|
|
583
|
+
}
|
|
584
|
+
}
|
|
585
|
+
/**
|
|
586
|
+
* (provider, model) pairs whose unusable answer was already reported this
|
|
587
|
+
* process. Bounded by the route table times the model ids in play, and cleared
|
|
588
|
+
* when the module is re-evaluated (/reload), which is the sense in which the
|
|
589
|
+
* notice is once per process.
|
|
590
|
+
*/
|
|
591
|
+
const reportedUnusableModels = new Set();
|
|
592
|
+
/**
|
|
593
|
+
* The skip notice, once per (provider, model) per process, through the same
|
|
594
|
+
* log channel every other auxiliary-call diagnostic uses. Repeats are silent,
|
|
595
|
+
* so a session that keeps re-resolving an unusable model writes one line.
|
|
596
|
+
*/
|
|
597
|
+
function reportUnusableModelOnce(model) {
|
|
598
|
+
const provider = model.provider ?? "unknown";
|
|
599
|
+
const key = `${provider}/${model.id}`;
|
|
600
|
+
if (reportedUnusableModels.has(key))
|
|
601
|
+
return;
|
|
602
|
+
reportedUnusableModels.add(key);
|
|
603
|
+
log.info(`Skipping auxiliary model ${provider}/${model.id}: the provider reports it ` +
|
|
604
|
+
`unusable right now (no usable key, or a request it just rejected).`);
|
|
605
|
+
}
|
|
606
|
+
/**
|
|
607
|
+
* The one yes/no question core asks the providers seam before re-using a
|
|
608
|
+
* (provider, model) pair for an auxiliary call: can this pair serve a request
|
|
609
|
+
* right now? The handler owns the answer, so core learns no route vocabulary:
|
|
610
|
+
* it asks and skips, it does not interpret.
|
|
611
|
+
*
|
|
612
|
+
* Fail-open by construction: with nothing published, no query method, or a
|
|
613
|
+
* throwing query, the answer is true, so auxiliary calls behave exactly as they
|
|
614
|
+
* did before the seam existed. A false answer is reported once.
|
|
615
|
+
*/
|
|
616
|
+
export function isModelRouteUsable(model) {
|
|
617
|
+
const handler = getKeyRingFeedbackHandler();
|
|
618
|
+
const query = handler && handler.routeUsable;
|
|
619
|
+
if (typeof query !== "function")
|
|
620
|
+
return true;
|
|
621
|
+
let usable;
|
|
622
|
+
try {
|
|
623
|
+
usable =
|
|
624
|
+
query.call(handler, model.id, model.provider) !== false;
|
|
625
|
+
}
|
|
626
|
+
catch {
|
|
627
|
+
return true; // the seam must never break an auxiliary call
|
|
628
|
+
}
|
|
629
|
+
if (!usable)
|
|
630
|
+
reportUnusableModelOnce(model);
|
|
631
|
+
return usable;
|
|
632
|
+
}
|
|
633
|
+
/**
|
|
634
|
+
* Combine two AbortSignals into one. When either signal aborts, the combined signal aborts.
|
|
635
|
+
*
|
|
636
|
+
* If either parent signal is already aborted, returns just the *other* signal unmodified
|
|
637
|
+
* rather than creating an immediately-aborted controller. This prevents stale external
|
|
638
|
+
* signals (e.g. from timed-out tool executions) from instant-killing the combined signal
|
|
639
|
+
* on retry.
|
|
640
|
+
*
|
|
641
|
+
* Cleans up event listeners after the combined signal fires to prevent memory leaks
|
|
642
|
+
* across repeated calls (e.g. retry loops creating new combined signals).
|
|
643
|
+
*
|
|
644
|
+
* @internal Exported for behavioral testing (test-call-llm-behavior.mjs).
|
|
645
|
+
* Production code should not call this directly.
|
|
646
|
+
*/
|
|
647
|
+
export function combineSignals(s1, s2) {
|
|
648
|
+
// If either signal is already dead, just return the other - combining into an
|
|
649
|
+
// already-aborted signal is a no-op that would only propagate the stale abort.
|
|
650
|
+
if (s1.aborted)
|
|
651
|
+
return s2;
|
|
652
|
+
if (s2.aborted)
|
|
653
|
+
return s1;
|
|
654
|
+
const controller = new AbortController();
|
|
655
|
+
const onAbort = () => {
|
|
656
|
+
controller.abort();
|
|
657
|
+
s1.removeEventListener("abort", onAbort);
|
|
658
|
+
s2.removeEventListener("abort", onAbort);
|
|
659
|
+
};
|
|
660
|
+
s1.addEventListener("abort", onAbort);
|
|
661
|
+
s2.addEventListener("abort", onAbort);
|
|
662
|
+
return controller.signal;
|
|
663
|
+
}
|
|
664
|
+
/** Detect errors that are worth retrying. */
|
|
665
|
+
function isTransientError(message) {
|
|
666
|
+
return isRateLimitError(message) || matchesTransientOnly(message);
|
|
667
|
+
}
|
|
668
|
+
/**
|
|
669
|
+
* Check if an error message indicates a rate-limit condition specifically.
|
|
670
|
+
* Delegates to the canonical patterns in lib/errors/llm-error.ts (dedupe:
|
|
671
|
+
* the former local substring list had drifted — no "429"-anywhere, no
|
|
672
|
+
* "rate_limit"/"too_many_requests" underscore forms, no "throttle/-ing").
|
|
673
|
+
*/
|
|
674
|
+
function isRateLimitError(message) {
|
|
675
|
+
return isRateLimitText(message);
|
|
676
|
+
}
|
|
677
|
+
/** Patterns that indicate transient failure but not rate-limit. */
|
|
678
|
+
const TRANSIENT_ONLY_PATTERNS = [
|
|
679
|
+
"overloaded",
|
|
680
|
+
"service unavailable",
|
|
681
|
+
"temporarily",
|
|
682
|
+
"try again later",
|
|
683
|
+
"please retry",
|
|
684
|
+
"network connection lost",
|
|
685
|
+
"upstream connect",
|
|
686
|
+
"connection refused",
|
|
687
|
+
];
|
|
688
|
+
const TRANSIENT_ONLY_CODES = ["529", "502", "503", "504"];
|
|
689
|
+
function matchesTransientOnly(message) {
|
|
690
|
+
if (TRANSIENT_ONLY_CODES.some((code) => message.startsWith(code)))
|
|
691
|
+
return true;
|
|
692
|
+
const lower = message.toLowerCase();
|
|
693
|
+
return TRANSIENT_ONLY_PATTERNS.some((p) => lower.includes(p));
|
|
694
|
+
}
|
|
695
|
+
/**
|
|
696
|
+
* Compute exponential backoff delay.
|
|
697
|
+
* attempt 1 -> 5s, attempt 2 -> 15s, attempt 3 -> 30s, attempt 4 -> 60s
|
|
698
|
+
* With +/-20% jitter. Capped at 60s.
|
|
699
|
+
*/
|
|
700
|
+
/**
|
|
701
|
+
* Cast our locally-typed `simpleOptions` to the options shape the registry's
|
|
702
|
+
* `streamSimple` expects.
|
|
703
|
+
*
|
|
704
|
+
* Why this exists: `reasoning` is typed `ModelThinkingLevel`, which includes
|
|
705
|
+
* "off", while the SDK's stream-options `ThinkingLevel` does not list it.
|
|
706
|
+
* pi-ai's runtime takes "off" and maps it (off if the model supports it,
|
|
707
|
+
* else the lowest available level like "minimal"), so the value is sound at
|
|
708
|
+
* runtime. One helper keeps the boundary explicit and findable; when the
|
|
709
|
+
* SDK's stream-options type gains "off", this becomes an identity cast.
|
|
710
|
+
*/
|
|
711
|
+
function toSimpleStreamOptions(opts) {
|
|
712
|
+
return opts;
|
|
713
|
+
}
|
|
714
|
+
function backoffDelay(attempt) {
|
|
715
|
+
const delays = [5_000, 15_000, 30_000, 60_000];
|
|
716
|
+
const base = delays[Math.min(attempt - 1, delays.length - 1)];
|
|
717
|
+
const jitter = Math.round(base * (0.8 + Math.random() * 0.4));
|
|
718
|
+
return Math.min(jitter, 60_000);
|
|
719
|
+
}
|
|
720
|
+
/**
|
|
721
|
+
* Abortable sleep. Resolves immediately if signal fires during the wait.
|
|
722
|
+
*
|
|
723
|
+
* Without this, pressing ESC during a retry backoff (5-60s) would
|
|
724
|
+
* leave the sleep running -- the retry would fire after the backoff,
|
|
725
|
+
* then hang until the new timeout fires. The signal was only checked
|
|
726
|
+
* at the next combineSignals call, not during the backoff itself.
|
|
727
|
+
*/
|
|
728
|
+
function sleep(ms, signal) {
|
|
729
|
+
if (!signal)
|
|
730
|
+
return new Promise((r) => setTimeout(r, ms));
|
|
731
|
+
if (signal.aborted)
|
|
732
|
+
return Promise.resolve();
|
|
733
|
+
return new Promise((resolve) => {
|
|
734
|
+
const timer = setTimeout(() => {
|
|
735
|
+
signal.removeEventListener("abort", onAbort);
|
|
736
|
+
resolve();
|
|
737
|
+
}, ms);
|
|
738
|
+
const onAbort = () => {
|
|
739
|
+
clearTimeout(timer);
|
|
740
|
+
resolve();
|
|
741
|
+
};
|
|
742
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
743
|
+
});
|
|
744
|
+
}
|
|
745
|
+
//# sourceMappingURL=llm-call.js.map
|