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,1095 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Heartbeat Scheduler - proactive cognitive scheduling based on paper 2604.14178.
|
|
3
|
+
*
|
|
4
|
+
* Triggers interventions before problems arise: silence, context overflow, error accumulation.
|
|
5
|
+
* This file is the extension entry point. Logic is decomposed into sub-modules:
|
|
6
|
+
* - types.ts Type definitions
|
|
7
|
+
* - state.ts State management and configuration
|
|
8
|
+
* - policies.ts Default policies (verification, context monitor)
|
|
9
|
+
* - meta-learning.ts Adaptive tick interval adjustment
|
|
10
|
+
* - modules/ Individual cognitive modules (recaller, reflection-consolidator,
|
|
11
|
+
* context-hygiene, evolver, ...). `dreamerModule` is the test-facing alias
|
|
12
|
+
* re-exported below, not a module file.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
16
|
+
import {
|
|
17
|
+
createPolicyEngine,
|
|
18
|
+
getPolicyEngine,
|
|
19
|
+
getBeliefStore,
|
|
20
|
+
cleanupSession,
|
|
21
|
+
type PolicyContext,
|
|
22
|
+
} from "../../../lib/store/belief-store.js";
|
|
23
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
24
|
+
import {
|
|
25
|
+
registerSessionStartHandler,
|
|
26
|
+
SessionPhase,
|
|
27
|
+
} from "../../../lib/state/session-start-queue.js";
|
|
28
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
29
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
30
|
+
import { fenceMemoryContext } from "../../../lib/utils/memory-fence.js";
|
|
31
|
+
import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
|
|
32
|
+
import { eventBus } from "../../../lib/events/event-bus.js";
|
|
33
|
+
import {
|
|
34
|
+
getRssGrowthWhisperShown,
|
|
35
|
+
markRssGrowthWhisperShown,
|
|
36
|
+
getContextEmergencyOffloadRunner,
|
|
37
|
+
} from "../../../lib/state/global-state.js";
|
|
38
|
+
import {
|
|
39
|
+
processConsolidationTick,
|
|
40
|
+
executeConsolidation,
|
|
41
|
+
} from "../../../lib/events/consolidation-channel.js";
|
|
42
|
+
import { heartbeatCheckpointTick } from "../../../lib/state/state-checkpoint.js";
|
|
43
|
+
import { getSessionHealth, recordConsolidationSkip } from "../../enforcement/session-health.js";
|
|
44
|
+
import { extractSOP } from "../../../lib/utils/sop-extractor.js";
|
|
45
|
+
import {
|
|
46
|
+
injectSopSuggestions,
|
|
47
|
+
trackSuggestionFeedback,
|
|
48
|
+
} from "../../../lib/utils/sop-suggestion.js";
|
|
49
|
+
import type { TrajectoryEntry } from "../../../lib/utils/sop-extractor.js";
|
|
50
|
+
import {
|
|
51
|
+
isDegraded,
|
|
52
|
+
recordTurnMetrics,
|
|
53
|
+
captureSystemMetrics,
|
|
54
|
+
} from "../../../lib/detection/degradation-detector.js";
|
|
55
|
+
import {
|
|
56
|
+
collectAndEmitContextHeartbeat,
|
|
57
|
+
noteAssistantMessageEnd,
|
|
58
|
+
} from "../../../lib/telemetry/context-heartbeat.js";
|
|
59
|
+
import type { Episode } from "../../../lib/types/episode-types.js";
|
|
60
|
+
import { retrieveEpisodes, addEpisode } from "../../memory/three-memory-stores/index.js";
|
|
61
|
+
import { getSessionIdSafe } from "../../../lib/state/extension-state.js";
|
|
62
|
+
import { deriveProjectIdFromCwd } from "../../../lib/memory/past-insights.js";
|
|
63
|
+
import { shouldWriteOutcomeEpisode } from "../../../lib/memory/write-quality.js";
|
|
64
|
+
import { getMemoryWriteGateConfig } from "../../../lib/config/braid-settings.js";
|
|
65
|
+
import { formatLocalTime } from "../../../lib/utils/local-time.js";
|
|
66
|
+
|
|
67
|
+
/** Derive a short project id from the current working directory. */
|
|
68
|
+
function deriveProject(ctx: ExtensionContext): string {
|
|
69
|
+
return typeof ctx.cwd === "string" ? deriveProjectIdFromCwd(ctx.cwd) : "unknown";
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Per-session slot holding the prompt captured before the run's first turn. */
|
|
73
|
+
interface TurnStartPromptState {
|
|
74
|
+
prompt: string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
function getTurnStartPrompt(ctx: ExtensionContext): TurnStartPromptState {
|
|
78
|
+
return getExtensionState(ctx, "turn-start-prompt", () => ({ prompt: "" }));
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Newest user-role text in the live branch, for runs whose prompt this process
|
|
83
|
+
* never saw: a resumed session's first turn has no before_agent_start capture,
|
|
84
|
+
* and pi appends the user message in its message_end handler, after
|
|
85
|
+
* turn_start(0). Branch entries wrap the message - a user turn is
|
|
86
|
+
* entry.type === "message" with entry.message.role === "user".
|
|
87
|
+
*/
|
|
88
|
+
function newestUserText(ctx: ExtensionContext): string {
|
|
89
|
+
try {
|
|
90
|
+
const sm = (ctx as { sessionManager?: { getBranch?: () => unknown[] } }).sessionManager;
|
|
91
|
+
const branch = sm?.getBranch?.() ?? [];
|
|
92
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
93
|
+
const entry = branch[i] as {
|
|
94
|
+
type?: string;
|
|
95
|
+
message?: { role?: string; content?: unknown };
|
|
96
|
+
};
|
|
97
|
+
if (entry?.type !== "message" || entry.message?.role !== "user") continue;
|
|
98
|
+
const content = entry.message.content;
|
|
99
|
+
if (typeof content === "string") return content;
|
|
100
|
+
if (Array.isArray(content)) {
|
|
101
|
+
return content
|
|
102
|
+
.map((part) => part as { type?: string; text?: string })
|
|
103
|
+
.filter((part) => part?.type === "text" && typeof part.text === "string")
|
|
104
|
+
.map((part) => part.text as string)
|
|
105
|
+
.join("\n");
|
|
106
|
+
}
|
|
107
|
+
return "";
|
|
108
|
+
}
|
|
109
|
+
} catch {
|
|
110
|
+
// Best-effort: a stale ctx or an absent tree yields no text.
|
|
111
|
+
}
|
|
112
|
+
return "";
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
import type { CognitiveModule, ModuleContext, PolicyEngine } from "./types.js";
|
|
116
|
+
import { DEFAULT_CONFIG, getState, getMemoryState } from "./state.js";
|
|
117
|
+
import { updateMetaLearning, getAdaptiveInterval } from "./meta-learning.js";
|
|
118
|
+
import { createDefaultPolicies, VERIFICATION_TOOLS, WEB_TOOLS, CODE_TOOLS } from "./policies.js";
|
|
119
|
+
import {
|
|
120
|
+
formatPendingCompactionsLine,
|
|
121
|
+
maybeArmAutoCompaction,
|
|
122
|
+
} from "../../memory/context-manager/handlers/tools/context-compress.js";
|
|
123
|
+
import { pushBounded } from "../../../lib/utils/bounded.js";
|
|
124
|
+
import { RSS_RING_CAP } from "../../../lib/telemetry/rss-telemetry.js";
|
|
125
|
+
import { recallerModule } from "./modules/recaller.js";
|
|
126
|
+
import { reflectionConsolidatorModule } from "./modules/reflection-consolidator.js";
|
|
127
|
+
import { contextHygieneModule } from "./modules/context-hygiene.js";
|
|
128
|
+
import { measurementModule } from "./modules/measurement.js";
|
|
129
|
+
import { budgetModule } from "./modules/budget.js";
|
|
130
|
+
import { evolverModule } from "./modules/evolver.js";
|
|
131
|
+
import { behavioralDriftModule } from "./modules/behavioral-drift.js";
|
|
132
|
+
import {
|
|
133
|
+
TURN_END,
|
|
134
|
+
TOOL_CALL,
|
|
135
|
+
SESSION_SHUTDOWN,
|
|
136
|
+
MESSAGE_END,
|
|
137
|
+
AGENT_END,
|
|
138
|
+
} from "../../../lib/core/event-names.js";
|
|
139
|
+
|
|
140
|
+
export { reflectionConsolidatorModule as dreamerModule };
|
|
141
|
+
|
|
142
|
+
const log = createLogger("heartbeat");
|
|
143
|
+
|
|
144
|
+
// Delayed Whisper Buffer
|
|
145
|
+
// Per-session buffer for heartbeat whispers. Instead of delivering whispers
|
|
146
|
+
// immediately (which puts them between turns, creating conversational adjacency
|
|
147
|
+
// confusion), we buffer them here and flush on the next before_agent_start.
|
|
148
|
+
// This way the agent sees whispers as part of the turn context, not as
|
|
149
|
+
// standalone messages that could be confused with user input.
|
|
150
|
+
//
|
|
151
|
+
// Keyed by sessionId (from getSessionIdSafe). Cleaned up on session_shutdown.
|
|
152
|
+
interface WhisperBufferEntry {
|
|
153
|
+
message: string;
|
|
154
|
+
priority: string;
|
|
155
|
+
source: string;
|
|
156
|
+
}
|
|
157
|
+
const _heartbeatWhisperBuffer = new Map<string, WhisperBufferEntry[]>();
|
|
158
|
+
|
|
159
|
+
// Outcome-episode write gate.
|
|
160
|
+
// Review-before-write quality gate on the session_outcome sender. The hasSignal
|
|
161
|
+
// tripwire + settings toggle + cooldown live in lib/memory/write-quality.ts;
|
|
162
|
+
// lastWriteAt is owned here (module scope, survives across sessions within the
|
|
163
|
+
// process) so the cooldown actually throttles back-to-back session ends.
|
|
164
|
+
let _lastOutcomeWriteAt = 0;
|
|
165
|
+
|
|
166
|
+
function bufferHeartbeatWhisper(
|
|
167
|
+
sessionId: string,
|
|
168
|
+
message: string,
|
|
169
|
+
priority: string,
|
|
170
|
+
source: string,
|
|
171
|
+
): void {
|
|
172
|
+
let buffer = _heartbeatWhisperBuffer.get(sessionId);
|
|
173
|
+
if (!buffer) {
|
|
174
|
+
buffer = [];
|
|
175
|
+
_heartbeatWhisperBuffer.set(sessionId, buffer);
|
|
176
|
+
}
|
|
177
|
+
// The buffer normally drains on the next before_agent_start, but
|
|
178
|
+
// ticks can pile up while the session is idle (no before_agent_start to
|
|
179
|
+
// flush). Cap at 100 entries per session, drop-oldest — stale heartbeat
|
|
180
|
+
// messages past 100 are noise by definition.
|
|
181
|
+
pushBounded(buffer, { message, priority, source }, 100);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
function flushDelayedWhispers(sessionId: string, pi: ExtensionAPI, selfState?: string): void {
|
|
185
|
+
const buffer = _heartbeatWhisperBuffer.get(sessionId);
|
|
186
|
+
if (!buffer || buffer.length === 0) return;
|
|
187
|
+
const batch = buffer.splice(0);
|
|
188
|
+
|
|
189
|
+
// Deduplicate near-duplicate messages: extract a semantic type key from
|
|
190
|
+
// each message. Messages of the same type (e.g., "Context at 40%..." and
|
|
191
|
+
// "Context at 50%...") collapse to one, so the Heartbeat Summary never
|
|
192
|
+
// lists 9 near-identical context-percentage messages with slightly
|
|
193
|
+
// different token counts.
|
|
194
|
+
function dedupKey(message: string): string {
|
|
195
|
+
// Context percentage messages: "Context at 40%. context_tag..."
|
|
196
|
+
if (/^Context at \d+%/.test(message)) return "context-percentage";
|
|
197
|
+
// Duplicate count messages: "39 near-duplicate messages..."
|
|
198
|
+
if (/^\d+ near-duplicate messages/.test(message)) return "duplicate-count";
|
|
199
|
+
// Context density messages
|
|
200
|
+
if (/^Low context density/.test(message)) return "density-low";
|
|
201
|
+
if (/^High density/.test(message)) return "density-high";
|
|
202
|
+
if (/^Context density still low/.test(message)) return "density-low-persistent";
|
|
203
|
+
// Proactive projection messages
|
|
204
|
+
if (/^\[proactive\]/.test(message)) return "proactive-projection";
|
|
205
|
+
// Degradation messages
|
|
206
|
+
if (/^Degradation detected/.test(message)) return "degradation";
|
|
207
|
+
// Fallback: use first 80 chars
|
|
208
|
+
return message.slice(0, 80);
|
|
209
|
+
}
|
|
210
|
+
interface DedupEntry {
|
|
211
|
+
message: string;
|
|
212
|
+
priority: string;
|
|
213
|
+
}
|
|
214
|
+
const deduped: DedupEntry[] = [];
|
|
215
|
+
const seen = new Set<string>();
|
|
216
|
+
for (const entry of batch) {
|
|
217
|
+
const key = dedupKey(entry.message);
|
|
218
|
+
if (seen.has(key)) continue;
|
|
219
|
+
seen.add(key);
|
|
220
|
+
deduped.push({ message: entry.message, priority: entry.priority });
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
// Aggregate by priority tier
|
|
224
|
+
const groups = new Map<string, string[]>();
|
|
225
|
+
for (const entry of deduped) {
|
|
226
|
+
const p = entry.priority;
|
|
227
|
+
if (!groups.has(p)) groups.set(p, []);
|
|
228
|
+
groups.get(p)!.push(entry.message);
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
for (const [, messages] of groups) {
|
|
232
|
+
// Fresh clock: every Heartbeat Summary carries a `now:` line (date +
|
|
233
|
+
// owner-TZ time via the ONE formatter) so a long session never reasons on
|
|
234
|
+
// a stale clock — the heartbeat is the only mid-session channel guaranteed
|
|
235
|
+
// to re-fire. One context-health line follows the clock (tokens /
|
|
236
|
+
// cache-hit / near-dups / tok-s trend), so every heartbeat delivery is
|
|
237
|
+
// also a self-state checkpoint.
|
|
238
|
+
const nowLine = `now: ${formatLocalTime(new Date(), true)}`;
|
|
239
|
+
const selfStateSuffix = selfState ? `\n${selfState}` : "";
|
|
240
|
+
const text =
|
|
241
|
+
messages.length === 1
|
|
242
|
+
? `${nowLine}${selfStateSuffix}\n${messages[0]}`
|
|
243
|
+
: `[Heartbeat Summary]\n${nowLine}${selfStateSuffix}\n${messages.map((m, i) => `${i + 1}. ${m}`).join("\n")}`;
|
|
244
|
+
try {
|
|
245
|
+
sendTrackedMessage(
|
|
246
|
+
pi,
|
|
247
|
+
{
|
|
248
|
+
customType: "heartbeat",
|
|
249
|
+
content: [{ type: "text" as const, text }],
|
|
250
|
+
display: true,
|
|
251
|
+
details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "heartbeat/delayed" },
|
|
252
|
+
},
|
|
253
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
254
|
+
{ type: "heartbeat", source: "heartbeat/delayed" },
|
|
255
|
+
);
|
|
256
|
+
} catch (err) {
|
|
257
|
+
log.warn(`[heartbeat] delayed whisper flush failed: ${err}`);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
// SOP Formatting
|
|
263
|
+
|
|
264
|
+
/** Format SOP (3-tier hierarchy) for whispering to agent */
|
|
265
|
+
export function formatSOPForWhisper(episode: Episode): string {
|
|
266
|
+
const parts: string[] = [];
|
|
267
|
+
|
|
268
|
+
if (episode.strategicSOP) {
|
|
269
|
+
parts.push(`**Strategy**: ${episode.strategicSOP}`);
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
if (episode.functionalSOP && episode.functionalSOP.length > 0) {
|
|
273
|
+
const steps = episode.functionalSOP.map((step, i) => `${i + 1}. ${step}`).join("\n");
|
|
274
|
+
parts.push(`**Key Steps**:\n${steps}`);
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
if (episode.atomicSOP && episode.atomicSOP.length > 0) {
|
|
278
|
+
parts.push(`**Tools**: ${episode.atomicSOP.join(" -> ")}`);
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
return parts.length > 0 ? parts.join("\n\n") : `SOP for: ${episode.task.slice(0, 100)}`;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/**
|
|
285
|
+
* Deliver the SOP coach whisper through the tracked channel.
|
|
286
|
+
*
|
|
287
|
+
* `ctx.whisper` is a type-only augmentation with no runtime implementation —
|
|
288
|
+
* a whisper sent there silently never fires, and would bypass the per-source
|
|
289
|
+
* flood cap, injection tracking, and the universal
|
|
290
|
+
* `[braid-whisper - heartbeat]` envelope. `sendTrackedMessage` (the trunk)
|
|
291
|
+
* is the delivery path; see `lib/utils/whisper-format.ts`.
|
|
292
|
+
*/
|
|
293
|
+
export function sendSopCoachWhisper(pi: ExtensionAPI, message: string): void {
|
|
294
|
+
sendTrackedMessage(
|
|
295
|
+
pi,
|
|
296
|
+
{
|
|
297
|
+
customType: "heartbeat",
|
|
298
|
+
content: [{ type: "text" as const, text: message }],
|
|
299
|
+
display: true,
|
|
300
|
+
},
|
|
301
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
302
|
+
{ type: "context", source: "heartbeat/sop-coach" },
|
|
303
|
+
);
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
// Whisper Batching
|
|
307
|
+
// flushWhisperBuffer lives in ./whisper-batcher.ts. The tick function
|
|
308
|
+
// imports it to flush module whispers as aggregated messages.
|
|
309
|
+
import { flushWhisperBuffer } from "./whisper-batcher.js";
|
|
310
|
+
import { buildSelfStateLine } from "./whisper-batcher.js";
|
|
311
|
+
import { getSelfStateSample } from "../../../lib/telemetry/context-heartbeat.js";
|
|
312
|
+
|
|
313
|
+
// Tick Engine
|
|
314
|
+
|
|
315
|
+
function tick(
|
|
316
|
+
pi: ExtensionAPI,
|
|
317
|
+
state: import("./types.js").HeartbeatState,
|
|
318
|
+
config: import("./types.js").HeartbeatConfig,
|
|
319
|
+
ctx: ExtensionContext,
|
|
320
|
+
): void {
|
|
321
|
+
state.stats.totalTicks++;
|
|
322
|
+
|
|
323
|
+
// Real telemetry: collect live context/RSS/session metrics, append the
|
|
324
|
+
// JSONL heartbeat line, and feed recordTurnMetrics real values (not
|
|
325
|
+
// placeholder constants). Sink failures are non-fatal inside the
|
|
326
|
+
// telemetry module; the degradation feed below tolerates unavailable
|
|
327
|
+
// samples (zeros).
|
|
328
|
+
const telemetry = collectAndEmitContextHeartbeat(ctx, {
|
|
329
|
+
turnNumber: state.turnCount,
|
|
330
|
+
healthMode: getSessionHealth(ctx).mode,
|
|
331
|
+
source: "heartbeat",
|
|
332
|
+
});
|
|
333
|
+
|
|
334
|
+
// Tool outcome stats from the capped trajectory (real error accounting).
|
|
335
|
+
const trajectory = state.metaLearning.toolTracking.trajectory ?? [];
|
|
336
|
+
const trajectoryErrors = trajectory.reduce((n, t) => n + (t.success ? 0 : 1), 0);
|
|
337
|
+
let trailingErrors = 0;
|
|
338
|
+
for (let i = trajectory.length - 1; i >= 0; i--) {
|
|
339
|
+
if (trajectory[i].success) break;
|
|
340
|
+
trailingErrors++;
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
recordTurnMetrics(ctx, {
|
|
344
|
+
turnNumber: state.turnCount,
|
|
345
|
+
avgTurnDurationMs: telemetry.lastAssistantDurationMs ?? 0,
|
|
346
|
+
inputTokens: telemetry.inputTokens,
|
|
347
|
+
outputTokens: telemetry.outputTokens,
|
|
348
|
+
toolCalls: state.metaLearning.toolTracking.totalToolsUsed,
|
|
349
|
+
errors: trajectoryErrors,
|
|
350
|
+
errorRate: trajectory.length > 0 ? trajectoryErrors / trajectory.length : 0,
|
|
351
|
+
toolSuccessRate:
|
|
352
|
+
trajectory.length > 0
|
|
353
|
+
? ((trajectory.length - trajectoryErrors) / trajectory.length) * 100
|
|
354
|
+
: 100,
|
|
355
|
+
consecutiveErrors: trailingErrors,
|
|
356
|
+
tokenUsage: { input: telemetry.inputTokens, output: telemetry.outputTokens },
|
|
357
|
+
memoryUsagePercent: captureSystemMetrics().memoryUsagePercent,
|
|
358
|
+
});
|
|
359
|
+
|
|
360
|
+
// sustained RSS growth advisory (ONE per boot, no spam)
|
|
361
|
+
// The ring + baseline + verdict come from the telemetry module above. A
|
|
362
|
+
// FULL 24-sample ring sitting entirely above 2x the boot baseline is the
|
|
363
|
+
// accumulator-growth signature; the latch (process-global, global-state.ts)
|
|
364
|
+
// guarantees at most one advisory per boot. Advisory: buffered heartbeat
|
|
365
|
+
// message, never a wake.
|
|
366
|
+
if (telemetry.rssSustainedGrowth && !getRssGrowthWhisperShown()) {
|
|
367
|
+
markRssGrowthWhisperShown();
|
|
368
|
+
const baseMb = ((telemetry.rssBaselineBytes ?? 0) / 1048576).toFixed(0);
|
|
369
|
+
const curBytes = telemetry.rssRing[telemetry.rssRing.length - 1] ?? 0;
|
|
370
|
+
const curMb = (curBytes / 1048576).toFixed(0);
|
|
371
|
+
const sid0 = getSessionIdSafe(ctx) ?? "anonymous";
|
|
372
|
+
bufferHeartbeatWhisper(
|
|
373
|
+
sid0,
|
|
374
|
+
`[memory] Sustained RSS growth: ${curMb}MB now vs ${baseMb}MB boot baseline ` +
|
|
375
|
+
`(>2x across ${RSS_RING_CAP} heartbeat samples). Unbounded in-memory accumulator ` +
|
|
376
|
+
`likely — investigate (context_inspect, /logs) before the next OOM. ` +
|
|
377
|
+
`This advisory fires once per boot.`,
|
|
378
|
+
"medium",
|
|
379
|
+
"heartbeat/rss-growth",
|
|
380
|
+
);
|
|
381
|
+
log.warn(
|
|
382
|
+
`[heartbeat] RSS sustained-growth advisory fired: ${(curBytes / 1048576).toFixed(0)}MB vs ${baseMb}MB baseline (${RSS_RING_CAP}-sample ring)`,
|
|
383
|
+
);
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
// armed-compaction visibility + usage-driven auto-arm
|
|
387
|
+
// A compaction armed by context_compress fires at the next turn boundary
|
|
388
|
+
// (turn_end) or at run settle. While it sits armed, live usage reads
|
|
389
|
+
// pre-compaction state — the pending state must stay visible in every
|
|
390
|
+
// heartbeat summary until it lands (a once-per-tier advisory went quiet
|
|
391
|
+
// exactly while nothing was landing), and usage sustained above the
|
|
392
|
+
// configured threshold must arm relief on its own: same pending queue,
|
|
393
|
+
// same boundary discipline (arming only queues; the compact still fires at
|
|
394
|
+
// a safe boundary, never mid-run). Best-effort: neither surface may break
|
|
395
|
+
// the tick.
|
|
396
|
+
try {
|
|
397
|
+
const pendingLine = formatPendingCompactionsLine(ctx);
|
|
398
|
+
if (pendingLine) {
|
|
399
|
+
bufferHeartbeatWhisper(
|
|
400
|
+
getSessionIdSafe(ctx) ?? "anonymous",
|
|
401
|
+
pendingLine,
|
|
402
|
+
"high",
|
|
403
|
+
"heartbeat/pending-compaction",
|
|
404
|
+
);
|
|
405
|
+
}
|
|
406
|
+
} catch (err) {
|
|
407
|
+
log.warn(`[heartbeat] pending-compaction advisory failed: ${err}`);
|
|
408
|
+
}
|
|
409
|
+
try {
|
|
410
|
+
maybeArmAutoCompaction(pi, ctx);
|
|
411
|
+
} catch (err) {
|
|
412
|
+
log.warn(`[heartbeat] context auto-arm check failed: ${err}`);
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
try {
|
|
416
|
+
eventBus.emit({
|
|
417
|
+
type: "heartbeat_tick",
|
|
418
|
+
turn: state.turnCount,
|
|
419
|
+
tickCount: state.stats.totalTicks,
|
|
420
|
+
timestamp: Date.now(),
|
|
421
|
+
});
|
|
422
|
+
} catch (err) {
|
|
423
|
+
log.warn(`[heartbeat] Could not emit tick event: ${err}`);
|
|
424
|
+
}
|
|
425
|
+
|
|
426
|
+
state.policyTurnCount++;
|
|
427
|
+
|
|
428
|
+
updateMetaLearning(state);
|
|
429
|
+
|
|
430
|
+
// Evaluate policies on each tick
|
|
431
|
+
if (state.policyEngineReady) {
|
|
432
|
+
const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
|
|
433
|
+
const engine = getPolicyEngine(sessionId);
|
|
434
|
+
if (engine) {
|
|
435
|
+
const policyCtx: PolicyContext = {
|
|
436
|
+
sessionId,
|
|
437
|
+
turnNumber: state.policyTurnCount,
|
|
438
|
+
toolStats: new Map(),
|
|
439
|
+
cwd: ctx.cwd ?? ".",
|
|
440
|
+
getContextUsage: () => ctx.getContextUsage(),
|
|
441
|
+
};
|
|
442
|
+
engine
|
|
443
|
+
.evaluate(policyCtx)
|
|
444
|
+
.then((fired) => {
|
|
445
|
+
if (fired.length > 0) {
|
|
446
|
+
log.info(`Policies fired: ${fired.map((p) => p.id).join(", ")}`);
|
|
447
|
+
}
|
|
448
|
+
})
|
|
449
|
+
.catch((err) => {
|
|
450
|
+
log.error("Policy evaluation error:", err);
|
|
451
|
+
});
|
|
452
|
+
}
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
// Build module context from heartbeat state. Modules call context.whisper()
|
|
456
|
+
// (not ctx.whisper?.()) to honor the flood cap: the whisperBuffer collects
|
|
457
|
+
// all module whispers; the tick handler flushes them via sendTrackedMessage.
|
|
458
|
+
const whisperBuffer: Array<{ message: string; priority: string }> = [];
|
|
459
|
+
|
|
460
|
+
// Per-tick AbortController for ESC propagation
|
|
461
|
+
// Create a fresh AbortController for this tick; modules receive it
|
|
462
|
+
// as context.abortSignal for cancellation-aware calls. On
|
|
463
|
+
// session_shutdown, the controller is aborted, cancelling any
|
|
464
|
+
// in-flight call instead of letting it run for its full timeout
|
|
465
|
+
// (10m default) after the session ends.
|
|
466
|
+
const tickController = new AbortController();
|
|
467
|
+
const abortState = getExtensionState<{ controller: AbortController | null }>(
|
|
468
|
+
ctx,
|
|
469
|
+
"heartbeat-abort",
|
|
470
|
+
() => ({ controller: null }),
|
|
471
|
+
);
|
|
472
|
+
abortState.controller = tickController;
|
|
473
|
+
|
|
474
|
+
const moduleContext: ModuleContext = {
|
|
475
|
+
ctx,
|
|
476
|
+
abortSignal: tickController.signal,
|
|
477
|
+
turnCount: state.turnCount,
|
|
478
|
+
lastActivation: state.lastActivation,
|
|
479
|
+
sessionAge: state.turnCount,
|
|
480
|
+
toolCallsSinceLastTick: [],
|
|
481
|
+
totalToolCalls: state.metaLearning.toolTracking.totalToolsUsed,
|
|
482
|
+
silentTurns:
|
|
483
|
+
state.stats.totalTicks > 0
|
|
484
|
+
? Math.max(
|
|
485
|
+
0,
|
|
486
|
+
state.stats.totalTicks - (state.metaLearning.toolTracking.lastToolCallTurn || 0),
|
|
487
|
+
)
|
|
488
|
+
: 0,
|
|
489
|
+
metadata: {
|
|
490
|
+
toolFailures:
|
|
491
|
+
state.metaLearning.toolTracking.totalToolsUsed > 10
|
|
492
|
+
? Math.max(0, Math.floor(state.metaLearning.toolTracking.totalToolsUsed * 0.15))
|
|
493
|
+
: 0,
|
|
494
|
+
decompositionDepth: 0,
|
|
495
|
+
},
|
|
496
|
+
whisper: (msg, opts) => {
|
|
497
|
+
whisperBuffer.push({ message: msg, priority: opts?.priority ?? "low" });
|
|
498
|
+
},
|
|
499
|
+
};
|
|
500
|
+
|
|
501
|
+
// Evaluate which modules should activate
|
|
502
|
+
const candidates: Array<{ module: CognitiveModule; priority: number; reg: any }> = [];
|
|
503
|
+
|
|
504
|
+
for (const [, reg] of state.modules) {
|
|
505
|
+
if (!reg.enabled) continue;
|
|
506
|
+
try {
|
|
507
|
+
if (reg.module.shouldActivate(moduleContext)) {
|
|
508
|
+
candidates.push({ module: reg.module, priority: reg.module.priority, reg });
|
|
509
|
+
}
|
|
510
|
+
} catch (err) {
|
|
511
|
+
log.error(`Module "${reg.module.name}" shouldActivate error:`, err);
|
|
512
|
+
}
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
// Whisper batching: moduleContext.whisper() is the API modules call; it
|
|
516
|
+
// pushes to whisperBuffer (declared above) instead of mutating ctx.
|
|
517
|
+
// Modules that still call ctx.whisper directly bypass the per-source flood
|
|
518
|
+
// cap; future module migrations should adopt context.whisper().
|
|
519
|
+
|
|
520
|
+
candidates
|
|
521
|
+
.sort((a, b) => b.priority - a.priority)
|
|
522
|
+
.slice(0, config.maxActivationsPerTick)
|
|
523
|
+
.forEach(async ({ module, reg }) => {
|
|
524
|
+
try {
|
|
525
|
+
await module.activate(moduleContext);
|
|
526
|
+
reg.activations++;
|
|
527
|
+
reg.lastActivated = state.turnCount;
|
|
528
|
+
state.lastActivation.set(module.name, state.turnCount);
|
|
529
|
+
state.stats.totalActivations++;
|
|
530
|
+
state.stats.activationsByModule[module.name] =
|
|
531
|
+
(state.stats.activationsByModule[module.name] ?? 0) + 1;
|
|
532
|
+
|
|
533
|
+
state.activationHistory.push({
|
|
534
|
+
tick: state.stats.totalTicks,
|
|
535
|
+
moduleName: module.name,
|
|
536
|
+
timestamp: Date.now(),
|
|
537
|
+
reason: "heartbeat",
|
|
538
|
+
});
|
|
539
|
+
|
|
540
|
+
if (state.activationHistory.length > 100) {
|
|
541
|
+
state.activationHistory.shift();
|
|
542
|
+
}
|
|
543
|
+
|
|
544
|
+
state.metaLearning.pendingSignals.set(module.name, state.turnCount);
|
|
545
|
+
state.metaLearning.activationSignalWindow.set(module.name, state.turnCount);
|
|
546
|
+
|
|
547
|
+
log.info(`Activated module "${module.name}" (priority ${module.priority.toFixed(1)})`);
|
|
548
|
+
} catch (err) {
|
|
549
|
+
log.error(`Module "${module.name}" activate error:`, err);
|
|
550
|
+
}
|
|
551
|
+
});
|
|
552
|
+
|
|
553
|
+
// Auto-checkpoint + auto-rollback
|
|
554
|
+
const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
|
|
555
|
+
|
|
556
|
+
// Consolidation Channel - fire-and-forget
|
|
557
|
+
processConsolidationTick(ctx).catch((err) => {
|
|
558
|
+
log.error("Consolidation tick error:", err);
|
|
559
|
+
});
|
|
560
|
+
|
|
561
|
+
heartbeatCheckpointTick(ctx, state.turnCount, sessionId, isDegraded(ctx))
|
|
562
|
+
.then((result) => {
|
|
563
|
+
if (result.checkpointCreated) {
|
|
564
|
+
log.info(`Auto-checkpoint created at turn ${state.turnCount}`);
|
|
565
|
+
}
|
|
566
|
+
if (result.rollbackPerformed) {
|
|
567
|
+
log.warn(`Auto-rollback performed: ${result.message}`);
|
|
568
|
+
whisperBuffer.push({
|
|
569
|
+
message: `Auto-rollback: ${result.message}`,
|
|
570
|
+
priority: "high",
|
|
571
|
+
});
|
|
572
|
+
}
|
|
573
|
+
if (result.rollbackSuppressed) {
|
|
574
|
+
// Test-debug guard: destructive rollback withheld on a
|
|
575
|
+
// test-runner-dominated error burst. Advice stays, action withheld —
|
|
576
|
+
// the agent hears the degradation signal without a conversation rewind.
|
|
577
|
+
log.warn(`Auto-rollback suppressed (test-debug loop): ${result.message}`);
|
|
578
|
+
whisperBuffer.push({
|
|
579
|
+
message:
|
|
580
|
+
`Degradation detected but the recent error burst is test-runner dominated — ` +
|
|
581
|
+
`auto-rollback withheld (failing tests are expected in TDD/gate triage). ` +
|
|
582
|
+
`If this is NOT an intentional test loop, run health_maintenance(action="check").`,
|
|
583
|
+
priority: "medium",
|
|
584
|
+
});
|
|
585
|
+
}
|
|
586
|
+
})
|
|
587
|
+
.catch((err) => {
|
|
588
|
+
log.error("Checkpoint tick error:", err);
|
|
589
|
+
})
|
|
590
|
+
.finally(() => {
|
|
591
|
+
// Flush via the proper tracked channel: the buffer is collected by
|
|
592
|
+
// moduleContext.whisper(). Modules that still call ctx.whisper directly
|
|
593
|
+
// (not yet migrated) go through the original sendTrackedMessage channel
|
|
594
|
+
// so they still get batched + flood-capped.
|
|
595
|
+
const sendFn = (msg: string, opts?: { category?: string; priority?: string }) => {
|
|
596
|
+
const sid = getSessionIdSafe(ctx) ?? "anonymous";
|
|
597
|
+
bufferHeartbeatWhisper(sid, msg, opts?.priority ?? "low", "heartbeat/whisper-batcher");
|
|
598
|
+
};
|
|
599
|
+
// Self-state (Refine-2): the tick summary carries the self-state
|
|
600
|
+
// line (fresh telemetry was collected at the top of this tick).
|
|
601
|
+
flushWhisperBuffer(whisperBuffer, sendFn, buildSelfStateLine(getSelfStateSample(ctx)));
|
|
602
|
+
});
|
|
603
|
+
}
|
|
604
|
+
|
|
605
|
+
// Extension
|
|
606
|
+
|
|
607
|
+
export default function heartbeatExtension(pi: ExtensionAPI) {
|
|
608
|
+
const config = { ...DEFAULT_CONFIG };
|
|
609
|
+
|
|
610
|
+
// Register built-in modules. Timer reminders are not a module: the timer
|
|
611
|
+
// extension's own wake/reminder delivery (timer/index.ts) is the
|
|
612
|
+
// canonical path — one timer fire, one whisper.
|
|
613
|
+
const builtInModules: CognitiveModule[] = [
|
|
614
|
+
recallerModule,
|
|
615
|
+
reflectionConsolidatorModule,
|
|
616
|
+
contextHygieneModule,
|
|
617
|
+
measurementModule,
|
|
618
|
+
evolverModule,
|
|
619
|
+
budgetModule,
|
|
620
|
+
behavioralDriftModule,
|
|
621
|
+
];
|
|
622
|
+
|
|
623
|
+
// Event: turn_end
|
|
624
|
+
|
|
625
|
+
pi.on(TURN_END, async (_event: any, ctx: ExtensionContext) => {
|
|
626
|
+
const state = getState(ctx);
|
|
627
|
+
if (!state.enabled || !config.enabled) return;
|
|
628
|
+
|
|
629
|
+
state.turnCount++;
|
|
630
|
+
|
|
631
|
+
eventBus.emit({
|
|
632
|
+
type: "turn_complete",
|
|
633
|
+
turn: state.turnCount,
|
|
634
|
+
duration: Date.now(),
|
|
635
|
+
});
|
|
636
|
+
|
|
637
|
+
const interval = getAdaptiveInterval(state);
|
|
638
|
+
if (state.turnCount % interval !== 0) return;
|
|
639
|
+
|
|
640
|
+
tick(pi, state, config, ctx);
|
|
641
|
+
});
|
|
642
|
+
|
|
643
|
+
// Event: before_agent_start - flush delayed whispers
|
|
644
|
+
// Deliver buffered heartbeat whispers as part of the turn context,
|
|
645
|
+
// not as standalone messages between turns. This prevents the
|
|
646
|
+
// conversational adjacency confusion where the agent treats a
|
|
647
|
+
// between-turn whisper as user input.
|
|
648
|
+
pi.on("before_agent_start", (event: unknown, ctx: ExtensionContext) => {
|
|
649
|
+
const sid = getSessionIdSafe(ctx) ?? "anonymous";
|
|
650
|
+
// turn_start carries no user text (TurnStartEvent = type/turnIndex/timestamp),
|
|
651
|
+
// so capture the run's prompt here - the last point pi exposes it before
|
|
652
|
+
// turn 0. A failed capture leaves the slot untouched: empty on the session's
|
|
653
|
+
// first capture, so the branch fallback takes over; otherwise the previous
|
|
654
|
+
// capture stands.
|
|
655
|
+
const prompt = (event as { prompt?: unknown } | undefined)?.prompt;
|
|
656
|
+
if (typeof prompt === "string" && prompt.length > 0) {
|
|
657
|
+
getTurnStartPrompt(ctx).prompt = prompt;
|
|
658
|
+
}
|
|
659
|
+
// Self-state (Refine-2): every heartbeat-family delivery carries the
|
|
660
|
+
// self-state line. Sampling never throws; missing telemetry -> "n/a".
|
|
661
|
+
flushDelayedWhispers(sid, pi, buildSelfStateLine(getSelfStateSample(ctx)));
|
|
662
|
+
});
|
|
663
|
+
|
|
664
|
+
// Event: tool_call
|
|
665
|
+
|
|
666
|
+
pi.on(TOOL_CALL, async (event: any, ctx: ExtensionContext) => {
|
|
667
|
+
const state = getState(ctx);
|
|
668
|
+
|
|
669
|
+
try {
|
|
670
|
+
const toolName = event?.toolName as string;
|
|
671
|
+
if (toolName) trackSuggestionFeedback(ctx, toolName);
|
|
672
|
+
} catch {
|
|
673
|
+
// Suggestion telemetry is observational — a malformed event must not
|
|
674
|
+
// break the tool-execution pipeline it observes.
|
|
675
|
+
}
|
|
676
|
+
|
|
677
|
+
// Meta-learning signal detection
|
|
678
|
+
if (state.metaLearning.pendingSignals.size > 0) {
|
|
679
|
+
state.metaLearning.postActivationToolCount++;
|
|
680
|
+
}
|
|
681
|
+
|
|
682
|
+
state.metaLearning.toolTracking.totalToolsUsed++;
|
|
683
|
+
state.metaLearning.toolTracking.lastToolCallTurn = state.policyTurnCount;
|
|
684
|
+
|
|
685
|
+
const toolName = event?.toolName as string;
|
|
686
|
+
if (!toolName) return;
|
|
687
|
+
|
|
688
|
+
if (VERIFICATION_TOOLS.has(toolName)) {
|
|
689
|
+
state.metaLearning.toolTracking.verificationCount++;
|
|
690
|
+
state.metaLearning.toolTracking.lastVerificationTurn = state.policyTurnCount;
|
|
691
|
+
}
|
|
692
|
+
if (WEB_TOOLS.has(toolName)) {
|
|
693
|
+
state.metaLearning.toolTracking.lastWebFetchTurn = state.policyTurnCount;
|
|
694
|
+
}
|
|
695
|
+
if (CODE_TOOLS.has(toolName)) {
|
|
696
|
+
state.metaLearning.toolTracking.lastCodeExecutionTurn = state.policyTurnCount;
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
|
|
700
|
+
const store = getBeliefStore(sessionId);
|
|
701
|
+
if (store) {
|
|
702
|
+
store.add({
|
|
703
|
+
id: `tool-${toolName}-${Date.now()}`,
|
|
704
|
+
content: `Tool ${toolName} executed at turn ${state.policyTurnCount}`,
|
|
705
|
+
source: "observation",
|
|
706
|
+
confidence: 0.9,
|
|
707
|
+
timestamp: Date.now(),
|
|
708
|
+
tags: ["tool", toolName],
|
|
709
|
+
});
|
|
710
|
+
}
|
|
711
|
+
});
|
|
712
|
+
|
|
713
|
+
// Event: message_end - assistant tps telemetry feed
|
|
714
|
+
// Duration = now - message.timestamp
|
|
715
|
+
// (stream-start proxy), usage.input/output from the final assistant
|
|
716
|
+
// message. Feeds tokensPerSec + the real token metrics in tick().
|
|
717
|
+
// No LLM calls, no whispering — pure observation.
|
|
718
|
+
pi.on(MESSAGE_END, (event: any, ctx: ExtensionContext) => {
|
|
719
|
+
try {
|
|
720
|
+
noteAssistantMessageEnd(ctx, event?.message);
|
|
721
|
+
} catch {
|
|
722
|
+
// telemetry never fatal
|
|
723
|
+
}
|
|
724
|
+
});
|
|
725
|
+
|
|
726
|
+
// Event: tool_result - collect tool success/failure for trajectory enrichment
|
|
727
|
+
pi.on("tool_result", (event: any, ctx: ExtensionContext) => {
|
|
728
|
+
const state = getState(ctx);
|
|
729
|
+
const toolName = event?.toolName as string;
|
|
730
|
+
if (!toolName) return;
|
|
731
|
+
|
|
732
|
+
// Track tool outcome for richer SOP extraction
|
|
733
|
+
const success = !event?.isError;
|
|
734
|
+
state.metaLearning.toolTracking.trajectory ??= [];
|
|
735
|
+
state.metaLearning.toolTracking.trajectory.push({
|
|
736
|
+
toolName,
|
|
737
|
+
success,
|
|
738
|
+
turn: state.policyTurnCount,
|
|
739
|
+
});
|
|
740
|
+
|
|
741
|
+
// Cap trajectory length
|
|
742
|
+
if (state.metaLearning.toolTracking.trajectory.length > 200) {
|
|
743
|
+
state.metaLearning.toolTracking.trajectory =
|
|
744
|
+
state.metaLearning.toolTracking.trajectory.slice(-100);
|
|
745
|
+
}
|
|
746
|
+
});
|
|
747
|
+
|
|
748
|
+
// Event: session_start
|
|
749
|
+
registerSessionStartHandler(
|
|
750
|
+
pi,
|
|
751
|
+
SessionPhase.MemoryState,
|
|
752
|
+
async (_event: any, ctx: ExtensionContext) => {
|
|
753
|
+
const state = getState(ctx);
|
|
754
|
+
|
|
755
|
+
for (const module of builtInModules) {
|
|
756
|
+
if (!state.modules.has(module.name)) {
|
|
757
|
+
state.modules.set(module.name, {
|
|
758
|
+
module,
|
|
759
|
+
enabled: true,
|
|
760
|
+
activations: 0,
|
|
761
|
+
lastActivated: 0,
|
|
762
|
+
effectiveness: 0.5,
|
|
763
|
+
});
|
|
764
|
+
log.info(`Registered module "${module.name}"`);
|
|
765
|
+
}
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
|
|
769
|
+
const engine = createPolicyEngine(sessionId);
|
|
770
|
+
state.policyTurnCount = 0;
|
|
771
|
+
state.policyEngineReady = true;
|
|
772
|
+
|
|
773
|
+
const onSignal = (type: string, _data: Record<string, unknown>) => {
|
|
774
|
+
state.activationHistory.push({
|
|
775
|
+
tick: state.stats.totalTicks,
|
|
776
|
+
moduleName: type,
|
|
777
|
+
timestamp: Date.now(),
|
|
778
|
+
reason: "policy",
|
|
779
|
+
});
|
|
780
|
+
};
|
|
781
|
+
|
|
782
|
+
const defaultPolicies = createDefaultPolicies(
|
|
783
|
+
() => state.metaLearning.toolTracking,
|
|
784
|
+
onSignal,
|
|
785
|
+
// Policy engine whisper uses the proper sendTrackedMessage channel
|
|
786
|
+
// (honors flood cap and injection tracking) instead of ctx.whisper.
|
|
787
|
+
// The per-tick aggregation (whisperBuffer) is for module whispers;
|
|
788
|
+
// policy whispers are signal-triggered and fire independently of the
|
|
789
|
+
// tick.
|
|
790
|
+
//
|
|
791
|
+
// Policy whispers are buffered and delivered on the next
|
|
792
|
+
// before_agent_start instead of immediately, preventing
|
|
793
|
+
// conversational adjacency confusion (the agent treating a
|
|
794
|
+
// between-turn whisper as user input). The auto-finalize callback
|
|
795
|
+
// (below) still delivers immediately because it uses
|
|
796
|
+
// deliverAs:"steer" and is time-critical (at ≥90% context the
|
|
797
|
+
// whisper may never get a next turn — steer it into the current run).
|
|
798
|
+
(msg: string) => {
|
|
799
|
+
const sid = getSessionIdSafe(ctx) ?? "anonymous";
|
|
800
|
+
bufferHeartbeatWhisper(sid, msg, "medium", "heartbeat/policy");
|
|
801
|
+
},
|
|
802
|
+
(msg: string) => {
|
|
803
|
+
sendTrackedMessage(
|
|
804
|
+
pi,
|
|
805
|
+
{
|
|
806
|
+
customType: "heartbeat",
|
|
807
|
+
content: [{ type: "text" as const, text: msg }],
|
|
808
|
+
display: true,
|
|
809
|
+
},
|
|
810
|
+
{ delivery: "live", deliverAs: "steer" },
|
|
811
|
+
{ type: "heartbeat", source: "heartbeat/auto-finalize" },
|
|
812
|
+
);
|
|
813
|
+
},
|
|
814
|
+
);
|
|
815
|
+
for (const policy of defaultPolicies) {
|
|
816
|
+
engine.register(policy);
|
|
817
|
+
}
|
|
818
|
+
log.info(
|
|
819
|
+
`Policy engine initialized with ${defaultPolicies.length} default policies (tool tracking active)`,
|
|
820
|
+
);
|
|
821
|
+
|
|
822
|
+
// Activate policy engine wrapper
|
|
823
|
+
activatePolicyEngine(engine, state, ctx);
|
|
824
|
+
|
|
825
|
+
// SOP Retrieval + Coach Decision
|
|
826
|
+
try {
|
|
827
|
+
const memState = getMemoryState(ctx);
|
|
828
|
+
if (memState) {
|
|
829
|
+
const project = ctx.cwd ?? "unknown";
|
|
830
|
+
const episodes = retrieveEpisodes(memState, project, 3, project);
|
|
831
|
+
if (episodes && episodes.length > 0) {
|
|
832
|
+
const topEpisode = episodes[0];
|
|
833
|
+
if (topEpisode.similarity > 0.3) {
|
|
834
|
+
// Recalled episode SOPs are fenced non-user context.
|
|
835
|
+
const sopSummary = fenceMemoryContext(formatSOPForWhisper(topEpisode));
|
|
836
|
+
// Deliver via the tracked channel so the whisper actually
|
|
837
|
+
// fires (ctx.whisper is a type-only augmentation, no runtime
|
|
838
|
+
// implementation) and carries the [braid-whisper - heartbeat]
|
|
839
|
+
// envelope.
|
|
840
|
+
sendSopCoachWhisper(pi, sopSummary);
|
|
841
|
+
log.info(`Coach: Whispered SOP from past episode ${topEpisode.id}`);
|
|
842
|
+
}
|
|
843
|
+
}
|
|
844
|
+
}
|
|
845
|
+
} catch (err) {
|
|
846
|
+
log.debug(`SOP retrieval skipped: ${(err as Error).message}`);
|
|
847
|
+
}
|
|
848
|
+
},
|
|
849
|
+
);
|
|
850
|
+
|
|
851
|
+
// Event: turn_start - inject relevant SOPs from past episodes
|
|
852
|
+
|
|
853
|
+
pi.on("turn_start", async (_event: any, ctx: ExtensionContext) => {
|
|
854
|
+
try {
|
|
855
|
+
const memState = getMemoryState(ctx);
|
|
856
|
+
if (memState && memState.episodes) {
|
|
857
|
+
// The turn's user text is not on the event; consult the prompt
|
|
858
|
+
// captured at before_agent_start, falling back to the live branch.
|
|
859
|
+
const userText = getTurnStartPrompt(ctx).prompt || newestUserText(ctx);
|
|
860
|
+
if (userText.length > 5) {
|
|
861
|
+
try {
|
|
862
|
+
const sopState = getExtensionState(ctx, "sop-suggestion", () => ({
|
|
863
|
+
suggestedEpisodeIds: new Set<string>(),
|
|
864
|
+
}));
|
|
865
|
+
// Derive project ID from cwd (last 2 path components)
|
|
866
|
+
const cwdParts = (ctx.cwd ?? "").replace(/\\/g, "/").split("/").filter(Boolean);
|
|
867
|
+
const currentProject =
|
|
868
|
+
cwdParts.length >= 2 ? cwdParts.slice(-2).join("/") : (ctx.cwd ?? "unknown");
|
|
869
|
+
|
|
870
|
+
injectSopSuggestions(
|
|
871
|
+
pi,
|
|
872
|
+
ctx,
|
|
873
|
+
userText,
|
|
874
|
+
memState.episodes,
|
|
875
|
+
sopState.suggestedEpisodeIds,
|
|
876
|
+
currentProject,
|
|
877
|
+
);
|
|
878
|
+
} catch {
|
|
879
|
+
// Non-fatal: basic suggestion without dedup
|
|
880
|
+
const cwdParts = (ctx.cwd ?? "").replace(/\\/g, "/").split("/").filter(Boolean);
|
|
881
|
+
const currentProject =
|
|
882
|
+
cwdParts.length >= 2 ? cwdParts.slice(-2).join("/") : (ctx.cwd ?? "unknown");
|
|
883
|
+
injectSopSuggestions(pi, ctx, userText, memState.episodes, undefined, currentProject);
|
|
884
|
+
}
|
|
885
|
+
}
|
|
886
|
+
}
|
|
887
|
+
} catch (err) {
|
|
888
|
+
log.debug(`SOP suggestion skipped: ${(err as Error).message}`);
|
|
889
|
+
}
|
|
890
|
+
});
|
|
891
|
+
|
|
892
|
+
// Event: agent_end
|
|
893
|
+
|
|
894
|
+
pi.on(AGENT_END, async (_event: any, ctx: ExtensionContext) => {
|
|
895
|
+
const state = getState(ctx);
|
|
896
|
+
// agent_end carries only `messages`; the run outcome is the final
|
|
897
|
+
// assistant message's stopReason, classified the way pi classifies its
|
|
898
|
+
// own activity outcome (agent-session _dispatchTurnEndBoundary).
|
|
899
|
+
const messages = Array.isArray(_event?.messages) ? _event.messages : [];
|
|
900
|
+
const lastAssistant = [...messages].reverse().find((m: any) => m?.role === "assistant");
|
|
901
|
+
const outcome =
|
|
902
|
+
lastAssistant?.stopReason === "aborted"
|
|
903
|
+
? "aborted"
|
|
904
|
+
: lastAssistant?.stopReason === "error"
|
|
905
|
+
? "error"
|
|
906
|
+
: "completed";
|
|
907
|
+
log.info(
|
|
908
|
+
`Session ended. Ticks: ${state.stats.totalTicks}, ` +
|
|
909
|
+
`Activations: ${state.stats.totalActivations}, ` +
|
|
910
|
+
`Tools: ${state.metaLearning.toolTracking.totalToolsUsed}, ` +
|
|
911
|
+
`Outcome: ${outcome}`,
|
|
912
|
+
);
|
|
913
|
+
for (const [name, count] of Object.entries(state.stats.activationsByModule)) {
|
|
914
|
+
log.info(` ${name}: ${count} activations`);
|
|
915
|
+
}
|
|
916
|
+
|
|
917
|
+
try {
|
|
918
|
+
const memState = getMemoryState(ctx);
|
|
919
|
+
if (memState) {
|
|
920
|
+
// agent_end carries no task descriptor; the sentinel is the fallback
|
|
921
|
+
// the write gate and the recall filter already expect.
|
|
922
|
+
const taskDesc = "session_outcome";
|
|
923
|
+
const success = outcome === "completed";
|
|
924
|
+
|
|
925
|
+
// Use enriched trajectory from tool_end tracking (has success/failure data)
|
|
926
|
+
// Fall back to activation history if tool_end wasn't available
|
|
927
|
+
const enrichedTrajectory = state.metaLearning.toolTracking.trajectory ?? [];
|
|
928
|
+
const trajectory: TrajectoryEntry[] =
|
|
929
|
+
enrichedTrajectory.length > 0
|
|
930
|
+
? enrichedTrajectory.map((t: any) => ({
|
|
931
|
+
toolName: t.toolName,
|
|
932
|
+
success: t.success,
|
|
933
|
+
}))
|
|
934
|
+
: state.activationHistory
|
|
935
|
+
.filter((h) => h.moduleName === "tool_call" || h.reason === "tool")
|
|
936
|
+
.map((h) => ({ toolName: h.moduleName, success: true }));
|
|
937
|
+
|
|
938
|
+
// Extract SOP from the trajectory (uses LLM pattern detection when ctx available)
|
|
939
|
+
const sop = await extractSOP({
|
|
940
|
+
task: taskDesc,
|
|
941
|
+
trajectory,
|
|
942
|
+
solution: `Ticks:${state.stats.totalTicks} Tools:${state.metaLearning.toolTracking.totalToolsUsed}`,
|
|
943
|
+
outcome: success ? "success" : "partial",
|
|
944
|
+
ctx,
|
|
945
|
+
});
|
|
946
|
+
|
|
947
|
+
// Review-before-write quality gate (hasSignal tripwire + settings
|
|
948
|
+
// toggle + cooldown) decides "is this episode worth writing?" before
|
|
949
|
+
// addEpisode on this sender. The shared hasSignal suppressor lives in
|
|
950
|
+
// lib/memory/write-quality.ts; the config is read fresh each event
|
|
951
|
+
// (settings-over-env via braid-settings.ts). Cooldown state is owned
|
|
952
|
+
// at module scope so back-to-back session ends never thrash. With the
|
|
953
|
+
// toggle OFF only the literal "session_outcome" sentinel kill applies.
|
|
954
|
+
const writeGate = getMemoryWriteGateConfig();
|
|
955
|
+
if (shouldWriteOutcomeEpisode(writeGate, taskDesc, sop.strategicSOP, _lastOutcomeWriteAt)) {
|
|
956
|
+
if (writeGate.enabled) _lastOutcomeWriteAt = Date.now(); // gated writes only
|
|
957
|
+
addEpisode(
|
|
958
|
+
memState,
|
|
959
|
+
taskDesc,
|
|
960
|
+
sop.strategicSOP,
|
|
961
|
+
success ? "success" : "partial",
|
|
962
|
+
sop.atomicSOP,
|
|
963
|
+
["session", "outcome", success ? "success" : "partial"],
|
|
964
|
+
deriveProject(ctx), // project
|
|
965
|
+
sop.strategicSOP,
|
|
966
|
+
sop.functionalSOP,
|
|
967
|
+
sop.atomicSOP,
|
|
968
|
+
);
|
|
969
|
+
log.info(
|
|
970
|
+
`[heartbeat] Outcome episode recorded: ${success ? "success" : "partial"} ` +
|
|
971
|
+
`(SOP: ${sop.functionalSOP.length} steps, ${sop.atomicSOP.length} tools)`,
|
|
972
|
+
);
|
|
973
|
+
} else {
|
|
974
|
+
log.debug(
|
|
975
|
+
`[heartbeat] Outcome episode skipped by write-quality gate ` +
|
|
976
|
+
`(task=${JSON.stringify(taskDesc)})`,
|
|
977
|
+
);
|
|
978
|
+
}
|
|
979
|
+
|
|
980
|
+
if (success) {
|
|
981
|
+
// Layer 6: gate consolidation on session health.
|
|
982
|
+
// When the LLM provider is unavailable (balance, auth) or the
|
|
983
|
+
// session is degraded, the consolidation pipeline is a 402
|
|
984
|
+
// waiting to happen. Score the candidate (so it persists) but
|
|
985
|
+
// skip execution; the SessionHealthState tracks this so the
|
|
986
|
+
// next healthy session drains the queue.
|
|
987
|
+
const health = getSessionHealth(ctx);
|
|
988
|
+
if (health.mode === "balance" || health.mode === "auth" || health.mode === "degraded") {
|
|
989
|
+
// Counts consolidation skips per health mode; without it, a
|
|
990
|
+
// latched auth mode runs for minutes with zero visibility.
|
|
991
|
+
recordConsolidationSkip(ctx, health.mode);
|
|
992
|
+
log.warn(
|
|
993
|
+
`[heartbeat] Skipping consolidation: session health is ${health.mode} ` +
|
|
994
|
+
`(consecutive errors: ${health.consecutiveErrors})`,
|
|
995
|
+
);
|
|
996
|
+
// Still record the episode - we want the history even when we can't act on it.
|
|
997
|
+
// The episode will surface in the next healthy session via retrieveEpisodes().
|
|
998
|
+
} else if (health.mode === "context_overflow") {
|
|
999
|
+
// Health-gate exception: a context_window error latches
|
|
1000
|
+
// context_overflow and this gate then blocks every shrink that
|
|
1001
|
+
// could fix it — the consolidation pipeline (an LLM call)
|
|
1002
|
+
// is indeed a 402/413 waiting to happen in this mode, but the
|
|
1003
|
+
// emergency offloader is NOT an LLM pipeline: it is a
|
|
1004
|
+
// deterministic, lossless size-driven shrink (largest toolResults
|
|
1005
|
+
// → disk + stubs). Run it here so the session actually shrinks
|
|
1006
|
+
// while the mode is latched; consolidation itself stays skipped.
|
|
1007
|
+
const runner = getContextEmergencyOffloadRunner();
|
|
1008
|
+
if (runner) {
|
|
1009
|
+
try {
|
|
1010
|
+
const offload = await runner(ctx, "heartbeat-gate");
|
|
1011
|
+
if (offload.offloaded > 0) {
|
|
1012
|
+
log.warn(
|
|
1013
|
+
`[heartbeat] context_overflow: emergency offload freed ` +
|
|
1014
|
+
`${offload.charsSaved} chars (${offload.offloaded} oversized ` +
|
|
1015
|
+
`toolResult(s) stubbed); consolidation stays skipped in this mode`,
|
|
1016
|
+
);
|
|
1017
|
+
}
|
|
1018
|
+
} catch (err) {
|
|
1019
|
+
log.warn(`[heartbeat] context_overflow emergency offload failed: ${err}`);
|
|
1020
|
+
}
|
|
1021
|
+
}
|
|
1022
|
+
recordConsolidationSkip(ctx, "context_overflow");
|
|
1023
|
+
} else {
|
|
1024
|
+
try {
|
|
1025
|
+
const result = await executeConsolidation({
|
|
1026
|
+
id: `ep-${Date.now()}`,
|
|
1027
|
+
task: taskDesc,
|
|
1028
|
+
outcome: "success",
|
|
1029
|
+
strategicSOP: sop.strategicSOP,
|
|
1030
|
+
functionalSOP: sop.functionalSOP,
|
|
1031
|
+
toolSequence: sop.atomicSOP,
|
|
1032
|
+
});
|
|
1033
|
+
if (result) {
|
|
1034
|
+
log.info(
|
|
1035
|
+
`[heartbeat] Consolidation candidate enqueued ` +
|
|
1036
|
+
`(score=${result.consolidationScore.toFixed(2)})`,
|
|
1037
|
+
);
|
|
1038
|
+
}
|
|
1039
|
+
} catch (err) {
|
|
1040
|
+
log.warn(`[heartbeat] Could not score consolidation candidate: ${err}`);
|
|
1041
|
+
}
|
|
1042
|
+
}
|
|
1043
|
+
}
|
|
1044
|
+
}
|
|
1045
|
+
} catch (err) {
|
|
1046
|
+
log.warn(`[heartbeat] Could not record outcome episode: ${err}`);
|
|
1047
|
+
}
|
|
1048
|
+
});
|
|
1049
|
+
|
|
1050
|
+
// Event: session_shutdown
|
|
1051
|
+
|
|
1052
|
+
pi.on(SESSION_SHUTDOWN, async (_event: any, ctx: ExtensionContext) => {
|
|
1053
|
+
// CleanupSession must target the SAME key the BeliefStore was
|
|
1054
|
+
// created under (getSessionIdSafe at session_start), not just ctx.cwd —
|
|
1055
|
+
// passing only ctx.cwd leaked the per-session store in the process-global
|
|
1056
|
+
// stores/engines Maps whenever the key was a real session id. Delete
|
|
1057
|
+
// both candidate keys defensively.
|
|
1058
|
+
const shutdownSid = getSessionIdSafe(ctx);
|
|
1059
|
+
if (shutdownSid && shutdownSid !== "?") cleanupSession(shutdownSid);
|
|
1060
|
+
cleanupSession(ctx.cwd);
|
|
1061
|
+
const sid = getSessionIdSafe(ctx) ?? "anonymous";
|
|
1062
|
+
_heartbeatWhisperBuffer.delete(sid);
|
|
1063
|
+
// Abort any in-flight heartbeat LLM calls (ESC for background tasks)
|
|
1064
|
+
const abortCtl = getExtensionState<{ controller: AbortController | null }>(
|
|
1065
|
+
ctx,
|
|
1066
|
+
"heartbeat-abort",
|
|
1067
|
+
() => ({ controller: null }),
|
|
1068
|
+
);
|
|
1069
|
+
if (abortCtl.controller) {
|
|
1070
|
+
abortCtl.controller.abort();
|
|
1071
|
+
abortCtl.controller = null;
|
|
1072
|
+
}
|
|
1073
|
+
log.info("Heartbeat scheduler shutting down");
|
|
1074
|
+
});
|
|
1075
|
+
|
|
1076
|
+
// Policy Engine Activation
|
|
1077
|
+
|
|
1078
|
+
function activatePolicyEngine(
|
|
1079
|
+
engine: PolicyEngine,
|
|
1080
|
+
state: import("./types.js").HeartbeatState,
|
|
1081
|
+
_ctx: ExtensionContext,
|
|
1082
|
+
): void {
|
|
1083
|
+
const originalEvaluate = engine.evaluate.bind(engine);
|
|
1084
|
+
engine.evaluate = async (context: PolicyContext) => {
|
|
1085
|
+
const fired = await originalEvaluate(context);
|
|
1086
|
+
if (fired.length > 0) {
|
|
1087
|
+
for (const policy of fired) {
|
|
1088
|
+
state.policyLastFire.set(policy.id, state.policyTurnCount);
|
|
1089
|
+
}
|
|
1090
|
+
}
|
|
1091
|
+
return fired;
|
|
1092
|
+
};
|
|
1093
|
+
log.info("[heartbeat] Policy engine activated - cognitive modules will fire on turns");
|
|
1094
|
+
}
|
|
1095
|
+
}
|