pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,800 @@
|
|
|
1
|
+
// Bounded chunked summarization.
|
|
2
|
+
//
|
|
3
|
+
// One summarization request that swallows an oversized span dies on the output
|
|
4
|
+
// token cap: pi-ai clamps the request's max_tokens to window - estimate(prompt)
|
|
5
|
+
// - 4096 (simple-options.js:6-12), and a 185-message span in one call with
|
|
6
|
+
// xhigh reasoning billed inside the same budget is length-stopped before the
|
|
7
|
+
// summary completes ("Summarization failed: generation hit the token cap and
|
|
8
|
+
// the summary is incomplete"). This module owns the bounded alternative: split
|
|
9
|
+
// the span into units (an assistant tool-call turn glued to its toolResults),
|
|
10
|
+
// pack the units into chunks under a per-call input cap, and summarize
|
|
11
|
+
// successively — each chunk's prompt carries the running summary, the previous
|
|
12
|
+
// compaction summary, and the user anchor, and its output becomes the next
|
|
13
|
+
// running summary. Every request is then bounded on both the input side (chunk
|
|
14
|
+
// cap) and the output side (its own fixed budget, reasoning off).
|
|
15
|
+
//
|
|
16
|
+
// The fold grows: each call's output becomes the next call's running summary,
|
|
17
|
+
// so a span whose accumulated summary reaches the output budget length-stops
|
|
18
|
+
// every later chunk no matter how small that chunk's own input is. Splitting a
|
|
19
|
+
// chunk's INPUT cannot shrink the FOLD, so a fold that survives its own
|
|
20
|
+
// rewrite burns the call budget down to a single unit and aborts. A
|
|
21
|
+
// length-stop on a material fold therefore runs the fold-shrink rung first:
|
|
22
|
+
// one bounded rewrite attempt (accepted only when it is not itself
|
|
23
|
+
// length-stopped and keeps at least half the fold), then - whichever way the
|
|
24
|
+
// rewrite went - a deterministic head-and-tail reduction that lands the fold
|
|
25
|
+
// strictly below CHUNK_FOLD_TARGET_TOKENS with no model call and names the
|
|
26
|
+
// elision in the summary. The retry merge then cannot hit the same fold wall.
|
|
27
|
+
// Only when the fold is not the cause (below the material share) does the
|
|
28
|
+
// ladder split the chunk's units (the content-dense class the split recovers,
|
|
29
|
+
// 60-unit chunks into 30+30) or accept the partial merge, keeping the running
|
|
30
|
+
// fold untouched when that partial text is shorter than the fold. Only a call
|
|
31
|
+
// budget exhausted with work left is a summary-cap failure.
|
|
32
|
+
|
|
33
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
34
|
+
import type { Usage } from "@earendil-works/pi-ai";
|
|
35
|
+
import { estimateMessagesTokens, resolveWindow } from "../../../../lib/detection/context-usage.js";
|
|
36
|
+
import { callLlm } from "../../../../lib/ai/llm-call.js";
|
|
37
|
+
import { log, getCmState } from "./shared.js";
|
|
38
|
+
import { notifyCompactionProgress } from "./compaction-watchdog.js";
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* A fold this large (as a share of the merge budget) is a plausible cause of a
|
|
42
|
+
* length-stop on its own: at a quarter of the budget the accumulated summary
|
|
43
|
+
* can consume the whole generation before the new part is merged in. Below
|
|
44
|
+
* the share the fold cannot be the reason, so the ladder goes straight to the
|
|
45
|
+
* unit split.
|
|
46
|
+
*/
|
|
47
|
+
export const CHUNK_FOLD_MATERIAL_SHARE = 0.25;
|
|
48
|
+
|
|
49
|
+
/** Max messages in one summarization call's chunk. */
|
|
50
|
+
export const CHUNK_MAX_MESSAGES = 60;
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Per-call input cap as a share of the context window. The call must coexist
|
|
54
|
+
* with its own output budget and the rest of the request pipeline inside the
|
|
55
|
+
* window; a quarter of the window keeps the serialized chunk an order below
|
|
56
|
+
* the request clamp for every realistic window.
|
|
57
|
+
*/
|
|
58
|
+
export const CHUNK_INPUT_TOKEN_FRACTION = 0.25;
|
|
59
|
+
|
|
60
|
+
/** Floor for the per-call input cap so tiny windows still get usable chunks. */
|
|
61
|
+
export const CHUNK_MIN_INPUT_TOKENS = 8192;
|
|
62
|
+
|
|
63
|
+
/** Fixed output budget per chunk call (a chunk summary is a bounded artifact).
|
|
64
|
+
*
|
|
65
|
+
* Raised from 4096: a dense 60-message chunk is ~23.6K input tokens of
|
|
66
|
+
* preserved paths, identifiers, and error text to fold into a running
|
|
67
|
+
* summary; 4096 output tokens is smaller than that demand for exactly the
|
|
68
|
+
* spans this path serves, so the cap fired deterministically on the live
|
|
69
|
+
* 750-message range archive. 8192 keeps the per-call total (input <= a
|
|
70
|
+
* quarter-window + this output + pipeline overhead) far under the request
|
|
71
|
+
* clamp for every realistic window while roughly doubling the summary
|
|
72
|
+
* headroom. A raised constant moves the threshold; the mechanism that
|
|
73
|
+
* removes the failure class is the length-stop ladder in summarizeSpanInChunks
|
|
74
|
+
* (fold compression, then unit split, then partial acceptance).
|
|
75
|
+
*/
|
|
76
|
+
export const CHUNK_SUMMARY_MAX_TOKENS = 8192;
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Output budget for one fold-compression rewrite. A rewrite is not a merge: it
|
|
80
|
+
* must only shrink the running summary while preserving structure and verbatim
|
|
81
|
+
* identifiers, so its budget stays far below the merge budget - a 2048-token
|
|
82
|
+
* fold leaves the 8192-token merge ample output headroom.
|
|
83
|
+
*/
|
|
84
|
+
export const CHUNK_FOLD_COMPRESS_MAX_TOKENS = 2048;
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* A fold-compression rewrite is accepted only when it is not itself
|
|
88
|
+
* length-stopped AND keeps at least this share of the running fold. A shorter
|
|
89
|
+
* rewrite either dropped most of the fold or was cut by its own output budget
|
|
90
|
+
* (a length stop consumed as success is exactly the silent loss the acceptance
|
|
91
|
+
* rung's length rule closes one rung later). A refused rewrite keeps the fold
|
|
92
|
+
* and falls through to the unit split.
|
|
93
|
+
*/
|
|
94
|
+
export const CHUNK_FOLD_MIN_KEEP_SHARE = 0.5;
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Token count at which the running fold is treated as the cause of a
|
|
98
|
+
* length-stop: at or above it the accumulated summary can consume the whole
|
|
99
|
+
* merge generation on its own. The fold-shrink rung must leave the fold
|
|
100
|
+
* STRICTLY below this count before the merge is retried, or the same
|
|
101
|
+
* length-stop repeats and the cycle burns its call budget without shrinking
|
|
102
|
+
* the fold. Named once here; both the discriminator and the deterministic
|
|
103
|
+
* reduction read it.
|
|
104
|
+
*/
|
|
105
|
+
export const CHUNK_FOLD_TARGET_TOKENS = Math.floor(
|
|
106
|
+
CHUNK_SUMMARY_MAX_TOKENS * CHUNK_FOLD_MATERIAL_SHARE,
|
|
107
|
+
);
|
|
108
|
+
|
|
109
|
+
/** Chars per token used to compare a fold's length against the token target. */
|
|
110
|
+
export const CHUNK_FOLD_CHARS_PER_TOKEN = 4;
|
|
111
|
+
|
|
112
|
+
/** Hard ceiling on chunk count; beyond it the caller falls back to pi-core. */
|
|
113
|
+
export const CHUNK_COUNT_MAX = 16;
|
|
114
|
+
|
|
115
|
+
/** Per-call timeout: bounded input + fixed output must settle far below it. */
|
|
116
|
+
export const CHUNK_CALL_TIMEOUT_MS = 180_000;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Hard bound on total callLlm invocations across one summarizeSpanInChunks
|
|
120
|
+
* run, split retries included. The base chain is <=
|
|
121
|
+
* CHUNK_COUNT_MAX calls; every capped chunk adds its halves to the worklist,
|
|
122
|
+
* so without a stated bound a pathological all-cap span recurses
|
|
123
|
+
* unbounded. Exceeding the budget returns the honest summary-cap failure
|
|
124
|
+
* (no fall-through); the compaction retry ladder owns the next move.
|
|
125
|
+
*/
|
|
126
|
+
export const CHUNK_SPLIT_CALL_BUDGET = 64;
|
|
127
|
+
|
|
128
|
+
interface SpanChunk {
|
|
129
|
+
messages: unknown[];
|
|
130
|
+
estimatedTokens: number;
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* Group a span's messages into units that must not be split across chunks: an
|
|
135
|
+
* assistant message carrying toolCall blocks is glued to every immediately
|
|
136
|
+
* following toolResult message, so a call and its results stay in one chunk
|
|
137
|
+
* (a chunk boundary between them would produce summaries that reference
|
|
138
|
+
* results they never saw).
|
|
139
|
+
*/
|
|
140
|
+
export function groupIntoUnits(messages: readonly unknown[]): unknown[][] {
|
|
141
|
+
const units: unknown[][] = [];
|
|
142
|
+
let i = 0;
|
|
143
|
+
while (i < messages.length) {
|
|
144
|
+
const message = messages[i] as { role?: string; content?: unknown } | undefined;
|
|
145
|
+
const hasToolCalls =
|
|
146
|
+
message?.role === "assistant" &&
|
|
147
|
+
Array.isArray(message.content) &&
|
|
148
|
+
message.content.some(
|
|
149
|
+
(c: { type?: string }) => c && typeof c === "object" && c.type === "toolCall",
|
|
150
|
+
);
|
|
151
|
+
if (!hasToolCalls) {
|
|
152
|
+
units.push([messages[i]]);
|
|
153
|
+
i++;
|
|
154
|
+
continue;
|
|
155
|
+
}
|
|
156
|
+
const unit: unknown[] = [messages[i]];
|
|
157
|
+
i++;
|
|
158
|
+
while (i < messages.length) {
|
|
159
|
+
const next = messages[i] as { role?: string } | undefined;
|
|
160
|
+
if (next?.role !== "toolResult") break;
|
|
161
|
+
unit.push(next);
|
|
162
|
+
i++;
|
|
163
|
+
}
|
|
164
|
+
units.push(unit);
|
|
165
|
+
}
|
|
166
|
+
return units;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/**
|
|
170
|
+
* Pack units into chunks under the per-call input cap and the per-chunk
|
|
171
|
+
* message cap. Returns null when the span needs more chunks than
|
|
172
|
+
* CHUNK_COUNT_MAX — the caller then falls back to the default path instead of
|
|
173
|
+
* silently unbounding a call. A single unit whose own estimate exceeds the cap
|
|
174
|
+
* becomes its own chunk: the serialized text is typically smaller than the raw
|
|
175
|
+
* estimate (toolResults truncate at 2000 chars), so honesty beats silence.
|
|
176
|
+
*/
|
|
177
|
+
export function planChunks(
|
|
178
|
+
messages: readonly unknown[],
|
|
179
|
+
contextWindow: number,
|
|
180
|
+
): SpanChunk[] | null {
|
|
181
|
+
if (!Array.isArray(messages) || messages.length === 0) return [];
|
|
182
|
+
const cap = Math.max(
|
|
183
|
+
CHUNK_MIN_INPUT_TOKENS,
|
|
184
|
+
Math.floor(contextWindow * CHUNK_INPUT_TOKEN_FRACTION),
|
|
185
|
+
);
|
|
186
|
+
const units = groupIntoUnits(messages);
|
|
187
|
+
const unitTokens = units.map((u) => estimateMessagesTokens(u));
|
|
188
|
+
const chunks: SpanChunk[] = [];
|
|
189
|
+
let current: unknown[] = [];
|
|
190
|
+
let currentTokens = 0;
|
|
191
|
+
for (let i = 0; i < units.length; i++) {
|
|
192
|
+
const unit = units[i];
|
|
193
|
+
const tokens = unitTokens[i];
|
|
194
|
+
const tooManyMessages = current.length > 0 && current.length + unit.length > CHUNK_MAX_MESSAGES;
|
|
195
|
+
const tooManyTokens = current.length > 0 && currentTokens + tokens > cap;
|
|
196
|
+
if (tooManyMessages || tooManyTokens) {
|
|
197
|
+
chunks.push({ messages: current, estimatedTokens: currentTokens });
|
|
198
|
+
current = [];
|
|
199
|
+
currentTokens = 0;
|
|
200
|
+
}
|
|
201
|
+
current = current.concat(unit);
|
|
202
|
+
currentTokens += tokens;
|
|
203
|
+
if (currentTokens > cap) {
|
|
204
|
+
// Oversized unit alone in its chunk - keep it, log loudly.
|
|
205
|
+
chunks.push({ messages: current, estimatedTokens: currentTokens });
|
|
206
|
+
current = [];
|
|
207
|
+
currentTokens = 0;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
if (current.length > 0) chunks.push({ messages: current, estimatedTokens: currentTokens });
|
|
211
|
+
if (chunks.length > CHUNK_COUNT_MAX) return null;
|
|
212
|
+
return chunks;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* The previous compaction summary on the current branch — the substance a new
|
|
217
|
+
* compaction entry supersedes and therefore must carry forward (older
|
|
218
|
+
* compaction entries project to empty in the canonical context, so a summary
|
|
219
|
+
* that drops it erases everything the branch compacted before). Returns
|
|
220
|
+
* undefined when the branch has no non-empty compaction summary.
|
|
221
|
+
*/
|
|
222
|
+
export function findPreviousSummary(
|
|
223
|
+
branch: ReadonlyArray<{ type?: string; summary?: unknown }>,
|
|
224
|
+
): string | undefined {
|
|
225
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
226
|
+
const entry = branch[i];
|
|
227
|
+
if (entry?.type === "compaction" && typeof entry.summary === "string" && entry.summary.trim()) {
|
|
228
|
+
return entry.summary;
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
return undefined;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
const CHUNK_SYSTEM_PROMPT =
|
|
235
|
+
"You are a conversation summarization assistant. You never continue the conversation " +
|
|
236
|
+
"and never answer questions found in it; you merge the given conversation part into " +
|
|
237
|
+
"the running structured summary and output only that summary.";
|
|
238
|
+
|
|
239
|
+
const CHUNK_FOLD_COMPRESS_PROMPT =
|
|
240
|
+
"The running summary below has grown too long to keep merging new conversation parts " +
|
|
241
|
+
"into it. Rewrite it so it is substantially shorter: keep the same section structure, " +
|
|
242
|
+
"keep every exact file path, identifier, function name, and error message verbatim, " +
|
|
243
|
+
"and drop only restatement and detail a future session can reconstruct. Output ONLY " +
|
|
244
|
+
"the rewritten summary.";
|
|
245
|
+
|
|
246
|
+
const CHUNK_FORMAT_SPEC = [
|
|
247
|
+
"Output ONLY the updated summary, in exactly this structure (no preamble, no commentary):",
|
|
248
|
+
"",
|
|
249
|
+
"## Goal",
|
|
250
|
+
"## Constraints & Preferences",
|
|
251
|
+
"## Progress",
|
|
252
|
+
"## Key Decisions",
|
|
253
|
+
"## Next Steps",
|
|
254
|
+
"## Critical Context",
|
|
255
|
+
"",
|
|
256
|
+
"Keep each section concise. Preserve exact file paths, function names, identifiers, and",
|
|
257
|
+
"error messages verbatim — they are the part a future session cannot reconstruct.",
|
|
258
|
+
].join("\n");
|
|
259
|
+
|
|
260
|
+
function buildChunkUserPrompt(params: {
|
|
261
|
+
partIndex: number;
|
|
262
|
+
partCount: number;
|
|
263
|
+
serialized: string;
|
|
264
|
+
runningSummary?: string;
|
|
265
|
+
anchor?: { topic: string; summary: string };
|
|
266
|
+
}): string {
|
|
267
|
+
const parts: string[] = [
|
|
268
|
+
`This is part ${params.partIndex} of ${params.partCount} of one conversation (user and assistant turns). ` +
|
|
269
|
+
"Merge the conversation part below into the running summary per the output format.",
|
|
270
|
+
"",
|
|
271
|
+
CHUNK_FORMAT_SPEC,
|
|
272
|
+
];
|
|
273
|
+
if (params.anchor) {
|
|
274
|
+
parts.push(
|
|
275
|
+
"",
|
|
276
|
+
`The user declared this range as an archive of topic "${params.anchor.topic}". Fold the ` +
|
|
277
|
+
"intent, changes made, decisions, and next steps of this anchor summary into the output; " +
|
|
278
|
+
"keep its substance intact:",
|
|
279
|
+
"---ANCHOR---",
|
|
280
|
+
params.anchor.summary,
|
|
281
|
+
"---END ANCHOR---",
|
|
282
|
+
);
|
|
283
|
+
}
|
|
284
|
+
if (params.runningSummary) {
|
|
285
|
+
parts.push("", "<running-summary>", params.runningSummary, "</running-summary>");
|
|
286
|
+
}
|
|
287
|
+
parts.push("", "<conversation-part>", params.serialized, "</conversation-part>");
|
|
288
|
+
return parts.join("\n");
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
export interface ChunkedSummaryResult {
|
|
292
|
+
summary: string;
|
|
293
|
+
chunkCount: number;
|
|
294
|
+
spanMessages: number;
|
|
295
|
+
spanTokens: number;
|
|
296
|
+
usage: Usage | undefined;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* One bounded fold-compression call: rewrite the accumulated running summary
|
|
301
|
+
* shorter so the next merge has output headroom. The raw text and its stop
|
|
302
|
+
* reason are returned; the ladder owns the accept/refuse decision, because it
|
|
303
|
+
* holds the fold length the keep floor is measured against and knows how to
|
|
304
|
+
* continue when the rewrite is refused.
|
|
305
|
+
*/
|
|
306
|
+
async function compressRunningSummary(params: {
|
|
307
|
+
model: NonNullable<ExtensionContext["model"]>;
|
|
308
|
+
apiKey: string | undefined;
|
|
309
|
+
running: string;
|
|
310
|
+
signal?: AbortSignal;
|
|
311
|
+
}): Promise<{ text: string; stopReason?: string } | { error: string }> {
|
|
312
|
+
const prompt = [
|
|
313
|
+
CHUNK_FOLD_COMPRESS_PROMPT,
|
|
314
|
+
"",
|
|
315
|
+
"<running-summary>",
|
|
316
|
+
params.running,
|
|
317
|
+
"</running-summary>",
|
|
318
|
+
].join("\n");
|
|
319
|
+
const result = await callLlm(params.model, params.apiKey, CHUNK_SYSTEM_PROMPT, prompt, {
|
|
320
|
+
maxTokens: CHUNK_FOLD_COMPRESS_MAX_TOKENS,
|
|
321
|
+
reasoning: "off",
|
|
322
|
+
timeoutMs: CHUNK_CALL_TIMEOUT_MS,
|
|
323
|
+
signal: params.signal,
|
|
324
|
+
});
|
|
325
|
+
if ("error" in result) return { error: `fold compression failed: ${result.error}` };
|
|
326
|
+
const text = (result.text ?? "").trim();
|
|
327
|
+
if (!text) return { error: "fold compression returned an empty rewrite" };
|
|
328
|
+
return { text, stopReason: result.stopReason };
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
/**
|
|
332
|
+
* Deterministic fold reduction: the floor of the fold-shrink rung. Keep a
|
|
333
|
+
* bounded head and tail of the running summary, elide the middle, and name
|
|
334
|
+
* the loss inline with the existing `[note: ...]` convention. No model call,
|
|
335
|
+
* so it always runs and always lands the fold strictly below
|
|
336
|
+
* {@link CHUNK_FOLD_TARGET_TOKENS}: a fold the model would not rewrite shorter
|
|
337
|
+
* can still be made to fit by construction, and the note states what was
|
|
338
|
+
* dropped (the full fold stays in the append-only session file).
|
|
339
|
+
*
|
|
340
|
+
* The character budget is one token below the target because the token count
|
|
341
|
+
* is `ceil(chars / CHUNK_FOLD_CHARS_PER_TOKEN)`: `(target - 1) * charsPerToken`
|
|
342
|
+
* chars still round to `target - 1` tokens, below the material share. The note
|
|
343
|
+
* is sized for a 12-digit elided count, which bounds any real fold.
|
|
344
|
+
*/
|
|
345
|
+
function reduceFoldDeterministically(
|
|
346
|
+
fold: string,
|
|
347
|
+
logPrefix: string,
|
|
348
|
+
partIndex: number,
|
|
349
|
+
): { text: string; elidedChars: number } {
|
|
350
|
+
const targetChars = (CHUNK_FOLD_TARGET_TOKENS - 1) * CHUNK_FOLD_CHARS_PER_TOKEN;
|
|
351
|
+
const notePrefix = "\n\n[note: ";
|
|
352
|
+
const noteSuffix =
|
|
353
|
+
" characters from the middle of the running summary were elided deterministically " +
|
|
354
|
+
"(head and tail kept) to bring the fold below its budget; the elided text stays in " +
|
|
355
|
+
"the append-only session file.]\n\n";
|
|
356
|
+
const maxNoteChars = notePrefix.length + noteSuffix.length + 12;
|
|
357
|
+
const side = Math.max(1, Math.floor((targetChars - maxNoteChars) / 2));
|
|
358
|
+
const head = fold.slice(0, side);
|
|
359
|
+
const tail = fold.slice(Math.max(side, fold.length - side));
|
|
360
|
+
const elidedChars = Math.max(0, fold.length - head.length - tail.length);
|
|
361
|
+
const text = `${head}${notePrefix}${elidedChars}${noteSuffix}${tail}`;
|
|
362
|
+
log.warn(
|
|
363
|
+
`[context-manager] ${logPrefix} chunk ${partIndex}: the running fold could not be shrunk by ` +
|
|
364
|
+
`rewrite - eliding ${elidedChars} characters from its middle deterministically ` +
|
|
365
|
+
`(${fold.length} -> ${text.length} chars, target <${CHUNK_FOLD_TARGET_TOKENS} tokens)`,
|
|
366
|
+
);
|
|
367
|
+
return { text, elidedChars };
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* The fold-shrink rung: the ladder's guarantee that a material fold can
|
|
372
|
+
* always be reduced. One bounded rewrite attempt, then - whether the rewrite
|
|
373
|
+
* landed, was refused, or no call budget remained for it - the deterministic
|
|
374
|
+
* reduction. Returns a fold strictly below {@link CHUNK_FOLD_TARGET_TOKENS}.
|
|
375
|
+
* `refused` names a rewrite that did not land (the summary note reports it);
|
|
376
|
+
* `elidedChars` reports the deterministic loss; `calls` is the rewrite call
|
|
377
|
+
* count for the caller's budget.
|
|
378
|
+
*/
|
|
379
|
+
async function shrinkRunningFold(params: {
|
|
380
|
+
model: NonNullable<ExtensionContext["model"]>;
|
|
381
|
+
apiKey: string | undefined;
|
|
382
|
+
running: string;
|
|
383
|
+
signal?: AbortSignal;
|
|
384
|
+
logPrefix: string;
|
|
385
|
+
partIndex: number;
|
|
386
|
+
partCount: number;
|
|
387
|
+
canCallLlm: boolean;
|
|
388
|
+
}): Promise<{ text: string; refused: boolean; elidedChars: number; calls: number }> {
|
|
389
|
+
let fold = params.running;
|
|
390
|
+
let refused = false;
|
|
391
|
+
let calls = 0;
|
|
392
|
+
const foldTokens = () => Math.ceil(fold.length / CHUNK_FOLD_CHARS_PER_TOKEN);
|
|
393
|
+
if (foldTokens() >= CHUNK_FOLD_TARGET_TOKENS) {
|
|
394
|
+
if (params.canCallLlm) {
|
|
395
|
+
calls++;
|
|
396
|
+
const compressed = await compressRunningSummary({
|
|
397
|
+
model: params.model,
|
|
398
|
+
apiKey: params.apiKey,
|
|
399
|
+
running: fold,
|
|
400
|
+
signal: params.signal,
|
|
401
|
+
});
|
|
402
|
+
if ("error" in compressed) {
|
|
403
|
+
refused = true;
|
|
404
|
+
log.warn(
|
|
405
|
+
`[context-manager] ${params.logPrefix} fold compression did not land (${compressed.error}) - ` +
|
|
406
|
+
`reducing the fold deterministically instead`,
|
|
407
|
+
);
|
|
408
|
+
} else {
|
|
409
|
+
const minKeep = Math.floor(fold.length * CHUNK_FOLD_MIN_KEEP_SHARE);
|
|
410
|
+
const stoppedAtLength = compressed.stopReason === "length";
|
|
411
|
+
const belowKeepFloor = compressed.text.length < minKeep;
|
|
412
|
+
if (stoppedAtLength || belowKeepFloor) {
|
|
413
|
+
refused = true;
|
|
414
|
+
log.warn(
|
|
415
|
+
`[context-manager] ${params.logPrefix} fold compression refused (` +
|
|
416
|
+
(stoppedAtLength
|
|
417
|
+
? "the rewrite was length-stopped"
|
|
418
|
+
: `the ${compressed.text.length}-char rewrite is below the ${minKeep}-char keep floor`) +
|
|
419
|
+
`) - reducing the fold deterministically instead`,
|
|
420
|
+
);
|
|
421
|
+
} else {
|
|
422
|
+
log.warn(
|
|
423
|
+
`[context-manager] ${params.logPrefix} chunk ${params.partIndex}/${params.partCount} hit the ` +
|
|
424
|
+
`output cap with a ${foldTokens()}-token fold - compressing the running summary once and ` +
|
|
425
|
+
`retrying the merge`,
|
|
426
|
+
);
|
|
427
|
+
fold = compressed.text;
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
} else {
|
|
431
|
+
refused = true;
|
|
432
|
+
log.warn(
|
|
433
|
+
`[context-manager] ${params.logPrefix} fold compression skipped (call budget spent) - ` +
|
|
434
|
+
`reducing the fold deterministically instead`,
|
|
435
|
+
);
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
let elidedChars = 0;
|
|
439
|
+
if (foldTokens() >= CHUNK_FOLD_TARGET_TOKENS) {
|
|
440
|
+
const reduced = reduceFoldDeterministically(fold, params.logPrefix, params.partIndex);
|
|
441
|
+
fold = reduced.text;
|
|
442
|
+
elidedChars = reduced.elidedChars;
|
|
443
|
+
}
|
|
444
|
+
return { text: fold, refused, elidedChars, calls };
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
/** Error variant of the chunked summary. failureClass marks the cycle's
|
|
448
|
+
* failure class where the chunked path itself knows it (today only the
|
|
449
|
+
* summary-cap class); callers route on it instead of re-parsing the text. */
|
|
450
|
+
export interface ChunkedSummaryError {
|
|
451
|
+
error: string;
|
|
452
|
+
failureClass?: "summary-cap";
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
/**
|
|
456
|
+
* Test seam: force the chunked summary to report a class without running the
|
|
457
|
+
* chain. Mirrors the codebase's other __set*ForTest seams. The controller's
|
|
458
|
+
* never-block rung (the deterministic cut after a bounded summarizer failure)
|
|
459
|
+
* is otherwise unreachable from a test: the length-stop ladder completes a
|
|
460
|
+
* chain in-process instead of failing the cycle.
|
|
461
|
+
*/
|
|
462
|
+
let forcedFailureForTest: "summary-cap" | null = null;
|
|
463
|
+
export function __setChunkedSummaryFailureForTest(failure: "summary-cap" | null): void {
|
|
464
|
+
forcedFailureForTest = failure;
|
|
465
|
+
}
|
|
466
|
+
|
|
467
|
+
/**
|
|
468
|
+
* Test seam: the deterministic fold reduction in isolation, so a fixture can
|
|
469
|
+
* assert the guarantee without driving a whole chain (the fold it returns is
|
|
470
|
+
* the one the rung lands; the stub cannot observe the fold at retry time).
|
|
471
|
+
*/
|
|
472
|
+
export function __reduceFoldForTest(fold: string): { text: string; elidedChars: number } {
|
|
473
|
+
return reduceFoldDeterministically(fold, "test-fold-reduce", 1);
|
|
474
|
+
}
|
|
475
|
+
|
|
476
|
+
/**
|
|
477
|
+
* Summarize a span in bounded chunks with reasoning off, split-on-cap: a
|
|
478
|
+
* chunk whose generation is length-stopped splits into two unit-halves that
|
|
479
|
+
* re-enter the worklist and retry (the whole-chain abort on one capped chunk
|
|
480
|
+
* is gone), under the hard CHUNK_SPLIT_CALL_BUDGET. Returns the final merged
|
|
481
|
+
* summary, or { error, failureClass? }; a summary-cap-class failureClass
|
|
482
|
+
* tells the caller to fail the cycle honestly — never to hand the span to
|
|
483
|
+
* pi-core's unbounded single-call summarizer, which is the one recovery that
|
|
484
|
+
* cannot work for the class that made the bounded path necessary. Abort
|
|
485
|
+
* honesty: a watchdog cancel between chunks stops the chain instead of
|
|
486
|
+
* feeding a dead cycle.
|
|
487
|
+
*/
|
|
488
|
+
export async function summarizeSpanInChunks(params: {
|
|
489
|
+
ctx: ExtensionContext;
|
|
490
|
+
span: readonly unknown[];
|
|
491
|
+
anchor?: { topic: string; summary: string };
|
|
492
|
+
/** Summary from the previous compaction (pi-core's prepared previousSummary); falls back to a branch walk. */
|
|
493
|
+
previousSummary?: string;
|
|
494
|
+
/** Cycle abort signal (session_before_compact carries pi-core's compaction controller). */
|
|
495
|
+
signal?: AbortSignal;
|
|
496
|
+
logPrefix: string;
|
|
497
|
+
}): Promise<ChunkedSummaryResult | ChunkedSummaryError> {
|
|
498
|
+
const { ctx, span, anchor, signal, logPrefix } = params;
|
|
499
|
+
if (forcedFailureForTest) {
|
|
500
|
+
return {
|
|
501
|
+
error: `forced ${forcedFailureForTest} failure (test seam)`,
|
|
502
|
+
failureClass: forcedFailureForTest,
|
|
503
|
+
};
|
|
504
|
+
}
|
|
505
|
+
const model = ctx.model;
|
|
506
|
+
if (!model) return { error: "no model available for the chunked summary" };
|
|
507
|
+
const window = resolveWindow(ctx?.model?.contextWindow).contextWindow;
|
|
508
|
+
const chunks = planChunks(span, window);
|
|
509
|
+
if (!chunks) {
|
|
510
|
+
return {
|
|
511
|
+
error: `span needs more than ${CHUNK_COUNT_MAX} chunks (est. ${estimateMessagesTokens(span)} tokens) - not chunkable within the bounded call shape`,
|
|
512
|
+
};
|
|
513
|
+
}
|
|
514
|
+
if (chunks.length === 0) return { error: "empty span" };
|
|
515
|
+
|
|
516
|
+
let apiKey: string | undefined;
|
|
517
|
+
try {
|
|
518
|
+
apiKey = await (
|
|
519
|
+
ctx.modelRegistry as
|
|
520
|
+
| {
|
|
521
|
+
getApiKeyForProvider?: (provider: string) => Promise<string | undefined>;
|
|
522
|
+
}
|
|
523
|
+
| undefined
|
|
524
|
+
)?.getApiKeyForProvider?.(model.provider);
|
|
525
|
+
} catch {
|
|
526
|
+
apiKey = undefined; // degraded auth - the call will surface its own error
|
|
527
|
+
}
|
|
528
|
+
|
|
529
|
+
let running: string | undefined = params.previousSummary;
|
|
530
|
+
if (!running) {
|
|
531
|
+
try {
|
|
532
|
+
const branch =
|
|
533
|
+
(
|
|
534
|
+
ctx.sessionManager as { getBranch?: () => Array<{ type?: string; summary?: unknown }> }
|
|
535
|
+
).getBranch?.() ?? [];
|
|
536
|
+
running = findPreviousSummary(branch);
|
|
537
|
+
} catch {
|
|
538
|
+
running = undefined;
|
|
539
|
+
}
|
|
540
|
+
}
|
|
541
|
+
|
|
542
|
+
const spanMessages = span.length;
|
|
543
|
+
const spanTokens = estimateMessagesTokens(span);
|
|
544
|
+
// callLlm reports only input/output/totalTokens (no cache/cost fields), so
|
|
545
|
+
// the accumulated usage zero-fills those and the report states the gap.
|
|
546
|
+
const usage: Usage = {
|
|
547
|
+
input: 0,
|
|
548
|
+
output: 0,
|
|
549
|
+
cacheRead: 0,
|
|
550
|
+
cacheWrite: 0,
|
|
551
|
+
totalTokens: 0,
|
|
552
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
|
|
553
|
+
};
|
|
554
|
+
let usageSeen = false;
|
|
555
|
+
|
|
556
|
+
// Worklist of remaining chunks. A length-stopped chunk splits into two
|
|
557
|
+
// unit-halves that re-enter the FRONT of the list (sequential chain, the
|
|
558
|
+
// running-summary fold stays order-preserving) and retry — the split-on-cap
|
|
559
|
+
// mechanism. callsUsed counts every callLlm invocation against
|
|
560
|
+
// CHUNK_SPLIT_CALL_BUDGET; partIndex/partCount track the live worklist so
|
|
561
|
+
// the prompt's "part X of Y" stays true after splits.
|
|
562
|
+
const pending: SpanChunk[] = chunks.slice();
|
|
563
|
+
let callsUsed = 0;
|
|
564
|
+
let completed = 0;
|
|
565
|
+
// Parts whose generation was cut before it reproduced the running fold: the
|
|
566
|
+
// span is still covered by the session file, but this summary does not carry
|
|
567
|
+
// them, and saying so is the honest half of the acceptance rule.
|
|
568
|
+
const unmergedParts: number[] = [];
|
|
569
|
+
// Parts whose fold-compression rewrite was refused (length-stopped or below
|
|
570
|
+
// the keep floor): the fold was reduced deterministically there, and the
|
|
571
|
+
// note must distinguish that from a compression that landed.
|
|
572
|
+
const refusedFoldParts: number[] = [];
|
|
573
|
+
// Parts whose fold was elided by the deterministic reduction, with the
|
|
574
|
+
// characters dropped from its middle. The note names the loss.
|
|
575
|
+
const elidedFoldParts: { part: number; elided: number }[] = [];
|
|
576
|
+
|
|
577
|
+
while (pending.length > 0) {
|
|
578
|
+
try {
|
|
579
|
+
if (getCmState(ctx).cancelSource === "watchdog") {
|
|
580
|
+
return { error: "chunked summary aborted mid-chain (watchdog cancel)" };
|
|
581
|
+
}
|
|
582
|
+
} catch {
|
|
583
|
+
/* state unavailable - continue the chain */
|
|
584
|
+
}
|
|
585
|
+
if (callsUsed >= CHUNK_SPLIT_CALL_BUDGET) {
|
|
586
|
+
return {
|
|
587
|
+
error:
|
|
588
|
+
`split call budget exhausted after ${callsUsed} call(s) ` +
|
|
589
|
+
`(${completed} chunk summary(ies) landed) - span not chunkable within the bounded call shape`,
|
|
590
|
+
failureClass: "summary-cap",
|
|
591
|
+
};
|
|
592
|
+
}
|
|
593
|
+
const chunk = pending.shift() as SpanChunk;
|
|
594
|
+
const partCount = completed + pending.length + 1;
|
|
595
|
+
const partIndex = completed + 1;
|
|
596
|
+
const serialized = serializeSpanForChunk(chunk.messages);
|
|
597
|
+
const prompt = buildChunkUserPrompt({
|
|
598
|
+
partIndex,
|
|
599
|
+
partCount,
|
|
600
|
+
serialized,
|
|
601
|
+
runningSummary: running,
|
|
602
|
+
anchor,
|
|
603
|
+
});
|
|
604
|
+
log.info(
|
|
605
|
+
`[context-manager] ${logPrefix} chunk ${partIndex}/${partCount}: ` +
|
|
606
|
+
`${chunk.messages.length} msgs, ~${chunk.estimatedTokens} tokens est, ` +
|
|
607
|
+
`maxTokens ${CHUNK_SUMMARY_MAX_TOKENS}, reasoning off`,
|
|
608
|
+
);
|
|
609
|
+
const result = await callLlm(model, apiKey, CHUNK_SYSTEM_PROMPT, prompt, {
|
|
610
|
+
maxTokens: CHUNK_SUMMARY_MAX_TOKENS,
|
|
611
|
+
reasoning: "off",
|
|
612
|
+
timeoutMs: CHUNK_CALL_TIMEOUT_MS,
|
|
613
|
+
signal,
|
|
614
|
+
});
|
|
615
|
+
callsUsed++;
|
|
616
|
+
if ("error" in result) {
|
|
617
|
+
return { error: `chunk ${partIndex}/${partCount} failed: ${result.error}` };
|
|
618
|
+
}
|
|
619
|
+
const text = (result.text ?? "").trim();
|
|
620
|
+
if (!text) {
|
|
621
|
+
return { error: `chunk ${partIndex}/${partCount} returned an empty summary` };
|
|
622
|
+
}
|
|
623
|
+
if (result.stopReason === "length") {
|
|
624
|
+
// Two distinct causes wear the same stopReason and need opposite
|
|
625
|
+
// recoveries. (i) The FOLD overflowed the output budget: the generation
|
|
626
|
+
// IS the merged running summary ("output only that summary"), so once
|
|
627
|
+
// the fold approaches the merge budget every later chunk length-stops no
|
|
628
|
+
// matter how small its own input is - splitting that input cannot shrink
|
|
629
|
+
// the fold. (ii) The CHUNK CONTENT is too dense for one call's output
|
|
630
|
+
// budget (many units, a small fold), where the unit split is the proven
|
|
631
|
+
// recovery (60-unit chunks split 30+30 complete). Discriminate on the
|
|
632
|
+
// fold's own size against the
|
|
633
|
+
// merge budget. A material fold runs the fold-shrink rung, which always
|
|
634
|
+
// lands the fold strictly below the material share (a rewrite that did
|
|
635
|
+
// not land is followed by the deterministic reduction), so the retry
|
|
636
|
+
// merge cannot wall on the same fold. A non-material fold goes straight
|
|
637
|
+
// to the unit split or the partial acceptance. Nothing here aborts the
|
|
638
|
+
// cycle.
|
|
639
|
+
const units = groupIntoUnits(chunk.messages);
|
|
640
|
+
const foldChars = (running ?? "").length;
|
|
641
|
+
const foldTokens = Math.ceil(foldChars / CHUNK_FOLD_CHARS_PER_TOKEN);
|
|
642
|
+
const foldIsMaterial = foldTokens >= CHUNK_FOLD_TARGET_TOKENS;
|
|
643
|
+
if (foldIsMaterial && (running ?? "").trim()) {
|
|
644
|
+
const shrink = await shrinkRunningFold({
|
|
645
|
+
model,
|
|
646
|
+
apiKey,
|
|
647
|
+
running: running ?? "",
|
|
648
|
+
signal,
|
|
649
|
+
logPrefix,
|
|
650
|
+
partIndex,
|
|
651
|
+
partCount,
|
|
652
|
+
canCallLlm: callsUsed < CHUNK_SPLIT_CALL_BUDGET,
|
|
653
|
+
});
|
|
654
|
+
callsUsed += shrink.calls;
|
|
655
|
+
if (shrink.refused) refusedFoldParts.push(partIndex);
|
|
656
|
+
if (shrink.elidedChars > 0) {
|
|
657
|
+
elidedFoldParts.push({ part: partIndex, elided: shrink.elidedChars });
|
|
658
|
+
}
|
|
659
|
+
running = shrink.text;
|
|
660
|
+
pending.unshift(chunk);
|
|
661
|
+
continue;
|
|
662
|
+
}
|
|
663
|
+
// Nothing left to split or shrink: accept the partial generation. The
|
|
664
|
+
// text is the merged summary as far as the generation got - honest,
|
|
665
|
+
// bounded, and strictly better than aborting the cycle (a cancel leaves
|
|
666
|
+
// the session unable to compact at all). Overwriting the fold with text
|
|
667
|
+
// shorter than the fold's own length would erase a summary that already
|
|
668
|
+
// landed (the cut happened before the fold was reproduced), so keep the
|
|
669
|
+
// fold in that case and record the part as unmerged.
|
|
670
|
+
if (units.length < 2) {
|
|
671
|
+
if (foldChars > 0 && text.length < foldChars) {
|
|
672
|
+
log.warn(
|
|
673
|
+
`[context-manager] ${logPrefix} chunk ${partIndex}/${partCount} hit its own token cap ` +
|
|
674
|
+
`and its partial merge (${text.length} chars) is shorter than the running fold ` +
|
|
675
|
+
`(${foldChars} chars) - keeping the fold, recording the part as unmerged`,
|
|
676
|
+
);
|
|
677
|
+
unmergedParts.push(partIndex);
|
|
678
|
+
completed++;
|
|
679
|
+
continue;
|
|
680
|
+
}
|
|
681
|
+
log.warn(
|
|
682
|
+
`[context-manager] ${logPrefix} chunk ${partIndex}/${partCount} hit its own token cap ` +
|
|
683
|
+
`(stopReason length) with nothing left to split - accepting the partial merge ` +
|
|
684
|
+
`(${text.length} chars)`,
|
|
685
|
+
);
|
|
686
|
+
running = text;
|
|
687
|
+
completed++;
|
|
688
|
+
continue;
|
|
689
|
+
}
|
|
690
|
+
// Units are message arrays; the chunk carries a flat message list (as
|
|
691
|
+
// planChunks does), so the halves are flattened before re-entry.
|
|
692
|
+
const halfA = units.slice(0, Math.ceil(units.length / 2)).flat() as unknown[];
|
|
693
|
+
const halfB = units.slice(Math.ceil(units.length / 2)).flat() as unknown[];
|
|
694
|
+
log.warn(
|
|
695
|
+
`[context-manager] ${logPrefix} chunk ${partIndex}/${partCount} hit its own token cap ` +
|
|
696
|
+
`(stopReason length); splitting ${units.length} units into ${halfA.length}+${halfB.length} and retrying ` +
|
|
697
|
+
`(${callsUsed}/${CHUNK_SPLIT_CALL_BUDGET} calls used)`,
|
|
698
|
+
);
|
|
699
|
+
pending.unshift(
|
|
700
|
+
{ messages: halfA, estimatedTokens: estimateMessagesTokens(halfA) },
|
|
701
|
+
{ messages: halfB, estimatedTokens: estimateMessagesTokens(halfB) },
|
|
702
|
+
);
|
|
703
|
+
continue;
|
|
704
|
+
}
|
|
705
|
+
if (result.usage) {
|
|
706
|
+
usageSeen = true;
|
|
707
|
+
usage.input += result.usage.input ?? 0;
|
|
708
|
+
usage.output += result.usage.output ?? 0;
|
|
709
|
+
usage.totalTokens += result.usage.totalTokens ?? 0;
|
|
710
|
+
}
|
|
711
|
+
running = text;
|
|
712
|
+
completed++;
|
|
713
|
+
if (pending.length > 0) notifyCompactionProgress(ctx);
|
|
714
|
+
}
|
|
715
|
+
|
|
716
|
+
log.info(
|
|
717
|
+
`[context-manager] ${logPrefix} done: ${callsUsed} call(s) ` +
|
|
718
|
+
`(planned ${chunks.length}, split retries ${callsUsed - completed}), ` +
|
|
719
|
+
`span ${spanMessages} msgs / ~${spanTokens} tokens est -> summary ${(running ?? "").length} chars`,
|
|
720
|
+
);
|
|
721
|
+
const finalSummary = running ?? "";
|
|
722
|
+
const notes: string[] = [];
|
|
723
|
+
if (unmergedParts.length > 0) {
|
|
724
|
+
notes.push(
|
|
725
|
+
`part(s) ${unmergedParts.join(", ")} of this span were not merged - their summarization ` +
|
|
726
|
+
"generations were cut before they reproduced the running summary. The full span stays in " +
|
|
727
|
+
"the append-only session file.",
|
|
728
|
+
);
|
|
729
|
+
}
|
|
730
|
+
if (refusedFoldParts.length > 0) {
|
|
731
|
+
notes.push(
|
|
732
|
+
`the running fold could not be compressed at part(s) ${refusedFoldParts.join(", ")} - the ` +
|
|
733
|
+
"rewrite was length-stopped or below the keep floor, so the fold was reduced " +
|
|
734
|
+
"deterministically instead.",
|
|
735
|
+
);
|
|
736
|
+
}
|
|
737
|
+
if (elidedFoldParts.length > 0) {
|
|
738
|
+
const totalElided = elidedFoldParts.reduce((sum, e) => sum + e.elided, 0);
|
|
739
|
+
const parts = elidedFoldParts.map((e) => e.part).join(", ");
|
|
740
|
+
notes.push(
|
|
741
|
+
`the running summary was elided deterministically at part(s) ${parts}: ${totalElided} ` +
|
|
742
|
+
"characters from the middle were dropped (head and tail kept) to bring the fold below " +
|
|
743
|
+
"its budget. The elided text stays in the append-only session file.",
|
|
744
|
+
);
|
|
745
|
+
}
|
|
746
|
+
return {
|
|
747
|
+
summary: notes.length > 0 ? `${finalSummary}\n\n[note: ${notes.join(" ")}]` : finalSummary,
|
|
748
|
+
chunkCount: chunks.length,
|
|
749
|
+
spanMessages,
|
|
750
|
+
spanTokens,
|
|
751
|
+
usage: usageSeen ? usage : undefined,
|
|
752
|
+
};
|
|
753
|
+
}
|
|
754
|
+
|
|
755
|
+
/**
|
|
756
|
+
* Serialize one chunk's messages for the summarizer, with the same
|
|
757
|
+
* truncation discipline pi-core applies to compaction input: toolResult
|
|
758
|
+
* content is cut at 2000 chars, then the whole block is JSON-embedded in the
|
|
759
|
+
* prompt so structural roles survive the text-only call.
|
|
760
|
+
*/
|
|
761
|
+
function serializeSpanForChunk(messages: readonly unknown[]): string {
|
|
762
|
+
const lines: string[] = [];
|
|
763
|
+
for (const message of messages) {
|
|
764
|
+
const m = message as {
|
|
765
|
+
role?: string;
|
|
766
|
+
content?: unknown;
|
|
767
|
+
toolName?: string;
|
|
768
|
+
toolCallId?: string;
|
|
769
|
+
};
|
|
770
|
+
const role = m?.role ?? "unknown";
|
|
771
|
+
let text = "";
|
|
772
|
+
if (typeof m?.content === "string") {
|
|
773
|
+
text = m.content;
|
|
774
|
+
} else if (Array.isArray(m?.content)) {
|
|
775
|
+
text = (
|
|
776
|
+
m.content as Array<{
|
|
777
|
+
type?: string;
|
|
778
|
+
text?: string;
|
|
779
|
+
name?: string;
|
|
780
|
+
arguments?: unknown;
|
|
781
|
+
output?: unknown;
|
|
782
|
+
}>
|
|
783
|
+
)
|
|
784
|
+
.map((c) => {
|
|
785
|
+
if (c?.type === "text" && typeof c.text === "string") return c.text;
|
|
786
|
+
if (c?.type === "toolCall")
|
|
787
|
+
return `[tool call: ${c.name ?? "?"} ${JSON.stringify(c.arguments ?? {}).slice(0, 400)}]`;
|
|
788
|
+
if (c?.type === "image") return "[image]";
|
|
789
|
+
return `[${c?.type ?? "block"}]`;
|
|
790
|
+
})
|
|
791
|
+
.join("\n");
|
|
792
|
+
}
|
|
793
|
+
if (role === "toolResult") {
|
|
794
|
+
text = `[tool result: ${m.toolName ?? "?"}] ${text}`;
|
|
795
|
+
}
|
|
796
|
+
if (text.length > 2000) text = `${text.slice(0, 2000)}…[truncated]`;
|
|
797
|
+
lines.push(`${role}: ${text}`);
|
|
798
|
+
}
|
|
799
|
+
return lines.join("\n");
|
|
800
|
+
}
|