pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,961 @@
|
|
|
1
|
+
// Context-Manager Shared State & Helpers
|
|
2
|
+
// Shared across all handler modules. Module-level singletons + session-scoped factories.
|
|
3
|
+
|
|
4
|
+
import { getExtensionState } from "../../../../lib/state/extension-state.js";
|
|
5
|
+
import { createLogger } from "../../../../lib/core/logger.js";
|
|
6
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
7
|
+
import { createPruningState } from "../pruning.js";
|
|
8
|
+
import { getSessionManager } from "../../../../lib/state/session-manager.js";
|
|
9
|
+
import { sendTrackedMessage } from "../../../../lib/utils/injection-tracker.js";
|
|
10
|
+
import { getRotationState } from "../../../../lib/state/global-state.js";
|
|
11
|
+
|
|
12
|
+
export const log = createLogger("context-manager");
|
|
13
|
+
|
|
14
|
+
// Internal tool detection
|
|
15
|
+
export const INTERNAL_TOOLS = new Set([
|
|
16
|
+
"context_navigate",
|
|
17
|
+
"context_compress",
|
|
18
|
+
"context_inspect",
|
|
19
|
+
"context_proposals",
|
|
20
|
+
"offload_recover",
|
|
21
|
+
"think",
|
|
22
|
+
"hypothesize",
|
|
23
|
+
"finalize",
|
|
24
|
+
"heuristics_evaluate",
|
|
25
|
+
"cognition_evaluate",
|
|
26
|
+
"memory_store",
|
|
27
|
+
"memory",
|
|
28
|
+
"goal",
|
|
29
|
+
"plan",
|
|
30
|
+
"scratchpad",
|
|
31
|
+
"health_maintenance",
|
|
32
|
+
]);
|
|
33
|
+
|
|
34
|
+
export function isInternal(toolName: string): boolean {
|
|
35
|
+
return INTERNAL_TOOLS.has(toolName);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
// Session-scoped state
|
|
39
|
+
import type { CompressionStats } from "../semantic-compress.js";
|
|
40
|
+
|
|
41
|
+
interface CmState {
|
|
42
|
+
checkoutParams: { target: string; newId: string; targetId: string; backupTag?: string } | null;
|
|
43
|
+
pruningState: any;
|
|
44
|
+
overflowNotified?: boolean;
|
|
45
|
+
// H5: Retry guards for compaction/overflow (prevents double-trigger)
|
|
46
|
+
compactionRetryActive?: boolean;
|
|
47
|
+
overflowRetryActive?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* Consecutive compaction cycles that ended without landing an entry
|
|
50
|
+
* (failure, abort, or verify rejection) while the session sat at or above
|
|
51
|
+
* the critical usage band. Reset by any landed compaction. Read by the
|
|
52
|
+
* failure routing: at COMPACTION_NO_PROGRESS_LIMIT the next cycle takes the
|
|
53
|
+
* deterministic cut instead of trying a summarizer that has already failed.
|
|
54
|
+
*/
|
|
55
|
+
compactionNoProgress?: number;
|
|
56
|
+
/**
|
|
57
|
+
* The deterministic cut armed for the next compaction cycle. Present means
|
|
58
|
+
* the session is known to be unable to summarize its own context at this
|
|
59
|
+
* usage; the next session_before_compact returns this cut instead of
|
|
60
|
+
* handing a span to a summarizer (pi-core consumes an extension compaction
|
|
61
|
+
* result verbatim and skips its own call). One-shot, and cleared by any
|
|
62
|
+
* landed compaction.
|
|
63
|
+
*/
|
|
64
|
+
compactionFailsafeCut?: FailsafeCutState;
|
|
65
|
+
/** Compression metadata from the last semantic compression pass. */
|
|
66
|
+
lastCompressionStats?: CompressionStats & {
|
|
67
|
+
turnRange: { from: number; to: number };
|
|
68
|
+
timestamp: number;
|
|
69
|
+
};
|
|
70
|
+
/** Slide-mode state for deterministic sliding-window compaction. */
|
|
71
|
+
slideMode?: SlideModeState | null;
|
|
72
|
+
/** Archive range-mode state for commitment-preserving archive compactions. */
|
|
73
|
+
rangeMode?: RangeModeState | null;
|
|
74
|
+
/**
|
|
75
|
+
* Bounded-recovery state armed by a summary token-cap failure; consumed by
|
|
76
|
+
* the retry cycle's session_before_compact (chunked summarization, reasoning
|
|
77
|
+
* off). Cleared by the consuming branch, the success handler, and the
|
|
78
|
+
* failure routing so a stale flag never hijacks an unrelated cycle.
|
|
79
|
+
*/
|
|
80
|
+
pendingSummaryCapRecovery?: SummaryCapRecoveryState;
|
|
81
|
+
/**
|
|
82
|
+
* The declared range stashed by the range branch so a failed range-archive
|
|
83
|
+
* cycle can be re-armed as range mode on its summary-cap retry cycle
|
|
84
|
+
* (retry cycles recompute pi-core's default span, which would silently drop
|
|
85
|
+
* the declaration). Cleared on success and consumed by the failure routing.
|
|
86
|
+
*/
|
|
87
|
+
pendingRangeArchive?: RangeModeState;
|
|
88
|
+
/**
|
|
89
|
+
* Thinking level captured when the summarizer thinking-off switch armed,
|
|
90
|
+
* restored at the cycle outcome. Absent means the switch is not armed.
|
|
91
|
+
*/
|
|
92
|
+
pendingSummarizerThinkingLevel?: string;
|
|
93
|
+
/**
|
|
94
|
+
* Whether a compaction was already in-flight when the current cycle's
|
|
95
|
+
* session_before_compact firing began (P2a). Captured BEFORE the cycle is
|
|
96
|
+
* marked active, carried to the session_compact_failed abort branch to tag
|
|
97
|
+
* the abort telemetry.
|
|
98
|
+
*/
|
|
99
|
+
inFlightBeforeCapture?: boolean;
|
|
100
|
+
/**
|
|
101
|
+
* Monotonic counter of this session's compaction cycle firings, incremented
|
|
102
|
+
* at session_before_compact (the watchdog arm site) and written into every
|
|
103
|
+
* compaction trace as `cycleId`. Without it a retry ladder is reconstructable
|
|
104
|
+
* only by entry ordering; with it, an outcome names the attempt it belongs
|
|
105
|
+
* to. Mirrors the watchdog's own per-arm counter.
|
|
106
|
+
*/
|
|
107
|
+
compactionCycleId?: number;
|
|
108
|
+
/**
|
|
109
|
+
* Fingerprint of the current compaction cycle's INPUT (Pattern 8 delta-only
|
|
110
|
+
* skip). Computed at session_before_compact (before the branch is mutated),
|
|
111
|
+
* recorded into lastCompactionFingerprints on successful compaction, cleared
|
|
112
|
+
* on failure/abort.
|
|
113
|
+
*/
|
|
114
|
+
pendingCompactionFingerprint?: string;
|
|
115
|
+
/**
|
|
116
|
+
* Per-leaf (sessionId::leafId) fingerprints of the last SUCCESSFUL compaction
|
|
117
|
+
* input. A later auto-compaction whose input fingerprint matches is skipped
|
|
118
|
+
* (no re-summarization of identical content — silent re-prime starvation).
|
|
119
|
+
*/
|
|
120
|
+
lastCompactionFingerprints?: Record<string, string>;
|
|
121
|
+
/**
|
|
122
|
+
* Pre-compaction context usage (percent) captured at session_before_compact
|
|
123
|
+
* (the session_before_compact stage). Reuses the analyzeSession already performed there; consumed
|
|
124
|
+
* by the session_compact verify stage to check that the compaction actually
|
|
125
|
+
* recovered budget (post-compaction usage strictly below this, <=1pp slack).
|
|
126
|
+
* Cleared at the start of each compaction cycle so a stale value from a
|
|
127
|
+
* previous cycle can never trigger a false budget failure.
|
|
128
|
+
*/
|
|
129
|
+
preCompactionUsagePercent?: number;
|
|
130
|
+
/**
|
|
131
|
+
* Set when the session_compact verify stage rejects a "successful" compaction
|
|
132
|
+
* (empty/boilerplate summary or budget not recovered). Records the failure
|
|
133
|
+
* truthfully on the archive path; it is NOT a gate anymore (the append-only
|
|
134
|
+
* originals archive is always-on per option B P1). Cleared by
|
|
135
|
+
* writeOriginalsArchive's finally, along with the capture.
|
|
136
|
+
*/
|
|
137
|
+
verifyFailed?: boolean;
|
|
138
|
+
/**
|
|
139
|
+
* Who cancelled the current cycle, when the cancellation came from inside
|
|
140
|
+
* this extension: "extension" (a session_before_compact cancel return, e.g.
|
|
141
|
+
* the fingerprint skip), "watchdog" (the stall watchdog's ctx.abort()), or
|
|
142
|
+
* "summary-cap" (the bounded chunked path itself failed with a
|
|
143
|
+
* summary-cap-class error and the cycle was cancelled instead of falling
|
|
144
|
+
* through to pi-core's unbounded summarizer). Read and cleared by the
|
|
145
|
+
* session_compact_failed handler so an abort can be attributed (user Escape
|
|
146
|
+
* leaves it unset). Cleared at fresh-cycle start so a stale source never
|
|
147
|
+
* mislabels a later abort.
|
|
148
|
+
*/
|
|
149
|
+
cancelSource?: "extension" | "watchdog" | "summary-cap";
|
|
150
|
+
/**
|
|
151
|
+
* The chunked summary's error text behind a "summary-cap" cancelSource
|
|
152
|
+
* cancel. Read and cleared by the session_compact_failed handler (the
|
|
153
|
+
* retry warn and the trace name the real error); cleared at fresh-cycle
|
|
154
|
+
* start with cancelSource so a stale text never mislabels a later cycle.
|
|
155
|
+
*/
|
|
156
|
+
summaryCapCancelError?: string;
|
|
157
|
+
/**
|
|
158
|
+
* JSON serialization of the RAW compaction input (prep.messagesToSummarize)
|
|
159
|
+
* captured at session_before_compact — AFTER the fingerprint
|
|
160
|
+
* block, BEFORE the semantic-compression block (which replaces
|
|
161
|
+
* prep.messagesToSummarize in place, so the capture must see the raw
|
|
162
|
+
* originals). Consumed by the session_compact append-only originals archive
|
|
163
|
+
* write (always-on, on both the success and verify-failure
|
|
164
|
+
* paths); cleared on the session_compact outcome stage and on every
|
|
165
|
+
* session_compact_failed path so a stale capture never leaks into a later
|
|
166
|
+
* cycle.
|
|
167
|
+
*/
|
|
168
|
+
pendingCompactionOriginals?: string;
|
|
169
|
+
/**
|
|
170
|
+
* Lazy per-session navigation-adoption counters.
|
|
171
|
+
* Created ONLY when a navigation/compression action actually succeeds —
|
|
172
|
+
* absent means the agent has not steered anywhere this session.
|
|
173
|
+
*/
|
|
174
|
+
navigationAdoption?: NavigationAdoption;
|
|
175
|
+
/**
|
|
176
|
+
* ToolCallId → ISO timestamp of the first offloader flush, so the stub
|
|
177
|
+
* rendered into the per-request context stays byte-identical across LLM
|
|
178
|
+
* calls within a session (idempotent substitution). Lazily initialized by
|
|
179
|
+
* the offloader handler when the setting is enabled.
|
|
180
|
+
*/
|
|
181
|
+
offloadIsoByToolCallId?: Record<string, string>;
|
|
182
|
+
/**
|
|
183
|
+
* ToolCallId → emergency stub record. Populated ONLY by an
|
|
184
|
+
* emergency offload run (context_window/413 error path); consumed by the
|
|
185
|
+
* context-emergency `context` handler to substitute stubs into the
|
|
186
|
+
* per-request context on every LLM call until the session rotates. Session-
|
|
187
|
+
* scoped via getExtensionState — never process-global.
|
|
188
|
+
*/
|
|
189
|
+
emergencyStubsByToolCallId?: Record<string, import("./context-emergency.js").EmergencyStubRecord>;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* State for the sliding-window compaction action (action="slide").
|
|
194
|
+
* Stored per-session via getExtensionState, consumed by session_before_compact.
|
|
195
|
+
*/
|
|
196
|
+
export interface SlideModeState {
|
|
197
|
+
/** Whether slide mode is active for the current compaction cycle. */
|
|
198
|
+
active: boolean;
|
|
199
|
+
/** Entry ID to start keeping from (cut point). */
|
|
200
|
+
cutEntryId: string;
|
|
201
|
+
/** Number of entries to keep (the `keep` parameter). */
|
|
202
|
+
keepCount: number;
|
|
203
|
+
/** Number of entries dropped before the cut point. */
|
|
204
|
+
droppedCount: number;
|
|
205
|
+
/** Timestamp when slide mode was activated. */
|
|
206
|
+
timestamp: number;
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* State for the declared archive range (action="archive").
|
|
211
|
+
* Stored per-session via getExtensionState, consumed by session_before_compact.
|
|
212
|
+
* Carries the user's `summary` as the commitment-preserving anchor so the
|
|
213
|
+
* compaction summarizing LLM folds intent/changes/decisions/next-steps forward.
|
|
214
|
+
*/
|
|
215
|
+
export interface RangeModeState {
|
|
216
|
+
/** Whether range mode is active for the current compaction cycle. */
|
|
217
|
+
active: boolean;
|
|
218
|
+
/** First entry index of the declared span. */
|
|
219
|
+
startIndex: number;
|
|
220
|
+
/** Last entry index of the declared span (inclusive). */
|
|
221
|
+
endIndex: number;
|
|
222
|
+
/** User-provided summary that must anchor the compaction summary. */
|
|
223
|
+
summary: string;
|
|
224
|
+
/** Topic label for the declared span. */
|
|
225
|
+
topic: string;
|
|
226
|
+
/** Entry id at endIndex+1 — the compaction boundary AFTER the declared span. */
|
|
227
|
+
firstKeptEntryId?: string;
|
|
228
|
+
/** True when the declared span reaches the branch end (no post-span entry to keep). */
|
|
229
|
+
boundaryIsBranchEnd: boolean;
|
|
230
|
+
/** Timestamp when range mode was activated. */
|
|
231
|
+
timestamp: number;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Recovery state armed by a summary token-cap failure (class "summary-cap").
|
|
236
|
+
* Consumed by the retry cycle's session_before_compact, which replaces the
|
|
237
|
+
* default summarization with a bounded chunked summary (reasoning off).
|
|
238
|
+
*/
|
|
239
|
+
export interface SummaryCapRecoveryState {
|
|
240
|
+
/** Retry attempt the recovery was armed for (1-based, mirrors compactionRetryState). */
|
|
241
|
+
attempt: number;
|
|
242
|
+
/** Epoch ms when the recovery was armed (diagnostics only). */
|
|
243
|
+
armedAt: number;
|
|
244
|
+
/** Range anchor to fold into the chunked summary, when the failed cycle was a range archive. */
|
|
245
|
+
anchor?: { topic: string; summary: string };
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
export function getCmState(ctx: ExtensionContext): CmState {
|
|
249
|
+
return getExtensionState<CmState>(ctx, "context-manager", () => ({
|
|
250
|
+
checkoutParams: null,
|
|
251
|
+
pruningState: createPruningState(),
|
|
252
|
+
overflowNotified: false,
|
|
253
|
+
// H5: Retry guards initialized to false (prevents double-trigger)
|
|
254
|
+
compactionRetryActive: false,
|
|
255
|
+
overflowRetryActive: false,
|
|
256
|
+
compactionNoProgress: 0,
|
|
257
|
+
compactionFailsafeCut: undefined,
|
|
258
|
+
slideMode: null,
|
|
259
|
+
rangeMode: null,
|
|
260
|
+
pendingCompactionFingerprint: undefined,
|
|
261
|
+
lastCompactionFingerprints: {},
|
|
262
|
+
preCompactionUsagePercent: undefined,
|
|
263
|
+
verifyFailed: false,
|
|
264
|
+
pendingCompactionOriginals: undefined,
|
|
265
|
+
cancelSource: undefined,
|
|
266
|
+
summaryCapCancelError: undefined,
|
|
267
|
+
compactionCycleId: 0,
|
|
268
|
+
}));
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
// Navigation Adoption Counters
|
|
272
|
+
// Per-session counters measuring whether the agent STEERS with
|
|
273
|
+
// loss-preferring navigation (tag/checkout/log/archive/slide) instead of
|
|
274
|
+
// destructive compact. Fixed 7 kinds — no free-form counters. LONG-
|
|
275
|
+
// RUNNING-SESSIONS.md success metrics: "navigation adoption per long
|
|
276
|
+
// session ... trending up, compaction-per-session trending down". The block
|
|
277
|
+
// is lazily initialized by recordNavigationAction so an untouched session
|
|
278
|
+
// stays free of the field.
|
|
279
|
+
|
|
280
|
+
export interface NavigationAdoption {
|
|
281
|
+
tags: number;
|
|
282
|
+
checkouts: number;
|
|
283
|
+
logs: number;
|
|
284
|
+
archives: number;
|
|
285
|
+
slides: number;
|
|
286
|
+
compacts: number;
|
|
287
|
+
deepCleans: number;
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
export type NavigationActionKind =
|
|
291
|
+
| "tag"
|
|
292
|
+
| "checkout"
|
|
293
|
+
| "log"
|
|
294
|
+
| "archive"
|
|
295
|
+
| "slide"
|
|
296
|
+
| "compact"
|
|
297
|
+
| "deep_clean";
|
|
298
|
+
|
|
299
|
+
const NAVIGATION_KIND_FIELD: Record<NavigationActionKind, keyof NavigationAdoption> = {
|
|
300
|
+
tag: "tags",
|
|
301
|
+
checkout: "checkouts",
|
|
302
|
+
log: "logs",
|
|
303
|
+
archive: "archives",
|
|
304
|
+
slide: "slides",
|
|
305
|
+
compact: "compacts",
|
|
306
|
+
deep_clean: "deepCleans",
|
|
307
|
+
};
|
|
308
|
+
|
|
309
|
+
/**
|
|
310
|
+
* Lazily initialize the session navigation-adoption counter block and
|
|
311
|
+
* increment one fixed kind. Callers invoke this ONLY after the action has
|
|
312
|
+
* truly succeeded (the archive was declared, the compact was scheduled, the
|
|
313
|
+
* tag was written) — abort/error/no-op paths must never reach this helper so
|
|
314
|
+
* the counters measure real steering, not intent.
|
|
315
|
+
*/
|
|
316
|
+
export function recordNavigationAction(ctx: ExtensionContext, kind: NavigationActionKind): void {
|
|
317
|
+
const state = getCmState(ctx);
|
|
318
|
+
if (!state.navigationAdoption) {
|
|
319
|
+
state.navigationAdoption = {
|
|
320
|
+
tags: 0,
|
|
321
|
+
checkouts: 0,
|
|
322
|
+
logs: 0,
|
|
323
|
+
archives: 0,
|
|
324
|
+
slides: 0,
|
|
325
|
+
compacts: 0,
|
|
326
|
+
deepCleans: 0,
|
|
327
|
+
};
|
|
328
|
+
}
|
|
329
|
+
state.navigationAdoption[NAVIGATION_KIND_FIELD[kind]]++;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
/**
|
|
333
|
+
* One-line navigation-adoption summary for context_inspect detail=detailed.
|
|
334
|
+
* Loss-preferring navigation (tag/checkout/archive/slide, plus deep-cleans)
|
|
335
|
+
* is visually separated from destructive compacts. Returns null when no
|
|
336
|
+
* navigation action has succeeded yet (must not show an empty line).
|
|
337
|
+
*/
|
|
338
|
+
export function formatNavigationAdoptionLine(na?: NavigationAdoption): string | null {
|
|
339
|
+
if (!na) return null;
|
|
340
|
+
return (
|
|
341
|
+
`navigation: ${na.tags} tags / ${na.checkouts} checkouts / ${na.logs} logs · ` +
|
|
342
|
+
`archives ${na.archives} / slides ${na.slides} (deep-cleans ${na.deepCleans}) vs compacts ${na.compacts}`
|
|
343
|
+
);
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
// Module-level retry state (process-scoped, not session-scoped)
|
|
347
|
+
export interface RetryState {
|
|
348
|
+
attempt: number;
|
|
349
|
+
lastError: string;
|
|
350
|
+
lastReason: string;
|
|
351
|
+
retryTimeout: ReturnType<typeof setTimeout> | null;
|
|
352
|
+
/**
|
|
353
|
+
* True from the moment a retry of this ladder is dispatched (the timer
|
|
354
|
+
* fired and ctx.compact() was called) until that cycle reports its outcome.
|
|
355
|
+
*
|
|
356
|
+
* The dispatch is pi-core's MANUAL compaction entry point, which begins by
|
|
357
|
+
* aborting the in-flight turn and every in-flight compaction controller, so
|
|
358
|
+
* the resulting turn_end lands BEFORE the dispatched cycle's own outcome.
|
|
359
|
+
* The turn-end reset keys on the absence of a pending timer, which the
|
|
360
|
+
* dispatch has already cleared - so without this flag the reset erases the
|
|
361
|
+
* attempt the retry was spending, every later failure restarts at attempt 1,
|
|
362
|
+
* and the exhausted rungs (the ladder's only terminal states) stay
|
|
363
|
+
* unreachable.
|
|
364
|
+
*/
|
|
365
|
+
inFlight: boolean;
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
export const compactionRetryState: RetryState = {
|
|
369
|
+
attempt: 0,
|
|
370
|
+
lastError: "",
|
|
371
|
+
lastReason: "",
|
|
372
|
+
retryTimeout: null,
|
|
373
|
+
inFlight: false,
|
|
374
|
+
};
|
|
375
|
+
|
|
376
|
+
export const overflowRetryState: RetryState = {
|
|
377
|
+
attempt: 0,
|
|
378
|
+
lastError: "",
|
|
379
|
+
lastReason: "",
|
|
380
|
+
retryTimeout: null,
|
|
381
|
+
inFlight: false,
|
|
382
|
+
};
|
|
383
|
+
|
|
384
|
+
// Compaction-active state is per-session. The accessor functions here are
|
|
385
|
+
// a stable API; the underlying storage is session-scoped via
|
|
386
|
+
// getExtensionState (a module-level flag would leak across sessions).
|
|
387
|
+
|
|
388
|
+
interface CompactionActiveState {
|
|
389
|
+
active: boolean;
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
function getCompactionActiveState(ctx: ExtensionContext): CompactionActiveState {
|
|
393
|
+
return getExtensionState(ctx, "context-manager/compaction-active", () => ({
|
|
394
|
+
active: false,
|
|
395
|
+
}));
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
export function isCompactionActive(ctx?: ExtensionContext): boolean {
|
|
399
|
+
// Module-level call (no ctx) is supported for backward compat; returns
|
|
400
|
+
// the FIRST session's value, which is OK in pi's single-session-per-process.
|
|
401
|
+
if (!ctx) {
|
|
402
|
+
return _fallbackActive;
|
|
403
|
+
}
|
|
404
|
+
return getCompactionActiveState(ctx).active;
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
export function setCompactionActive(value: boolean, ctx: ExtensionContext): void {
|
|
408
|
+
getCompactionActiveState(ctx).active = value;
|
|
409
|
+
// Mirror to module-level fallback for ctx-less callers.
|
|
410
|
+
_fallbackActive = value;
|
|
411
|
+
}
|
|
412
|
+
|
|
413
|
+
// Module-level fallback used when callers don't have ctx. Updated by
|
|
414
|
+
// setCompactionActive() with the most recent value. In pi-core's
|
|
415
|
+
// single-session-per-process model this is equivalent to per-session.
|
|
416
|
+
let _fallbackActive = false;
|
|
417
|
+
|
|
418
|
+
// Constants
|
|
419
|
+
export const COMPACTION_RETRY_MAX_ATTEMPTS = 3;
|
|
420
|
+
export const OVERFLOW_RETRY_MAX_ATTEMPTS = 3;
|
|
421
|
+
export const OVERFLOW_RETRY_KEEP_REDUCTION_FACTOR = 0.6;
|
|
422
|
+
export const COMPACTION_RETRY_CUSTOM_TYPE = "__compaction_retry_trigger";
|
|
423
|
+
|
|
424
|
+
// Navigation helpers.
|
|
425
|
+
// Contract: resolveTarget returns null for any target that does not resolve
|
|
426
|
+
// to a real entry in the current session — passing a non-existent target to
|
|
427
|
+
// sm.branchWithSummary() fails upstream ("Entry not found"), and aborting on
|
|
428
|
+
// it kills the turn with a half-checked-out session. The caller is responsible
|
|
429
|
+
// for proposing a recovery via getRecoveryFallback() rather than dead-ending
|
|
430
|
+
// the turn.
|
|
431
|
+
export function resolveTarget(ctx: ExtensionContext, target?: string): string | null {
|
|
432
|
+
if (!target) return null;
|
|
433
|
+
const sm = getSessionManager(ctx);
|
|
434
|
+
const tree = sm.getTree();
|
|
435
|
+
if (tree.length === 0) return null;
|
|
436
|
+
|
|
437
|
+
if (target.toLowerCase() === "root") {
|
|
438
|
+
return tree[0].entry.id;
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
// Accept an 8+ hex-char ID only if it actually exists in the current
|
|
442
|
+
// session — a blind accept would let cross-session IDs leak through and
|
|
443
|
+
// fail upstream.
|
|
444
|
+
if (/^[0-9a-f]{8,}$/i.test(target)) {
|
|
445
|
+
for (const node of tree) {
|
|
446
|
+
if (node.entry.id === target) return target;
|
|
447
|
+
}
|
|
448
|
+
return null;
|
|
449
|
+
}
|
|
450
|
+
|
|
451
|
+
// Label lookup.
|
|
452
|
+
for (const node of tree) {
|
|
453
|
+
if (sm.getLabel(node.entry.id) === target) return node.entry.id;
|
|
454
|
+
}
|
|
455
|
+
return null;
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
/**
|
|
459
|
+
* Get a recovery target when the requested target is not in the current
|
|
460
|
+
* session. Priority: (1) most recent tag, (2) the most recent non-internal
|
|
461
|
+
* user/assistant message, (3) the session root. Returns null when the
|
|
462
|
+
* session is empty.
|
|
463
|
+
*
|
|
464
|
+
* Used by `context_navigate` checkout to avoid the "Entry not found"
|
|
465
|
+
* dead-end that was corrupting the session.
|
|
466
|
+
*/
|
|
467
|
+
export function getRecoveryFallback(
|
|
468
|
+
ctx: ExtensionContext,
|
|
469
|
+
_requested: string,
|
|
470
|
+
): { id: string; label: string; reason: string } | null {
|
|
471
|
+
const sm = getSessionManager(ctx);
|
|
472
|
+
const branch = sm.getBranch();
|
|
473
|
+
if (branch.length === 0) return null;
|
|
474
|
+
|
|
475
|
+
// Priority 1: most recent tag in the current branch.
|
|
476
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
477
|
+
const label = sm.getLabel(branch[i].id);
|
|
478
|
+
if (label) {
|
|
479
|
+
return { id: branch[i].id, label, reason: "most-recent-tag" };
|
|
480
|
+
}
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
// Priority 2: session root.
|
|
484
|
+
const tree = sm.getTree();
|
|
485
|
+
if (tree.length > 0) {
|
|
486
|
+
return { id: tree[0].entry.id, label: "root", reason: "session-root" };
|
|
487
|
+
}
|
|
488
|
+
|
|
489
|
+
return null;
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
export function findByLabel(ctx: ExtensionContext, label: string): string | null {
|
|
493
|
+
const sm = getSessionManager(ctx);
|
|
494
|
+
const tree = sm.getTree();
|
|
495
|
+
for (const node of tree) {
|
|
496
|
+
if (sm.getLabel(node.entry.id) === label) return node.entry.id;
|
|
497
|
+
}
|
|
498
|
+
return null;
|
|
499
|
+
}
|
|
500
|
+
|
|
501
|
+
export function resolveDefaultTarget(ctx: ExtensionContext): string | null {
|
|
502
|
+
const sm = getSessionManager(ctx);
|
|
503
|
+
const branch = sm.getBranch();
|
|
504
|
+
let targetId: string | null = null;
|
|
505
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
506
|
+
const entry = branch[i];
|
|
507
|
+
if (entry.type === "message") {
|
|
508
|
+
const msg = entry.message;
|
|
509
|
+
if (msg?.role === "toolResult") {
|
|
510
|
+
if (!isInternal(String(msg.toolName ?? ""))) {
|
|
511
|
+
targetId = entry.id;
|
|
512
|
+
break;
|
|
513
|
+
}
|
|
514
|
+
} else if (msg?.role === "assistant") {
|
|
515
|
+
const hasInternal =
|
|
516
|
+
Array.isArray(msg.content) &&
|
|
517
|
+
msg.content.some(
|
|
518
|
+
(c: { type?: string; name?: string }) =>
|
|
519
|
+
c.type === "toolCall" && isInternal(String(c.name ?? "")),
|
|
520
|
+
);
|
|
521
|
+
if (!hasInternal) {
|
|
522
|
+
targetId = entry.id;
|
|
523
|
+
break;
|
|
524
|
+
}
|
|
525
|
+
}
|
|
526
|
+
}
|
|
527
|
+
break;
|
|
528
|
+
}
|
|
529
|
+
if (!targetId && branch.length > 0) targetId = sm.getLeafId();
|
|
530
|
+
return targetId;
|
|
531
|
+
}
|
|
532
|
+
|
|
533
|
+
// Retry helpers
|
|
534
|
+
export function resetCompactionRetry(): void {
|
|
535
|
+
if (compactionRetryState.retryTimeout) clearTimeout(compactionRetryState.retryTimeout);
|
|
536
|
+
compactionRetryState.attempt = 0;
|
|
537
|
+
compactionRetryState.lastError = "";
|
|
538
|
+
compactionRetryState.lastReason = "";
|
|
539
|
+
compactionRetryState.retryTimeout = null;
|
|
540
|
+
compactionRetryState.inFlight = false;
|
|
541
|
+
}
|
|
542
|
+
|
|
543
|
+
export function resetOverflowRetry(): void {
|
|
544
|
+
if (overflowRetryState.retryTimeout) clearTimeout(overflowRetryState.retryTimeout);
|
|
545
|
+
overflowRetryState.attempt = 0;
|
|
546
|
+
overflowRetryState.lastError = "";
|
|
547
|
+
overflowRetryState.lastReason = "";
|
|
548
|
+
overflowRetryState.retryTimeout = null;
|
|
549
|
+
overflowRetryState.inFlight = false;
|
|
550
|
+
}
|
|
551
|
+
|
|
552
|
+
/**
|
|
553
|
+
* The dispatched cycle reported an outcome: the dispatch is over. Only the
|
|
554
|
+
* in-flight marker is cleared - the attempt counter is the ladder's progress
|
|
555
|
+
* and survives until the ladder itself settles.
|
|
556
|
+
*/
|
|
557
|
+
export function settleCompactionRetry(): void {
|
|
558
|
+
compactionRetryState.inFlight = false;
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
export function settleOverflowRetry(): void {
|
|
562
|
+
overflowRetryState.inFlight = false;
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
// Compaction Fail-Safe Ladder
|
|
566
|
+
// The ladder above bounds how many times a cycle may fail before it is
|
|
567
|
+
// declared exhausted. It cannot bound the case that motivated this state: at
|
|
568
|
+
// or above the critical usage band pi-core re-fires threshold compaction on
|
|
569
|
+
// every turn, and a cycle that ends with no entry (an aborted cycle carries no
|
|
570
|
+
// error text at all) leaves the session exactly as full as it was. Nothing in
|
|
571
|
+
// the per-cycle routing can see that repetition, so the repetition itself is
|
|
572
|
+
// the signal: N consecutive cycles with no landed entry while the session is
|
|
573
|
+
// over the threshold means no summarizer run is going to land, and the next
|
|
574
|
+
// cycle must compact deterministically instead.
|
|
575
|
+
|
|
576
|
+
/**
|
|
577
|
+
* Consecutive no-progress cycles tolerated above the critical band before the
|
|
578
|
+
* deterministic cut is armed. One abort is an operator Escape and two can be a
|
|
579
|
+
* coincidence; three cycles that each leave the session over its threshold is
|
|
580
|
+
* a loop.
|
|
581
|
+
*/
|
|
582
|
+
export const COMPACTION_NO_PROGRESS_LIMIT = 3;
|
|
583
|
+
|
|
584
|
+
/** The deterministic cut armed for the next compaction cycle. */
|
|
585
|
+
export interface FailsafeCutState {
|
|
586
|
+
/** Why the cut was armed - carried into the landed summary. */
|
|
587
|
+
reason: string;
|
|
588
|
+
/** Epoch ms the cut was armed (diagnostics only). */
|
|
589
|
+
armedAt: number;
|
|
590
|
+
}
|
|
591
|
+
|
|
592
|
+
/**
|
|
593
|
+
* Count one cycle that landed no compaction entry. Returns the running count
|
|
594
|
+
* for this session, so the caller decides on the value it just produced.
|
|
595
|
+
*/
|
|
596
|
+
export function noteCompactionNoProgress(ctx: ExtensionContext): number {
|
|
597
|
+
const cmState = getCmState(ctx);
|
|
598
|
+
cmState.compactionNoProgress = (cmState.compactionNoProgress ?? 0) + 1;
|
|
599
|
+
return cmState.compactionNoProgress;
|
|
600
|
+
}
|
|
601
|
+
|
|
602
|
+
/**
|
|
603
|
+
* A compaction landed: the no-progress ladder is broken, so neither the count
|
|
604
|
+
* nor an armed cut outlives it.
|
|
605
|
+
*/
|
|
606
|
+
export function clearCompactionFailsafe(ctx: ExtensionContext): void {
|
|
607
|
+
const cmState = getCmState(ctx);
|
|
608
|
+
cmState.compactionNoProgress = 0;
|
|
609
|
+
cmState.compactionFailsafeCut = undefined;
|
|
610
|
+
}
|
|
611
|
+
|
|
612
|
+
/**
|
|
613
|
+
* Arm the deterministic cut for the next cycle. Idempotent: returns true only
|
|
614
|
+
* for the call that armed it, so one no-progress sequence dispatches exactly
|
|
615
|
+
* one compaction.
|
|
616
|
+
*/
|
|
617
|
+
export function armCompactionFailsafeCut(ctx: ExtensionContext, reason: string): boolean {
|
|
618
|
+
const cmState = getCmState(ctx);
|
|
619
|
+
if (cmState.compactionFailsafeCut) return false;
|
|
620
|
+
cmState.compactionFailsafeCut = { reason, armedAt: Date.now() };
|
|
621
|
+
return true;
|
|
622
|
+
}
|
|
623
|
+
|
|
624
|
+
/**
|
|
625
|
+
* Take the armed cut, if any, for the cycle that is starting. The cut is
|
|
626
|
+
* one-shot: the consuming cycle owns the outcome, and a landed compaction
|
|
627
|
+
* clears the whole fail-safe state.
|
|
628
|
+
*/
|
|
629
|
+
export function consumeCompactionFailsafeCut(ctx: ExtensionContext): FailsafeCutState | undefined {
|
|
630
|
+
const cmState = getCmState(ctx);
|
|
631
|
+
const armed = cmState.compactionFailsafeCut;
|
|
632
|
+
cmState.compactionFailsafeCut = undefined;
|
|
633
|
+
return armed;
|
|
634
|
+
}
|
|
635
|
+
|
|
636
|
+
export function getCompactionRetryDelay(attempt: number): number {
|
|
637
|
+
return 3000 * Math.pow(2, attempt - 1); // 3s, 6s, 12s
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
export function getOverflowRetryDelay(attempt: number): number {
|
|
641
|
+
return 2000 * Math.pow(2, attempt - 1); // 2s, 4s, 8s
|
|
642
|
+
}
|
|
643
|
+
|
|
644
|
+
export function isTransientCompactionError(errorMessage?: string): boolean {
|
|
645
|
+
if (!errorMessage) return false;
|
|
646
|
+
const transientPatterns = [
|
|
647
|
+
/529/,
|
|
648
|
+
/overloaded/i,
|
|
649
|
+
/rate.?limit/i,
|
|
650
|
+
/too many requests/i,
|
|
651
|
+
/server error/i,
|
|
652
|
+
/service unavailable/i,
|
|
653
|
+
/503/,
|
|
654
|
+
/502/,
|
|
655
|
+
/network/i,
|
|
656
|
+
/timeout/i,
|
|
657
|
+
/ECONNRESET/i,
|
|
658
|
+
];
|
|
659
|
+
return transientPatterns.some((p) => p.test(errorMessage));
|
|
660
|
+
}
|
|
661
|
+
|
|
662
|
+
export function isContextWindowError(errorMessage?: string): boolean {
|
|
663
|
+
if (!errorMessage) return false;
|
|
664
|
+
const contextWindowPatterns = [
|
|
665
|
+
/context window exceeds limit/i,
|
|
666
|
+
/context length exceeded/i,
|
|
667
|
+
/maximum context length/i,
|
|
668
|
+
/token limit exceeded/i,
|
|
669
|
+
/too many tokens/i,
|
|
670
|
+
/invalid_request_error.*context/i,
|
|
671
|
+
];
|
|
672
|
+
return contextWindowPatterns.some((p) => p.test(errorMessage));
|
|
673
|
+
}
|
|
674
|
+
|
|
675
|
+
// Rotation utilities (the cyclic-import-free home for the rotation summary).
|
|
676
|
+
|
|
677
|
+
/**
|
|
678
|
+
* Build a summary of the current session for continuity across rotations.
|
|
679
|
+
*/
|
|
680
|
+
export function buildContinuationSummary(ctx: ExtensionContext): string {
|
|
681
|
+
try {
|
|
682
|
+
const sm = ctx.sessionManager as {
|
|
683
|
+
getBranch?(): Array<{
|
|
684
|
+
id: string;
|
|
685
|
+
type?: string;
|
|
686
|
+
message?: { role?: string; content?: string | Array<{ text?: string }> };
|
|
687
|
+
}>;
|
|
688
|
+
getLabel?(id: string): string | undefined;
|
|
689
|
+
};
|
|
690
|
+
const branch = sm.getBranch?.() ?? [];
|
|
691
|
+
const tags: string[] = [];
|
|
692
|
+
|
|
693
|
+
for (const entry of branch) {
|
|
694
|
+
const label = sm.getLabel?.(entry.id);
|
|
695
|
+
if (label) tags.push(label);
|
|
696
|
+
}
|
|
697
|
+
|
|
698
|
+
const lines: string[] = [
|
|
699
|
+
"## Session Continuation",
|
|
700
|
+
"",
|
|
701
|
+
"This session continues from a previous session that was rotated.",
|
|
702
|
+
"",
|
|
703
|
+
`Previous session: ${branch.length} entries, ${tags.length} tags`,
|
|
704
|
+
];
|
|
705
|
+
|
|
706
|
+
if (tags.length > 0) {
|
|
707
|
+
lines.push(`Tags preserved: ${tags.join(", ")}`);
|
|
708
|
+
}
|
|
709
|
+
|
|
710
|
+
const recentUserMessages: string[] = [];
|
|
711
|
+
for (let i = branch.length - 1; i >= Math.max(0, branch.length - 5); i--) {
|
|
712
|
+
const entry = branch[i];
|
|
713
|
+
if (entry.type === "message" && entry.message?.role === "user") {
|
|
714
|
+
const text =
|
|
715
|
+
typeof entry.message.content === "string"
|
|
716
|
+
? entry.message.content
|
|
717
|
+
: (entry.message.content?.[0]?.text ?? "");
|
|
718
|
+
if (text) recentUserMessages.unshift(text.slice(0, 200));
|
|
719
|
+
}
|
|
720
|
+
}
|
|
721
|
+
|
|
722
|
+
if (recentUserMessages.length > 0) {
|
|
723
|
+
lines.push("", "Recent context:");
|
|
724
|
+
for (const msg of recentUserMessages.slice(-3)) {
|
|
725
|
+
lines.push(`- ${msg}`);
|
|
726
|
+
}
|
|
727
|
+
}
|
|
728
|
+
|
|
729
|
+
lines.push("", "Use the `memory` tool to retrieve cross-session knowledge.");
|
|
730
|
+
|
|
731
|
+
return lines.join("\n");
|
|
732
|
+
} catch {
|
|
733
|
+
return "Session continuation from rotated session. Use the `memory` tool for context.";
|
|
734
|
+
}
|
|
735
|
+
}
|
|
736
|
+
|
|
737
|
+
/**
|
|
738
|
+
* Emergency rotation trigger - called when context overflow is imminent.
|
|
739
|
+
*/
|
|
740
|
+
export function triggerEmergencyRotation(pi: ExtensionAPI, ctx: ExtensionContext): void {
|
|
741
|
+
try {
|
|
742
|
+
const state = getRotationState();
|
|
743
|
+
if (state.pendingRotation) {
|
|
744
|
+
log.info("[Emergency] Rotation already pending, skipping duplicate trigger");
|
|
745
|
+
return;
|
|
746
|
+
}
|
|
747
|
+
|
|
748
|
+
state.pendingRotation = true;
|
|
749
|
+
state.emergencyRotation = true;
|
|
750
|
+
state.continuationSummary = buildContinuationSummary(ctx);
|
|
751
|
+
|
|
752
|
+
sendTrackedMessage(
|
|
753
|
+
pi,
|
|
754
|
+
{
|
|
755
|
+
customType: "context",
|
|
756
|
+
content: [
|
|
757
|
+
{
|
|
758
|
+
type: "text" as const,
|
|
759
|
+
text: [
|
|
760
|
+
"## Session Rotation Required",
|
|
761
|
+
"",
|
|
762
|
+
"Context overflow detected. Automatic rotation triggered to prevent data loss.",
|
|
763
|
+
"",
|
|
764
|
+
"Please call `finalize()` to complete this task and start fresh.",
|
|
765
|
+
"",
|
|
766
|
+
"Rotation will happen automatically on next `finalize()`.",
|
|
767
|
+
].join("\n"),
|
|
768
|
+
},
|
|
769
|
+
],
|
|
770
|
+
display: true,
|
|
771
|
+
},
|
|
772
|
+
{ deliverAs: "steer", triggerTurn: true },
|
|
773
|
+
{ type: "context", source: "context-manager/rotation" },
|
|
774
|
+
);
|
|
775
|
+
|
|
776
|
+
log.info("[Emergency] Rotation triggered due to context overflow risk");
|
|
777
|
+
} catch (err) {
|
|
778
|
+
log.error("[Emergency] Rotation trigger failed:", err);
|
|
779
|
+
}
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
// Compaction Health Metrics
|
|
783
|
+
// Tracks compaction outcomes across sessions for analytics and retry tuning.
|
|
784
|
+
|
|
785
|
+
export interface CompactionHealth {
|
|
786
|
+
totalCompactions: number;
|
|
787
|
+
totalFailures: number;
|
|
788
|
+
/** Total aborted (user-cancelled) compactions, counted distinctly from failures. */
|
|
789
|
+
totalAborted: number;
|
|
790
|
+
/** Aborted compactions where another compaction was in-flight when the aborted cycle began. */
|
|
791
|
+
inFlightAborted: number;
|
|
792
|
+
totalTokensBefore: number;
|
|
793
|
+
totalTokensAfter: number;
|
|
794
|
+
totalEntriesRemoved: number;
|
|
795
|
+
/** Verify-stage rejections (rollback count): a compaction the coherence/budget verify rejected. */
|
|
796
|
+
totalVerifyFailures: number;
|
|
797
|
+
/** Option B always-on originals archives actually appended to disk (coverage, NOT loss). */
|
|
798
|
+
totalArchivesWritten: number;
|
|
799
|
+
/**
|
|
800
|
+
* Last successful compaction (surface): raw summarization-input
|
|
801
|
+
* message count from the cycle's originals capture. Absent = never measured
|
|
802
|
+
* (degrade-to-absent telemetry, never wrong).
|
|
803
|
+
*/
|
|
804
|
+
lastCompactedMessages?: number;
|
|
805
|
+
/** Last successful compaction: live messages kept from the first-kept anchor. Absent = never measured. */
|
|
806
|
+
lastKeptMessages?: number;
|
|
807
|
+
lastOutcome: "success" | "failure" | "partial" | "aborted" | null;
|
|
808
|
+
lastErrorMessage?: string;
|
|
809
|
+
}
|
|
810
|
+
|
|
811
|
+
const compactionHealth: CompactionHealth = {
|
|
812
|
+
totalCompactions: 0,
|
|
813
|
+
totalFailures: 0,
|
|
814
|
+
totalAborted: 0,
|
|
815
|
+
inFlightAborted: 0,
|
|
816
|
+
totalTokensBefore: 0,
|
|
817
|
+
totalTokensAfter: 0,
|
|
818
|
+
totalEntriesRemoved: 0,
|
|
819
|
+
totalVerifyFailures: 0,
|
|
820
|
+
totalArchivesWritten: 0,
|
|
821
|
+
lastOutcome: null,
|
|
822
|
+
};
|
|
823
|
+
|
|
824
|
+
export function getCompactionHealth(): CompactionHealth {
|
|
825
|
+
return compactionHealth;
|
|
826
|
+
}
|
|
827
|
+
|
|
828
|
+
/** Reset all compaction-health counters. Used by tests and session-start resets. */
|
|
829
|
+
export function resetCompactionHealth(): void {
|
|
830
|
+
compactionHealth.totalCompactions = 0;
|
|
831
|
+
compactionHealth.totalFailures = 0;
|
|
832
|
+
compactionHealth.totalAborted = 0;
|
|
833
|
+
compactionHealth.inFlightAborted = 0;
|
|
834
|
+
compactionHealth.totalTokensBefore = 0;
|
|
835
|
+
compactionHealth.totalTokensAfter = 0;
|
|
836
|
+
compactionHealth.totalEntriesRemoved = 0;
|
|
837
|
+
compactionHealth.totalVerifyFailures = 0;
|
|
838
|
+
compactionHealth.totalArchivesWritten = 0;
|
|
839
|
+
compactionHealth.lastOutcome = null;
|
|
840
|
+
delete compactionHealth.lastCompactedMessages;
|
|
841
|
+
delete compactionHealth.lastKeptMessages;
|
|
842
|
+
delete compactionHealth.lastErrorMessage;
|
|
843
|
+
}
|
|
844
|
+
|
|
845
|
+
/**
|
|
846
|
+
* One-line compaction summary for context_inspect / heartbeat analytics.
|
|
847
|
+
* Returns null only when there is nothing worth reporting: no loss signals
|
|
848
|
+
* AND no originals archives written (i.e. no compaction activity at all).
|
|
849
|
+
*
|
|
850
|
+
* Loss gate: ONLY loss signals (aborts, generic failures, verify rollbacks)
|
|
851
|
+
* keep the loss portion alive. Archives-written is COVERAGE, not loss — it
|
|
852
|
+
* never contributes to the gate, but is reported as non-loss telemetry
|
|
853
|
+
* whenever compaction activity happened (even with zero failures), so the
|
|
854
|
+
* always-on archive surface is measurable.
|
|
855
|
+
*/
|
|
856
|
+
export function formatCompactionLossLine(): string | null {
|
|
857
|
+
const bad =
|
|
858
|
+
compactionHealth.totalAborted +
|
|
859
|
+
compactionHealth.totalFailures +
|
|
860
|
+
compactionHealth.inFlightAborted +
|
|
861
|
+
compactionHealth.totalVerifyFailures;
|
|
862
|
+
const archives = compactionHealth.totalArchivesWritten;
|
|
863
|
+
const lastCompacted = compactionHealth.lastCompactedMessages;
|
|
864
|
+
// A last-compaction measurement is compaction activity worth surfacing —
|
|
865
|
+
// include it in the gate alongside loss signals and archive coverage.
|
|
866
|
+
if (bad === 0 && archives === 0 && lastCompacted === undefined) return null;
|
|
867
|
+
const parts: string[] = [];
|
|
868
|
+
if (bad > 0) {
|
|
869
|
+
parts.push(
|
|
870
|
+
`compaction loss: ${compactionHealth.inFlightAborted} in-flight aborts, ` +
|
|
871
|
+
`${compactionHealth.totalFailures} failures, ${compactionHealth.totalCompactions} compacts`,
|
|
872
|
+
);
|
|
873
|
+
}
|
|
874
|
+
// A verify rejection is a loss signal (a rollback happened) — report it
|
|
875
|
+
// next to the failure counts.
|
|
876
|
+
if (compactionHealth.totalVerifyFailures > 0) {
|
|
877
|
+
parts.push(`verify rollbacks: ${compactionHealth.totalVerifyFailures}`);
|
|
878
|
+
}
|
|
879
|
+
// Coverage telemetry, NOT loss: emitted only when archives actually exist —
|
|
880
|
+
// still reported when failures are zero, so a bare abort/loss with no
|
|
881
|
+
// archives never gains an `archives: 0` suffix.
|
|
882
|
+
if (archives > 0) {
|
|
883
|
+
parts.push(`archives: ${archives}`);
|
|
884
|
+
}
|
|
885
|
+
// The compacted-vs-kept counters of the last successful
|
|
886
|
+
// compaction (kept side degrades to "?" when its source was absent).
|
|
887
|
+
if (lastCompacted !== undefined) {
|
|
888
|
+
parts.push(
|
|
889
|
+
`last compaction: ${lastCompacted} compacted → ${compactionHealth.lastKeptMessages ?? "?"} kept`,
|
|
890
|
+
);
|
|
891
|
+
}
|
|
892
|
+
return parts.join(" · ");
|
|
893
|
+
}
|
|
894
|
+
|
|
895
|
+
export function recordCompactionOutcome(
|
|
896
|
+
outcome: CompactionHealth["lastOutcome"],
|
|
897
|
+
details?: {
|
|
898
|
+
tokensBefore?: number;
|
|
899
|
+
tokensAfter?: number;
|
|
900
|
+
entriesRemoved?: number;
|
|
901
|
+
errorMessage?: string;
|
|
902
|
+
/** Whether another compaction was in-flight when this cycle began (abort tagging, P2a). */
|
|
903
|
+
inFlight?: boolean;
|
|
904
|
+
/** Surface: this cycle's raw summarization-input count (absent = not measured). */
|
|
905
|
+
compactedMessages?: number;
|
|
906
|
+
/** Surface: live messages kept from the first-kept anchor (absent = not measured). */
|
|
907
|
+
keptMessages?: number;
|
|
908
|
+
},
|
|
909
|
+
): void {
|
|
910
|
+
compactionHealth.lastOutcome = outcome;
|
|
911
|
+
if (outcome === "success") {
|
|
912
|
+
compactionHealth.totalCompactions++;
|
|
913
|
+
if (details?.tokensBefore) compactionHealth.totalTokensBefore += details.tokensBefore;
|
|
914
|
+
if (details?.tokensAfter) compactionHealth.totalTokensAfter += details.tokensAfter;
|
|
915
|
+
if (details?.entriesRemoved) compactionHealth.totalEntriesRemoved += details.entriesRemoved;
|
|
916
|
+
// Last-compaction counters (reassigned every success so a
|
|
917
|
+
// stale value from an earlier cycle can never masquerade as current).
|
|
918
|
+
compactionHealth.lastCompactedMessages = details?.compactedMessages;
|
|
919
|
+
compactionHealth.lastKeptMessages = details?.keptMessages;
|
|
920
|
+
} else if (outcome === "aborted") {
|
|
921
|
+
// P2a: aborts are counted distinctly from failures and successes.
|
|
922
|
+
compactionHealth.totalAborted++;
|
|
923
|
+
if (details?.inFlight) compactionHealth.inFlightAborted++;
|
|
924
|
+
compactionHealth.lastErrorMessage = details?.errorMessage;
|
|
925
|
+
} else {
|
|
926
|
+
compactionHealth.totalFailures++;
|
|
927
|
+
compactionHealth.lastErrorMessage = details?.errorMessage;
|
|
928
|
+
}
|
|
929
|
+
}
|
|
930
|
+
|
|
931
|
+
/**
|
|
932
|
+
* Increment a non-outcome CompactionHealth counter.
|
|
933
|
+
* Distinct from recordCompactionOutcome (which encodes the cycle outcome as a
|
|
934
|
+
* whole): these two counters measure the real state — every verify
|
|
935
|
+
* rejection is a rollback (loss), every originals archive append is coverage
|
|
936
|
+
* (not loss). Callers only bump the archive counter AFTER a successful
|
|
937
|
+
* appendFileSync so a failed write never inflates coverage.
|
|
938
|
+
*/
|
|
939
|
+
export function recordCompactionHealth(
|
|
940
|
+
counter: "totalVerifyFailures" | "totalArchivesWritten",
|
|
941
|
+
): void {
|
|
942
|
+
compactionHealth[counter]++;
|
|
943
|
+
}
|
|
944
|
+
|
|
945
|
+
// Formatting helpers
|
|
946
|
+
|
|
947
|
+
export function formatPruneCandidates(candidates: any[], count?: number): string {
|
|
948
|
+
const lines: string[] = [];
|
|
949
|
+
for (let i = 0; i < (count ?? candidates.length); i++) {
|
|
950
|
+
const c = candidates[i];
|
|
951
|
+
if (!c) break;
|
|
952
|
+
const role = c.role || "?";
|
|
953
|
+
const preview = (c.preview || "").slice(0, 60);
|
|
954
|
+
const reason = c.reason || "unknown";
|
|
955
|
+
const age = c.age !== undefined ? `${c.age} turns` : "?";
|
|
956
|
+
const score = c.score !== undefined ? `${(c.score * 100).toFixed(0)}%` : "?";
|
|
957
|
+
lines.push(`${i + 1}. [${role}] ${preview} (age: ${age}, score: ${score})`);
|
|
958
|
+
lines.push(` Reason: ${reason}`);
|
|
959
|
+
}
|
|
960
|
+
return lines.join("\n");
|
|
961
|
+
}
|