pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,579 @@
|
|
|
1
|
+
// Context-Manager Shared State & Helpers
|
|
2
|
+
// Shared across all handler modules. Module-level singletons + session-scoped factories.
|
|
3
|
+
import { getExtensionState } from "../../../../lib/state/extension-state.js";
|
|
4
|
+
import { createLogger } from "../../../../lib/core/logger.js";
|
|
5
|
+
import { createPruningState } from "../pruning.js";
|
|
6
|
+
import { getSessionManager } from "../../../../lib/state/session-manager.js";
|
|
7
|
+
import { sendTrackedMessage } from "../../../../lib/utils/injection-tracker.js";
|
|
8
|
+
import { getRotationState } from "../../../../lib/state/global-state.js";
|
|
9
|
+
export const log = createLogger("context-manager");
|
|
10
|
+
// Internal tool detection
|
|
11
|
+
export const INTERNAL_TOOLS = new Set([
|
|
12
|
+
"context_navigate",
|
|
13
|
+
"context_compress",
|
|
14
|
+
"context_inspect",
|
|
15
|
+
"context_proposals",
|
|
16
|
+
"offload_recover",
|
|
17
|
+
"think",
|
|
18
|
+
"hypothesize",
|
|
19
|
+
"finalize",
|
|
20
|
+
"heuristics_evaluate",
|
|
21
|
+
"cognition_evaluate",
|
|
22
|
+
"memory_store",
|
|
23
|
+
"memory",
|
|
24
|
+
"goal",
|
|
25
|
+
"plan",
|
|
26
|
+
"scratchpad",
|
|
27
|
+
"health_maintenance",
|
|
28
|
+
]);
|
|
29
|
+
export function isInternal(toolName) {
|
|
30
|
+
return INTERNAL_TOOLS.has(toolName);
|
|
31
|
+
}
|
|
32
|
+
export function getCmState(ctx) {
|
|
33
|
+
return getExtensionState(ctx, "context-manager", () => ({
|
|
34
|
+
checkoutParams: null,
|
|
35
|
+
pruningState: createPruningState(),
|
|
36
|
+
overflowNotified: false,
|
|
37
|
+
// H5: Retry guards initialized to false (prevents double-trigger)
|
|
38
|
+
compactionRetryActive: false,
|
|
39
|
+
overflowRetryActive: false,
|
|
40
|
+
compactionNoProgress: 0,
|
|
41
|
+
compactionFailsafeCut: undefined,
|
|
42
|
+
slideMode: null,
|
|
43
|
+
rangeMode: null,
|
|
44
|
+
pendingCompactionFingerprint: undefined,
|
|
45
|
+
lastCompactionFingerprints: {},
|
|
46
|
+
preCompactionUsagePercent: undefined,
|
|
47
|
+
verifyFailed: false,
|
|
48
|
+
pendingCompactionOriginals: undefined,
|
|
49
|
+
cancelSource: undefined,
|
|
50
|
+
summaryCapCancelError: undefined,
|
|
51
|
+
compactionCycleId: 0,
|
|
52
|
+
}));
|
|
53
|
+
}
|
|
54
|
+
const NAVIGATION_KIND_FIELD = {
|
|
55
|
+
tag: "tags",
|
|
56
|
+
checkout: "checkouts",
|
|
57
|
+
log: "logs",
|
|
58
|
+
archive: "archives",
|
|
59
|
+
slide: "slides",
|
|
60
|
+
compact: "compacts",
|
|
61
|
+
deep_clean: "deepCleans",
|
|
62
|
+
};
|
|
63
|
+
/**
|
|
64
|
+
* Lazily initialize the session navigation-adoption counter block and
|
|
65
|
+
* increment one fixed kind. Callers invoke this ONLY after the action has
|
|
66
|
+
* truly succeeded (the archive was declared, the compact was scheduled, the
|
|
67
|
+
* tag was written) — abort/error/no-op paths must never reach this helper so
|
|
68
|
+
* the counters measure real steering, not intent.
|
|
69
|
+
*/
|
|
70
|
+
export function recordNavigationAction(ctx, kind) {
|
|
71
|
+
const state = getCmState(ctx);
|
|
72
|
+
if (!state.navigationAdoption) {
|
|
73
|
+
state.navigationAdoption = {
|
|
74
|
+
tags: 0,
|
|
75
|
+
checkouts: 0,
|
|
76
|
+
logs: 0,
|
|
77
|
+
archives: 0,
|
|
78
|
+
slides: 0,
|
|
79
|
+
compacts: 0,
|
|
80
|
+
deepCleans: 0,
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
state.navigationAdoption[NAVIGATION_KIND_FIELD[kind]]++;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* One-line navigation-adoption summary for context_inspect detail=detailed.
|
|
87
|
+
* Loss-preferring navigation (tag/checkout/archive/slide, plus deep-cleans)
|
|
88
|
+
* is visually separated from destructive compacts. Returns null when no
|
|
89
|
+
* navigation action has succeeded yet (must not show an empty line).
|
|
90
|
+
*/
|
|
91
|
+
export function formatNavigationAdoptionLine(na) {
|
|
92
|
+
if (!na)
|
|
93
|
+
return null;
|
|
94
|
+
return (`navigation: ${na.tags} tags / ${na.checkouts} checkouts / ${na.logs} logs · ` +
|
|
95
|
+
`archives ${na.archives} / slides ${na.slides} (deep-cleans ${na.deepCleans}) vs compacts ${na.compacts}`);
|
|
96
|
+
}
|
|
97
|
+
export const compactionRetryState = {
|
|
98
|
+
attempt: 0,
|
|
99
|
+
lastError: "",
|
|
100
|
+
lastReason: "",
|
|
101
|
+
retryTimeout: null,
|
|
102
|
+
inFlight: false,
|
|
103
|
+
};
|
|
104
|
+
export const overflowRetryState = {
|
|
105
|
+
attempt: 0,
|
|
106
|
+
lastError: "",
|
|
107
|
+
lastReason: "",
|
|
108
|
+
retryTimeout: null,
|
|
109
|
+
inFlight: false,
|
|
110
|
+
};
|
|
111
|
+
function getCompactionActiveState(ctx) {
|
|
112
|
+
return getExtensionState(ctx, "context-manager/compaction-active", () => ({
|
|
113
|
+
active: false,
|
|
114
|
+
}));
|
|
115
|
+
}
|
|
116
|
+
export function isCompactionActive(ctx) {
|
|
117
|
+
// Module-level call (no ctx) is supported for backward compat; returns
|
|
118
|
+
// the FIRST session's value, which is OK in pi's single-session-per-process.
|
|
119
|
+
if (!ctx) {
|
|
120
|
+
return _fallbackActive;
|
|
121
|
+
}
|
|
122
|
+
return getCompactionActiveState(ctx).active;
|
|
123
|
+
}
|
|
124
|
+
export function setCompactionActive(value, ctx) {
|
|
125
|
+
getCompactionActiveState(ctx).active = value;
|
|
126
|
+
// Mirror to module-level fallback for ctx-less callers.
|
|
127
|
+
_fallbackActive = value;
|
|
128
|
+
}
|
|
129
|
+
// Module-level fallback used when callers don't have ctx. Updated by
|
|
130
|
+
// setCompactionActive() with the most recent value. In pi-core's
|
|
131
|
+
// single-session-per-process model this is equivalent to per-session.
|
|
132
|
+
let _fallbackActive = false;
|
|
133
|
+
// Constants
|
|
134
|
+
export const COMPACTION_RETRY_MAX_ATTEMPTS = 3;
|
|
135
|
+
export const OVERFLOW_RETRY_MAX_ATTEMPTS = 3;
|
|
136
|
+
export const OVERFLOW_RETRY_KEEP_REDUCTION_FACTOR = 0.6;
|
|
137
|
+
export const COMPACTION_RETRY_CUSTOM_TYPE = "__compaction_retry_trigger";
|
|
138
|
+
// Navigation helpers.
|
|
139
|
+
// Contract: resolveTarget returns null for any target that does not resolve
|
|
140
|
+
// to a real entry in the current session — passing a non-existent target to
|
|
141
|
+
// sm.branchWithSummary() fails upstream ("Entry not found"), and aborting on
|
|
142
|
+
// it kills the turn with a half-checked-out session. The caller is responsible
|
|
143
|
+
// for proposing a recovery via getRecoveryFallback() rather than dead-ending
|
|
144
|
+
// the turn.
|
|
145
|
+
export function resolveTarget(ctx, target) {
|
|
146
|
+
if (!target)
|
|
147
|
+
return null;
|
|
148
|
+
const sm = getSessionManager(ctx);
|
|
149
|
+
const tree = sm.getTree();
|
|
150
|
+
if (tree.length === 0)
|
|
151
|
+
return null;
|
|
152
|
+
if (target.toLowerCase() === "root") {
|
|
153
|
+
return tree[0].entry.id;
|
|
154
|
+
}
|
|
155
|
+
// Accept an 8+ hex-char ID only if it actually exists in the current
|
|
156
|
+
// session — a blind accept would let cross-session IDs leak through and
|
|
157
|
+
// fail upstream.
|
|
158
|
+
if (/^[0-9a-f]{8,}$/i.test(target)) {
|
|
159
|
+
for (const node of tree) {
|
|
160
|
+
if (node.entry.id === target)
|
|
161
|
+
return target;
|
|
162
|
+
}
|
|
163
|
+
return null;
|
|
164
|
+
}
|
|
165
|
+
// Label lookup.
|
|
166
|
+
for (const node of tree) {
|
|
167
|
+
if (sm.getLabel(node.entry.id) === target)
|
|
168
|
+
return node.entry.id;
|
|
169
|
+
}
|
|
170
|
+
return null;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Get a recovery target when the requested target is not in the current
|
|
174
|
+
* session. Priority: (1) most recent tag, (2) the most recent non-internal
|
|
175
|
+
* user/assistant message, (3) the session root. Returns null when the
|
|
176
|
+
* session is empty.
|
|
177
|
+
*
|
|
178
|
+
* Used by `context_navigate` checkout to avoid the "Entry not found"
|
|
179
|
+
* dead-end that was corrupting the session.
|
|
180
|
+
*/
|
|
181
|
+
export function getRecoveryFallback(ctx, _requested) {
|
|
182
|
+
const sm = getSessionManager(ctx);
|
|
183
|
+
const branch = sm.getBranch();
|
|
184
|
+
if (branch.length === 0)
|
|
185
|
+
return null;
|
|
186
|
+
// Priority 1: most recent tag in the current branch.
|
|
187
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
188
|
+
const label = sm.getLabel(branch[i].id);
|
|
189
|
+
if (label) {
|
|
190
|
+
return { id: branch[i].id, label, reason: "most-recent-tag" };
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
// Priority 2: session root.
|
|
194
|
+
const tree = sm.getTree();
|
|
195
|
+
if (tree.length > 0) {
|
|
196
|
+
return { id: tree[0].entry.id, label: "root", reason: "session-root" };
|
|
197
|
+
}
|
|
198
|
+
return null;
|
|
199
|
+
}
|
|
200
|
+
export function findByLabel(ctx, label) {
|
|
201
|
+
const sm = getSessionManager(ctx);
|
|
202
|
+
const tree = sm.getTree();
|
|
203
|
+
for (const node of tree) {
|
|
204
|
+
if (sm.getLabel(node.entry.id) === label)
|
|
205
|
+
return node.entry.id;
|
|
206
|
+
}
|
|
207
|
+
return null;
|
|
208
|
+
}
|
|
209
|
+
export function resolveDefaultTarget(ctx) {
|
|
210
|
+
const sm = getSessionManager(ctx);
|
|
211
|
+
const branch = sm.getBranch();
|
|
212
|
+
let targetId = null;
|
|
213
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
214
|
+
const entry = branch[i];
|
|
215
|
+
if (entry.type === "message") {
|
|
216
|
+
const msg = entry.message;
|
|
217
|
+
if (msg?.role === "toolResult") {
|
|
218
|
+
if (!isInternal(String(msg.toolName ?? ""))) {
|
|
219
|
+
targetId = entry.id;
|
|
220
|
+
break;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
else if (msg?.role === "assistant") {
|
|
224
|
+
const hasInternal = Array.isArray(msg.content) &&
|
|
225
|
+
msg.content.some((c) => c.type === "toolCall" && isInternal(String(c.name ?? "")));
|
|
226
|
+
if (!hasInternal) {
|
|
227
|
+
targetId = entry.id;
|
|
228
|
+
break;
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
break;
|
|
233
|
+
}
|
|
234
|
+
if (!targetId && branch.length > 0)
|
|
235
|
+
targetId = sm.getLeafId();
|
|
236
|
+
return targetId;
|
|
237
|
+
}
|
|
238
|
+
// Retry helpers
|
|
239
|
+
export function resetCompactionRetry() {
|
|
240
|
+
if (compactionRetryState.retryTimeout)
|
|
241
|
+
clearTimeout(compactionRetryState.retryTimeout);
|
|
242
|
+
compactionRetryState.attempt = 0;
|
|
243
|
+
compactionRetryState.lastError = "";
|
|
244
|
+
compactionRetryState.lastReason = "";
|
|
245
|
+
compactionRetryState.retryTimeout = null;
|
|
246
|
+
compactionRetryState.inFlight = false;
|
|
247
|
+
}
|
|
248
|
+
export function resetOverflowRetry() {
|
|
249
|
+
if (overflowRetryState.retryTimeout)
|
|
250
|
+
clearTimeout(overflowRetryState.retryTimeout);
|
|
251
|
+
overflowRetryState.attempt = 0;
|
|
252
|
+
overflowRetryState.lastError = "";
|
|
253
|
+
overflowRetryState.lastReason = "";
|
|
254
|
+
overflowRetryState.retryTimeout = null;
|
|
255
|
+
overflowRetryState.inFlight = false;
|
|
256
|
+
}
|
|
257
|
+
/**
|
|
258
|
+
* The dispatched cycle reported an outcome: the dispatch is over. Only the
|
|
259
|
+
* in-flight marker is cleared - the attempt counter is the ladder's progress
|
|
260
|
+
* and survives until the ladder itself settles.
|
|
261
|
+
*/
|
|
262
|
+
export function settleCompactionRetry() {
|
|
263
|
+
compactionRetryState.inFlight = false;
|
|
264
|
+
}
|
|
265
|
+
export function settleOverflowRetry() {
|
|
266
|
+
overflowRetryState.inFlight = false;
|
|
267
|
+
}
|
|
268
|
+
// Compaction Fail-Safe Ladder
|
|
269
|
+
// The ladder above bounds how many times a cycle may fail before it is
|
|
270
|
+
// declared exhausted. It cannot bound the case that motivated this state: at
|
|
271
|
+
// or above the critical usage band pi-core re-fires threshold compaction on
|
|
272
|
+
// every turn, and a cycle that ends with no entry (an aborted cycle carries no
|
|
273
|
+
// error text at all) leaves the session exactly as full as it was. Nothing in
|
|
274
|
+
// the per-cycle routing can see that repetition, so the repetition itself is
|
|
275
|
+
// the signal: N consecutive cycles with no landed entry while the session is
|
|
276
|
+
// over the threshold means no summarizer run is going to land, and the next
|
|
277
|
+
// cycle must compact deterministically instead.
|
|
278
|
+
/**
|
|
279
|
+
* Consecutive no-progress cycles tolerated above the critical band before the
|
|
280
|
+
* deterministic cut is armed. One abort is an operator Escape and two can be a
|
|
281
|
+
* coincidence; three cycles that each leave the session over its threshold is
|
|
282
|
+
* a loop.
|
|
283
|
+
*/
|
|
284
|
+
export const COMPACTION_NO_PROGRESS_LIMIT = 3;
|
|
285
|
+
/**
|
|
286
|
+
* Count one cycle that landed no compaction entry. Returns the running count
|
|
287
|
+
* for this session, so the caller decides on the value it just produced.
|
|
288
|
+
*/
|
|
289
|
+
export function noteCompactionNoProgress(ctx) {
|
|
290
|
+
const cmState = getCmState(ctx);
|
|
291
|
+
cmState.compactionNoProgress = (cmState.compactionNoProgress ?? 0) + 1;
|
|
292
|
+
return cmState.compactionNoProgress;
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* A compaction landed: the no-progress ladder is broken, so neither the count
|
|
296
|
+
* nor an armed cut outlives it.
|
|
297
|
+
*/
|
|
298
|
+
export function clearCompactionFailsafe(ctx) {
|
|
299
|
+
const cmState = getCmState(ctx);
|
|
300
|
+
cmState.compactionNoProgress = 0;
|
|
301
|
+
cmState.compactionFailsafeCut = undefined;
|
|
302
|
+
}
|
|
303
|
+
/**
|
|
304
|
+
* Arm the deterministic cut for the next cycle. Idempotent: returns true only
|
|
305
|
+
* for the call that armed it, so one no-progress sequence dispatches exactly
|
|
306
|
+
* one compaction.
|
|
307
|
+
*/
|
|
308
|
+
export function armCompactionFailsafeCut(ctx, reason) {
|
|
309
|
+
const cmState = getCmState(ctx);
|
|
310
|
+
if (cmState.compactionFailsafeCut)
|
|
311
|
+
return false;
|
|
312
|
+
cmState.compactionFailsafeCut = { reason, armedAt: Date.now() };
|
|
313
|
+
return true;
|
|
314
|
+
}
|
|
315
|
+
/**
|
|
316
|
+
* Take the armed cut, if any, for the cycle that is starting. The cut is
|
|
317
|
+
* one-shot: the consuming cycle owns the outcome, and a landed compaction
|
|
318
|
+
* clears the whole fail-safe state.
|
|
319
|
+
*/
|
|
320
|
+
export function consumeCompactionFailsafeCut(ctx) {
|
|
321
|
+
const cmState = getCmState(ctx);
|
|
322
|
+
const armed = cmState.compactionFailsafeCut;
|
|
323
|
+
cmState.compactionFailsafeCut = undefined;
|
|
324
|
+
return armed;
|
|
325
|
+
}
|
|
326
|
+
export function getCompactionRetryDelay(attempt) {
|
|
327
|
+
return 3000 * Math.pow(2, attempt - 1); // 3s, 6s, 12s
|
|
328
|
+
}
|
|
329
|
+
export function getOverflowRetryDelay(attempt) {
|
|
330
|
+
return 2000 * Math.pow(2, attempt - 1); // 2s, 4s, 8s
|
|
331
|
+
}
|
|
332
|
+
export function isTransientCompactionError(errorMessage) {
|
|
333
|
+
if (!errorMessage)
|
|
334
|
+
return false;
|
|
335
|
+
const transientPatterns = [
|
|
336
|
+
/529/,
|
|
337
|
+
/overloaded/i,
|
|
338
|
+
/rate.?limit/i,
|
|
339
|
+
/too many requests/i,
|
|
340
|
+
/server error/i,
|
|
341
|
+
/service unavailable/i,
|
|
342
|
+
/503/,
|
|
343
|
+
/502/,
|
|
344
|
+
/network/i,
|
|
345
|
+
/timeout/i,
|
|
346
|
+
/ECONNRESET/i,
|
|
347
|
+
];
|
|
348
|
+
return transientPatterns.some((p) => p.test(errorMessage));
|
|
349
|
+
}
|
|
350
|
+
export function isContextWindowError(errorMessage) {
|
|
351
|
+
if (!errorMessage)
|
|
352
|
+
return false;
|
|
353
|
+
const contextWindowPatterns = [
|
|
354
|
+
/context window exceeds limit/i,
|
|
355
|
+
/context length exceeded/i,
|
|
356
|
+
/maximum context length/i,
|
|
357
|
+
/token limit exceeded/i,
|
|
358
|
+
/too many tokens/i,
|
|
359
|
+
/invalid_request_error.*context/i,
|
|
360
|
+
];
|
|
361
|
+
return contextWindowPatterns.some((p) => p.test(errorMessage));
|
|
362
|
+
}
|
|
363
|
+
// Rotation utilities (the cyclic-import-free home for the rotation summary).
|
|
364
|
+
/**
|
|
365
|
+
* Build a summary of the current session for continuity across rotations.
|
|
366
|
+
*/
|
|
367
|
+
export function buildContinuationSummary(ctx) {
|
|
368
|
+
try {
|
|
369
|
+
const sm = ctx.sessionManager;
|
|
370
|
+
const branch = sm.getBranch?.() ?? [];
|
|
371
|
+
const tags = [];
|
|
372
|
+
for (const entry of branch) {
|
|
373
|
+
const label = sm.getLabel?.(entry.id);
|
|
374
|
+
if (label)
|
|
375
|
+
tags.push(label);
|
|
376
|
+
}
|
|
377
|
+
const lines = [
|
|
378
|
+
"## Session Continuation",
|
|
379
|
+
"",
|
|
380
|
+
"This session continues from a previous session that was rotated.",
|
|
381
|
+
"",
|
|
382
|
+
`Previous session: ${branch.length} entries, ${tags.length} tags`,
|
|
383
|
+
];
|
|
384
|
+
if (tags.length > 0) {
|
|
385
|
+
lines.push(`Tags preserved: ${tags.join(", ")}`);
|
|
386
|
+
}
|
|
387
|
+
const recentUserMessages = [];
|
|
388
|
+
for (let i = branch.length - 1; i >= Math.max(0, branch.length - 5); i--) {
|
|
389
|
+
const entry = branch[i];
|
|
390
|
+
if (entry.type === "message" && entry.message?.role === "user") {
|
|
391
|
+
const text = typeof entry.message.content === "string"
|
|
392
|
+
? entry.message.content
|
|
393
|
+
: (entry.message.content?.[0]?.text ?? "");
|
|
394
|
+
if (text)
|
|
395
|
+
recentUserMessages.unshift(text.slice(0, 200));
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
if (recentUserMessages.length > 0) {
|
|
399
|
+
lines.push("", "Recent context:");
|
|
400
|
+
for (const msg of recentUserMessages.slice(-3)) {
|
|
401
|
+
lines.push(`- ${msg}`);
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
lines.push("", "Use the `memory` tool to retrieve cross-session knowledge.");
|
|
405
|
+
return lines.join("\n");
|
|
406
|
+
}
|
|
407
|
+
catch {
|
|
408
|
+
return "Session continuation from rotated session. Use the `memory` tool for context.";
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
/**
|
|
412
|
+
* Emergency rotation trigger - called when context overflow is imminent.
|
|
413
|
+
*/
|
|
414
|
+
export function triggerEmergencyRotation(pi, ctx) {
|
|
415
|
+
try {
|
|
416
|
+
const state = getRotationState();
|
|
417
|
+
if (state.pendingRotation) {
|
|
418
|
+
log.info("[Emergency] Rotation already pending, skipping duplicate trigger");
|
|
419
|
+
return;
|
|
420
|
+
}
|
|
421
|
+
state.pendingRotation = true;
|
|
422
|
+
state.emergencyRotation = true;
|
|
423
|
+
state.continuationSummary = buildContinuationSummary(ctx);
|
|
424
|
+
sendTrackedMessage(pi, {
|
|
425
|
+
customType: "context",
|
|
426
|
+
content: [
|
|
427
|
+
{
|
|
428
|
+
type: "text",
|
|
429
|
+
text: [
|
|
430
|
+
"## Session Rotation Required",
|
|
431
|
+
"",
|
|
432
|
+
"Context overflow detected. Automatic rotation triggered to prevent data loss.",
|
|
433
|
+
"",
|
|
434
|
+
"Please call `finalize()` to complete this task and start fresh.",
|
|
435
|
+
"",
|
|
436
|
+
"Rotation will happen automatically on next `finalize()`.",
|
|
437
|
+
].join("\n"),
|
|
438
|
+
},
|
|
439
|
+
],
|
|
440
|
+
display: true,
|
|
441
|
+
}, { deliverAs: "steer", triggerTurn: true }, { type: "context", source: "context-manager/rotation" });
|
|
442
|
+
log.info("[Emergency] Rotation triggered due to context overflow risk");
|
|
443
|
+
}
|
|
444
|
+
catch (err) {
|
|
445
|
+
log.error("[Emergency] Rotation trigger failed:", err);
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
const compactionHealth = {
|
|
449
|
+
totalCompactions: 0,
|
|
450
|
+
totalFailures: 0,
|
|
451
|
+
totalAborted: 0,
|
|
452
|
+
inFlightAborted: 0,
|
|
453
|
+
totalTokensBefore: 0,
|
|
454
|
+
totalTokensAfter: 0,
|
|
455
|
+
totalEntriesRemoved: 0,
|
|
456
|
+
totalVerifyFailures: 0,
|
|
457
|
+
totalArchivesWritten: 0,
|
|
458
|
+
lastOutcome: null,
|
|
459
|
+
};
|
|
460
|
+
export function getCompactionHealth() {
|
|
461
|
+
return compactionHealth;
|
|
462
|
+
}
|
|
463
|
+
/** Reset all compaction-health counters. Used by tests and session-start resets. */
|
|
464
|
+
export function resetCompactionHealth() {
|
|
465
|
+
compactionHealth.totalCompactions = 0;
|
|
466
|
+
compactionHealth.totalFailures = 0;
|
|
467
|
+
compactionHealth.totalAborted = 0;
|
|
468
|
+
compactionHealth.inFlightAborted = 0;
|
|
469
|
+
compactionHealth.totalTokensBefore = 0;
|
|
470
|
+
compactionHealth.totalTokensAfter = 0;
|
|
471
|
+
compactionHealth.totalEntriesRemoved = 0;
|
|
472
|
+
compactionHealth.totalVerifyFailures = 0;
|
|
473
|
+
compactionHealth.totalArchivesWritten = 0;
|
|
474
|
+
compactionHealth.lastOutcome = null;
|
|
475
|
+
delete compactionHealth.lastCompactedMessages;
|
|
476
|
+
delete compactionHealth.lastKeptMessages;
|
|
477
|
+
delete compactionHealth.lastErrorMessage;
|
|
478
|
+
}
|
|
479
|
+
/**
|
|
480
|
+
* One-line compaction summary for context_inspect / heartbeat analytics.
|
|
481
|
+
* Returns null only when there is nothing worth reporting: no loss signals
|
|
482
|
+
* AND no originals archives written (i.e. no compaction activity at all).
|
|
483
|
+
*
|
|
484
|
+
* Loss gate: ONLY loss signals (aborts, generic failures, verify rollbacks)
|
|
485
|
+
* keep the loss portion alive. Archives-written is COVERAGE, not loss — it
|
|
486
|
+
* never contributes to the gate, but is reported as non-loss telemetry
|
|
487
|
+
* whenever compaction activity happened (even with zero failures), so the
|
|
488
|
+
* always-on archive surface is measurable.
|
|
489
|
+
*/
|
|
490
|
+
export function formatCompactionLossLine() {
|
|
491
|
+
const bad = compactionHealth.totalAborted +
|
|
492
|
+
compactionHealth.totalFailures +
|
|
493
|
+
compactionHealth.inFlightAborted +
|
|
494
|
+
compactionHealth.totalVerifyFailures;
|
|
495
|
+
const archives = compactionHealth.totalArchivesWritten;
|
|
496
|
+
const lastCompacted = compactionHealth.lastCompactedMessages;
|
|
497
|
+
// A last-compaction measurement is compaction activity worth surfacing —
|
|
498
|
+
// include it in the gate alongside loss signals and archive coverage.
|
|
499
|
+
if (bad === 0 && archives === 0 && lastCompacted === undefined)
|
|
500
|
+
return null;
|
|
501
|
+
const parts = [];
|
|
502
|
+
if (bad > 0) {
|
|
503
|
+
parts.push(`compaction loss: ${compactionHealth.inFlightAborted} in-flight aborts, ` +
|
|
504
|
+
`${compactionHealth.totalFailures} failures, ${compactionHealth.totalCompactions} compacts`);
|
|
505
|
+
}
|
|
506
|
+
// A verify rejection is a loss signal (a rollback happened) — report it
|
|
507
|
+
// next to the failure counts.
|
|
508
|
+
if (compactionHealth.totalVerifyFailures > 0) {
|
|
509
|
+
parts.push(`verify rollbacks: ${compactionHealth.totalVerifyFailures}`);
|
|
510
|
+
}
|
|
511
|
+
// Coverage telemetry, NOT loss: emitted only when archives actually exist —
|
|
512
|
+
// still reported when failures are zero, so a bare abort/loss with no
|
|
513
|
+
// archives never gains an `archives: 0` suffix.
|
|
514
|
+
if (archives > 0) {
|
|
515
|
+
parts.push(`archives: ${archives}`);
|
|
516
|
+
}
|
|
517
|
+
// The compacted-vs-kept counters of the last successful
|
|
518
|
+
// compaction (kept side degrades to "?" when its source was absent).
|
|
519
|
+
if (lastCompacted !== undefined) {
|
|
520
|
+
parts.push(`last compaction: ${lastCompacted} compacted → ${compactionHealth.lastKeptMessages ?? "?"} kept`);
|
|
521
|
+
}
|
|
522
|
+
return parts.join(" · ");
|
|
523
|
+
}
|
|
524
|
+
export function recordCompactionOutcome(outcome, details) {
|
|
525
|
+
compactionHealth.lastOutcome = outcome;
|
|
526
|
+
if (outcome === "success") {
|
|
527
|
+
compactionHealth.totalCompactions++;
|
|
528
|
+
if (details?.tokensBefore)
|
|
529
|
+
compactionHealth.totalTokensBefore += details.tokensBefore;
|
|
530
|
+
if (details?.tokensAfter)
|
|
531
|
+
compactionHealth.totalTokensAfter += details.tokensAfter;
|
|
532
|
+
if (details?.entriesRemoved)
|
|
533
|
+
compactionHealth.totalEntriesRemoved += details.entriesRemoved;
|
|
534
|
+
// Last-compaction counters (reassigned every success so a
|
|
535
|
+
// stale value from an earlier cycle can never masquerade as current).
|
|
536
|
+
compactionHealth.lastCompactedMessages = details?.compactedMessages;
|
|
537
|
+
compactionHealth.lastKeptMessages = details?.keptMessages;
|
|
538
|
+
}
|
|
539
|
+
else if (outcome === "aborted") {
|
|
540
|
+
// P2a: aborts are counted distinctly from failures and successes.
|
|
541
|
+
compactionHealth.totalAborted++;
|
|
542
|
+
if (details?.inFlight)
|
|
543
|
+
compactionHealth.inFlightAborted++;
|
|
544
|
+
compactionHealth.lastErrorMessage = details?.errorMessage;
|
|
545
|
+
}
|
|
546
|
+
else {
|
|
547
|
+
compactionHealth.totalFailures++;
|
|
548
|
+
compactionHealth.lastErrorMessage = details?.errorMessage;
|
|
549
|
+
}
|
|
550
|
+
}
|
|
551
|
+
/**
|
|
552
|
+
* Increment a non-outcome CompactionHealth counter.
|
|
553
|
+
* Distinct from recordCompactionOutcome (which encodes the cycle outcome as a
|
|
554
|
+
* whole): these two counters measure the real state — every verify
|
|
555
|
+
* rejection is a rollback (loss), every originals archive append is coverage
|
|
556
|
+
* (not loss). Callers only bump the archive counter AFTER a successful
|
|
557
|
+
* appendFileSync so a failed write never inflates coverage.
|
|
558
|
+
*/
|
|
559
|
+
export function recordCompactionHealth(counter) {
|
|
560
|
+
compactionHealth[counter]++;
|
|
561
|
+
}
|
|
562
|
+
// Formatting helpers
|
|
563
|
+
export function formatPruneCandidates(candidates, count) {
|
|
564
|
+
const lines = [];
|
|
565
|
+
for (let i = 0; i < (count ?? candidates.length); i++) {
|
|
566
|
+
const c = candidates[i];
|
|
567
|
+
if (!c)
|
|
568
|
+
break;
|
|
569
|
+
const role = c.role || "?";
|
|
570
|
+
const preview = (c.preview || "").slice(0, 60);
|
|
571
|
+
const reason = c.reason || "unknown";
|
|
572
|
+
const age = c.age !== undefined ? `${c.age} turns` : "?";
|
|
573
|
+
const score = c.score !== undefined ? `${(c.score * 100).toFixed(0)}%` : "?";
|
|
574
|
+
lines.push(`${i + 1}. [${role}] ${preview} (age: ${age}, score: ${score})`);
|
|
575
|
+
lines.push(` Reason: ${reason}`);
|
|
576
|
+
}
|
|
577
|
+
return lines.join("\n");
|
|
578
|
+
}
|
|
579
|
+
//# sourceMappingURL=shared.js.map
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool-batch-safe compaction boundaries.
|
|
3
|
+
*
|
|
4
|
+
* braid supplies the compaction boundary (`firstKeptEntryId`) that pi-core
|
|
5
|
+
* consumes verbatim: slide cuts, archive ranges, and the deterministic
|
|
6
|
+
* (high-context/failsafe) cuts all hand one over. pi-core's own cut-point
|
|
7
|
+
* selector never picks a tool result - `isCutPointMessage` returns false for
|
|
8
|
+
* `toolResult` (pi-coding-agent dist/core/compaction/compaction.js:253-266)
|
|
9
|
+
* and `findValidCutPoints` is built on it (:288-305) - because the kept slice
|
|
10
|
+
* after a compaction becomes the opening of the next provider request, where a
|
|
11
|
+
* `tool` message without its preceding `tool_calls` (or a truncated parallel
|
|
12
|
+
* batch) is rejected with: "Messages with role 'tool' must be a response to a
|
|
13
|
+
* preceding message with 'tool_calls'" (HTTP 400). A boundary braid supplies
|
|
14
|
+
* must keep that invariant; pi-core applies no defensive snap of its own.
|
|
15
|
+
*
|
|
16
|
+
* Every boundary supplier routes its candidate index through
|
|
17
|
+
* `snapBoundaryOutsideToolBatch`, and the consumers that persist a stored
|
|
18
|
+
* boundary id re-derive the index and snap it against the branch as it stands
|
|
19
|
+
* at consumption (the armer may have read the branch before the batch's later
|
|
20
|
+
* results landed).
|
|
21
|
+
*
|
|
22
|
+
* The readers take raw session entries (`readonly unknown[]`) because that is
|
|
23
|
+
* what a live branch is at the boundaries; the shape is narrowed here rather
|
|
24
|
+
* than asserted at every call site.
|
|
25
|
+
*/
|
|
26
|
+
/** A kept slice is "minimal" at one entry; below that the snap goes backward. */
|
|
27
|
+
export declare const MIN_KEPT_ENTRIES = 1;
|
|
28
|
+
/**
|
|
29
|
+
* The structurally invalid shape of a kept slice [candidateIndex..end]:
|
|
30
|
+
* either it begins with a tool result (its call fell outside the slice), or it
|
|
31
|
+
* contains an assistant whose tool_calls are not fully answered inside it.
|
|
32
|
+
* Returns null for a valid slice. Exported for tests and audit surfaces.
|
|
33
|
+
*/
|
|
34
|
+
export declare function findBoundaryViolation(entries: readonly unknown[], candidateIndex: number): {
|
|
35
|
+
kind: "leading-tool-result" | "unanswered-tool-calls";
|
|
36
|
+
entryId?: string;
|
|
37
|
+
/** Index of the offending assistant entry (unanswered-tool-calls). */
|
|
38
|
+
assistantIndex?: number;
|
|
39
|
+
} | null;
|
|
40
|
+
/**
|
|
41
|
+
* Snap a candidate first-kept index so the kept slice [result..end] cannot
|
|
42
|
+
* split a tool batch:
|
|
43
|
+
* - a candidate landing mid-batch snaps FORWARD to the first entry after
|
|
44
|
+
* the batch's last tool result (parallel calls are one batch of N results);
|
|
45
|
+
* - when that would keep less than `MIN_KEPT_ENTRIES`, it snaps BACKWARD to
|
|
46
|
+
* the batch's assistant message instead, keeping the whole batch live;
|
|
47
|
+
* - a leading result whose call is no longer in the branch (summarized away)
|
|
48
|
+
* is dropped by snapping forward past the leading run.
|
|
49
|
+
* Returns the candidate unchanged when it is already valid (or when the branch
|
|
50
|
+
* is empty). Deterministic, pure, and safe on a branch that grows later: a
|
|
51
|
+
* boundary computed from incomplete in-flight results lands on the batch's
|
|
52
|
+
* assistant via the backward snap, which stays valid as the rest arrive.
|
|
53
|
+
*/
|
|
54
|
+
export declare function snapBoundaryOutsideToolBatch(entries: readonly unknown[], candidateIndex: number): number;
|
|
55
|
+
//# sourceMappingURL=tool-batch-boundary.d.ts.map
|