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,243 @@
|
|
|
1
|
+
// Compaction failure trace.
|
|
2
|
+
//
|
|
3
|
+
// A failed, aborted, cancelled or empty-summary compaction leaves no trace in
|
|
4
|
+
// the session file on its own: pi-core's session_compact_failed reaches only
|
|
5
|
+
// extension handlers (agent-session.js:326-327), so a post-mortem cannot tell
|
|
6
|
+
// that compaction was attempted, why it failed, or how often it was retried.
|
|
7
|
+
// This module owns the durable transcript trace:
|
|
8
|
+
// one custom session entry per non-success outcome, plus the log line naming
|
|
9
|
+
// the failure class, the span size, and the retry count.
|
|
10
|
+
//
|
|
11
|
+
// The entry lands via pi.appendEntry (pi-core ExtensionAPI, types.d.ts
|
|
12
|
+
// "appendEntry<T>(customType, data)" → sessionManager.appendCustomEntry →
|
|
13
|
+
// _persist → immediate appendFileSync to the session file), the documented
|
|
14
|
+
// write seam that also emits entry_appended so renderers and integrations
|
|
15
|
+
// observe the trace. Plain custom
|
|
16
|
+
// entries are display/state entries: sessionEntryToContextMessages
|
|
17
|
+
// (pi-core session-manager.js:166-193) documents that they never participate
|
|
18
|
+
// in the LLM context, so the trace is visible to operators and session
|
|
19
|
+
// readers without polluting the agent's context or the summarizer's input.
|
|
20
|
+
//
|
|
21
|
+
// Read it back: grep '"context_compaction_failure"' over the session file, or
|
|
22
|
+
// jq 'select(.customType=="context_compaction_failure")' <session>.jsonl.
|
|
23
|
+
|
|
24
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
25
|
+
import { log } from "./shared.js";
|
|
26
|
+
import { getSessionIdSafe, getLeafIdSafe } from "../../../../lib/state/extension-state.js";
|
|
27
|
+
export const COMPACTION_TRACE_ENTRY_TYPE = "context_compaction_failure";
|
|
28
|
+
|
|
29
|
+
/** What kind of non-success outcome this trace records. */ export type CompactionTraceEvent =
|
|
30
|
+
| /** The cycle failed and will not retry (or was retried and failed again). */ "failure"
|
|
31
|
+
/** The cycle was cancelled (user Escape, pi-core signal abort, or an extension cancel). */
|
|
32
|
+
| "aborted"
|
|
33
|
+
/** The verify stage rejected the compaction (empty summary / budget not recovered). */
|
|
34
|
+
| "verify-failed"
|
|
35
|
+
/** The watchdog fired: the cycle showed no completion past the stall threshold. */
|
|
36
|
+
| "stall";
|
|
37
|
+
|
|
38
|
+
/** Coarse failure class carried in the log line and the trace entry. */
|
|
39
|
+
export type CompactionFailureClass =
|
|
40
|
+
| "transient"
|
|
41
|
+
| "context-window"
|
|
42
|
+
| "summary-cap"
|
|
43
|
+
| "threshold"
|
|
44
|
+
| "overflow"
|
|
45
|
+
| "manual"
|
|
46
|
+
| "cancelled"
|
|
47
|
+
| "verify-coherence"
|
|
48
|
+
| "verify-budget"
|
|
49
|
+
| "aborted"
|
|
50
|
+
| "stall"
|
|
51
|
+
| "unknown";
|
|
52
|
+
|
|
53
|
+
export interface CompactionTraceData {
|
|
54
|
+
event: CompactionTraceEvent;
|
|
55
|
+
/** pi-core's cycle trigger: manual | threshold | overflow | undefined. */
|
|
56
|
+
reason?: string;
|
|
57
|
+
/** Coarse failure class (classifyCompactionFailure or the verify reason). */
|
|
58
|
+
failureClass?: string;
|
|
59
|
+
errorMessage?: string;
|
|
60
|
+
/** Messages in this cycle's raw summarization input (absent when unmeasured). */
|
|
61
|
+
spanMessages?: number;
|
|
62
|
+
/** Active retry attempt at trace time (0 = first attempt of the sequence). */
|
|
63
|
+
retryAttempt?: number;
|
|
64
|
+
/** Whether pi-core announced a further retry for this firing. */
|
|
65
|
+
willRetry?: boolean;
|
|
66
|
+
/**
|
|
67
|
+
* Whether the failing content came from this extension's own
|
|
68
|
+
* session_before_compact result (pi-core's fromExtension flag). Separates
|
|
69
|
+
* "braid's bounded/chunked summary failed" from "pi's default summarizer
|
|
70
|
+
* failed" - the first question after a compaction incident. Always false on
|
|
71
|
+
* a cancelled cycle (no compaction was returned), which is why cancelSource
|
|
72
|
+
* is recorded alongside it rather than instead of it.
|
|
73
|
+
*/
|
|
74
|
+
fromExtension?: boolean;
|
|
75
|
+
/** Monotonic per-session compaction cycle counter (session_before_compact firing). */
|
|
76
|
+
cycleId?: number;
|
|
77
|
+
/** Who cancelled the cycle, when known: extension | watchdog (else unset). */
|
|
78
|
+
cancelSource?: string;
|
|
79
|
+
/** Wall time from cycle start (watchdog arm) to this trace, when armed. */
|
|
80
|
+
durationMs?: number;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Classify a failed/aborted cycle. Order matters: explicit cancel markers
|
|
85
|
+
* first, then the error-text classes shared with the retry machinery, then
|
|
86
|
+
* the cycle trigger as the fallback.
|
|
87
|
+
*/
|
|
88
|
+
export function classifyCompactionFailure(input: {
|
|
89
|
+
errorMessage?: string;
|
|
90
|
+
reason?: string;
|
|
91
|
+
aborted?: boolean;
|
|
92
|
+
cancelSource?: string;
|
|
93
|
+
}): CompactionFailureClass {
|
|
94
|
+
const { errorMessage, reason, aborted, cancelSource } = input;
|
|
95
|
+
if (cancelSource === "watchdog") return "stall";
|
|
96
|
+
if (errorMessage && /compaction cancelled/i.test(errorMessage)) return "cancelled";
|
|
97
|
+
if (aborted) return "aborted";
|
|
98
|
+
if (errorMessage) {
|
|
99
|
+
// A length-stopped summarization generation is its own class, distinct
|
|
100
|
+
// from both transient faults and context-window rejections: the REQUEST
|
|
101
|
+
// fit the window (pi-ai clamps max_tokens to window - prompt - 4096), but
|
|
102
|
+
// the generation burned its output budget before finishing the summary
|
|
103
|
+
// (observed: xhigh reasoning on a 185-message range-archive span).
|
|
104
|
+
// pi-core throws it verbatim from getSummarizationFailure, with and
|
|
105
|
+
// without the "Compaction failed: / Auto-compaction failed:" cycle
|
|
106
|
+
// prefixes, so the match keys on the provider-independent suffix.
|
|
107
|
+
if (
|
|
108
|
+
/generation hit the token cap/i.test(errorMessage) ||
|
|
109
|
+
/summary is incomplete/i.test(errorMessage)
|
|
110
|
+
) {
|
|
111
|
+
return "summary-cap";
|
|
112
|
+
}
|
|
113
|
+
// Mirror shared.isTransientCompactionError / isContextWindowError here so
|
|
114
|
+
// the trace names the class without re-running the full routing chain.
|
|
115
|
+
const transient = [
|
|
116
|
+
/529/,
|
|
117
|
+
/overloaded/i,
|
|
118
|
+
/rate.?limit/i,
|
|
119
|
+
/too many requests/i,
|
|
120
|
+
/server error/i,
|
|
121
|
+
/service unavailable/i,
|
|
122
|
+
/503/,
|
|
123
|
+
/502/,
|
|
124
|
+
/network/i,
|
|
125
|
+
/timeout/i,
|
|
126
|
+
/ECONNRESET/i,
|
|
127
|
+
// Stream-cut classes: a summarization stream that ends mid-flight
|
|
128
|
+
// (pi-ai throws "Stream ended without finish_reason") or is terminated
|
|
129
|
+
// by the transport is a transient provider fault, and the trace says so.
|
|
130
|
+
/stream ended/i,
|
|
131
|
+
/terminated/i,
|
|
132
|
+
];
|
|
133
|
+
const contextWindow = [
|
|
134
|
+
/context window exceeds limit/i,
|
|
135
|
+
/context length exceeded/i,
|
|
136
|
+
/maximum context length/i,
|
|
137
|
+
/token limit exceeded/i,
|
|
138
|
+
/too many tokens/i,
|
|
139
|
+
/invalid_request_error.*context/i,
|
|
140
|
+
];
|
|
141
|
+
if (contextWindow.some((p) => p.test(errorMessage))) return "context-window";
|
|
142
|
+
if (transient.some((p) => p.test(errorMessage))) return "transient";
|
|
143
|
+
return "unknown";
|
|
144
|
+
}
|
|
145
|
+
if (reason === "threshold" || reason === "manual") return "threshold";
|
|
146
|
+
if (reason === "overflow") return "overflow";
|
|
147
|
+
return "unknown";
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/** One-line human summary: class, span size, retry count — the post-mortem triad. */
|
|
151
|
+
export function formatCompactionTraceLine(data: CompactionTraceData): string {
|
|
152
|
+
const parts = [
|
|
153
|
+
`class=${data.failureClass ?? "unknown"}`,
|
|
154
|
+
`span=${data.spanMessages ?? "?"} msgs`,
|
|
155
|
+
`retry=${data.retryAttempt ?? 0}`,
|
|
156
|
+
];
|
|
157
|
+
if (data.willRetry) parts.push("will-retry");
|
|
158
|
+
if (data.cancelSource) parts.push(`source=${data.cancelSource}`);
|
|
159
|
+
if (data.durationMs !== undefined) parts.push(`duration=${Math.round(data.durationMs / 1000)}s`);
|
|
160
|
+
if (data.reason) parts.push(`reason=${data.reason}`);
|
|
161
|
+
// Appended last so the established class/span/retry prefix stays byte-stable
|
|
162
|
+
// for log scrapers and fixtures.
|
|
163
|
+
if (data.fromExtension) parts.push("from-extension");
|
|
164
|
+
if (data.cycleId !== undefined) parts.push(`cycle=${data.cycleId}`);
|
|
165
|
+
return parts.join(" ");
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* The appendEntry seam of the extension API: the documented write path for
|
|
170
|
+
* durable custom entries (it wraps the session manager's append and emits
|
|
171
|
+
* entry_appended). Structural so tests can double it without a full API.
|
|
172
|
+
*/
|
|
173
|
+
export interface EntryAppender {
|
|
174
|
+
appendEntry<T = unknown>(customType: string, data?: T): void;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/**
|
|
178
|
+
* Write the durable trace: one custom session entry plus a log line. Every
|
|
179
|
+
* non-success compaction outcome funnels here; the trace must never break the
|
|
180
|
+
* compaction path it describes, so every failure degrades to logging.
|
|
181
|
+
*/
|
|
182
|
+
export function writeCompactionTrace(
|
|
183
|
+
appender: EntryAppender,
|
|
184
|
+
ctx: ExtensionContext,
|
|
185
|
+
data: CompactionTraceData,
|
|
186
|
+
): void {
|
|
187
|
+
try {
|
|
188
|
+
let sessionId: string | undefined;
|
|
189
|
+
let leafId: string | undefined;
|
|
190
|
+
try {
|
|
191
|
+
sessionId = getSessionIdSafe(ctx);
|
|
192
|
+
leafId = getLeafIdSafe(ctx);
|
|
193
|
+
} catch {
|
|
194
|
+
/* identity unavailable - trace degrades to untagged */
|
|
195
|
+
}
|
|
196
|
+
const entryData = {
|
|
197
|
+
event: data.event,
|
|
198
|
+
failureClass: data.failureClass,
|
|
199
|
+
reason: data.reason,
|
|
200
|
+
errorMessage: data.errorMessage,
|
|
201
|
+
spanMessages: data.spanMessages,
|
|
202
|
+
retryAttempt: data.retryAttempt,
|
|
203
|
+
willRetry: data.willRetry,
|
|
204
|
+
fromExtension: data.fromExtension,
|
|
205
|
+
cycleId: data.cycleId,
|
|
206
|
+
cancelSource: data.cancelSource,
|
|
207
|
+
durationMs: data.durationMs,
|
|
208
|
+
sessionId,
|
|
209
|
+
leafId,
|
|
210
|
+
timestamp: new Date().toISOString(),
|
|
211
|
+
};
|
|
212
|
+
// The extension API's appendEntry is the documented write path; the
|
|
213
|
+
// event-handler context types sessionManager as read-only, and reaching
|
|
214
|
+
// through it would also bypass the entry_appended notification.
|
|
215
|
+
try {
|
|
216
|
+
appender.appendEntry(COMPACTION_TRACE_ENTRY_TYPE, entryData);
|
|
217
|
+
} catch (e) {
|
|
218
|
+
log.warn("[context-manager] compaction trace entry append failed:", e);
|
|
219
|
+
}
|
|
220
|
+
log.error(
|
|
221
|
+
`[context-manager] Compaction ${data.event.toUpperCase()}: ` +
|
|
222
|
+
`${formatCompactionTraceLine(data)}` +
|
|
223
|
+
(data.errorMessage ? ` — ${data.errorMessage}` : ""),
|
|
224
|
+
);
|
|
225
|
+
} catch (e) {
|
|
226
|
+
log.warn("[context-manager] compaction trace write failed:", e);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* Count messages in a captured raw summarization input (the pending originals
|
|
232
|
+
* capture) so the trace carries the span size. Returns undefined when the
|
|
233
|
+
* capture is absent/unparseable — degrade to absent, never wrong.
|
|
234
|
+
*/
|
|
235
|
+
export function countSpanMessages(originals: string | undefined): number | undefined {
|
|
236
|
+
if (!originals) return undefined;
|
|
237
|
+
try {
|
|
238
|
+
const parsed = JSON.parse(originals);
|
|
239
|
+
return Array.isArray(parsed) ? parsed.length : undefined;
|
|
240
|
+
} catch {
|
|
241
|
+
return undefined;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
@@ -0,0 +1,366 @@
|
|
|
1
|
+
// Compaction stall watchdog.
|
|
2
|
+
//
|
|
3
|
+
// A stalling in-flight auto-compaction freezes the agent: pi-core's
|
|
4
|
+
// summarization stream has no extension-visible progress signal
|
|
5
|
+
// between session_before_compact and the outcome events, and when the stream
|
|
6
|
+
// stalls mid-flight (headers arrived, body never completes) the compaction
|
|
7
|
+
// promise never settles - no session_compact, no session_compact_failed, no
|
|
8
|
+
// retry, no timeout (stalls have run 25+ minutes frozen at "Auto-compacting...",
|
|
9
|
+
// until an operator Escape). A
|
|
10
|
+
// session abort cancels the in-flight compaction via
|
|
11
|
+
// AgentSession.abortCompaction() (pi-core agent-session.js:1602-1606, aborting
|
|
12
|
+
// the manual + auto + branch-summary AbortControllers) and lands the cycle in
|
|
13
|
+
// session_compact_failed, which returns the agent to its loop.
|
|
14
|
+
//
|
|
15
|
+
// This module automates exactly that. Armed when a compaction cycle starts
|
|
16
|
+
// (session_before_compact), cleared when the cycle ends (session_compact /
|
|
17
|
+
// session_compact_failed / session_shutdown). If no completion arrives within
|
|
18
|
+
// the threshold, it logs one loud line, writes a durable trace entry (the
|
|
19
|
+
// compaction-trace module), marks the cancel source, and calls ctx.abort() -
|
|
20
|
+
// the extension surface's documented cancel path (runner.js "abort: () =>
|
|
21
|
+
// runner.abortFn()" wired to session.abort() at agent-session.js:2064-2070).
|
|
22
|
+
//
|
|
23
|
+
// Silence semantics: pi-core 0.85.1 exposes NO per-chunk or per-retry progress
|
|
24
|
+
// to extensions during a summarization (the retry callbacks
|
|
25
|
+
// _summarizationRetryCallbacks, agent-session.js:1470-1489, emit only to
|
|
26
|
+
// AgentSession's internal listeners, never to the extension runner). Until a
|
|
27
|
+
// progress source exists, notifyCompactionProgress() has no production caller
|
|
28
|
+
// and the silence threshold equals the total-cycle deadline. The API exists
|
|
29
|
+
// so the moment pi-core exposes progress (or a future braid layer feeds it),
|
|
30
|
+
// the deadline extends without redesign - tested by the
|
|
31
|
+
// slow-but-progressing fixture.
|
|
32
|
+
|
|
33
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
34
|
+
import { log, getCmState, isCompactionActive, armCompactionFailsafeCut } from "./shared.js";
|
|
35
|
+
import { triggerFailsafeCompaction } from "./compaction-retry.js";
|
|
36
|
+
import { getExtensionState } from "../../../../lib/state/extension-state.js";
|
|
37
|
+
import { countSpanMessages, writeCompactionTrace, type EntryAppender } from "./compaction-trace.js";
|
|
38
|
+
import { sendTrackedMessage } from "../../../../lib/utils/injection-tracker.js";
|
|
39
|
+
import { USAGE_WHISPER_CRITICAL } from "../../../../lib/detection/context-thresholds.js";
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Silence threshold after which an in-flight compaction is declared stalled
|
|
43
|
+
* and aborted. Justified from the observed data: legitimate summarizations
|
|
44
|
+
* complete in 31-87 s in observed repro runs, the
|
|
45
|
+
* retry backoff ladders add seconds (compaction 3s/6s/12s, overflow 2s/4s/8s,
|
|
46
|
+
* provider retries <= 8s each), while an observed stall ran 25+ minutes with
|
|
47
|
+
* byte-identical token counters. 15 minutes is ~10x the slowest observed
|
|
48
|
+
* legitimate completion and recovers a dead stream well before a
|
|
49
|
+
* multi-minute operator-visible freeze.
|
|
50
|
+
*/
|
|
51
|
+
export const COMPACTION_STALL_THRESHOLD_MS = 900_000;
|
|
52
|
+
|
|
53
|
+
interface CompactionWatchdogState {
|
|
54
|
+
/** Pending deadline timer, or null when disarmed. */
|
|
55
|
+
timer: ReturnType<typeof setTimeout> | null;
|
|
56
|
+
/** Monotonic cycle counter; a stale timer must not fire on a newer cycle. */
|
|
57
|
+
cycleId: number;
|
|
58
|
+
/** Epoch ms when the current deadline expires (undefined when disarmed). */
|
|
59
|
+
deadlineAt: number | undefined;
|
|
60
|
+
/** Epoch ms when the current cycle was armed (stall duration measurement). */
|
|
61
|
+
armedAt: number | undefined;
|
|
62
|
+
/** pi-core reason of the armed cycle (manual | threshold | overflow). */
|
|
63
|
+
armedReason: string | undefined;
|
|
64
|
+
/** Raw summarization-input message count captured at arm time. */
|
|
65
|
+
spanMessages: number | undefined;
|
|
66
|
+
/** Progress notifications received for the armed cycle. */
|
|
67
|
+
progressCount: number;
|
|
68
|
+
/** Silence threshold of the armed cycle (test seam). */
|
|
69
|
+
thresholdMs: number;
|
|
70
|
+
/** The extension API appendEntry seam captured at arm time. */
|
|
71
|
+
appender: EntryAppender | undefined;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const DEFAULT_WATCHDOG_STATE: Omit<CompactionWatchdogState, "thresholdMs"> = {
|
|
75
|
+
timer: null,
|
|
76
|
+
cycleId: 0,
|
|
77
|
+
deadlineAt: undefined,
|
|
78
|
+
armedAt: undefined,
|
|
79
|
+
armedReason: undefined,
|
|
80
|
+
spanMessages: undefined,
|
|
81
|
+
progressCount: 0,
|
|
82
|
+
appender: undefined,
|
|
83
|
+
};
|
|
84
|
+
|
|
85
|
+
function getWatchdogState(ctx: ExtensionContext): CompactionWatchdogState {
|
|
86
|
+
return getExtensionState<CompactionWatchdogState>(
|
|
87
|
+
ctx,
|
|
88
|
+
"context-manager/compaction-watchdog",
|
|
89
|
+
() => ({
|
|
90
|
+
...DEFAULT_WATCHDOG_STATE,
|
|
91
|
+
thresholdMs: COMPACTION_STALL_THRESHOLD_MS,
|
|
92
|
+
}),
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function disarmTimer(state: CompactionWatchdogState): void {
|
|
97
|
+
if (state.timer !== null) {
|
|
98
|
+
clearTimeout(state.timer);
|
|
99
|
+
state.timer = null;
|
|
100
|
+
}
|
|
101
|
+
state.deadlineAt = undefined;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** The watchdog fire block, shared by arm and progress re-arm. */
|
|
105
|
+
function scheduleStallCheck(ctx: ExtensionContext, cycleId: number, sinceLabel: string): void {
|
|
106
|
+
const state = getWatchdogState(ctx);
|
|
107
|
+
const deadline = Date.now() + state.thresholdMs;
|
|
108
|
+
state.deadlineAt = deadline;
|
|
109
|
+
state.timer = setTimeout(() => {
|
|
110
|
+
// A cleared watchdog (null timer) or a replaced cycle must not fire.
|
|
111
|
+
const st = getWatchdogState(ctx);
|
|
112
|
+
if (st.timer === null || st.cycleId !== cycleId) return;
|
|
113
|
+
// Only fire while a compaction is actually in-flight; the outcome stages
|
|
114
|
+
// clear the watchdog, so an armed timer at fire time means no outcome
|
|
115
|
+
// arrived - but guard against the race anyway.
|
|
116
|
+
if (!isCompactionActive(ctx)) {
|
|
117
|
+
disarmTimer(st);
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
const durationMs = st.armedAt !== undefined ? Date.now() - st.armedAt : undefined;
|
|
121
|
+
disarmTimer(st);
|
|
122
|
+
const reason = st.armedReason;
|
|
123
|
+
const spanMessages = st.spanMessages;
|
|
124
|
+
let traceCycleId: number | undefined;
|
|
125
|
+
try {
|
|
126
|
+
traceCycleId = getCmState(ctx).compactionCycleId;
|
|
127
|
+
} catch {
|
|
128
|
+
/* state unavailable - cycle id degrades to absent */
|
|
129
|
+
}
|
|
130
|
+
log.error(
|
|
131
|
+
`[context-manager] Compaction STALLED: no completion event for ` +
|
|
132
|
+
`${Math.round(st.thresholdMs / 1000)}s ${sinceLabel} ` +
|
|
133
|
+
`(duration=${durationMs !== undefined ? Math.round(durationMs / 1000) : "?"}s, ` +
|
|
134
|
+
`class=stall span=${spanMessages ?? "?"} msgs progress-events=${st.progressCount}) - ` +
|
|
135
|
+
`aborting in-flight compaction so the agent returns to its loop`,
|
|
136
|
+
);
|
|
137
|
+
try {
|
|
138
|
+
if (st.appender) {
|
|
139
|
+
writeCompactionTrace(st.appender, ctx, {
|
|
140
|
+
event: "stall",
|
|
141
|
+
reason,
|
|
142
|
+
failureClass: "stall",
|
|
143
|
+
errorMessage: `no completion event within ${Math.round(st.thresholdMs / 1000)}s ${sinceLabel}`,
|
|
144
|
+
spanMessages,
|
|
145
|
+
retryAttempt: 0,
|
|
146
|
+
willRetry: false,
|
|
147
|
+
cancelSource: "watchdog",
|
|
148
|
+
cycleId: traceCycleId,
|
|
149
|
+
durationMs,
|
|
150
|
+
});
|
|
151
|
+
} else {
|
|
152
|
+
log.warn(
|
|
153
|
+
"[context-manager] watchdog fired without an appendEntry seam - trace entry skipped",
|
|
154
|
+
);
|
|
155
|
+
}
|
|
156
|
+
} catch {
|
|
157
|
+
/* trace failures are already logged and degraded inside */
|
|
158
|
+
}
|
|
159
|
+
// Mark the cancel source so session_compact_failed knows this abort was
|
|
160
|
+
// a stall, not an operator action, and can re-issue a bounded retry.
|
|
161
|
+
try {
|
|
162
|
+
getCmState(ctx).cancelSource = "watchdog";
|
|
163
|
+
} catch {
|
|
164
|
+
/* state unavailable - the cancel then records as an external abort */
|
|
165
|
+
}
|
|
166
|
+
try {
|
|
167
|
+
ctx.abort();
|
|
168
|
+
} catch (e) {
|
|
169
|
+
// The runner context asserts liveness before dispatching abort; a
|
|
170
|
+
// watchdog firing into a dying session must never crash the process.
|
|
171
|
+
log.warn("[context-manager] watchdog abort failed:", e);
|
|
172
|
+
}
|
|
173
|
+
}, state.thresholdMs);
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Arm (or re-arm) the stall watchdog for a compaction cycle. Each call
|
|
178
|
+
* replaces any pending timer: re-firings of the same cycle (pi-core's
|
|
179
|
+
* in-cycle double-fire of session_before_compact) simply refresh the
|
|
180
|
+
* deadline; a genuinely new cycle gets a new cycleId so a stale timer can
|
|
181
|
+
* never fire on it.
|
|
182
|
+
*/
|
|
183
|
+
export function armCompactionWatchdog(
|
|
184
|
+
pi: EntryAppender,
|
|
185
|
+
ctx: ExtensionContext,
|
|
186
|
+
opts?: { thresholdMs?: number; reason?: string },
|
|
187
|
+
): void {
|
|
188
|
+
const state = getWatchdogState(ctx);
|
|
189
|
+
const thresholdMs = opts?.thresholdMs ?? COMPACTION_STALL_THRESHOLD_MS;
|
|
190
|
+
disarmTimer(state);
|
|
191
|
+
state.cycleId++;
|
|
192
|
+
state.armedAt = Date.now();
|
|
193
|
+
state.armedReason = opts?.reason;
|
|
194
|
+
state.progressCount = 0;
|
|
195
|
+
state.thresholdMs = thresholdMs;
|
|
196
|
+
state.appender = pi;
|
|
197
|
+
try {
|
|
198
|
+
state.spanMessages = countSpanMessages(getCmState(ctx).pendingCompactionOriginals);
|
|
199
|
+
} catch {
|
|
200
|
+
state.spanMessages = undefined;
|
|
201
|
+
}
|
|
202
|
+
scheduleStallCheck(ctx, state.cycleId, "(cycle start)");
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Report summarization progress for the armed cycle: pushes the stall
|
|
207
|
+
* deadline forward. With no per-chunk progress source in pi-core 0.85.1 this
|
|
208
|
+
* has no production caller yet; it is the seam future progress events wire
|
|
209
|
+
* into (see module header).
|
|
210
|
+
*/
|
|
211
|
+
export function notifyCompactionProgress(ctx: ExtensionContext): void {
|
|
212
|
+
const state = getWatchdogState(ctx);
|
|
213
|
+
if (state.timer === null) return;
|
|
214
|
+
state.progressCount++;
|
|
215
|
+
disarmTimer(state);
|
|
216
|
+
scheduleStallCheck(ctx, state.cycleId, "since last progress");
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Disarm the watchdog. Called on every cycle outcome (success, failure,
|
|
221
|
+
* abort, cancel) and on session shutdown, so a completed compaction can never
|
|
222
|
+
* leave a live timer behind.
|
|
223
|
+
*/
|
|
224
|
+
export function clearCompactionWatchdog(ctx: ExtensionContext): void {
|
|
225
|
+
const state = getWatchdogState(ctx);
|
|
226
|
+
disarmTimer(state);
|
|
227
|
+
state.armedAt = undefined;
|
|
228
|
+
state.armedReason = undefined;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* Epoch ms when the currently armed cycle started, or undefined when disarmed.
|
|
233
|
+
* Read BEFORE clearCompactionWatchdog so an outcome trace can carry the cycle
|
|
234
|
+
* wall time: the failure handler clears the watchdog before it writes the
|
|
235
|
+
* trace, so the armed timestamp is otherwise gone by trace time.
|
|
236
|
+
*/
|
|
237
|
+
export function getCompactionWatchdogArmedAt(ctx: ExtensionContext): number | undefined {
|
|
238
|
+
return getWatchdogState(ctx).armedAt;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
// A summary token-cap abort is the one compaction failure whose own recovery
|
|
242
|
+
// can wedge: the bounded chunked retry is dispatched by a guard
|
|
243
|
+
// (compactionRetryActive), and the observed end state was
|
|
244
|
+
// "Retry skipped - already active" with no landed entry - the session stayed
|
|
245
|
+
// over its threshold and could not compact. The stall watchdog above answers a
|
|
246
|
+
// hung stream; this rule answers a failed one: a summary-cap abort lands one
|
|
247
|
+
// deterministic keep-recent slide (no model call) and names the action, so the
|
|
248
|
+
// class can never be the terminal state of a session. The rule is gated twice
|
|
249
|
+
// so it cannot itself loop: it only fires above the critical usage band (below
|
|
250
|
+
// it the bounded retry ladder owns recovery), and at most once per cooldown
|
|
251
|
+
// window (a second abort inside it is observed, not slid again).
|
|
252
|
+
|
|
253
|
+
export const SUMMARY_CAP_SLIDE_COOLDOWN_MS = 15 * 60 * 1000;
|
|
254
|
+
/** Window over which concurrent summary-cap aborts are counted for the alert. */
|
|
255
|
+
export const SUMMARY_CAP_ABORT_WINDOW_MS = 15 * 60 * 1000;
|
|
256
|
+
/**
|
|
257
|
+
* Usage band above which a summary-cap abort is a loop signal, not a one-off:
|
|
258
|
+
* below it the bounded retry is the cheaper, lossless recovery. Mirrors the
|
|
259
|
+
* band the no-progress fail-safe arms at (USAGE_WHISPER_CRITICAL).
|
|
260
|
+
*/
|
|
261
|
+
export const SUMMARY_CAP_SLIDE_USAGE_THRESHOLD = USAGE_WHISPER_CRITICAL;
|
|
262
|
+
|
|
263
|
+
interface SummaryCapWatchdogState {
|
|
264
|
+
/** Epoch ms of the last automatic deterministic slide (cooldown anchor). */
|
|
265
|
+
lastSlideAt: number | undefined;
|
|
266
|
+
/** Recent summary-cap abort times, pruned to the observation window. */
|
|
267
|
+
abortTimes: number[];
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
function getSummaryCapWatchdogState(ctx: ExtensionContext): SummaryCapWatchdogState {
|
|
271
|
+
return getExtensionState<SummaryCapWatchdogState>(
|
|
272
|
+
ctx,
|
|
273
|
+
"context-manager/summary-cap-watchdog",
|
|
274
|
+
() => ({ lastSlideAt: undefined, abortTimes: [] }),
|
|
275
|
+
);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/**
|
|
279
|
+
* Record a summary-cap abort and, when the gates allow, arm and dispatch one
|
|
280
|
+
* deterministic slide. Returns what the rule did so the caller and its
|
|
281
|
+
* fixtures can assert it. Never throws: a watchdog that crashes the failure
|
|
282
|
+
* path it observes is worse than no watchdog.
|
|
283
|
+
*/
|
|
284
|
+
export function handleSummaryCapAbort(
|
|
285
|
+
pi: ExtensionAPI,
|
|
286
|
+
ctx: ExtensionContext,
|
|
287
|
+
opts: { errorMessage?: string; spanMessages?: number; usagePercent?: number; now?: number } = {},
|
|
288
|
+
): { slid: boolean; reason: string } {
|
|
289
|
+
const state = getSummaryCapWatchdogState(ctx);
|
|
290
|
+
const now = opts.now ?? Date.now();
|
|
291
|
+
state.abortTimes.push(now);
|
|
292
|
+
state.abortTimes = state.abortTimes.filter((t) => now - t <= SUMMARY_CAP_ABORT_WINDOW_MS);
|
|
293
|
+
let usagePercent = opts.usagePercent;
|
|
294
|
+
if (usagePercent === undefined) {
|
|
295
|
+
try {
|
|
296
|
+
usagePercent = getCmState(ctx).preCompactionUsagePercent;
|
|
297
|
+
} catch {
|
|
298
|
+
/* state unavailable - the gate degrades to below-threshold */
|
|
299
|
+
}
|
|
300
|
+
}
|
|
301
|
+
const span = opts.spanMessages ?? "?";
|
|
302
|
+
const abortsInWindow = state.abortTimes.length;
|
|
303
|
+
try {
|
|
304
|
+
if (typeof usagePercent !== "number" || usagePercent < SUMMARY_CAP_SLIDE_USAGE_THRESHOLD) {
|
|
305
|
+
log.error(
|
|
306
|
+
`[context-manager] Summary-cap abort: class=summary-cap span=${span} msgs ` +
|
|
307
|
+
`action=deterministic-slide-skipped reason=below-usage-threshold ` +
|
|
308
|
+
`(usage=${usagePercent ?? "?"}% < ${SUMMARY_CAP_SLIDE_USAGE_THRESHOLD}%) - the bounded retry ladder owns recovery`,
|
|
309
|
+
);
|
|
310
|
+
return { slid: false, reason: "below-usage-threshold" };
|
|
311
|
+
}
|
|
312
|
+
if (
|
|
313
|
+
state.lastSlideAt !== undefined &&
|
|
314
|
+
now - state.lastSlideAt < SUMMARY_CAP_SLIDE_COOLDOWN_MS
|
|
315
|
+
) {
|
|
316
|
+
const remainingSec = Math.ceil(
|
|
317
|
+
(SUMMARY_CAP_SLIDE_COOLDOWN_MS - (now - state.lastSlideAt)) / 1000,
|
|
318
|
+
);
|
|
319
|
+
log.error(
|
|
320
|
+
`[context-manager] Summary-cap abort: class=summary-cap span=${span} msgs ` +
|
|
321
|
+
`action=deterministic-slide-skipped reason=cooldown ${remainingSec}s remaining ` +
|
|
322
|
+
`(aborts-in-window=${abortsInWindow})`,
|
|
323
|
+
);
|
|
324
|
+
return { slid: false, reason: "cooldown" };
|
|
325
|
+
}
|
|
326
|
+
const reason =
|
|
327
|
+
`summary-cap abort (span ${span} msgs, ${abortsInWindow} abort(s) in window, ` +
|
|
328
|
+
`usage ${usagePercent.toFixed(0)}%)`;
|
|
329
|
+
const armed = armCompactionFailsafeCut(ctx, reason);
|
|
330
|
+
if (armed) {
|
|
331
|
+
state.lastSlideAt = now;
|
|
332
|
+
// Deferred: the dispatch must not abort the very turn reporting the
|
|
333
|
+
// failure. If a bounded retry already owns the next cycle the dispatch
|
|
334
|
+
// stands down and that cycle lands the armed cut instead.
|
|
335
|
+
triggerFailsafeCompaction(ctx);
|
|
336
|
+
}
|
|
337
|
+
log.error(
|
|
338
|
+
`[context-manager] Summary-cap abort: class=summary-cap span=${span} msgs ` +
|
|
339
|
+
`action=deterministic-slide-${armed ? "armed" : "already-armed"} usage=${usagePercent.toFixed(0)}%` +
|
|
340
|
+
(opts.errorMessage ? ` error=${opts.errorMessage}` : ""),
|
|
341
|
+
);
|
|
342
|
+
sendTrackedMessage(
|
|
343
|
+
pi,
|
|
344
|
+
{
|
|
345
|
+
customType: "context",
|
|
346
|
+
content: [
|
|
347
|
+
{
|
|
348
|
+
type: "text" as const,
|
|
349
|
+
text:
|
|
350
|
+
`[warn] Summary-cap abort (class=summary-cap, span ${span} msgs) at ${usagePercent.toFixed(0)}% context. ` +
|
|
351
|
+
`A bounded chunked retry can wedge on "already active", so the deterministic keep-recent slide ` +
|
|
352
|
+
`(no LLM) is ${armed ? "armed" : "already armed"} for the next compaction. ` +
|
|
353
|
+
`At most one automatic slide per ${Math.round(SUMMARY_CAP_SLIDE_COOLDOWN_MS / 60000)} min.`,
|
|
354
|
+
},
|
|
355
|
+
],
|
|
356
|
+
display: true,
|
|
357
|
+
},
|
|
358
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
359
|
+
{ type: "context", source: "context-manager/compaction/summary-cap-watchdog" },
|
|
360
|
+
);
|
|
361
|
+
return { slid: armed, reason: armed ? "armed" : "already-armed" };
|
|
362
|
+
} catch (e) {
|
|
363
|
+
log.warn("[context-manager] summary-cap watchdog rule failed:", e);
|
|
364
|
+
return { slid: false, reason: "error" };
|
|
365
|
+
}
|
|
366
|
+
}
|