pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
// Stale toolResult offloader.
|
|
2
|
+
//
|
|
3
|
+
// Setting-gated (braid.context.staleToolResultOffload, default OFF), fully
|
|
4
|
+
// deterministic (char-count + age, no LLM) offloader for stale large
|
|
5
|
+
// toolResults: the full original text is flushed losslessly to disk BEFORE any
|
|
6
|
+
// substitution, and the per-request context carries a stub pointing at the
|
|
7
|
+
// flush file. Recovery = read the file.
|
|
8
|
+
//
|
|
9
|
+
// Mechanism: registered as a `context` event handler — pi-core's
|
|
10
|
+
// transformContext path. The installed pi-core applies a handler's returned
|
|
11
|
+
// { messages } once per LLM call, BEFORE convertToLlm (emitContext
|
|
12
|
+
// structuredClones the live session messages). The session file itself is
|
|
13
|
+
// append-only and is never touched, so the offloader is lossless by
|
|
14
|
+
// construction and naturally idempotent (the substitution is recomputed from
|
|
15
|
+
// the append-only original on every call; the flush is guarded by file
|
|
16
|
+
// existence). This is NOT the disabled registerContextPruningHandler path
|
|
17
|
+
// (see index.ts NOTE): that handler's semantics (per-streaming compaction
|
|
18
|
+
// prep) are unrelated to a per-request substitution.
|
|
19
|
+
//
|
|
20
|
+
// Safety choices (v1): skip isError results, internal-tool results,
|
|
21
|
+
// bashExecution messages, and any result containing non-text (image) blocks.
|
|
22
|
+
|
|
23
|
+
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
24
|
+
import { dirname } from "node:path";
|
|
25
|
+
|
|
26
|
+
import type { AgentMessage } from "@earendil-works/pi-agent-core";
|
|
27
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
28
|
+
import {
|
|
29
|
+
getStaleToolResultOffloadConfig,
|
|
30
|
+
type ResolvedStaleToolResultOffloadConfig,
|
|
31
|
+
} from "../../../../lib/config/braid-settings.js";
|
|
32
|
+
import { getOffloadFilePath } from "../../../../lib/config/braid-paths.js";
|
|
33
|
+
import { getCmState, isInternal, log } from "./shared.js";
|
|
34
|
+
|
|
35
|
+
/** Stub prefix — recognizable marker for already-offloaded entries. */
|
|
36
|
+
export const STALE_OFFLOAD_STUB_PREFIX = "[offloaded:";
|
|
37
|
+
|
|
38
|
+
/** One toolResult selected for offload in a single planning pass. */
|
|
39
|
+
export interface OffloadPlanItem {
|
|
40
|
+
/** Position of the message in the context array. */
|
|
41
|
+
index: number;
|
|
42
|
+
toolCallId: string;
|
|
43
|
+
toolName: string;
|
|
44
|
+
/** Char count of the text that will be replaced by the stub. */
|
|
45
|
+
chars: number;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Deterministic planning pass over the per-request context. Pure char-count +
|
|
50
|
+
* age logic: no LLM, no I/O. Age is measured in toolResult rank from the end
|
|
51
|
+
* of the context (0 = most recent tool result), matching the repo's
|
|
52
|
+
* tool-result volume/recency conventions.
|
|
53
|
+
*
|
|
54
|
+
* Eligibility (ALL required):
|
|
55
|
+
* - role === "toolResult", not isError, not already stubbed;
|
|
56
|
+
* - toolName not an internal braid tool (shared.ts INTERNAL_TOOLS);
|
|
57
|
+
* - content is all-text and non-empty;
|
|
58
|
+
* - chars >= minChars;
|
|
59
|
+
* - age >= stalenessTurns AND age >= keepRecentTurns (the keep-recent
|
|
60
|
+
* guard is a hard floor: recency always wins);
|
|
61
|
+
* - cumulative chars fit within maxOffloadCharsPerRun (oldest-first; a
|
|
62
|
+
* single item larger than the whole budget is never planned).
|
|
63
|
+
*
|
|
64
|
+
* Returns the plan oldest-first plus the count of already-stubbed entries
|
|
65
|
+
* (idempotence signal for tests/telemetry).
|
|
66
|
+
*/
|
|
67
|
+
export function planStaleToolResultOffloads(
|
|
68
|
+
messages: AgentMessage[],
|
|
69
|
+
cfg: ResolvedStaleToolResultOffloadConfig,
|
|
70
|
+
): { plan: OffloadPlanItem[]; alreadyStubbed: number } {
|
|
71
|
+
// Rank from end among tool results: one reverse pass.
|
|
72
|
+
const ranks = new Map<number, number>();
|
|
73
|
+
let seen = 0;
|
|
74
|
+
for (let i = messages.length - 1; i >= 0; i--) {
|
|
75
|
+
const msg = messages[i] as { role?: string } | undefined;
|
|
76
|
+
if (msg?.role === "toolResult") {
|
|
77
|
+
ranks.set(i, seen);
|
|
78
|
+
seen++;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
const plan: OffloadPlanItem[] = [];
|
|
83
|
+
let alreadyStubbed = 0;
|
|
84
|
+
let budget = cfg.maxOffloadCharsPerRun;
|
|
85
|
+
const minAge = Math.max(cfg.stalenessTurns, cfg.keepRecentTurns);
|
|
86
|
+
for (let i = 0; i < messages.length; i++) {
|
|
87
|
+
const msg = messages[i] as {
|
|
88
|
+
role?: string;
|
|
89
|
+
toolCallId?: string;
|
|
90
|
+
toolName?: string;
|
|
91
|
+
isError?: boolean;
|
|
92
|
+
content?: unknown;
|
|
93
|
+
};
|
|
94
|
+
if (msg?.role !== "toolResult") continue;
|
|
95
|
+
if (msg.isError === true) continue;
|
|
96
|
+
if (isStubbed(msg.content)) {
|
|
97
|
+
alreadyStubbed++;
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
if (isInternal(String(msg.toolName ?? ""))) continue;
|
|
101
|
+
const { text, hasNonText } = extractToolResultText(msg.content);
|
|
102
|
+
if (hasNonText || text.length === 0) continue;
|
|
103
|
+
if (text.length < cfg.minChars) continue;
|
|
104
|
+
const age = ranks.get(i) ?? 0;
|
|
105
|
+
if (age < minAge) continue;
|
|
106
|
+
if (text.length > budget) continue; // bounded work: skip, keep scanning
|
|
107
|
+
plan.push({
|
|
108
|
+
index: i,
|
|
109
|
+
toolCallId: String(msg.toolCallId ?? `idx-${i}`),
|
|
110
|
+
toolName: String(msg.toolName ?? "unknown"),
|
|
111
|
+
chars: text.length,
|
|
112
|
+
});
|
|
113
|
+
budget -= text.length;
|
|
114
|
+
}
|
|
115
|
+
return { plan, alreadyStubbed };
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/** Extract concatenated text of a toolResult's text blocks ("" if none). */
|
|
119
|
+
function extractToolResultText(content: unknown): { text: string; hasNonText: boolean } {
|
|
120
|
+
if (!Array.isArray(content)) return { text: "", hasNonText: false };
|
|
121
|
+
let text = "";
|
|
122
|
+
let hasNonText = false;
|
|
123
|
+
for (const block of content) {
|
|
124
|
+
if (!block || typeof block !== "object") continue;
|
|
125
|
+
const b = block as { type?: string; text?: unknown };
|
|
126
|
+
if (b.type === "text" && typeof b.text === "string") {
|
|
127
|
+
text += b.text;
|
|
128
|
+
} else if (b.type && b.type !== "text") {
|
|
129
|
+
hasNonText = true;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return { text, hasNonText };
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
function isStubbed(content: unknown): boolean {
|
|
136
|
+
if (!Array.isArray(content) || content.length === 0) return false;
|
|
137
|
+
const first = content[0] as { type?: string; text?: unknown } | undefined;
|
|
138
|
+
return (
|
|
139
|
+
first?.type === "text" &&
|
|
140
|
+
typeof first.text === "string" &&
|
|
141
|
+
first.text.startsWith(STALE_OFFLOAD_STUB_PREFIX)
|
|
142
|
+
);
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
export interface OffloadIo {
|
|
146
|
+
nowIso(): string;
|
|
147
|
+
exists(path: string): boolean;
|
|
148
|
+
/** mkdir -p + write the full original text. Throws on failure. */
|
|
149
|
+
flush(path: string, text: string): void;
|
|
150
|
+
flushPath(sessionId: string, toolCallId: string, toolName: string): string;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
export interface OffloadApplyDeps {
|
|
154
|
+
sessionId: string;
|
|
155
|
+
/** toolCallId → ISO timestamp of the first flush (stub stability across calls). */
|
|
156
|
+
isoByToolCallId?: Record<string, string>;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
export interface OffloadApplyResult {
|
|
160
|
+
/** New message array (same reference when nothing changed). */
|
|
161
|
+
messages: AgentMessage[];
|
|
162
|
+
/** Entries actually stubbed this run. */
|
|
163
|
+
offloaded: number;
|
|
164
|
+
/** Gross in-context chars freed by stubbing. */
|
|
165
|
+
charsSaved: number;
|
|
166
|
+
/** Stub overhead added to the context. */
|
|
167
|
+
stubChars: number;
|
|
168
|
+
/** Bytes actually written to disk this run (0 when flushes were deduped). */
|
|
169
|
+
bytesFlushed: number;
|
|
170
|
+
/** Entries whose flush failed — left untouched (never stub without flush). */
|
|
171
|
+
skipped: number;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Apply a plan: for each item, ensure the lossless flush exists (write when
|
|
176
|
+
* missing; skip the write when the file already exists — idempotent), then
|
|
177
|
+
* replace the in-context body with the stub. A flush write that THROWS is
|
|
178
|
+
* counted as skipped and the item is left untouched (never stub without a
|
|
179
|
+
* verified flush). Double-offload is a no-op: the plan excludes stubbed
|
|
180
|
+
* entries, and the flush is exists-guarded. The input array is never mutated;
|
|
181
|
+
* a new array is returned only when at least one entry was stubbed.
|
|
182
|
+
*/
|
|
183
|
+
export function applyStaleToolResultOffloads(
|
|
184
|
+
messages: AgentMessage[],
|
|
185
|
+
plan: OffloadPlanItem[],
|
|
186
|
+
io: OffloadIo,
|
|
187
|
+
deps: OffloadApplyDeps,
|
|
188
|
+
): OffloadApplyResult {
|
|
189
|
+
const result: OffloadApplyResult = {
|
|
190
|
+
messages,
|
|
191
|
+
offloaded: 0,
|
|
192
|
+
charsSaved: 0,
|
|
193
|
+
stubChars: 0,
|
|
194
|
+
bytesFlushed: 0,
|
|
195
|
+
skipped: 0,
|
|
196
|
+
};
|
|
197
|
+
if (plan.length === 0) return result;
|
|
198
|
+
|
|
199
|
+
const output = [...messages];
|
|
200
|
+
for (const item of plan) {
|
|
201
|
+
const msg = output[item.index] as {
|
|
202
|
+
role?: string;
|
|
203
|
+
toolCallId?: string;
|
|
204
|
+
toolName?: string;
|
|
205
|
+
content?: unknown;
|
|
206
|
+
};
|
|
207
|
+
if (!msg || msg.role !== "toolResult") continue;
|
|
208
|
+
const { text } = extractToolResultText(msg.content);
|
|
209
|
+
if (text.length === 0) continue;
|
|
210
|
+
|
|
211
|
+
const path = io.flushPath(deps.sessionId, item.toolCallId, item.toolName);
|
|
212
|
+
let written = 0;
|
|
213
|
+
try {
|
|
214
|
+
if (!io.exists(path)) {
|
|
215
|
+
io.flush(path, text);
|
|
216
|
+
written = Buffer.byteLength(text, "utf-8");
|
|
217
|
+
}
|
|
218
|
+
} catch {
|
|
219
|
+
result.skipped++;
|
|
220
|
+
continue; // NEVER stub without a verified flush.
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
const iso = (deps.isoByToolCallId && deps.isoByToolCallId[item.toolCallId]) || io.nowIso();
|
|
224
|
+
const stub = `[offloaded: ${item.toolName} result, ${item.chars} chars, ${iso} — full text: ${path}]`;
|
|
225
|
+
// Preserve ALL original ToolResultMessage fields (toolCallId pairing,
|
|
226
|
+
// isError, timestamp, details) — only the content body becomes the stub.
|
|
227
|
+
output[item.index] = {
|
|
228
|
+
...(msg as unknown as Record<string, unknown>),
|
|
229
|
+
content: [{ type: "text" as const, text: stub }],
|
|
230
|
+
} as AgentMessage;
|
|
231
|
+
result.offloaded++;
|
|
232
|
+
result.charsSaved += item.chars;
|
|
233
|
+
result.stubChars += stub.length;
|
|
234
|
+
result.bytesFlushed += written;
|
|
235
|
+
if (deps.isoByToolCallId && !deps.isoByToolCallId[item.toolCallId]) {
|
|
236
|
+
deps.isoByToolCallId[item.toolCallId] = iso;
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
result.messages = result.offloaded > 0 ? output : messages;
|
|
240
|
+
return result;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// Telemetry (owner metric rule: every innovation needs a counter)
|
|
244
|
+
|
|
245
|
+
export interface OffloaderHealth {
|
|
246
|
+
/** Runs (LLM calls) that actually offloaded at least one entry. */
|
|
247
|
+
totalRuns: number;
|
|
248
|
+
/** Lifetime count of stubbed tool results. */
|
|
249
|
+
totalOffloaded: number;
|
|
250
|
+
/** Gross in-context chars freed across all runs. */
|
|
251
|
+
totalCharsSaved: number;
|
|
252
|
+
/** Stub overhead added across runs. */
|
|
253
|
+
totalStubChars: number;
|
|
254
|
+
/** Bytes written to flush files across runs. */
|
|
255
|
+
totalBytesFlushed: number;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
const offloaderHealth: OffloaderHealth = {
|
|
259
|
+
totalRuns: 0,
|
|
260
|
+
totalOffloaded: 0,
|
|
261
|
+
totalCharsSaved: 0,
|
|
262
|
+
totalStubChars: 0,
|
|
263
|
+
totalBytesFlushed: 0,
|
|
264
|
+
};
|
|
265
|
+
|
|
266
|
+
export function getOffloaderHealth(): OffloaderHealth {
|
|
267
|
+
return offloaderHealth;
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
const defaultIo: OffloadIo = {
|
|
271
|
+
nowIso: () => new Date().toISOString(),
|
|
272
|
+
exists: (path) => existsSync(path),
|
|
273
|
+
flush: (path, text) => {
|
|
274
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
275
|
+
writeFileSync(path, text, "utf-8");
|
|
276
|
+
},
|
|
277
|
+
flushPath: (sessionId, toolCallId, toolName) =>
|
|
278
|
+
getOffloadFilePath(sessionId, toolCallId, toolName),
|
|
279
|
+
};
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* Register the stale-toolResult offloader on the `context` event
|
|
283
|
+
* (transformContext path). Reads the setting FRESH on every call; when the
|
|
284
|
+
* setting is OFF (the default) the handler returns undefined immediately —
|
|
285
|
+
* provably zero behavior change. Never throws into pi's event pipeline.
|
|
286
|
+
*/
|
|
287
|
+
export function registerStaleToolResultOffloader(pi: ExtensionAPI): void {
|
|
288
|
+
pi.on("context", async (event: any, ctx: any) => {
|
|
289
|
+
let cfg: ResolvedStaleToolResultOffloadConfig;
|
|
290
|
+
try {
|
|
291
|
+
cfg = getStaleToolResultOffloadConfig();
|
|
292
|
+
} catch {
|
|
293
|
+
return undefined;
|
|
294
|
+
}
|
|
295
|
+
if (!cfg.enabled) return undefined; // default-off fast path: no-op
|
|
296
|
+
try {
|
|
297
|
+
const { plan } = planStaleToolResultOffloads(event.messages as AgentMessage[], cfg);
|
|
298
|
+
if (plan.length === 0) return undefined;
|
|
299
|
+
|
|
300
|
+
const cmState = getCmState(ctx);
|
|
301
|
+
if (!cmState.offloadIsoByToolCallId) cmState.offloadIsoByToolCallId = {};
|
|
302
|
+
const sessionId =
|
|
303
|
+
(
|
|
304
|
+
ctx as { sessionManager?: { getSessionId?: () => string } }
|
|
305
|
+
)?.sessionManager?.getSessionId?.() ?? "anonymous";
|
|
306
|
+
|
|
307
|
+
const result = applyStaleToolResultOffloads(event.messages, plan, defaultIo, {
|
|
308
|
+
sessionId,
|
|
309
|
+
isoByToolCallId: cmState.offloadIsoByToolCallId,
|
|
310
|
+
});
|
|
311
|
+
if (result.offloaded === 0) return undefined;
|
|
312
|
+
|
|
313
|
+
// Telemetry: lifetime counters + per-run log line.
|
|
314
|
+
offloaderHealth.totalRuns++;
|
|
315
|
+
offloaderHealth.totalOffloaded += result.offloaded;
|
|
316
|
+
offloaderHealth.totalCharsSaved += result.charsSaved;
|
|
317
|
+
offloaderHealth.totalStubChars += result.stubChars;
|
|
318
|
+
offloaderHealth.totalBytesFlushed += result.bytesFlushed;
|
|
319
|
+
log.info(
|
|
320
|
+
`[offload] ${result.offloaded} stale toolResult(s) offloaded: ` +
|
|
321
|
+
`${result.charsSaved} in-context chars freed ` +
|
|
322
|
+
`(stub overhead ${result.stubChars}), ${result.bytesFlushed} bytes flushed to disk`,
|
|
323
|
+
);
|
|
324
|
+
return { messages: result.messages };
|
|
325
|
+
} catch (err) {
|
|
326
|
+
log.warn("[offload] stale toolResult offload failed - context untouched", err);
|
|
327
|
+
return undefined;
|
|
328
|
+
}
|
|
329
|
+
});
|
|
330
|
+
}
|
|
@@ -0,0 +1,363 @@
|
|
|
1
|
+
// Smart session file rotation for long-running daemon sessions.
|
|
2
|
+
// Prevents unbounded session file growth by rotating based on size + task boundaries.
|
|
3
|
+
//
|
|
4
|
+
// Rotation strategies:
|
|
5
|
+
// 1. Size-based: rotate when session file > MAX_SESSION_SIZE_BYTES
|
|
6
|
+
// 2. Task-based: rotate after finalize() call (task boundary detected)
|
|
7
|
+
// 3. Time-based: rotate after MAX_SESSION_AGE_MS since last rotation
|
|
8
|
+
//
|
|
9
|
+
// State preservation across rotations:
|
|
10
|
+
// - Tags/checkpoints are preserved in the new session
|
|
11
|
+
// - Memory stores (episodic, heuristics, tool reliability) survive via three-memory-stores
|
|
12
|
+
// - Key context is carried forward as a "continuation summary"
|
|
13
|
+
|
|
14
|
+
import { statSync } from "node:fs";
|
|
15
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
16
|
+
import { getCmState, log, buildContinuationSummary, triggerEmergencyRotation } from "./shared.js";
|
|
17
|
+
import { getRotationState } from "../../../../lib/state/global-state.js";
|
|
18
|
+
import type { RotationState } from "../../../../lib/state/global-state.js";
|
|
19
|
+
import {
|
|
20
|
+
sendTrackedMessage,
|
|
21
|
+
hasUnresolvedAdvisory,
|
|
22
|
+
} from "../../../../lib/utils/injection-tracker.js";
|
|
23
|
+
import {
|
|
24
|
+
tryRestoreAppendMessage,
|
|
25
|
+
clearInterceptState,
|
|
26
|
+
flushPendingOwnerInputs,
|
|
27
|
+
clearOwnerInputSeats,
|
|
28
|
+
} from "./compaction.js";
|
|
29
|
+
import { TURN_END, SESSION_SHUTDOWN } from "../../../../lib/core/event-names.js";
|
|
30
|
+
import {
|
|
31
|
+
MAX_SESSION_AGE_MS,
|
|
32
|
+
NUDGE_COOLDOWN_TURNS,
|
|
33
|
+
NUDGE_COOLDOWN_MS,
|
|
34
|
+
} from "../../../../lib/constants/session-thresholds.js";
|
|
35
|
+
|
|
36
|
+
const MAX_SESSION_SIZE_BYTES = 50 * 1024 * 1024; // 50 MB
|
|
37
|
+
const MAX_TURNS_SINCE_ROTATION = 500; // 500 turns
|
|
38
|
+
|
|
39
|
+
// Advisory kind for the in-flight registry (injection-tracker). One size
|
|
40
|
+
// notice in flight at a time: a second one would queue behind the first on
|
|
41
|
+
// pi's delivery lane and land after the work it asks for.
|
|
42
|
+
const ROTATION_ADVISORY = "rotation";
|
|
43
|
+
|
|
44
|
+
// Rotation state provided by global-state.ts (Symbol-keyed, DRY)
|
|
45
|
+
function _sessionRotationState(): RotationState {
|
|
46
|
+
return getRotationState();
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function estimateSessionSize(ctx: ExtensionContext): number {
|
|
50
|
+
try {
|
|
51
|
+
const sm = ctx.sessionManager as {
|
|
52
|
+
sessionFile?: string;
|
|
53
|
+
getSessionFile?(): string | undefined;
|
|
54
|
+
getBranch?(): Array<unknown>;
|
|
55
|
+
};
|
|
56
|
+
const filePath = sm.sessionFile ?? sm.getSessionFile?.();
|
|
57
|
+
if (filePath) {
|
|
58
|
+
const stat = statSync(filePath);
|
|
59
|
+
return stat.size;
|
|
60
|
+
}
|
|
61
|
+
// Fallback: estimate from branch length
|
|
62
|
+
const branch = sm.getBranch?.() ?? [];
|
|
63
|
+
return branch.length * 2000; // rough estimate: 2KB per entry
|
|
64
|
+
} catch {
|
|
65
|
+
return 0;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
function shouldRotate(ctx: ExtensionContext): { needed: boolean; reason: string } {
|
|
70
|
+
const state = _sessionRotationState();
|
|
71
|
+
const size = estimateSessionSize(ctx);
|
|
72
|
+
const age = Date.now() - state.lastRotationTimestamp;
|
|
73
|
+
|
|
74
|
+
// If the agent recently took context-preserving action, suppress nudges for a grace period
|
|
75
|
+
// (25 turns / ~5 min) to avoid spam during legitimate long tasks.
|
|
76
|
+
if (state.actionTaken) {
|
|
77
|
+
const turnsSinceAction = state.turnsSinceRotation - state.actionTakenAtTurn;
|
|
78
|
+
if (turnsSinceAction < 25) {
|
|
79
|
+
log.debug(
|
|
80
|
+
`Rotation nudge suppressed: actionTaken=true, grace period (${turnsSinceAction}/25 turns since action)`,
|
|
81
|
+
);
|
|
82
|
+
return { needed: false, reason: "" };
|
|
83
|
+
}
|
|
84
|
+
// Grace period expired - reset actionTaken so nudges can resume if still needed
|
|
85
|
+
state.actionTaken = false;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
if (size > MAX_SESSION_SIZE_BYTES) {
|
|
89
|
+
return {
|
|
90
|
+
needed: true,
|
|
91
|
+
reason: `Session file ${Math.round(size / 1024 / 1024)}MB exceeds ${Math.round(MAX_SESSION_SIZE_BYTES / 1024 / 1024)}MB limit`,
|
|
92
|
+
};
|
|
93
|
+
}
|
|
94
|
+
if (state.turnsSinceRotation > MAX_TURNS_SINCE_ROTATION) {
|
|
95
|
+
return {
|
|
96
|
+
needed: true,
|
|
97
|
+
reason: `${state.turnsSinceRotation} turns since last rotation (limit: ${MAX_TURNS_SINCE_ROTATION})`,
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
if (age > MAX_SESSION_AGE_MS) {
|
|
101
|
+
return {
|
|
102
|
+
needed: true,
|
|
103
|
+
reason: `Session age ${Math.round(age / 86400000)}d exceeds ${Math.round(MAX_SESSION_AGE_MS / 86400000)}d limit`,
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
return { needed: false, reason: "" };
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export function registerRotationHandlers(pi: ExtensionAPI): void {
|
|
110
|
+
pi.on(TURN_END, async (_event: any, ctx: ExtensionContext) => {
|
|
111
|
+
try {
|
|
112
|
+
const state = _sessionRotationState();
|
|
113
|
+
state.turnsSinceRotation++;
|
|
114
|
+
|
|
115
|
+
const { needed, reason } = shouldRotate(ctx);
|
|
116
|
+
|
|
117
|
+
if (!needed) return;
|
|
118
|
+
|
|
119
|
+
// NUDGE DEDUPLICATION: suppress duplicate nudges within cooldown
|
|
120
|
+
const currentTurn = state.turnsSinceRotation;
|
|
121
|
+
|
|
122
|
+
// If we already nudged this turn, skip (prevents rapid-fire during single turn)
|
|
123
|
+
// Deep-branch whisper to the agent (if needed). Fires BEFORE the
|
|
124
|
+
// rotation-nudge check so a deep branch always gets a whisper,
|
|
125
|
+
// independent of whether the session also needs rotation. The
|
|
126
|
+
// throttle (NUDGE_COOLDOWN_TURNS / NUDGE_COOLDOWN_MS) keeps it to
|
|
127
|
+
// one whisper per cooldown period — a per-turn log.warn would spam
|
|
128
|
+
// the operator console on a deep branch. The advice is for the agent
|
|
129
|
+
// (use context_tag / context_compress / finalize) so it goes
|
|
130
|
+
// through sendTrackedMessage.
|
|
131
|
+
try {
|
|
132
|
+
const sm = ctx.sessionManager as { getBranch?(): unknown[] };
|
|
133
|
+
const branch = sm.getBranch?.() ?? [];
|
|
134
|
+
if (branch.length > 150) {
|
|
135
|
+
const timeSinceDeepBranchWhisper = state.lastDeepBranchWhisperTimestamp
|
|
136
|
+
? Date.now() - state.lastDeepBranchWhisperTimestamp
|
|
137
|
+
: Infinity;
|
|
138
|
+
if (
|
|
139
|
+
state.lastDeepBranchWhisperTurn !== currentTurn &&
|
|
140
|
+
(currentTurn - state.lastDeepBranchWhisperTurn >= NUDGE_COOLDOWN_TURNS ||
|
|
141
|
+
timeSinceDeepBranchWhisper >= NUDGE_COOLDOWN_MS)
|
|
142
|
+
) {
|
|
143
|
+
state.lastDeepBranchWhisperTurn = currentTurn;
|
|
144
|
+
state.lastDeepBranchWhisperTimestamp = Date.now();
|
|
145
|
+
try {
|
|
146
|
+
sendTrackedMessage(
|
|
147
|
+
pi,
|
|
148
|
+
{
|
|
149
|
+
customType: "context",
|
|
150
|
+
display: true,
|
|
151
|
+
content: [
|
|
152
|
+
{
|
|
153
|
+
type: "text" as const,
|
|
154
|
+
text: [
|
|
155
|
+
"## Session Branch Depth Notice",
|
|
156
|
+
"",
|
|
157
|
+
`The current branch is ${branch.length} entries deep. Deep branches can slow down context operations.`,
|
|
158
|
+
"",
|
|
159
|
+
"To keep the session manageable:",
|
|
160
|
+
"1. **`context_navigate(action='tag')`** - mark a checkpoint before continuing on a long thread",
|
|
161
|
+
"2. **`context_compress`** - compress completed work mid-session",
|
|
162
|
+
"3. **`finalize()`** - when done with current work; rotates session with summary",
|
|
163
|
+
"",
|
|
164
|
+
"These are non-urgent suggestions - take them when natural in your workflow.",
|
|
165
|
+
].join("\n"),
|
|
166
|
+
},
|
|
167
|
+
],
|
|
168
|
+
},
|
|
169
|
+
{ delivery: "park", deliverAs: "followUp" },
|
|
170
|
+
{ type: "context", source: "context-manager/deep-branch" },
|
|
171
|
+
);
|
|
172
|
+
} catch (err) {
|
|
173
|
+
log.error("deep-branch whisper failed:", err);
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
} catch {
|
|
178
|
+
// Nudge bookkeeping reads optional enforcement state; without it the
|
|
179
|
+
// deep-branch enhancement is skipped and the base nudge path runs.
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
if (state.lastNudgeTurn === currentTurn) return;
|
|
183
|
+
|
|
184
|
+
// Suppress nudge if: not enough turns passed (<50) AND too soon since last nudge (<5 min)
|
|
185
|
+
const timeSinceNudge = state.lastNudgeTimestamp
|
|
186
|
+
? Date.now() - state.lastNudgeTimestamp
|
|
187
|
+
: Infinity;
|
|
188
|
+
const turnsSinceNudge = currentTurn - state.lastNudgeTurn;
|
|
189
|
+
if (turnsSinceNudge < NUDGE_COOLDOWN_TURNS && timeSinceNudge < NUDGE_COOLDOWN_MS) {
|
|
190
|
+
log.debug(
|
|
191
|
+
`Nudge suppressed: ${turnsSinceNudge} turns, ${Math.round(timeSinceNudge / 1000)}s since last`,
|
|
192
|
+
);
|
|
193
|
+
return;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
// Refuse to stack: while an earlier notice is still in flight (handed
|
|
197
|
+
// to pi but not yet appended), a second notice would queue behind it
|
|
198
|
+
// and arrive after the work it asks for. Leave the nudge state
|
|
199
|
+
// untouched so the emission retries at the next `turn_end` once the
|
|
200
|
+
// first one lands; the cooldown above still paces retries.
|
|
201
|
+
if (hasUnresolvedAdvisory(ROTATION_ADVISORY)) {
|
|
202
|
+
log.debug("Rotation nudge skipped: a previous notice is still in flight");
|
|
203
|
+
return;
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
state.lastNudgeTurn = currentTurn;
|
|
207
|
+
state.lastNudgeTimestamp = Date.now();
|
|
208
|
+
state.nudgeCount++;
|
|
209
|
+
state.actionTaken = false; // reset for next cycle
|
|
210
|
+
|
|
211
|
+
log.info(`Session rotation nudge #${state.nudgeCount}: ${reason}`);
|
|
212
|
+
|
|
213
|
+
state.continuationSummary = buildContinuationSummary(ctx);
|
|
214
|
+
state.pendingRotation = true;
|
|
215
|
+
|
|
216
|
+
// Off the run-stop lane while a run is streaming. `followUp` drains
|
|
217
|
+
// one message per run stop, so a notice queued there waits for the
|
|
218
|
+
// agent to stop - the measured median was 12 minutes, and 15 of 24
|
|
219
|
+
// notices landed after the agent had already taken the action they
|
|
220
|
+
// asked for. While streaming, park it: pi-core flushes parked
|
|
221
|
+
// messages at the same `turn_end`, after handler dispatch. When the
|
|
222
|
+
// session is idle, keep the wake - a parked notice would never start
|
|
223
|
+
// a turn. `ctx.isIdle()` is probed at the same moment pi-core reads
|
|
224
|
+
// its own `isStreaming`; a race lands in a branch that either parks or
|
|
225
|
+
// appends, both safe, and the wake gate covers the pre-flight window.
|
|
226
|
+
const idle = typeof ctx.isIdle === "function" ? ctx.isIdle() : true;
|
|
227
|
+
const deliveryOptions = idle
|
|
228
|
+
? { triggerTurn: true }
|
|
229
|
+
: { delivery: "park" as const, deliverAs: "steer" };
|
|
230
|
+
|
|
231
|
+
// Notify agent - ONCE - with identity-framed language (not compliance directives)
|
|
232
|
+
sendTrackedMessage(
|
|
233
|
+
pi,
|
|
234
|
+
{
|
|
235
|
+
customType: "context",
|
|
236
|
+
display: true,
|
|
237
|
+
content: [
|
|
238
|
+
{
|
|
239
|
+
type: "text" as const,
|
|
240
|
+
text: [
|
|
241
|
+
"## Session Size Notice",
|
|
242
|
+
"",
|
|
243
|
+
reason,
|
|
244
|
+
"",
|
|
245
|
+
"The session has grown large. To keep working smoothly:",
|
|
246
|
+
"1. **`finalize()`** - when done with current work; rotates session with summary",
|
|
247
|
+
"2. **`context_compress(action='archive', startIndex, endIndex, topic, summary)`** - archive completed work mid-session",
|
|
248
|
+
"3. **`memory_store(...)`** - preserve critical facts before compression",
|
|
249
|
+
"",
|
|
250
|
+
"If this stamp predates your last `context_compress`/`finalize`, this notice is already satisfied; ignore it.",
|
|
251
|
+
"",
|
|
252
|
+
"Taking any of these actions will reset the session counter for 25 turns.",
|
|
253
|
+
].join("\n"),
|
|
254
|
+
},
|
|
255
|
+
],
|
|
256
|
+
},
|
|
257
|
+
deliveryOptions,
|
|
258
|
+
{ type: "context", source: "context-manager/rotation", advisory: ROTATION_ADVISORY },
|
|
259
|
+
);
|
|
260
|
+
} catch (err) {
|
|
261
|
+
log.error("turn_end rotation check error:", err);
|
|
262
|
+
}
|
|
263
|
+
});
|
|
264
|
+
|
|
265
|
+
pi.on("tool_result", async (event: any, _ctx: ExtensionContext) => {
|
|
266
|
+
try {
|
|
267
|
+
if (!event?.toolName) return;
|
|
268
|
+
const state = _sessionRotationState();
|
|
269
|
+
const contextTools = new Set([
|
|
270
|
+
"memory_store",
|
|
271
|
+
"context_navigate",
|
|
272
|
+
"context_compress",
|
|
273
|
+
"scratchpad",
|
|
274
|
+
"finalize",
|
|
275
|
+
]);
|
|
276
|
+
if (contextTools.has(event.toolName)) {
|
|
277
|
+
state.actionTaken = true;
|
|
278
|
+
state.actionTakenAtTurn = state.turnsSinceRotation;
|
|
279
|
+
log.info(`Rotation action recorded: ${event.toolName} at turn ${state.turnsSinceRotation}`);
|
|
280
|
+
}
|
|
281
|
+
} catch (err) {
|
|
282
|
+
log.error("tool_end action tracking error:", err);
|
|
283
|
+
}
|
|
284
|
+
});
|
|
285
|
+
|
|
286
|
+
pi.on("tool_result", async (event: any, ctx: ExtensionContext) => {
|
|
287
|
+
try {
|
|
288
|
+
if (event?.toolName !== "finalize") return;
|
|
289
|
+
|
|
290
|
+
const state = _sessionRotationState();
|
|
291
|
+
if (!state.pendingRotation) return;
|
|
292
|
+
|
|
293
|
+
// Rotation triggered by finalize - task boundary detected
|
|
294
|
+
state.pendingRotation = false;
|
|
295
|
+
state.rotationCount++;
|
|
296
|
+
state.lastRotationTimestamp = Date.now();
|
|
297
|
+
state.turnsSinceRotation = 0;
|
|
298
|
+
state.lastNudgeTurn = 0;
|
|
299
|
+
state.lastNudgeTimestamp = 0;
|
|
300
|
+
state.nudgeCount = 0;
|
|
301
|
+
state.actionTaken = false;
|
|
302
|
+
|
|
303
|
+
// Reset compaction retry guards to prevent stale state
|
|
304
|
+
const cmState = getCmState(ctx);
|
|
305
|
+
cmState.compactionRetryActive = false;
|
|
306
|
+
cmState.overflowRetryActive = false;
|
|
307
|
+
|
|
308
|
+
log.info(`Session rotation triggered at task boundary (rotation #${state.rotationCount})`);
|
|
309
|
+
|
|
310
|
+
// Store continuation summary as memory for next session
|
|
311
|
+
sendTrackedMessage(
|
|
312
|
+
pi,
|
|
313
|
+
{
|
|
314
|
+
customType: "context",
|
|
315
|
+
content: [
|
|
316
|
+
{
|
|
317
|
+
type: "text" as const,
|
|
318
|
+
text: [
|
|
319
|
+
"## [..] Session Rotated",
|
|
320
|
+
"",
|
|
321
|
+
`Rotation #${state.rotationCount} completed at task boundary.`,
|
|
322
|
+
"Key context has been preserved in memory stores.",
|
|
323
|
+
"Use the `memory` tool to retrieve relevant context.",
|
|
324
|
+
].join("\n"),
|
|
325
|
+
},
|
|
326
|
+
],
|
|
327
|
+
display: true,
|
|
328
|
+
},
|
|
329
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
330
|
+
{ type: "context", source: "context-manager/rotation" },
|
|
331
|
+
);
|
|
332
|
+
} catch (err) {
|
|
333
|
+
log.error("tool_end rotation error:", err);
|
|
334
|
+
}
|
|
335
|
+
});
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
// Cleans up retry guards and compaction state when session ends.
|
|
339
|
+
// Prevents stale state from leaking between sessions.
|
|
340
|
+
|
|
341
|
+
export function registerSessionShutdownHandler(pi: ExtensionAPI): void {
|
|
342
|
+
pi.on(SESSION_SHUTDOWN, async (_event: unknown, ctx: ExtensionContext) => {
|
|
343
|
+
log.debug("Session shutdown: clearing compaction retry state and intercept");
|
|
344
|
+
const cmState = getCmState(ctx);
|
|
345
|
+
cmState.compactionRetryActive = false;
|
|
346
|
+
cmState.overflowRetryActive = false;
|
|
347
|
+
|
|
348
|
+
// CRITICAL: Clear intercept state to prevent stale intercept on next session.
|
|
349
|
+
// The intercept was set up during compaction. If session ends without
|
|
350
|
+
// proper cleanup (e.g., crash, force quit), the intercept could remain
|
|
351
|
+
// active in the new session.
|
|
352
|
+
// A seat still undelivered at shutdown is written into the session before
|
|
353
|
+
// the bookkeeping goes: the durable entry survives either way, but the
|
|
354
|
+
// session entry is what a resumed branch replays.
|
|
355
|
+
flushPendingOwnerInputs(ctx, "shutdown");
|
|
356
|
+
tryRestoreAppendMessage(ctx);
|
|
357
|
+
clearInterceptState(ctx);
|
|
358
|
+
clearOwnerInputSeats(ctx);
|
|
359
|
+
});
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
// Export for use in compaction retry guard
|
|
363
|
+
export { triggerEmergencyRotation, buildContinuationSummary };
|