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,195 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn-Scoped Whisper Dedup
|
|
3
|
+
*
|
|
4
|
+
* Multiple subsystems (BPE, dreamer, mars, drift, turn-outcome) all fire
|
|
5
|
+
* `sendTrackedMessage` on `turn_end`. Without coordination, a single degraded
|
|
6
|
+
* turn can produce 4-5 simultaneous steers, each nudging the agent in a
|
|
7
|
+
* slightly different direction. The agent is forced to triage noise rather
|
|
8
|
+
* than act.
|
|
9
|
+
*
|
|
10
|
+
* This module provides a turn-scoped registry. Each handler calls
|
|
11
|
+
* `tryClaim(type)` before sending. The first claim for a given type wins; the
|
|
12
|
+
* second is rejected. The registry is cleared at the start of each new turn
|
|
13
|
+
* (the `input` event) so the same warning can fire again on a future turn.
|
|
14
|
+
*
|
|
15
|
+
* Categories - handlers in the same category deduplicate against each other.
|
|
16
|
+
* Different categories are independent. Default is `"default"`:
|
|
17
|
+
*
|
|
18
|
+
* "loop": dreamer, turn-outcome (loop detection)
|
|
19
|
+
* "stability": bpe stability-decline, mars stability-decline
|
|
20
|
+
* "drift": bpe focus, drift handler
|
|
21
|
+
* "default": everything else (bpe generic, mars generic, etc.)
|
|
22
|
+
*
|
|
23
|
+
* Use `tryClaim(type, category)` to enroll. Use `tryClaim(type)` for the
|
|
24
|
+
* default category.
|
|
25
|
+
*/
|
|
26
|
+
import { createLogger } from "../core/logger.js";
|
|
27
|
+
const log = createLogger("turn-dedup");
|
|
28
|
+
/**
|
|
29
|
+
* Per-turn whisper cap (flood protection).
|
|
30
|
+
*
|
|
31
|
+
* Critical always passes. For other priorities, the cap controls the max
|
|
32
|
+
* number of whispers that can be delivered in a single turn from all
|
|
33
|
+
* sources combined. Sources that exceed their per-source budget are still
|
|
34
|
+
* counted toward the total, just not delivered.
|
|
35
|
+
*
|
|
36
|
+
* The defaults are intentionally small: a normal turn should have 0-1
|
|
37
|
+
* whispers. Multiple heartbeats firing simultaneously on the same turn
|
|
38
|
+
* can still produce a "[Heartbeat Summary]" (counts as 1).
|
|
39
|
+
*/
|
|
40
|
+
export const WHISPER_CAPS = {
|
|
41
|
+
critical: 5, // generous - auto-recovery
|
|
42
|
+
high: 3, // enforcement critical, compaction-retry exhausted
|
|
43
|
+
medium: 2, // analytics, context 80%+, navigation
|
|
44
|
+
low: 1, // hints, suggestions, dreams (filtered)
|
|
45
|
+
};
|
|
46
|
+
/** Per-source cap (a single subsystem can't flood). */
|
|
47
|
+
export const PER_SOURCE_CAP = 2;
|
|
48
|
+
/**
|
|
49
|
+
* Per-source cap overrides. Use these to raise the cap for sources that
|
|
50
|
+
* legitimately need more headroom (e.g. enforcement during a degraded
|
|
51
|
+
* turn where dropping a critical steer is the worst outcome). Lower
|
|
52
|
+
* caps than PER_SOURCE_CAP are NOT supported via overrides - if a
|
|
53
|
+
* source needs a lower cap, add a new explicit value here.
|
|
54
|
+
*
|
|
55
|
+
* EW-7.13: drop the all-sources-share cap so high-priority sources
|
|
56
|
+
* can get through during a degraded turn.
|
|
57
|
+
*/
|
|
58
|
+
export const PER_SOURCE_CAP_OVERRIDES = {
|
|
59
|
+
// Enforcement whispers are critical/high priority. A 3rd
|
|
60
|
+
// triggerTurn:true whisper in a degraded turn is more valuable
|
|
61
|
+
// than dropping it (the alternative is the agent missing a
|
|
62
|
+
// real signal).
|
|
63
|
+
"enforcement/whisper": 3,
|
|
64
|
+
};
|
|
65
|
+
/** Resolve the per-source cap for a given source (override or default). */
|
|
66
|
+
export function getPerSourceCap(source) {
|
|
67
|
+
return PER_SOURCE_CAP_OVERRIDES[source] ?? PER_SOURCE_CAP;
|
|
68
|
+
}
|
|
69
|
+
function getState() {
|
|
70
|
+
// We use a no-op key and module-level singleton. The dedup state is
|
|
71
|
+
// intentionally process-global, not per-session, because the `input` event
|
|
72
|
+
// is what defines "turn" and that already partitions correctly.
|
|
73
|
+
return _state;
|
|
74
|
+
}
|
|
75
|
+
let _state = {
|
|
76
|
+
currentTurn: 0,
|
|
77
|
+
claims: [],
|
|
78
|
+
whisperCounts: { critical: 0, high: 0, medium: 0, low: 0 },
|
|
79
|
+
whisperBySource: {},
|
|
80
|
+
suppressed: 0,
|
|
81
|
+
};
|
|
82
|
+
/**
|
|
83
|
+
* Bump the turn counter and clear all claims. Call this from the `input`
|
|
84
|
+
* event handler - it represents the start of a new assistant turn.
|
|
85
|
+
*/
|
|
86
|
+
export function beginTurn() {
|
|
87
|
+
_state.currentTurn += 1;
|
|
88
|
+
_state.claims = [];
|
|
89
|
+
_state.whisperCounts = { critical: 0, high: 0, medium: 0, low: 0 };
|
|
90
|
+
_state.whisperBySource = {};
|
|
91
|
+
_state.suppressed = 0;
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Try to claim the right to fire a whisper of `type` in `category` for the
|
|
95
|
+
* current turn. Returns `true` if the claim succeeded (caller should send),
|
|
96
|
+
* `false` if a different type in the same category already claimed this turn
|
|
97
|
+
* (caller should suppress).
|
|
98
|
+
*
|
|
99
|
+
* Calling `tryClaim` twice for the same `type` always returns `true` - the
|
|
100
|
+
* first claim is idempotent for the same type.
|
|
101
|
+
*/
|
|
102
|
+
export function tryClaim(type, category = "default") {
|
|
103
|
+
const state = getState();
|
|
104
|
+
// Idempotent: same type can re-claim.
|
|
105
|
+
const existing = state.claims.find((c) => c.type === type && c.category === category);
|
|
106
|
+
if (existing)
|
|
107
|
+
return true;
|
|
108
|
+
// Reject if any other type in the same category already claimed this turn.
|
|
109
|
+
const sameCategory = state.claims.find((c) => c.category === category);
|
|
110
|
+
if (sameCategory) {
|
|
111
|
+
log.debug(`[turn-dedup] ${type} suppressed: ${sameCategory.type} already fired in category "${category}" this turn`);
|
|
112
|
+
return false;
|
|
113
|
+
}
|
|
114
|
+
state.claims.push({ type, category, claimedAt: Date.now() });
|
|
115
|
+
return true;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Reset dedup state - primarily for tests.
|
|
119
|
+
*/
|
|
120
|
+
export function _resetForTests() {
|
|
121
|
+
_state = {
|
|
122
|
+
currentTurn: 0,
|
|
123
|
+
claims: [],
|
|
124
|
+
whisperCounts: { critical: 0, high: 0, medium: 0, low: 0 },
|
|
125
|
+
whisperBySource: {},
|
|
126
|
+
suppressed: 0,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Read-only view of current state, for diagnostics and tests.
|
|
131
|
+
*/
|
|
132
|
+
export function _snapshot() {
|
|
133
|
+
return {
|
|
134
|
+
currentTurn: _state.currentTurn,
|
|
135
|
+
claims: [..._state.claims],
|
|
136
|
+
whisperCounts: { ..._state.whisperCounts },
|
|
137
|
+
whisperBySource: { ..._state.whisperBySource },
|
|
138
|
+
suppressed: _state.suppressed,
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
// ── Per-Turn Whisper Cap (Flood Protection) ────────────────────────────────────────
|
|
142
|
+
/**
|
|
143
|
+
* Try to record a whisper of `priority` from `source` in the current turn.
|
|
144
|
+
* Returns `true` if the whisper should be delivered (under cap), `false`
|
|
145
|
+
* if it's been suppressed by the flood protection.
|
|
146
|
+
*
|
|
147
|
+
* Critical priority always passes. Other priorities are capped at
|
|
148
|
+
* WHISPER_CAPS[priority] per turn from all sources combined, with a
|
|
149
|
+
* per-source cap of PER_SOURCE_CAP.
|
|
150
|
+
*
|
|
151
|
+
* Use this BEFORE calling `sendTrackedMessage` or `ctx.whisper` to avoid
|
|
152
|
+
* flooding the agent. Returns the same value as `tryClaim` would (idempotent
|
|
153
|
+
* within a source).
|
|
154
|
+
*/
|
|
155
|
+
export function tryWhisper(priority, source) {
|
|
156
|
+
const state = getState();
|
|
157
|
+
// Critical always passes (subject to per-source cap to prevent a buggy
|
|
158
|
+
// critical source from monopolizing the channel).
|
|
159
|
+
if (priority === "critical") {
|
|
160
|
+
const sourceCount = state.whisperBySource[source] ?? 0;
|
|
161
|
+
const sourceCap = getPerSourceCap(source);
|
|
162
|
+
if (sourceCount >= sourceCap) {
|
|
163
|
+
state.suppressed++;
|
|
164
|
+
log.debug(`[turn-dedup] critical "${source}" suppressed (per-source cap ${sourceCap})`);
|
|
165
|
+
return false;
|
|
166
|
+
}
|
|
167
|
+
state.whisperCounts.critical++;
|
|
168
|
+
state.whisperBySource[source] = sourceCount + 1;
|
|
169
|
+
return true;
|
|
170
|
+
}
|
|
171
|
+
// Per-priority total cap
|
|
172
|
+
const cap = WHISPER_CAPS[priority];
|
|
173
|
+
if (state.whisperCounts[priority] >= cap) {
|
|
174
|
+
state.suppressed++;
|
|
175
|
+
log.debug(`[turn-dedup] ${priority} "${source}" suppressed (total cap ${cap} reached)`);
|
|
176
|
+
return false;
|
|
177
|
+
}
|
|
178
|
+
// Per-source fairness cap (override-aware)
|
|
179
|
+
const sourceCount = state.whisperBySource[source] ?? 0;
|
|
180
|
+
const sourceCap = getPerSourceCap(source);
|
|
181
|
+
if (sourceCount >= sourceCap) {
|
|
182
|
+
state.suppressed++;
|
|
183
|
+
log.debug(`[turn-dedup] ${priority} "${source}" suppressed (per-source cap ${sourceCap})`);
|
|
184
|
+
return false;
|
|
185
|
+
}
|
|
186
|
+
state.whisperCounts[priority]++;
|
|
187
|
+
state.whisperBySource[source] = sourceCount + 1;
|
|
188
|
+
return true;
|
|
189
|
+
}
|
|
190
|
+
// Note: we intentionally do NOT use `getExtensionState(ctx, ...)` here.
|
|
191
|
+
// Turn dedup must be a module-level singleton so that handlers running in
|
|
192
|
+
// different session contexts (rare but possible during handoff) share the
|
|
193
|
+
// same turn boundary. If you need per-session dedup, wrap `tryClaim` with a
|
|
194
|
+
// ctx-aware variant that keys on a session id derived from `ctx`.
|
|
195
|
+
//# sourceMappingURL=turn-dedup.js.map
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Unified LLM Error Classifier - one taxonomy, one place.
|
|
3
|
+
*
|
|
4
|
+
* Replaces the ad-hoc `isTransientCompactionError` / `isContextWindowError`
|
|
5
|
+
* helpers scattered across `compaction-retry.ts` and the local fallbacks
|
|
6
|
+
* in `llm-call.ts`. Every LLM-call failure routes through this classifier
|
|
7
|
+
* and gets a category. Consumers (SessionHealthState, recovery handlers,
|
|
8
|
+
* detector fallbacks) read the category instead of pattern-matching error
|
|
9
|
+
* strings.
|
|
10
|
+
*
|
|
11
|
+
* Categories:
|
|
12
|
+
* - balance: 402 / insufficient_balance / billing issues. Retry
|
|
13
|
+
* is pointless; user action required.
|
|
14
|
+
* - rate_limit: 429. Retry with backoff. The provider's `Retry-After`
|
|
15
|
+
* header is captured when present.
|
|
16
|
+
* - context_window: 413 / context_length_exceeded. Compaction must happen
|
|
17
|
+
* before any further LLM call. The session is too large.
|
|
18
|
+
* - transient: 500/502/503/504/529/network. Retry with backoff.
|
|
19
|
+
* - abort: ctx.signal.aborted. User cancelled, or shutdown.
|
|
20
|
+
* - auth: 401 / invalid_api_key. Token / credential issue.
|
|
21
|
+
* - unknown: catch-all. Treated as transient for safety.
|
|
22
|
+
*
|
|
23
|
+
* The classifier is intentionally tolerant -- it inspects both the error
|
|
24
|
+
* message string AND any status code on the error object. This is
|
|
25
|
+
* necessary because different providers (Anthropic, OpenAI, etc.) format
|
|
26
|
+
* their errors differently.
|
|
27
|
+
*/
|
|
28
|
+
export type LlmErrorCategory = "balance" | "rate_limit" | "context_window" | "transient" | "abort" | "auth" | "unknown";
|
|
29
|
+
export interface ClassifiedLlmError {
|
|
30
|
+
category: LlmErrorCategory;
|
|
31
|
+
/** Can we try the same call again with backoff and expect a different result? */
|
|
32
|
+
retryable: boolean;
|
|
33
|
+
/** Should consumers switch to a non-LLM path (hard truncation, heuristic)? */
|
|
34
|
+
fallbackToNonLlm: boolean;
|
|
35
|
+
/** Does the user need to do something (top up balance, fix key)? */
|
|
36
|
+
userActionRequired: boolean;
|
|
37
|
+
/** Plain-text hint for the user. Empty for transient/unknown. */
|
|
38
|
+
userMessage?: string;
|
|
39
|
+
/** Hint from Retry-After header or computed backoff (ms). */
|
|
40
|
+
retryAfterMs?: number;
|
|
41
|
+
/** Original error for debugging. */
|
|
42
|
+
raw: unknown;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Canonical rate-limit patterns — single source of truth (dedupe merged
|
|
46
|
+
* the drifted substring-list copy that lived in lib/ai/llm-call.ts).
|
|
47
|
+
* Superset semantics:
|
|
48
|
+
* - /429/ matches anywhere in the text (covers `startsWith("429")` consumers;
|
|
49
|
+
* "1429" also matches — accepted, that was already llm-error's behavior)
|
|
50
|
+
* - /rate[_ ]limit/ and /too[_ ]many[_ ]requests/ match the space and
|
|
51
|
+
* underscore forms ("rate limit", "rate_limit", …)
|
|
52
|
+
* - /throttl/i matches "throttle" / "throttled" / "throttling" — widened
|
|
53
|
+
* from the llm-call.ts list (which only had "throttled"); for
|
|
54
|
+
* classifyLlmError this moves such errors from `unknown` to `rate_limit`
|
|
55
|
+
*/
|
|
56
|
+
export declare const RATE_LIMIT_PATTERNS: RegExp[];
|
|
57
|
+
/** True when the text looks like an HTTP rate-limit condition (RATE_LIMIT_PATTERNS). */
|
|
58
|
+
export declare function isRateLimitText(text: string): boolean;
|
|
59
|
+
/**
|
|
60
|
+
* Extract the first standalone 3-digit HTTP status code (400-599) from an
|
|
61
|
+
* error TEXT. Keyring failures arrive as plain strings (no error object for
|
|
62
|
+
* extractStatusCode), and unclassified failures must still carry their HTTP
|
|
63
|
+
* code in the health record so root-causing needs no log forensics.
|
|
64
|
+
* Guards: not part of a longer number on either side ("1429" is not 429,
|
|
65
|
+
* "6721" is not 672); only 4xx/5xx (timestamps like "42.123" cannot produce
|
|
66
|
+
* a false 1xx/2xx hit).
|
|
67
|
+
*/
|
|
68
|
+
export declare function extractHttpCodeFromText(text: string): number | undefined;
|
|
69
|
+
/**
|
|
70
|
+
* True when the text looks like a context-window / payload-too-large error
|
|
71
|
+
* (CONTEXT_WINDOW_PATTERNS: 413, context_length_exceeded...). Canonical
|
|
72
|
+
* helper for text-based consumers: pi-core surfaces agent-loop API
|
|
73
|
+
* failures as plain strings (assistant errorMessage), where classifyLlmError
|
|
74
|
+
* is also usable, but error text arrives in several shapes — this is the one
|
|
75
|
+
* text predicate so emergency-offload consumers never fork the pattern list.
|
|
76
|
+
*/
|
|
77
|
+
export declare function isContextWindowErrorText(text: string): boolean;
|
|
78
|
+
export declare function classifyLlmError(err: unknown): ClassifiedLlmError;
|
|
79
|
+
//# sourceMappingURL=llm-error.d.ts.map
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Unified LLM Error Classifier - one taxonomy, one place.
|
|
3
|
+
*
|
|
4
|
+
* Replaces the ad-hoc `isTransientCompactionError` / `isContextWindowError`
|
|
5
|
+
* helpers scattered across `compaction-retry.ts` and the local fallbacks
|
|
6
|
+
* in `llm-call.ts`. Every LLM-call failure routes through this classifier
|
|
7
|
+
* and gets a category. Consumers (SessionHealthState, recovery handlers,
|
|
8
|
+
* detector fallbacks) read the category instead of pattern-matching error
|
|
9
|
+
* strings.
|
|
10
|
+
*
|
|
11
|
+
* Categories:
|
|
12
|
+
* - balance: 402 / insufficient_balance / billing issues. Retry
|
|
13
|
+
* is pointless; user action required.
|
|
14
|
+
* - rate_limit: 429. Retry with backoff. The provider's `Retry-After`
|
|
15
|
+
* header is captured when present.
|
|
16
|
+
* - context_window: 413 / context_length_exceeded. Compaction must happen
|
|
17
|
+
* before any further LLM call. The session is too large.
|
|
18
|
+
* - transient: 500/502/503/504/529/network. Retry with backoff.
|
|
19
|
+
* - abort: ctx.signal.aborted. User cancelled, or shutdown.
|
|
20
|
+
* - auth: 401 / invalid_api_key. Token / credential issue.
|
|
21
|
+
* - unknown: catch-all. Treated as transient for safety.
|
|
22
|
+
*
|
|
23
|
+
* The classifier is intentionally tolerant -- it inspects both the error
|
|
24
|
+
* message string AND any status code on the error object. This is
|
|
25
|
+
* necessary because different providers (Anthropic, OpenAI, etc.) format
|
|
26
|
+
* their errors differently.
|
|
27
|
+
*/
|
|
28
|
+
const BALANCE_PATTERNS = [
|
|
29
|
+
/402/,
|
|
30
|
+
/insufficient[_ ]balance/i,
|
|
31
|
+
/billing/i,
|
|
32
|
+
/payment[_ ]required/i,
|
|
33
|
+
/quota[_ ]exceeded/i,
|
|
34
|
+
];
|
|
35
|
+
/**
|
|
36
|
+
* Canonical rate-limit patterns — single source of truth (dedupe merged
|
|
37
|
+
* the drifted substring-list copy that lived in lib/ai/llm-call.ts).
|
|
38
|
+
* Superset semantics:
|
|
39
|
+
* - /429/ matches anywhere in the text (covers `startsWith("429")` consumers;
|
|
40
|
+
* "1429" also matches — accepted, that was already llm-error's behavior)
|
|
41
|
+
* - /rate[_ ]limit/ and /too[_ ]many[_ ]requests/ match the space and
|
|
42
|
+
* underscore forms ("rate limit", "rate_limit", …)
|
|
43
|
+
* - /throttl/i matches "throttle" / "throttled" / "throttling" — widened
|
|
44
|
+
* from the llm-call.ts list (which only had "throttled"); for
|
|
45
|
+
* classifyLlmError this moves such errors from `unknown` to `rate_limit`
|
|
46
|
+
*/
|
|
47
|
+
export const RATE_LIMIT_PATTERNS = [
|
|
48
|
+
/429/,
|
|
49
|
+
/rate[_ ]limit/i,
|
|
50
|
+
/too[_ ]many[_ ]requests/i,
|
|
51
|
+
/throttl/i,
|
|
52
|
+
];
|
|
53
|
+
/** True when the text looks like an HTTP rate-limit condition (RATE_LIMIT_PATTERNS). */
|
|
54
|
+
export function isRateLimitText(text) {
|
|
55
|
+
return matchesAny(text, RATE_LIMIT_PATTERNS);
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Extract the first standalone 3-digit HTTP status code (400-599) from an
|
|
59
|
+
* error TEXT. Keyring failures arrive as plain strings (no error object for
|
|
60
|
+
* extractStatusCode), and unclassified failures must still carry their HTTP
|
|
61
|
+
* code in the health record so root-causing needs no log forensics.
|
|
62
|
+
* Guards: not part of a longer number on either side ("1429" is not 429,
|
|
63
|
+
* "6721" is not 672); only 4xx/5xx (timestamps like "42.123" cannot produce
|
|
64
|
+
* a false 1xx/2xx hit).
|
|
65
|
+
*/
|
|
66
|
+
export function extractHttpCodeFromText(text) {
|
|
67
|
+
const m = /(?:^|[^0-9])(4\d{2}|5\d{2})(?![0-9])/.exec(text);
|
|
68
|
+
return m ? Number(m[1]) : undefined;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* True when the text looks like a context-window / payload-too-large error
|
|
72
|
+
* (CONTEXT_WINDOW_PATTERNS: 413, context_length_exceeded...). Canonical
|
|
73
|
+
* helper for text-based consumers: pi-core surfaces agent-loop API
|
|
74
|
+
* failures as plain strings (assistant errorMessage), where classifyLlmError
|
|
75
|
+
* is also usable, but error text arrives in several shapes — this is the one
|
|
76
|
+
* text predicate so emergency-offload consumers never fork the pattern list.
|
|
77
|
+
*/
|
|
78
|
+
export function isContextWindowErrorText(text) {
|
|
79
|
+
return matchesAny(text, CONTEXT_WINDOW_PATTERNS);
|
|
80
|
+
}
|
|
81
|
+
const CONTEXT_WINDOW_PATTERNS = [
|
|
82
|
+
/413/,
|
|
83
|
+
/context[_ ]length[_ ]exceeded/i,
|
|
84
|
+
/context[_ ]window/i,
|
|
85
|
+
/maximum[_ ]context/i,
|
|
86
|
+
/prompt[_ ]is[_ ]too[_ ]long/i,
|
|
87
|
+
];
|
|
88
|
+
const TRANSIENT_PATTERNS = [
|
|
89
|
+
/500/,
|
|
90
|
+
/502/,
|
|
91
|
+
/503/,
|
|
92
|
+
/504/,
|
|
93
|
+
/529/,
|
|
94
|
+
/overloaded/i,
|
|
95
|
+
/server[_ ]error/i,
|
|
96
|
+
/temporarily[_ ]unavailable/i,
|
|
97
|
+
/econnreset/i,
|
|
98
|
+
/etimedout/i,
|
|
99
|
+
/enotfound/i,
|
|
100
|
+
/network[_ ]error/i,
|
|
101
|
+
// Network idioms (sleep/wake timeouts, dropped sockets): these must land in
|
|
102
|
+
// `transient` rather than `unknown` so consumers (session_health, watchdog
|
|
103
|
+
// quota gating) treat them as retryable noise, never quota/auth problems.
|
|
104
|
+
/fetch failed/i,
|
|
105
|
+
/socket hang up/i,
|
|
106
|
+
/econnaborted/i,
|
|
107
|
+
/epipe/i,
|
|
108
|
+
/eai[_ ]again/i,
|
|
109
|
+
/und[_ ]err/i,
|
|
110
|
+
/other side closed/i,
|
|
111
|
+
];
|
|
112
|
+
const AUTH_PATTERNS = [/401/, /invalid[_ ]api[_ ]key/i, /unauthorized/i, /authentication/i];
|
|
113
|
+
/** Try to extract a numeric status code from the error object. */
|
|
114
|
+
function extractStatusCode(err) {
|
|
115
|
+
if (typeof err === "object" && err !== null) {
|
|
116
|
+
const e = err;
|
|
117
|
+
// Common shapes: { status: 402 }, { statusCode: 402 }, { code: 402 }
|
|
118
|
+
for (const key of ["status", "statusCode", "code"]) {
|
|
119
|
+
const v = e[key];
|
|
120
|
+
if (typeof v === "number" && v >= 400 && v < 600)
|
|
121
|
+
return v;
|
|
122
|
+
}
|
|
123
|
+
// pi-ai / anthropic / openai error shapes
|
|
124
|
+
if (typeof e.error === "object" && e.error !== null) {
|
|
125
|
+
const inner = e.error;
|
|
126
|
+
if (typeof inner.code === "string") {
|
|
127
|
+
// e.g. "insufficient_balance", "rate_limit_exceeded"
|
|
128
|
+
return undefined;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return undefined;
|
|
133
|
+
}
|
|
134
|
+
function matchesAny(text, patterns) {
|
|
135
|
+
for (const p of patterns) {
|
|
136
|
+
if (p.test(text))
|
|
137
|
+
return true;
|
|
138
|
+
}
|
|
139
|
+
return false;
|
|
140
|
+
}
|
|
141
|
+
function tryExtractRetryAfter(err) {
|
|
142
|
+
if (typeof err === "object" && err !== null) {
|
|
143
|
+
const e = err;
|
|
144
|
+
// pi-ai / fetch may put headers in `headers` or `response.headers`
|
|
145
|
+
const headers = e.headers ??
|
|
146
|
+
e.response?.headers;
|
|
147
|
+
if (headers) {
|
|
148
|
+
const ra = headers["retry-after"] ?? headers["Retry-After"];
|
|
149
|
+
if (typeof ra === "string") {
|
|
150
|
+
const seconds = parseInt(ra, 10);
|
|
151
|
+
if (!isNaN(seconds))
|
|
152
|
+
return seconds * 1000;
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
return undefined;
|
|
157
|
+
}
|
|
158
|
+
function makeError(category, raw, extras = {}) {
|
|
159
|
+
const defaults = {
|
|
160
|
+
balance: {
|
|
161
|
+
retryable: false,
|
|
162
|
+
fallbackToNonLlm: true,
|
|
163
|
+
userActionRequired: true,
|
|
164
|
+
},
|
|
165
|
+
rate_limit: {
|
|
166
|
+
retryable: true,
|
|
167
|
+
fallbackToNonLlm: false,
|
|
168
|
+
userActionRequired: false,
|
|
169
|
+
},
|
|
170
|
+
context_window: {
|
|
171
|
+
retryable: false,
|
|
172
|
+
fallbackToNonLlm: true,
|
|
173
|
+
userActionRequired: false,
|
|
174
|
+
},
|
|
175
|
+
transient: {
|
|
176
|
+
retryable: true,
|
|
177
|
+
fallbackToNonLlm: false,
|
|
178
|
+
userActionRequired: false,
|
|
179
|
+
},
|
|
180
|
+
abort: {
|
|
181
|
+
retryable: false,
|
|
182
|
+
fallbackToNonLlm: false,
|
|
183
|
+
userActionRequired: false,
|
|
184
|
+
},
|
|
185
|
+
auth: {
|
|
186
|
+
retryable: false,
|
|
187
|
+
fallbackToNonLlm: true,
|
|
188
|
+
userActionRequired: true,
|
|
189
|
+
},
|
|
190
|
+
unknown: {
|
|
191
|
+
retryable: true,
|
|
192
|
+
fallbackToNonLlm: false,
|
|
193
|
+
userActionRequired: false,
|
|
194
|
+
},
|
|
195
|
+
};
|
|
196
|
+
const base = {
|
|
197
|
+
category,
|
|
198
|
+
raw,
|
|
199
|
+
...defaults[category],
|
|
200
|
+
};
|
|
201
|
+
return { ...base, ...extras };
|
|
202
|
+
}
|
|
203
|
+
export function classifyLlmError(err) {
|
|
204
|
+
if (err == null)
|
|
205
|
+
return makeError("unknown", err);
|
|
206
|
+
// Abort detection first -- the user cancelled or the session shut down.
|
|
207
|
+
if (typeof err === "object" && err !== null) {
|
|
208
|
+
const e = err;
|
|
209
|
+
if (e.name === "AbortError" || e.aborted === true) {
|
|
210
|
+
return makeError("abort", err);
|
|
211
|
+
}
|
|
212
|
+
if (e.code === "ABORT_ERR" || (typeof e.message === "string" && /aborted/i.test(e.message))) {
|
|
213
|
+
return makeError("abort", err);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
const status = extractStatusCode(err);
|
|
217
|
+
const message = typeof err === "object" && err !== null && typeof err.message === "string"
|
|
218
|
+
? err.message
|
|
219
|
+
: String(err);
|
|
220
|
+
const text = `${status ?? ""} ${message}`.trim();
|
|
221
|
+
if (status === 402 || matchesAny(text, BALANCE_PATTERNS)) {
|
|
222
|
+
return makeError("balance", err);
|
|
223
|
+
}
|
|
224
|
+
if (status === 429 || matchesAny(text, RATE_LIMIT_PATTERNS)) {
|
|
225
|
+
return makeError("rate_limit", err, { retryAfterMs: tryExtractRetryAfter(err) });
|
|
226
|
+
}
|
|
227
|
+
if (status === 401 || matchesAny(text, AUTH_PATTERNS)) {
|
|
228
|
+
return makeError("auth", err);
|
|
229
|
+
}
|
|
230
|
+
if (status === 413 || matchesAny(text, CONTEXT_WINDOW_PATTERNS)) {
|
|
231
|
+
return makeError("context_window", err);
|
|
232
|
+
}
|
|
233
|
+
if (status === 500 || status === 502 || status === 503 || status === 504 || status === 529) {
|
|
234
|
+
return makeError("transient", err);
|
|
235
|
+
}
|
|
236
|
+
if (matchesAny(text, TRANSIENT_PATTERNS)) {
|
|
237
|
+
return makeError("transient", err);
|
|
238
|
+
}
|
|
239
|
+
return makeError("unknown", err);
|
|
240
|
+
}
|
|
241
|
+
//# sourceMappingURL=llm-error.js.map
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Experience Consolidation Queue
|
|
3
|
+
*
|
|
4
|
+
* Infrastructure for selecting, scoring, and scheduling experiences
|
|
5
|
+
* for consolidation from episodic memory into reusable patterns.
|
|
6
|
+
*
|
|
7
|
+
* Scoring is heuristic (quality x value x confidence x novelty).
|
|
8
|
+
* Weight update (LoRA/MEMIT) is not implemented - this queues experience
|
|
9
|
+
* data for potential future training pipelines.
|
|
10
|
+
*/
|
|
11
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
12
|
+
import { scoreEpisode } from "./consolidation-scoring.js";
|
|
13
|
+
export { scoreEpisode };
|
|
14
|
+
export interface ConsolidationCandidate {
|
|
15
|
+
/** Episode ID from three-memory-stores */
|
|
16
|
+
episodeId: string;
|
|
17
|
+
/** Task that was solved */
|
|
18
|
+
task: string;
|
|
19
|
+
/** Outcome of the episode */
|
|
20
|
+
outcome: "success" | "failure" | "partial";
|
|
21
|
+
/** Project identifier for cross-project filtering */
|
|
22
|
+
project?: string;
|
|
23
|
+
/** Strategic SOP (high-level strategy) */
|
|
24
|
+
strategicSOP?: string;
|
|
25
|
+
/** Functional SOP (mid-level steps) */
|
|
26
|
+
functionalSOP?: string[];
|
|
27
|
+
/** Quality score 0-1 */
|
|
28
|
+
quality: number;
|
|
29
|
+
/** Value score 0-1: how valuable is this experience? */
|
|
30
|
+
valueScore: number;
|
|
31
|
+
/** Confidence score 0-1: how reliable is the SOP? */
|
|
32
|
+
confidenceScore: number;
|
|
33
|
+
/** Novelty score 0-1: how different from existing patterns? */
|
|
34
|
+
noveltyScore: number;
|
|
35
|
+
/** Composite consolidation score 0-1 */
|
|
36
|
+
consolidationScore: number;
|
|
37
|
+
/** When this was queued */
|
|
38
|
+
queuedAt: number;
|
|
39
|
+
/** Status */
|
|
40
|
+
status: "pending" | "consolidating" | "completed" | "skipped";
|
|
41
|
+
}
|
|
42
|
+
export interface ConsolidationConfig {
|
|
43
|
+
/** Minimum quality for consideration */
|
|
44
|
+
minQuality: number;
|
|
45
|
+
/** Minimum value score for selection */
|
|
46
|
+
minValueScore: number;
|
|
47
|
+
/** Minimum confidence for selection */
|
|
48
|
+
minConfidence: number;
|
|
49
|
+
/** Maximum candidates to queue per tick */
|
|
50
|
+
maxCandidatesPerTick: number;
|
|
51
|
+
/** Maximum queue size */
|
|
52
|
+
maxQueueSize: number;
|
|
53
|
+
/** Heartbeat interval between consolidations (turns) */
|
|
54
|
+
consolidationInterval: number;
|
|
55
|
+
/** Enable auto-consolidation */
|
|
56
|
+
enabled: boolean;
|
|
57
|
+
}
|
|
58
|
+
export declare const DEFAULT_CONSOLIDATION_CONFIG: ConsolidationConfig;
|
|
59
|
+
/**
|
|
60
|
+
* Enqueue a scored consolidation candidate for deferred processing.
|
|
61
|
+
* Returns true if enqueued, false if queue full or duplicate.
|
|
62
|
+
*/
|
|
63
|
+
export declare function enqueueCandidate(candidate: ConsolidationCandidate): boolean;
|
|
64
|
+
/**
|
|
65
|
+
* Execute full consolidation pipeline: extract SOP via sop-extractor,
|
|
66
|
+
* score the episode, enqueue for deferred hint writing.
|
|
67
|
+
*
|
|
68
|
+
* This bridges heartbeat episode retrieval with the consolidation queue.
|
|
69
|
+
* The actual hint file write happens asynchronously via processConsolidationTick.
|
|
70
|
+
*/
|
|
71
|
+
export declare function executeConsolidation(episode: {
|
|
72
|
+
id: string;
|
|
73
|
+
task: string;
|
|
74
|
+
outcome: "success" | "failure" | "partial";
|
|
75
|
+
project?: string;
|
|
76
|
+
quality?: number;
|
|
77
|
+
trajectory?: {
|
|
78
|
+
toolName: string;
|
|
79
|
+
success: boolean;
|
|
80
|
+
error?: string;
|
|
81
|
+
}[];
|
|
82
|
+
solution?: string;
|
|
83
|
+
strategicSOP?: string;
|
|
84
|
+
functionalSOP?: string[];
|
|
85
|
+
toolSequence?: string[];
|
|
86
|
+
}): Promise<ConsolidationCandidate | null>;
|
|
87
|
+
/**
|
|
88
|
+
* Process consolidation queue on heartbeat tick.
|
|
89
|
+
* Called by heartbeat scheduler on each tick.
|
|
90
|
+
*/
|
|
91
|
+
export declare function processConsolidationTick(ctx: ExtensionContext): Promise<void>;
|
|
92
|
+
export interface ArchiveCandidate {
|
|
93
|
+
changeName: string;
|
|
94
|
+
archivePath: string;
|
|
95
|
+
hasProposal: boolean;
|
|
96
|
+
hasDesign: boolean;
|
|
97
|
+
specCount: number;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Scan openspec/changes/archive/ for new archives not yet ingested.
|
|
101
|
+
* Returns candidates for ingestion into the consolidation queue.
|
|
102
|
+
*/
|
|
103
|
+
export declare function scanArchives(projectRoot: string): Promise<ArchiveCandidate[]>;
|
|
104
|
+
/**
|
|
105
|
+
* Ingest scanned archives into the consolidation queue.
|
|
106
|
+
* Called from the enforcement turn-end handler.
|
|
107
|
+
*/
|
|
108
|
+
export declare function ingestArchives(projectRoot: string): Promise<number>;
|
|
109
|
+
//# sourceMappingURL=consolidation-channel.d.ts.map
|