pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,454 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Degradation Detector - Track performance metrics and detect degradation
|
|
3
|
+
*
|
|
4
|
+
* Session-scoped via ExtensionContext (in-memory). Global fallback for legacy callers.
|
|
5
|
+
* File persistence is process-global (separate concern).
|
|
6
|
+
*/
|
|
7
|
+
import * as os from "node:os";
|
|
8
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
9
|
+
import { saveStateImmediate, loadState } from "../state/async-storage.js";
|
|
10
|
+
import { createLogger } from "../core/logger.js";
|
|
11
|
+
import { degradationFilePath } from "../config/braid-paths.js";
|
|
12
|
+
const _log = createLogger("degradation-detector");
|
|
13
|
+
const DEFAULT_CONFIG = {
|
|
14
|
+
healthcheckMinScore: 80,
|
|
15
|
+
errorRateMax: 0.1,
|
|
16
|
+
toolSuccessMin: 70,
|
|
17
|
+
checkIntervalMs: 60000,
|
|
18
|
+
maxConsecutiveErrors: 3,
|
|
19
|
+
};
|
|
20
|
+
// Global fallback (legacy - for tool handlers without ctx)
|
|
21
|
+
let _global = {
|
|
22
|
+
metrics: [],
|
|
23
|
+
config: { ...DEFAULT_CONFIG },
|
|
24
|
+
isDegraded: false,
|
|
25
|
+
lastHealthcheck: null,
|
|
26
|
+
};
|
|
27
|
+
function getStateFrom(ctx) {
|
|
28
|
+
if (ctx) {
|
|
29
|
+
return getExtensionState(ctx, "degradation-detector", () =>
|
|
30
|
+
// Per-session scoping: enforcement reacts to the
|
|
31
|
+
// CURRENT session's error history only. degradation.json (the 30-day
|
|
32
|
+
// _global mirror loaded by loadMetrics) stays on disk for
|
|
33
|
+
// analysis/telemetry, but a NEW session must not inherit a previous
|
|
34
|
+
// session's stale error metrics — a polluted file poisoned the
|
|
35
|
+
// errorRate trajectory from turn 1 and drove false-positive
|
|
36
|
+
// rollbacks (see test-degradation-session-scoping.mjs). Config is
|
|
37
|
+
// still carried over: operator-tuned thresholds are not history.
|
|
38
|
+
// Live session writes are mirrored back into _global (telemetry).
|
|
39
|
+
({
|
|
40
|
+
metrics: [],
|
|
41
|
+
config: { ..._global.config },
|
|
42
|
+
isDegraded: false,
|
|
43
|
+
lastHealthcheck: null,
|
|
44
|
+
}));
|
|
45
|
+
}
|
|
46
|
+
// Global fallback: no ExtensionContext available, state is shared across sessions
|
|
47
|
+
return _global;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Telemetry mirror: append a live session's metric entry to the
|
|
51
|
+
* process-global mirror (_global) so degradation.json keeps receiving data
|
|
52
|
+
* for cross-session analysis. Enforcement state stays per-session; only the
|
|
53
|
+
* telemetry copy is shared.
|
|
54
|
+
*/
|
|
55
|
+
function mirrorToGlobal(entry, isDegraded) {
|
|
56
|
+
_global.metrics.push(entry);
|
|
57
|
+
if (_global.metrics.length > 100)
|
|
58
|
+
_global.metrics = _global.metrics.slice(-100);
|
|
59
|
+
_global.isDegraded = isDegraded;
|
|
60
|
+
}
|
|
61
|
+
/** Runtime type guard: is this an ExtensionContext?
|
|
62
|
+
*
|
|
63
|
+
* The guard keys on `sessionManager`, which exists on ctx in both old and
|
|
64
|
+
* new pi-core (pi-core 0.84.4 removed `settingsManager` from
|
|
65
|
+
* ExtensionContext, which is what exposed the older guard). A looser guard
|
|
66
|
+
* makes `recordTurnMetrics(ctx, metrics)` fail the ctx check and treat the
|
|
67
|
+
* ENTIRE ctx object as metrics — every heartbeat tick then embeds the full
|
|
68
|
+
* session graph (sessionManager.fileEntries) and modelRegistry
|
|
69
|
+
* (credentials!) into a metrics entry, ballooning degradation.json until
|
|
70
|
+
* JSON.stringify throws 'Invalid string length' and the heap OOMs.
|
|
71
|
+
*/
|
|
72
|
+
function isCtx(val) {
|
|
73
|
+
return (typeof val === "object" &&
|
|
74
|
+
val !== null &&
|
|
75
|
+
("sessionManager" in val || "modelRegistry" in val) &&
|
|
76
|
+
!("turnNumber" in val && "toolCalls" in val));
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Whitelist-copy metrics into a fresh scalar entry. NEVER spread the
|
|
80
|
+
* argument: a ctx-shaped object passed by mistake must not drag the
|
|
81
|
+
* session graph or credentials into persisted state (the
|
|
82
|
+
* OOM: {...ctx} embedded an 8MB sessionManager per heartbeat tick).
|
|
83
|
+
*/
|
|
84
|
+
function toScalarEntry(src, defaults, healthcheckScore) {
|
|
85
|
+
return {
|
|
86
|
+
turnNumber: typeof src.turnNumber === "number" ? src.turnNumber : 0,
|
|
87
|
+
avgTurnDurationMs: typeof src.avgTurnDurationMs === "number" ? src.avgTurnDurationMs : 0,
|
|
88
|
+
toolCalls: typeof src.toolCalls === "number" ? src.toolCalls : 0,
|
|
89
|
+
errors: typeof src.errors === "number" ? src.errors : 0,
|
|
90
|
+
inputTokens: typeof src.inputTokens === "number" ? src.inputTokens : 0,
|
|
91
|
+
outputTokens: typeof src.outputTokens === "number" ? src.outputTokens : 0,
|
|
92
|
+
errorRate: typeof src.errorRate === "number" ? src.errorRate : defaults.errorRate,
|
|
93
|
+
toolSuccessRate: typeof src.toolSuccessRate === "number" ? src.toolSuccessRate : defaults.toolSuccessRate,
|
|
94
|
+
memoryUsagePercent: typeof src.memoryUsagePercent === "number"
|
|
95
|
+
? src.memoryUsagePercent
|
|
96
|
+
: captureSystemMetrics().memoryUsagePercent,
|
|
97
|
+
consecutiveErrors: typeof src.consecutiveErrors === "number"
|
|
98
|
+
? src.consecutiveErrors
|
|
99
|
+
: defaults.consecutiveErrors,
|
|
100
|
+
tokenUsage: {
|
|
101
|
+
input: typeof src.tokenUsage?.input === "number" ? src.tokenUsage.input : 0,
|
|
102
|
+
output: typeof src.tokenUsage?.output === "number" ? src.tokenUsage.output : 0,
|
|
103
|
+
},
|
|
104
|
+
timestamp: Date.now(),
|
|
105
|
+
healthcheckScore,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
// ── Recovery-aware verdict ─────────────────────────────────────────────────
|
|
109
|
+
//
|
|
110
|
+
// The heartbeat feeds the session-CUMULATIVE error share
|
|
111
|
+
// (errors/toolCalls over the whole trajectory). That share decays
|
|
112
|
+
// asymptotically: a resolved error storm kept the verdict negative for
|
|
113
|
+
// dozens of clean turns (a live false whisper fired 23 minutes
|
|
114
|
+
// into a healthy session because 3 overnight errors held the cumulative
|
|
115
|
+
// rate above errorRateMax). The verdict therefore evaluates the TRAILING
|
|
116
|
+
// WINDOW (deltas of the cumulative counters between adjacent entries)
|
|
117
|
+
// plus an explicit clean-streak recovery override, never the decaying
|
|
118
|
+
// cumulative share itself.
|
|
119
|
+
/** Entries (heartbeat snapshots) in the trailing verdict window. */
|
|
120
|
+
const VERDICT_WINDOW = 5;
|
|
121
|
+
/** Clean snapshots (consecutiveErrors === 0) required to clear the metric
|
|
122
|
+
* verdict after a storm. One is not enough: the window may still carry
|
|
123
|
+
* the storm's deltas. */
|
|
124
|
+
const RECOVERY_CLEAN_ENTRIES = 2;
|
|
125
|
+
/** Below this many tool calls in the window the rate clauses are noise
|
|
126
|
+
* (1 error in 2 calls is 50% but not a storm); the storm clause still
|
|
127
|
+
* covers real streaks. */
|
|
128
|
+
const MIN_WINDOW_TOOL_CALLS = 3;
|
|
129
|
+
/** Deltas of the cumulative counters across the window — what actually
|
|
130
|
+
* HAPPENED recently, not the session-average. Adjacent-entry deltas only:
|
|
131
|
+
* each entry's absolute errors/toolCalls carry the whole session history. */
|
|
132
|
+
function windowStats(metrics) {
|
|
133
|
+
let errors = 0;
|
|
134
|
+
let toolCalls = 0;
|
|
135
|
+
for (let i = 1; i < metrics.length; i++) {
|
|
136
|
+
errors += Math.max(0, metrics[i].errors - metrics[i - 1].errors);
|
|
137
|
+
toolCalls += Math.max(0, metrics[i].toolCalls - metrics[i - 1].toolCalls);
|
|
138
|
+
}
|
|
139
|
+
return {
|
|
140
|
+
errors,
|
|
141
|
+
toolCalls,
|
|
142
|
+
errorRate: toolCalls > 0 ? errors / toolCalls : 0,
|
|
143
|
+
toolSuccessRate: toolCalls > 0 ? ((toolCalls - errors) / toolCalls) * 100 : 100,
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
function updateDegradationStatusFrom(state) {
|
|
147
|
+
const recent = state.metrics.slice(-VERDICT_WINDOW);
|
|
148
|
+
if (recent.length === 0) {
|
|
149
|
+
state.isDegraded = false;
|
|
150
|
+
return;
|
|
151
|
+
}
|
|
152
|
+
// Storm clause: consecutive means the CURRENT trailing streak (the
|
|
153
|
+
// newest entry carries the scheduler's trailing-error count). A stale
|
|
154
|
+
// window entry with a high count must not hold the verdict — that
|
|
155
|
+
// `some()` is what kept degraded latched after the storm ended.
|
|
156
|
+
const newest = recent[recent.length - 1];
|
|
157
|
+
if (newest.consecutiveErrors >= state.config.maxConsecutiveErrors) {
|
|
158
|
+
state.isDegraded = true;
|
|
159
|
+
return;
|
|
160
|
+
}
|
|
161
|
+
if (state.lastHealthcheck && state.lastHealthcheck.score < state.config.healthcheckMinScore) {
|
|
162
|
+
state.isDegraded = true;
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
// Recovery override: a streak of clean snapshots proves current tool
|
|
166
|
+
// calls succeed; older window deltas are resolved history. Clear the
|
|
167
|
+
// metric verdict even if the window average is still elevated.
|
|
168
|
+
let cleanStreak = 0;
|
|
169
|
+
for (let i = recent.length - 1; i >= 0 && recent[i].consecutiveErrors === 0; i--)
|
|
170
|
+
cleanStreak++;
|
|
171
|
+
if (cleanStreak >= RECOVERY_CLEAN_ENTRIES) {
|
|
172
|
+
state.isDegraded = false;
|
|
173
|
+
return;
|
|
174
|
+
}
|
|
175
|
+
const win = windowStats(recent);
|
|
176
|
+
if (win.toolCalls >= MIN_WINDOW_TOOL_CALLS) {
|
|
177
|
+
if (win.errorRate > state.config.errorRateMax) {
|
|
178
|
+
state.isDegraded = true;
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
if (win.toolSuccessRate < state.config.toolSuccessMin) {
|
|
182
|
+
state.isDegraded = true;
|
|
183
|
+
return;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
state.isDegraded = false;
|
|
187
|
+
}
|
|
188
|
+
// ── Public API (ctx-aware) ───────────────────────────────────────────────────────
|
|
189
|
+
export function getConfig(ctx) {
|
|
190
|
+
return { ...getStateFrom(ctx).config };
|
|
191
|
+
}
|
|
192
|
+
export function updateConfig(ctxOrPartial, partial) {
|
|
193
|
+
const ctx = typeof ctxOrPartial === "object" && !("healthcheckMinScore" in ctxOrPartial)
|
|
194
|
+
? ctxOrPartial
|
|
195
|
+
: undefined;
|
|
196
|
+
const config = ctx ? partial : ctxOrPartial;
|
|
197
|
+
getStateFrom(ctx).config = { ...getStateFrom(ctx).config, ...config };
|
|
198
|
+
}
|
|
199
|
+
export function recordTurnMetrics(ctxOrMetrics, metrics) {
|
|
200
|
+
const ctx = isCtx(ctxOrMetrics) ? ctxOrMetrics : undefined;
|
|
201
|
+
const actualMetrics = isCtx(ctxOrMetrics)
|
|
202
|
+
? metrics
|
|
203
|
+
: ctxOrMetrics;
|
|
204
|
+
if (!actualMetrics) {
|
|
205
|
+
// ctx passed with no metrics object (or a stray one-arg ctx call) —
|
|
206
|
+
// record nothing rather than guessing. Logging instead of throwing:
|
|
207
|
+
// metrics are advisory, a bad call must not break the turn_end handler.
|
|
208
|
+
_log.warn("recordTurnMetrics called with a ctx-shaped argument and no metrics — entry skipped");
|
|
209
|
+
return;
|
|
210
|
+
}
|
|
211
|
+
const s = getStateFrom(ctx);
|
|
212
|
+
const toolCalls = actualMetrics.toolCalls || 0;
|
|
213
|
+
const errors = actualMetrics.errors || 0;
|
|
214
|
+
const errorRate = actualMetrics.errorRate ?? (toolCalls > 0 ? errors / toolCalls : 0);
|
|
215
|
+
const toolSuccessRate = actualMetrics.toolSuccessRate ??
|
|
216
|
+
(toolCalls > 0 ? ((toolCalls - errors) / toolCalls) * 100 : 100);
|
|
217
|
+
const entry = toScalarEntry(actualMetrics, { errorRate, toolSuccessRate, consecutiveErrors: errors > 0 ? errors : 0 }, s.lastHealthcheck?.score ?? 100);
|
|
218
|
+
s.metrics.push(entry);
|
|
219
|
+
if (s.metrics.length > 100)
|
|
220
|
+
s.metrics = s.metrics.slice(-100);
|
|
221
|
+
updateDegradationStatusFrom(s);
|
|
222
|
+
if (ctx)
|
|
223
|
+
mirrorToGlobal(entry, s.isDegraded);
|
|
224
|
+
}
|
|
225
|
+
export function recordError(ctx) {
|
|
226
|
+
const s = getStateFrom(ctx);
|
|
227
|
+
const last = s.metrics[s.metrics.length - 1];
|
|
228
|
+
if (last) {
|
|
229
|
+
last.consecutiveErrors++;
|
|
230
|
+
last.errorRate = Math.min(1, last.errorRate + 0.1);
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
export function recordToolSuccess(ctx) {
|
|
234
|
+
const s = getStateFrom(ctx);
|
|
235
|
+
const last = s.metrics[s.metrics.length - 1];
|
|
236
|
+
if (last) {
|
|
237
|
+
last.consecutiveErrors = 0;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
export function isDegraded(ctx) {
|
|
241
|
+
return getStateFrom(ctx).isDegraded;
|
|
242
|
+
}
|
|
243
|
+
export function getDegradationReasons(ctx) {
|
|
244
|
+
const reasons = [];
|
|
245
|
+
const s = getStateFrom(ctx);
|
|
246
|
+
const recent = s.metrics.slice(-VERDICT_WINDOW);
|
|
247
|
+
if (recent.length > 0) {
|
|
248
|
+
// Mirror updateDegradationStatusFrom exactly: the newest entry's
|
|
249
|
+
// trailing streak (not `some()` over stale entries) and the trailing
|
|
250
|
+
// window's deltas (not the decaying cumulative share).
|
|
251
|
+
const newest = recent[recent.length - 1];
|
|
252
|
+
if (newest.consecutiveErrors >= s.config.maxConsecutiveErrors)
|
|
253
|
+
reasons.push(`High consecutive errors (max: ${newest.consecutiveErrors})`);
|
|
254
|
+
let cleanStreak = 0;
|
|
255
|
+
for (let i = recent.length - 1; i >= 0 && recent[i].consecutiveErrors === 0; i--)
|
|
256
|
+
cleanStreak++;
|
|
257
|
+
if (cleanStreak < RECOVERY_CLEAN_ENTRIES) {
|
|
258
|
+
const win = windowStats(recent);
|
|
259
|
+
if (win.toolCalls >= MIN_WINDOW_TOOL_CALLS) {
|
|
260
|
+
if (win.errorRate > s.config.errorRateMax)
|
|
261
|
+
reasons.push(`High error rate: ${(win.errorRate * 100).toFixed(1)}%`);
|
|
262
|
+
if (win.toolSuccessRate < s.config.toolSuccessMin)
|
|
263
|
+
reasons.push(`Low tool success: ${win.toolSuccessRate.toFixed(1)}%`);
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
// Always check healthcheck score (doesn't depend on having metrics)
|
|
268
|
+
if (s.lastHealthcheck && s.lastHealthcheck.score < s.config.healthcheckMinScore)
|
|
269
|
+
reasons.push(`Low healthcheck: ${s.lastHealthcheck.score}%`);
|
|
270
|
+
return reasons;
|
|
271
|
+
}
|
|
272
|
+
export function getRecentMetrics(ctxOrCount, count) {
|
|
273
|
+
const ctx = isCtx(ctxOrCount) ? ctxOrCount : undefined;
|
|
274
|
+
const actualCount = typeof ctxOrCount === "number" ? ctxOrCount : count;
|
|
275
|
+
return getStateFrom(ctx).metrics.slice(actualCount ? -actualCount : undefined);
|
|
276
|
+
}
|
|
277
|
+
export function getAllMetrics(ctx) {
|
|
278
|
+
return [...getStateFrom(ctx).metrics];
|
|
279
|
+
}
|
|
280
|
+
export function getMetricsSummary(ctx) {
|
|
281
|
+
const s = getStateFrom(ctx);
|
|
282
|
+
const recent = s.metrics;
|
|
283
|
+
if (recent.length === 0)
|
|
284
|
+
return {
|
|
285
|
+
totalTurns: 0,
|
|
286
|
+
avgHealthcheck: 100,
|
|
287
|
+
avgErrorRate: 0,
|
|
288
|
+
avgToolSuccess: 100,
|
|
289
|
+
degraded: false,
|
|
290
|
+
reasons: [],
|
|
291
|
+
};
|
|
292
|
+
return {
|
|
293
|
+
totalTurns: recent.length,
|
|
294
|
+
avgHealthcheck: recent.reduce((a, m) => a + m.healthcheckScore, 0) / recent.length,
|
|
295
|
+
avgErrorRate: recent.reduce((a, m) => a + m.errorRate, 0) / recent.length,
|
|
296
|
+
avgToolSuccess: recent.reduce((a, m) => a + m.toolSuccessRate, 0) / recent.length,
|
|
297
|
+
degraded: isDegraded(ctx),
|
|
298
|
+
reasons: getDegradationReasons(ctx),
|
|
299
|
+
};
|
|
300
|
+
}
|
|
301
|
+
export async function saveMetrics() {
|
|
302
|
+
try {
|
|
303
|
+
await saveStateImmediate(degradationFilePath(), _global);
|
|
304
|
+
}
|
|
305
|
+
catch (error) {
|
|
306
|
+
_log.error("Failed to save degradation metrics:", error);
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
// ── Sanitize-on-load (OOM follow-up) ─────────────────────────────────
|
|
310
|
+
//
|
|
311
|
+
// The write side whitelists via toScalarEntry, but loadMetrics() had NO
|
|
312
|
+
// filter: a polluted degradation.json on disk was JSON-parsed and spread
|
|
313
|
+
// straight into _global at startup, re-introducing the ctx-shaped entries
|
|
314
|
+
// (9MB sessionManager graphs + modelRegistry credentials) the write-side
|
|
315
|
+
// guard exists to prevent — and re-stringifying them on every heartbeat.
|
|
316
|
+
// Rebuild through the whitelist instead of spreading. Never log dropped
|
|
317
|
+
// entry CONTENT — counts only (credentials may be inside polluted entries).
|
|
318
|
+
/** Entries older than this are stale pollution from before the purge. */
|
|
319
|
+
const METRICS_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
|
|
320
|
+
/** Strings longer than this inside a metric entry are the pollution
|
|
321
|
+
* signature (embedded session graphs), not metric data. */
|
|
322
|
+
const METRIC_ENTRY_MAX_STRING_CHARS = 256;
|
|
323
|
+
/** Scalar values only: primitives (short strings bounded above) or the
|
|
324
|
+
* plain {input, output} token object. Functions, arrays, nested provider
|
|
325
|
+
* objects, and huge strings all fail — the ctx pollution signature. */
|
|
326
|
+
function isScalarMetricValue(val) {
|
|
327
|
+
if (val === null)
|
|
328
|
+
return true;
|
|
329
|
+
const t = typeof val;
|
|
330
|
+
if (t === "number" || t === "boolean")
|
|
331
|
+
return true;
|
|
332
|
+
if (t === "string")
|
|
333
|
+
return val.length <= METRIC_ENTRY_MAX_STRING_CHARS;
|
|
334
|
+
if (t === "object") {
|
|
335
|
+
// Only the tokenUsage shape: exactly { input: number, output: number }.
|
|
336
|
+
const o = val;
|
|
337
|
+
return (!Array.isArray(o) &&
|
|
338
|
+
Object.keys(o).length === 2 &&
|
|
339
|
+
"input" in o &&
|
|
340
|
+
"output" in o &&
|
|
341
|
+
typeof o.input === "number" &&
|
|
342
|
+
typeof o.output === "number");
|
|
343
|
+
}
|
|
344
|
+
return false;
|
|
345
|
+
}
|
|
346
|
+
/** A loadable metric entry: plain object, every value scalar, timestamp
|
|
347
|
+
* present and fresh (<= 30 days). Non-conforming entries are DROPPED,
|
|
348
|
+
* not repaired. */
|
|
349
|
+
function isLoadableMetricEntry(entry) {
|
|
350
|
+
if (typeof entry !== "object" || entry === null || Array.isArray(entry))
|
|
351
|
+
return false;
|
|
352
|
+
const o = entry;
|
|
353
|
+
if (typeof o.timestamp !== "number" || !Number.isFinite(o.timestamp))
|
|
354
|
+
return false;
|
|
355
|
+
if (Date.now() - o.timestamp > METRICS_MAX_AGE_MS)
|
|
356
|
+
return false;
|
|
357
|
+
for (const key of Object.keys(o)) {
|
|
358
|
+
if (!isScalarMetricValue(o[key]))
|
|
359
|
+
return false;
|
|
360
|
+
}
|
|
361
|
+
return true;
|
|
362
|
+
}
|
|
363
|
+
/**
|
|
364
|
+
* Rebuild a DegradationState from whatever is on disk, whitelist-first.
|
|
365
|
+
* Unknown top-level keys are NEVER copied; every field passes a shape
|
|
366
|
+
* check. `dropped` counts filtered metric entries (scalar-check failures,
|
|
367
|
+
* stale timestamps, and the >100 cap) for the count-only warn log.
|
|
368
|
+
*/
|
|
369
|
+
function sanitizeLoadedState(loaded) {
|
|
370
|
+
const next = {
|
|
371
|
+
metrics: [],
|
|
372
|
+
config: { ...DEFAULT_CONFIG },
|
|
373
|
+
isDegraded: _global.isDegraded,
|
|
374
|
+
lastHealthcheck: _global.lastHealthcheck,
|
|
375
|
+
};
|
|
376
|
+
if (typeof loaded !== "object" || loaded === null || Array.isArray(loaded))
|
|
377
|
+
return next;
|
|
378
|
+
const src = loaded;
|
|
379
|
+
let dropped = 0;
|
|
380
|
+
let unknownConfigKeys = 0;
|
|
381
|
+
// metrics: scalar entries only, fresh, capped to the LAST 100 (the
|
|
382
|
+
// write-side cap) — rebuilt via toScalarEntry, never spread.
|
|
383
|
+
if (Array.isArray(src.metrics)) {
|
|
384
|
+
const kept = [];
|
|
385
|
+
for (const raw of src.metrics) {
|
|
386
|
+
if (isLoadableMetricEntry(raw)) {
|
|
387
|
+
const entry = raw;
|
|
388
|
+
kept.push(toScalarEntry(entry, { errorRate: 0, toolSuccessRate: 100, consecutiveErrors: 0 }, typeof entry.healthcheckScore === "number" ? entry.healthcheckScore : 100));
|
|
389
|
+
}
|
|
390
|
+
else {
|
|
391
|
+
dropped++;
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
if (kept.length > 100) {
|
|
395
|
+
dropped += kept.length - 100;
|
|
396
|
+
next.metrics = kept.slice(-100);
|
|
397
|
+
}
|
|
398
|
+
else {
|
|
399
|
+
next.metrics = kept;
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
// config: known scalar fields only, unknown keys dropped.
|
|
403
|
+
if (typeof src.config === "object" && src.config !== null && !Array.isArray(src.config)) {
|
|
404
|
+
const cfg = src.config;
|
|
405
|
+
for (const key of Object.keys(DEFAULT_CONFIG)) {
|
|
406
|
+
if (typeof cfg[key] === "number")
|
|
407
|
+
next.config[key] = cfg[key];
|
|
408
|
+
}
|
|
409
|
+
unknownConfigKeys = Object.keys(cfg).filter((k) => !(k in DEFAULT_CONFIG)).length;
|
|
410
|
+
}
|
|
411
|
+
// lastHealthcheck: shape-valid only (numeric score + timestamp).
|
|
412
|
+
const lh = src.lastHealthcheck;
|
|
413
|
+
if (typeof lh === "object" && lh !== null && !Array.isArray(lh)) {
|
|
414
|
+
const { score, timestamp } = lh;
|
|
415
|
+
if (typeof score === "number" &&
|
|
416
|
+
Number.isFinite(score) &&
|
|
417
|
+
typeof timestamp === "number" &&
|
|
418
|
+
Number.isFinite(timestamp)) {
|
|
419
|
+
next.lastHealthcheck = { score, timestamp };
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
// Remaining state fields: booleans only.
|
|
423
|
+
if (typeof src.isDegraded === "boolean")
|
|
424
|
+
next.isDegraded = src.isDegraded;
|
|
425
|
+
if (dropped > 0 || unknownConfigKeys > 0) {
|
|
426
|
+
_log.warn(`loadMetrics: sanitized loaded state — dropped ${dropped} metric ` +
|
|
427
|
+
`entr${dropped === 1 ? "y" : "ies"}, ignored ${unknownConfigKeys} unknown ` +
|
|
428
|
+
`config key${unknownConfigKeys === 1 ? "" : "s"} (counts only, content never logged)`);
|
|
429
|
+
}
|
|
430
|
+
return next;
|
|
431
|
+
}
|
|
432
|
+
export async function loadMetrics() {
|
|
433
|
+
try {
|
|
434
|
+
const loaded = await loadState(degradationFilePath());
|
|
435
|
+
if (loaded) {
|
|
436
|
+
_global = sanitizeLoadedState(loaded);
|
|
437
|
+
}
|
|
438
|
+
}
|
|
439
|
+
catch (error) {
|
|
440
|
+
_log.error("Failed to load degradation metrics:", error);
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
export function resetMetrics(ctx) {
|
|
444
|
+
const s = getStateFrom(ctx);
|
|
445
|
+
s.metrics = [];
|
|
446
|
+
s.isDegraded = false;
|
|
447
|
+
s.lastHealthcheck = null;
|
|
448
|
+
}
|
|
449
|
+
export function captureSystemMetrics() {
|
|
450
|
+
const freeMem = os.freemem();
|
|
451
|
+
const totalMem = os.totalmem();
|
|
452
|
+
return { memoryUsagePercent: ((totalMem - freeMem) / totalMem) * 100 };
|
|
453
|
+
}
|
|
454
|
+
//# sourceMappingURL=degradation-detector.js.map
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Test-Burst Detector (Part 3 — auto-rollback test-debug guard)
|
|
3
|
+
*
|
|
4
|
+
* Evidence: the checkpoint extension's
|
|
5
|
+
* auto-rollback fired mid-implementation on a LEGITIMATE failing-test loop
|
|
6
|
+
* (error rate 10.6%, bash test-runner invocations), rewound the conversation
|
|
7
|
+
* to turn 21, and cost ~1.4M tokens of cache-invalidated re-prefill. An
|
|
8
|
+
* agent legitimately running failing tests (TDD, gate triage) is NOT a
|
|
9
|
+
* degraded agent — the rollback must not fire on it.
|
|
10
|
+
*
|
|
11
|
+
* Design (brief constraint): fix at the DECISION point (autoRollback's
|
|
12
|
+
* restore step), never by disabling telemetry. The detector keeps a bounded
|
|
13
|
+
* per-session ring of recent tool outcomes (fed from the enforcement
|
|
14
|
+
* tool_result handler) and classifies whether the current error burst is
|
|
15
|
+
* DOMINATED by test-runner invocations:
|
|
16
|
+
* - outputs carry test-runner markers (pass/fail counts, runner banners,
|
|
17
|
+
* assertion errors) or the command is a test-runner invocation;
|
|
18
|
+
* - ZERO errors span non-test tool families — the brief's hard rule:
|
|
19
|
+
* a single non-test failure means genuine degradation, rollback stays
|
|
20
|
+
* exactly as today (no weakening).
|
|
21
|
+
*
|
|
22
|
+
* When suppressed, the watchdog/auto-rollback action downgrades to
|
|
23
|
+
* whisper-only: the degradation advisory still fires, the destructive
|
|
24
|
+
* conversation rewind is withheld.
|
|
25
|
+
*
|
|
26
|
+
* State model: getExtensionState(ctx...) — per-session, no module-level
|
|
27
|
+
* let (lib/state/AGENTS.md contract). The ring is bounded and stores only
|
|
28
|
+
* scalars (tool name + booleans) — no tool output is retained.
|
|
29
|
+
*/
|
|
30
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
31
|
+
/** Minimum test-marked errors in the window before suppression applies. */
|
|
32
|
+
export declare const MIN_BURST_ERRORS = 3;
|
|
33
|
+
/**
|
|
34
|
+
* True when a command/output pair looks like a test-runner invocation.
|
|
35
|
+
* Either signal suffices (command OR output). Both inputs optional —
|
|
36
|
+
* missing telemetry degrades to "not test-like" (conservative: rollback
|
|
37
|
+
* stays for unclassifiable errors).
|
|
38
|
+
*/
|
|
39
|
+
export declare function classifyTestRunnerSignal(command?: string, output?: string): boolean;
|
|
40
|
+
/**
|
|
41
|
+
* Record one tool outcome in the per-session burst ring. Called from the
|
|
42
|
+
* enforcement tool_result handler for EVERY tool result (success and error —
|
|
43
|
+
* successes bound the burst window). Never throws; stores scalars only.
|
|
44
|
+
*
|
|
45
|
+
* @param ctx extension context (session scope)
|
|
46
|
+
* @param toolName tool that produced the result
|
|
47
|
+
* @param isError whether the tool call failed
|
|
48
|
+
* @param signal optional command (bash input) / output text for classification
|
|
49
|
+
*/
|
|
50
|
+
export declare function noteToolOutcomeForBurst(ctx: ExtensionContext, toolName: string, isError: boolean, signal?: {
|
|
51
|
+
command?: string;
|
|
52
|
+
output?: string;
|
|
53
|
+
}): void;
|
|
54
|
+
export interface TestBurstEvaluation {
|
|
55
|
+
/** An error burst exists in the window (>= MIN_BURST_ERRORS errors). */
|
|
56
|
+
burst: boolean;
|
|
57
|
+
/** Errors in the window carrying test-runner markers. */
|
|
58
|
+
testErrors: number;
|
|
59
|
+
/** Errors in the window NOT carrying test-runner markers. */
|
|
60
|
+
nonTestErrors: number;
|
|
61
|
+
/**
|
|
62
|
+
* The burst is test-dominated AND no error spans a non-test tool family —
|
|
63
|
+
* the only condition under which rollback may be downgraded.
|
|
64
|
+
*/
|
|
65
|
+
testDominated: boolean;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Evaluate the recent tool-outcome window. Suppression rule (strict, per
|
|
69
|
+
* brief): suppress the destructive rollback ONLY when the window holds at
|
|
70
|
+
* least MIN_BURST_ERRORS errors, EVERY one of them carries test-runner
|
|
71
|
+
* markers, and zero errors belong to non-test tool families. Any non-test
|
|
72
|
+
* error => genuine degradation => rollback behaves exactly as today.
|
|
73
|
+
*/
|
|
74
|
+
export declare function evaluateTestBurst(ctx: ExtensionContext): TestBurstEvaluation;
|
|
75
|
+
/** Convenience wrapper: should the destructive rollback be withheld? */
|
|
76
|
+
export declare function shouldSuppressRollbackForTestBurst(ctx: ExtensionContext): boolean;
|
|
77
|
+
//# sourceMappingURL=test-burst.d.ts.map
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Test-Burst Detector (Part 3 — auto-rollback test-debug guard)
|
|
3
|
+
*
|
|
4
|
+
* Evidence: the checkpoint extension's
|
|
5
|
+
* auto-rollback fired mid-implementation on a LEGITIMATE failing-test loop
|
|
6
|
+
* (error rate 10.6%, bash test-runner invocations), rewound the conversation
|
|
7
|
+
* to turn 21, and cost ~1.4M tokens of cache-invalidated re-prefill. An
|
|
8
|
+
* agent legitimately running failing tests (TDD, gate triage) is NOT a
|
|
9
|
+
* degraded agent — the rollback must not fire on it.
|
|
10
|
+
*
|
|
11
|
+
* Design (brief constraint): fix at the DECISION point (autoRollback's
|
|
12
|
+
* restore step), never by disabling telemetry. The detector keeps a bounded
|
|
13
|
+
* per-session ring of recent tool outcomes (fed from the enforcement
|
|
14
|
+
* tool_result handler) and classifies whether the current error burst is
|
|
15
|
+
* DOMINATED by test-runner invocations:
|
|
16
|
+
* - outputs carry test-runner markers (pass/fail counts, runner banners,
|
|
17
|
+
* assertion errors) or the command is a test-runner invocation;
|
|
18
|
+
* - ZERO errors span non-test tool families — the brief's hard rule:
|
|
19
|
+
* a single non-test failure means genuine degradation, rollback stays
|
|
20
|
+
* exactly as today (no weakening).
|
|
21
|
+
*
|
|
22
|
+
* When suppressed, the watchdog/auto-rollback action downgrades to
|
|
23
|
+
* whisper-only: the degradation advisory still fires, the destructive
|
|
24
|
+
* conversation rewind is withheld.
|
|
25
|
+
*
|
|
26
|
+
* State model: getExtensionState(ctx...) — per-session, no module-level
|
|
27
|
+
* let (lib/state/AGENTS.md contract). The ring is bounded and stores only
|
|
28
|
+
* scalars (tool name + booleans) — no tool output is retained.
|
|
29
|
+
*/
|
|
30
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
31
|
+
/** Ring window of recent tool outcomes kept per session. */
|
|
32
|
+
const BURST_WINDOW = 12;
|
|
33
|
+
/** Minimum test-marked errors in the window before suppression applies. */
|
|
34
|
+
export const MIN_BURST_ERRORS = 3;
|
|
35
|
+
/** Cap on retained command/output snippets — scalars only, never full output. */
|
|
36
|
+
const SNIPPET_MAX_CHARS = 200;
|
|
37
|
+
function burstState(ctx) {
|
|
38
|
+
return getExtensionState(ctx, "test-burst-guard", () => ({
|
|
39
|
+
outcomes: [],
|
|
40
|
+
}));
|
|
41
|
+
}
|
|
42
|
+
// ── Test-runner classification ───────────────────────────────────────────────
|
|
43
|
+
/**
|
|
44
|
+
* Command lines that are test-runner invocations. Intentionally covers the
|
|
45
|
+
* common JS/TS + polyglot runners; unknown runners fall back to output
|
|
46
|
+
* markers below.
|
|
47
|
+
*/
|
|
48
|
+
const RUNNER_COMMAND_RE = /\b(npm (run )?test|npm test|npx (vitest|jest|mocha|tsc|tsx|playwright)\b|node --test|node -[-]+test|pnpm (run )?test|yarn test|pytest|python -m pytest|cargo test|go test|make test|mvn test|gradle test|vitest|jest|playwright test)\b/;
|
|
49
|
+
/**
|
|
50
|
+
* Test-runner OUTPUT markers: numeric pass/fail counts, runner summary
|
|
51
|
+
* banners, check/cross result marks, assertion errors, TAP lines.
|
|
52
|
+
*/
|
|
53
|
+
const RUNNER_OUTPUT_RE = /\b\d+ (passing|failing|passed|failed)\b|\bTest Suites?:\s*\d+|\bTests?:\s*\d+|\b\d+\/\d+ (tests?|specs?|passing|failing)\b|\bfailures?:\s*\d+|^\s*(ok|not ok) \d+ |\bAssertionError\b|\bexpect\w*\([^)]*\)\s*(to|received)|[✓✔]|(✗|✘)/;
|
|
54
|
+
/**
|
|
55
|
+
* True when a command/output pair looks like a test-runner invocation.
|
|
56
|
+
* Either signal suffices (command OR output). Both inputs optional —
|
|
57
|
+
* missing telemetry degrades to "not test-like" (conservative: rollback
|
|
58
|
+
* stays for unclassifiable errors).
|
|
59
|
+
*/
|
|
60
|
+
export function classifyTestRunnerSignal(command, output) {
|
|
61
|
+
if (command && RUNNER_COMMAND_RE.test(command))
|
|
62
|
+
return true;
|
|
63
|
+
if (output && RUNNER_OUTPUT_RE.test(output))
|
|
64
|
+
return true;
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
// ── Ring feed ────────────────────────────────────────────────────────────────
|
|
68
|
+
/**
|
|
69
|
+
* Record one tool outcome in the per-session burst ring. Called from the
|
|
70
|
+
* enforcement tool_result handler for EVERY tool result (success and error —
|
|
71
|
+
* successes bound the burst window). Never throws; stores scalars only.
|
|
72
|
+
*
|
|
73
|
+
* @param ctx extension context (session scope)
|
|
74
|
+
* @param toolName tool that produced the result
|
|
75
|
+
* @param isError whether the tool call failed
|
|
76
|
+
* @param signal optional command (bash input) / output text for classification
|
|
77
|
+
*/
|
|
78
|
+
export function noteToolOutcomeForBurst(ctx, toolName, isError, signal) {
|
|
79
|
+
try {
|
|
80
|
+
const s = burstState(ctx);
|
|
81
|
+
const command = typeof signal?.command === "string" ? signal.command.slice(0, SNIPPET_MAX_CHARS) : undefined;
|
|
82
|
+
const output = typeof signal?.output === "string" ? signal.output.slice(0, SNIPPET_MAX_CHARS) : undefined;
|
|
83
|
+
s.outcomes.push({
|
|
84
|
+
toolName: String(toolName ?? "").slice(0, SNIPPET_MAX_CHARS),
|
|
85
|
+
isError: Boolean(isError),
|
|
86
|
+
testLike: classifyTestRunnerSignal(command, output),
|
|
87
|
+
ts: Date.now(),
|
|
88
|
+
});
|
|
89
|
+
if (s.outcomes.length > BURST_WINDOW) {
|
|
90
|
+
s.outcomes = s.outcomes.slice(-BURST_WINDOW);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
// guard telemetry never fatal
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Evaluate the recent tool-outcome window. Suppression rule (strict, per
|
|
99
|
+
* brief): suppress the destructive rollback ONLY when the window holds at
|
|
100
|
+
* least MIN_BURST_ERRORS errors, EVERY one of them carries test-runner
|
|
101
|
+
* markers, and zero errors belong to non-test tool families. Any non-test
|
|
102
|
+
* error => genuine degradation => rollback behaves exactly as today.
|
|
103
|
+
*/
|
|
104
|
+
export function evaluateTestBurst(ctx) {
|
|
105
|
+
const result = { burst: false, testErrors: 0, nonTestErrors: 0, testDominated: false };
|
|
106
|
+
try {
|
|
107
|
+
const s = burstState(ctx);
|
|
108
|
+
const window = s.outcomes.slice(-BURST_WINDOW);
|
|
109
|
+
const errors = window.filter((o) => o.isError);
|
|
110
|
+
if (errors.length < MIN_BURST_ERRORS)
|
|
111
|
+
return result;
|
|
112
|
+
result.burst = true;
|
|
113
|
+
result.testErrors = errors.filter((e) => e.testLike).length;
|
|
114
|
+
result.nonTestErrors = errors.length - result.testErrors;
|
|
115
|
+
result.testDominated = result.testErrors >= MIN_BURST_ERRORS && result.nonTestErrors === 0;
|
|
116
|
+
}
|
|
117
|
+
catch {
|
|
118
|
+
// evaluation never fatal — default (no suppression) on any failure
|
|
119
|
+
}
|
|
120
|
+
return result;
|
|
121
|
+
}
|
|
122
|
+
/** Convenience wrapper: should the destructive rollback be withheld? */
|
|
123
|
+
export function shouldSuppressRollbackForTestBurst(ctx) {
|
|
124
|
+
return evaluateTestBurst(ctx).testDominated;
|
|
125
|
+
}
|
|
126
|
+
//# sourceMappingURL=test-burst.js.map
|