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,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Heartbeat Telemetry - one append-only JSONL line per heartbeat tick.
|
|
3
|
+
*
|
|
4
|
+
* LIVE scalar telemetry so the metric-before-implementation rule has a
|
|
5
|
+
* continuous baseline: context tokens/percent/window, RSS + heap, session
|
|
6
|
+
* file size, per-class char deltas since the previous tick, whisper
|
|
7
|
+
* (injected custom_message) pressure, and tokens/sec from the last
|
|
8
|
+
* assistant message.
|
|
9
|
+
*
|
|
10
|
+
* Two hooks feed the same sink:
|
|
11
|
+
* - Hook 1 (turn-paced): heartbeat-scheduler tick → collectAndEmitContextHeartbeat
|
|
12
|
+
* (ctx available: full field set).
|
|
13
|
+
* - Hook 2 (wall-clock, idle-inclusive): watchdog engine check() → a cheap
|
|
14
|
+
* process-global line wired through the engine's optional `telemetryEmit`
|
|
15
|
+
* dep (the engine itself stays pure and ctx-free; watchdog/index.ts adds
|
|
16
|
+
* sessionId/session size/health mode at the wiring point).
|
|
17
|
+
*
|
|
18
|
+
* Design constraints (same scalar-only posture as degradation-detector.ts):
|
|
19
|
+
* - Entries are SCALAR-ONLY. The sink re-checks every value before the
|
|
20
|
+
* append (numbers/short strings/boolean/null) — a ctx-shaped object must
|
|
21
|
+
* never reach the file, so `never spread ctx` is enforced at the
|
|
22
|
+
* boundary, not just at the builders.
|
|
23
|
+
* - Sink failures are non-fatal (log + continue): telemetry must never
|
|
24
|
+
* break a heartbeat tick or a watchdog check.
|
|
25
|
+
* - No LLM calls anywhere. The entries walk is the context-density
|
|
26
|
+
* evaluator's template (lib/detection/context-density.ts), bounded by
|
|
27
|
+
* the same shape checks.
|
|
28
|
+
* - Per-tick state lives in getExtensionState (per-session, no module-level
|
|
29
|
+
* let — lib/state/AGENTS.md contract).
|
|
30
|
+
*
|
|
31
|
+
* Sink: <braidDir()>/telemetry/context-heartbeat.jsonl, resolved on every
|
|
32
|
+
* call through braid-paths (a module-load constant would pin the sink to the
|
|
33
|
+
* default tree and ignore BRAID_HOME).
|
|
34
|
+
*/
|
|
35
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
36
|
+
/** Sink directory (created on first append; see header note). */
|
|
37
|
+
export declare function heartbeatTelemetryDir(): string;
|
|
38
|
+
/** Sink file for the heartbeat JSONL (see header note). */
|
|
39
|
+
export declare function contextHeartbeatFilePath(): string;
|
|
40
|
+
/**
|
|
41
|
+
* Append one JSONL line to the sink. Scalar-only defense at the boundary;
|
|
42
|
+
* directory created on demand; every failure path returns false without
|
|
43
|
+
* throwing (callers must never break the tick/check on telemetry).
|
|
44
|
+
*
|
|
45
|
+
* @param entry flat record; non-scalar values are silently dropped
|
|
46
|
+
* @param file optional override (tests); defaults to contextHeartbeatFilePath()
|
|
47
|
+
* @returns true when the line was appended
|
|
48
|
+
*/
|
|
49
|
+
export declare function appendContextHeartbeatLine(entry: Record<string, unknown>, file?: string): boolean;
|
|
50
|
+
/**
|
|
51
|
+
* Record an assistant message_end (Hook 1 feed). message.timestamp is the
|
|
52
|
+
* stream-start proxy (pi-core message_start ≈ message creation), so
|
|
53
|
+
* duration = now - timestamp ≈ the pure API-call window the investigation's
|
|
54
|
+
* Semantics want (excludes tool execution).
|
|
55
|
+
*
|
|
56
|
+
* Self-state (Refine-2): also captures usage.cacheRead — the cache-hit
|
|
57
|
+
* share (cacheRead/(input+cacheRead), percent) is the session's
|
|
58
|
+
* efficiency signature (94-98% while healthy). n/a (null) when the provider
|
|
59
|
+
* does not report cacheRead.
|
|
60
|
+
*/
|
|
61
|
+
export declare function noteAssistantMessageEnd(ctx: ExtensionContext, message: unknown): void;
|
|
62
|
+
export interface ContextHeartbeatOptions {
|
|
63
|
+
turnNumber?: number;
|
|
64
|
+
/** Session health mode (passed in — lib/ may not import from extensions/). */
|
|
65
|
+
healthMode?: string;
|
|
66
|
+
/** Line source tag (Hook 1 "heartbeat", Hook 2 "watchdog"). */
|
|
67
|
+
source?: string;
|
|
68
|
+
/** Sink override (tests); defaults to contextHeartbeatFilePath(). */
|
|
69
|
+
sinkFile?: string;
|
|
70
|
+
}
|
|
71
|
+
/** The collected sample, so the caller can feed recordTurnMetrics real values. */
|
|
72
|
+
export interface ContextHeartbeatSample {
|
|
73
|
+
entry: Record<string, number | string | boolean | null>;
|
|
74
|
+
lastAssistantDurationMs: number | null;
|
|
75
|
+
inputTokens: number;
|
|
76
|
+
outputTokens: number;
|
|
77
|
+
tokensPerSec: number | null;
|
|
78
|
+
tpsEma: number | null;
|
|
79
|
+
assistantCharsDelta: number;
|
|
80
|
+
toolResultCharsDelta: number;
|
|
81
|
+
userCharsDelta: number;
|
|
82
|
+
whisperCharsDelta: number;
|
|
83
|
+
whisperCountDelta: number;
|
|
84
|
+
/** The RSS ring after this tick (oldest → newest, ≤ RSS_RING_CAP). */
|
|
85
|
+
rssRing: number[];
|
|
86
|
+
/** Boot-time RSS baseline (first tick of the process), bytes. */
|
|
87
|
+
rssBaselineBytes: number | null;
|
|
88
|
+
/** Sustained-growth verdict (full ring, all >2x baseline). */
|
|
89
|
+
rssSustainedGrowth: boolean;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Collect the per-tick context/RSS/session telemetry, append it to the JSONL
|
|
93
|
+
* sink, and return the sample for the degradation-detector feed (D2 fix).
|
|
94
|
+
* Never throws; returns whatever was collectable.
|
|
95
|
+
*/
|
|
96
|
+
export declare function collectAndEmitContextHeartbeat(ctx: ExtensionContext, opts?: ContextHeartbeatOptions): ContextHeartbeatSample;
|
|
97
|
+
/**
|
|
98
|
+
* The self-state metrics one heartbeat summary line renders.
|
|
99
|
+
* Every field is nullable: an unavailable metric renders "n/a", never zero
|
|
100
|
+
* (zero looks like a healthy reading, n/a says telemetry is
|
|
101
|
+
* missing).
|
|
102
|
+
*/
|
|
103
|
+
export interface SelfStateSample {
|
|
104
|
+
/** Current context size in tokens (live read, not the last-tick snapshot). */
|
|
105
|
+
contextTokens: number | null;
|
|
106
|
+
/** Cache-hit share, percent 0-100 (last assistant message). */
|
|
107
|
+
cacheHitShare: number | null;
|
|
108
|
+
/** Near-duplicate message count from the context-density evaluator. */
|
|
109
|
+
nearDupCount: number | null;
|
|
110
|
+
/** tok/s trend — the EMA over qualifying assistant messages. */
|
|
111
|
+
tpsEma: number | null;
|
|
112
|
+
/** Total turn-end hygiene ACTs recorded this session (0 when none). */
|
|
113
|
+
hygieneActs: number | null;
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* Sample the self-state metrics for the heartbeat self-state line.
|
|
117
|
+
* Reads per-session state keys owned by this module (telemetry) and the
|
|
118
|
+
* context-density evaluator (near-duplicates). Never throws — every read
|
|
119
|
+
* is wrapped; missing state yields null ("n/a" in the rendered line).
|
|
120
|
+
*/
|
|
121
|
+
export declare function getSelfStateSample(ctx: ExtensionContext): SelfStateSample;
|
|
122
|
+
//# sourceMappingURL=context-heartbeat.d.ts.map
|
|
@@ -0,0 +1,449 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Heartbeat Telemetry - one append-only JSONL line per heartbeat tick.
|
|
3
|
+
*
|
|
4
|
+
* LIVE scalar telemetry so the metric-before-implementation rule has a
|
|
5
|
+
* continuous baseline: context tokens/percent/window, RSS + heap, session
|
|
6
|
+
* file size, per-class char deltas since the previous tick, whisper
|
|
7
|
+
* (injected custom_message) pressure, and tokens/sec from the last
|
|
8
|
+
* assistant message.
|
|
9
|
+
*
|
|
10
|
+
* Two hooks feed the same sink:
|
|
11
|
+
* - Hook 1 (turn-paced): heartbeat-scheduler tick → collectAndEmitContextHeartbeat
|
|
12
|
+
* (ctx available: full field set).
|
|
13
|
+
* - Hook 2 (wall-clock, idle-inclusive): watchdog engine check() → a cheap
|
|
14
|
+
* process-global line wired through the engine's optional `telemetryEmit`
|
|
15
|
+
* dep (the engine itself stays pure and ctx-free; watchdog/index.ts adds
|
|
16
|
+
* sessionId/session size/health mode at the wiring point).
|
|
17
|
+
*
|
|
18
|
+
* Design constraints (same scalar-only posture as degradation-detector.ts):
|
|
19
|
+
* - Entries are SCALAR-ONLY. The sink re-checks every value before the
|
|
20
|
+
* append (numbers/short strings/boolean/null) — a ctx-shaped object must
|
|
21
|
+
* never reach the file, so `never spread ctx` is enforced at the
|
|
22
|
+
* boundary, not just at the builders.
|
|
23
|
+
* - Sink failures are non-fatal (log + continue): telemetry must never
|
|
24
|
+
* break a heartbeat tick or a watchdog check.
|
|
25
|
+
* - No LLM calls anywhere. The entries walk is the context-density
|
|
26
|
+
* evaluator's template (lib/detection/context-density.ts), bounded by
|
|
27
|
+
* the same shape checks.
|
|
28
|
+
* - Per-tick state lives in getExtensionState (per-session, no module-level
|
|
29
|
+
* let — lib/state/AGENTS.md contract).
|
|
30
|
+
*
|
|
31
|
+
* Sink: <braidDir()>/telemetry/context-heartbeat.jsonl, resolved on every
|
|
32
|
+
* call through braid-paths (a module-load constant would pin the sink to the
|
|
33
|
+
* default tree and ignore BRAID_HOME).
|
|
34
|
+
*/
|
|
35
|
+
import * as fs from "node:fs";
|
|
36
|
+
import * as path from "node:path";
|
|
37
|
+
import { createLogger } from "../core/logger.js";
|
|
38
|
+
import { telemetryDir } from "../config/braid-paths.js";
|
|
39
|
+
import { pushRssSample, assessSustainedRssGrowth, RSS_RING_CAP } from "./rss-telemetry.js";
|
|
40
|
+
import { getRssBootTelemetry, setRssBootBaseline } from "../state/global-state.js";
|
|
41
|
+
import { getExtensionState, hasExtensionState, safeSessionManagerTyped, } from "../state/extension-state.js";
|
|
42
|
+
import { getContextUsage } from "../detection/context-tiers.js";
|
|
43
|
+
import { measureLiveUsage } from "../detection/context-usage.js";
|
|
44
|
+
const log = createLogger("context-heartbeat");
|
|
45
|
+
/** Sink directory (created on first append; see header note). */
|
|
46
|
+
export function heartbeatTelemetryDir() {
|
|
47
|
+
return telemetryDir();
|
|
48
|
+
}
|
|
49
|
+
/** Sink file for the heartbeat JSONL (see header note). */
|
|
50
|
+
export function contextHeartbeatFilePath() {
|
|
51
|
+
return path.join(heartbeatTelemetryDir(), "context-heartbeat.jsonl");
|
|
52
|
+
}
|
|
53
|
+
/** Strings above this length inside an entry are truncated — bounded lines. */
|
|
54
|
+
const MAX_STRING_CHARS = 128;
|
|
55
|
+
/** Scalar whitelist at the sink boundary: number (finite), short string,
|
|
56
|
+
* boolean, null. Everything else (objects, arrays, undefined, NaN, long
|
|
57
|
+
* strings) is DROPPED — never serialized (the OOM signature). */
|
|
58
|
+
function sanitizeScalarValue(val) {
|
|
59
|
+
if (val === null)
|
|
60
|
+
return null;
|
|
61
|
+
if (typeof val === "number")
|
|
62
|
+
return Number.isFinite(val) ? val : null;
|
|
63
|
+
if (typeof val === "string") {
|
|
64
|
+
return val.length <= MAX_STRING_CHARS ? val : val.slice(0, MAX_STRING_CHARS);
|
|
65
|
+
}
|
|
66
|
+
if (typeof val === "boolean")
|
|
67
|
+
return val;
|
|
68
|
+
return undefined;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Append one JSONL line to the sink. Scalar-only defense at the boundary;
|
|
72
|
+
* directory created on demand; every failure path returns false without
|
|
73
|
+
* throwing (callers must never break the tick/check on telemetry).
|
|
74
|
+
*
|
|
75
|
+
* @param entry flat record; non-scalar values are silently dropped
|
|
76
|
+
* @param file optional override (tests); defaults to contextHeartbeatFilePath()
|
|
77
|
+
* @returns true when the line was appended
|
|
78
|
+
*/
|
|
79
|
+
export function appendContextHeartbeatLine(entry, file = contextHeartbeatFilePath()) {
|
|
80
|
+
try {
|
|
81
|
+
const clean = {};
|
|
82
|
+
for (const key of Object.keys(entry)) {
|
|
83
|
+
const v = sanitizeScalarValue(entry[key]);
|
|
84
|
+
if (v !== undefined)
|
|
85
|
+
clean[key] = v;
|
|
86
|
+
}
|
|
87
|
+
try {
|
|
88
|
+
fs.appendFileSync(file, `${JSON.stringify(clean)}\n`, "utf-8");
|
|
89
|
+
return true;
|
|
90
|
+
}
|
|
91
|
+
catch (err) {
|
|
92
|
+
// ENOENT (first write in a fresh install) → create the dir once, retry.
|
|
93
|
+
if (err.code === "ENOENT") {
|
|
94
|
+
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
95
|
+
fs.appendFileSync(file, `${JSON.stringify(clean)}\n`, "utf-8");
|
|
96
|
+
return true;
|
|
97
|
+
}
|
|
98
|
+
throw err;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
catch (err) {
|
|
102
|
+
log.warn(`[context-heartbeat] sink append failed (non-fatal): ${err.message}`);
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
const TELEMETRY_STATE_KEY = "context-heartbeat-telemetry";
|
|
107
|
+
function telemetryState(ctx) {
|
|
108
|
+
return getExtensionState(ctx, TELEMETRY_STATE_KEY, () => ({
|
|
109
|
+
lastContextTokens: null,
|
|
110
|
+
lastAssistantChars: 0,
|
|
111
|
+
lastToolResultChars: 0,
|
|
112
|
+
lastUserChars: 0,
|
|
113
|
+
lastWhisperChars: 0,
|
|
114
|
+
lastWhisperCount: 0,
|
|
115
|
+
lastAssistantDurationMs: null,
|
|
116
|
+
lastInputTokens: null,
|
|
117
|
+
lastOutputTokens: null,
|
|
118
|
+
lastCacheHitShare: null,
|
|
119
|
+
lastTps: null,
|
|
120
|
+
tpsEma: null,
|
|
121
|
+
rssRing: [],
|
|
122
|
+
}));
|
|
123
|
+
}
|
|
124
|
+
/** Minimum assistant duration to trust a tok/s sample (avoid div-by-tiny). */
|
|
125
|
+
const MIN_TPS_DURATION_MS = 250;
|
|
126
|
+
/** EMA weight for the new sample. */
|
|
127
|
+
const TPS_EMA_ALPHA = 0.3;
|
|
128
|
+
/**
|
|
129
|
+
* Record an assistant message_end (Hook 1 feed). message.timestamp is the
|
|
130
|
+
* stream-start proxy (pi-core message_start ≈ message creation), so
|
|
131
|
+
* duration = now - timestamp ≈ the pure API-call window the investigation's
|
|
132
|
+
* Semantics want (excludes tool execution).
|
|
133
|
+
*
|
|
134
|
+
* Self-state (Refine-2): also captures usage.cacheRead — the cache-hit
|
|
135
|
+
* share (cacheRead/(input+cacheRead), percent) is the session's
|
|
136
|
+
* efficiency signature (94-98% while healthy). n/a (null) when the provider
|
|
137
|
+
* does not report cacheRead.
|
|
138
|
+
*/
|
|
139
|
+
export function noteAssistantMessageEnd(ctx, message) {
|
|
140
|
+
try {
|
|
141
|
+
if (!message || typeof message !== "object")
|
|
142
|
+
return;
|
|
143
|
+
const m = message;
|
|
144
|
+
if (m.role !== "assistant")
|
|
145
|
+
return;
|
|
146
|
+
const s = telemetryState(ctx);
|
|
147
|
+
const now = Date.now();
|
|
148
|
+
if (typeof m.timestamp === "number" && m.timestamp > 0) {
|
|
149
|
+
const durationMs = now - m.timestamp;
|
|
150
|
+
if (durationMs > 0)
|
|
151
|
+
s.lastAssistantDurationMs = durationMs;
|
|
152
|
+
}
|
|
153
|
+
const usage = m.usage;
|
|
154
|
+
if (usage && typeof usage === "object") {
|
|
155
|
+
s.lastInputTokens = typeof usage.input === "number" ? usage.input : s.lastInputTokens;
|
|
156
|
+
const output = typeof usage.output === "number" ? usage.output : null;
|
|
157
|
+
if (output !== null)
|
|
158
|
+
s.lastOutputTokens = output;
|
|
159
|
+
// Cache-hit share: cacheRead/(input+cacheRead) — both must be
|
|
160
|
+
// present and the denominator positive; otherwise keep null (n/a).
|
|
161
|
+
const cacheRead = typeof usage.cacheRead === "number" ? usage.cacheRead : null;
|
|
162
|
+
if (cacheRead !== null && s.lastInputTokens !== null && s.lastInputTokens + cacheRead > 0) {
|
|
163
|
+
s.lastCacheHitShare = (cacheRead / (s.lastInputTokens + cacheRead)) * 100;
|
|
164
|
+
}
|
|
165
|
+
const dur = s.lastAssistantDurationMs;
|
|
166
|
+
if (output !== null && output >= 1 && dur !== null && dur >= MIN_TPS_DURATION_MS) {
|
|
167
|
+
const tps = output / (dur / 1000);
|
|
168
|
+
s.lastTps = tps;
|
|
169
|
+
s.tpsEma = s.tpsEma === null ? tps : s.tpsEma * (1 - TPS_EMA_ALPHA) + tps * TPS_EMA_ALPHA;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
catch {
|
|
174
|
+
// telemetry never fatal
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
/** Flatten message content (string | content-array) to a char count. */
|
|
178
|
+
function contentChars(content) {
|
|
179
|
+
if (typeof content === "string")
|
|
180
|
+
return content.length;
|
|
181
|
+
if (!Array.isArray(content))
|
|
182
|
+
return 0;
|
|
183
|
+
let n = 0;
|
|
184
|
+
for (const part of content) {
|
|
185
|
+
if (!part || typeof part !== "object")
|
|
186
|
+
continue;
|
|
187
|
+
const p = part;
|
|
188
|
+
if (typeof p.text === "string")
|
|
189
|
+
n += p.text.length;
|
|
190
|
+
else if (typeof p.thinking === "string")
|
|
191
|
+
n += p.thinking.length;
|
|
192
|
+
else if (p.type === "toolCall") {
|
|
193
|
+
try {
|
|
194
|
+
n += JSON.stringify(p.arguments ?? {}).length;
|
|
195
|
+
}
|
|
196
|
+
catch {
|
|
197
|
+
/* unserializable args: count as 0 */
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
return n;
|
|
202
|
+
}
|
|
203
|
+
/** Walk session entries once (density-evaluator template) and total chars
|
|
204
|
+
* per source class. Injected whispers are `custom_message` entries. */
|
|
205
|
+
function classifyEntries(ctx) {
|
|
206
|
+
const totals = {
|
|
207
|
+
assistantChars: 0,
|
|
208
|
+
toolResultChars: 0,
|
|
209
|
+
userChars: 0,
|
|
210
|
+
whisperChars: 0,
|
|
211
|
+
whisperCount: 0,
|
|
212
|
+
totalEntries: 0,
|
|
213
|
+
};
|
|
214
|
+
let entries;
|
|
215
|
+
try {
|
|
216
|
+
entries =
|
|
217
|
+
ctx.sessionManager?.getEntries?.() ?? [];
|
|
218
|
+
}
|
|
219
|
+
catch {
|
|
220
|
+
return totals;
|
|
221
|
+
}
|
|
222
|
+
for (const entry of entries) {
|
|
223
|
+
if (!entry || typeof entry !== "object")
|
|
224
|
+
continue;
|
|
225
|
+
const e = entry;
|
|
226
|
+
totals.totalEntries++;
|
|
227
|
+
if (e.type === "message" && e.message && typeof e.message === "object") {
|
|
228
|
+
const msg = e.message;
|
|
229
|
+
const chars = contentChars(msg.content);
|
|
230
|
+
if (msg.role === "assistant")
|
|
231
|
+
totals.assistantChars += chars;
|
|
232
|
+
else if (msg.role === "toolResult")
|
|
233
|
+
totals.toolResultChars += chars;
|
|
234
|
+
else if (msg.role === "user")
|
|
235
|
+
totals.userChars += chars;
|
|
236
|
+
else if (msg.role === "custom") {
|
|
237
|
+
// Custom messages live in context too (whispers/steer injections).
|
|
238
|
+
totals.whisperChars += chars;
|
|
239
|
+
totals.whisperCount++;
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
else if (e.type === "custom_message") {
|
|
243
|
+
totals.whisperCount++;
|
|
244
|
+
totals.whisperChars += contentChars(e.content);
|
|
245
|
+
}
|
|
246
|
+
// Other entry kinds (compaction, custom, label, …) carry no LLM context mass.
|
|
247
|
+
}
|
|
248
|
+
return totals;
|
|
249
|
+
}
|
|
250
|
+
/**
|
|
251
|
+
* Collect the per-tick context/RSS/session telemetry, append it to the JSONL
|
|
252
|
+
* sink, and return the sample for the degradation-detector feed (D2 fix).
|
|
253
|
+
* Never throws; returns whatever was collectable.
|
|
254
|
+
*/
|
|
255
|
+
export function collectAndEmitContextHeartbeat(ctx, opts = {}) {
|
|
256
|
+
const s = telemetryState(ctx);
|
|
257
|
+
// Context usage (pi-core agent-session getContextUsage).
|
|
258
|
+
const usage = getContextUsage(ctx);
|
|
259
|
+
const contextTokens = typeof usage?.tokens === "number" ? usage.tokens : null;
|
|
260
|
+
const contextWindow = typeof usage?.contextWindow === "number" ? usage.contextWindow : null;
|
|
261
|
+
const contextPercent = typeof usage?.percent === "number" ? usage.percent : null;
|
|
262
|
+
let rssBytes = null;
|
|
263
|
+
let heapUsed = null;
|
|
264
|
+
try {
|
|
265
|
+
const mem = process.memoryUsage();
|
|
266
|
+
rssBytes = mem.rss;
|
|
267
|
+
heapUsed = mem.heapUsed;
|
|
268
|
+
}
|
|
269
|
+
catch {
|
|
270
|
+
/* keep nulls */
|
|
271
|
+
}
|
|
272
|
+
// ── RSS ring + boot baseline + debug log ─────────────────────
|
|
273
|
+
// Every heartbeat tick pushes one RSS sample onto the per-session ring
|
|
274
|
+
// (capped at RSS_RING_CAP=24) and sets the PROCESS-GLOBAL boot baseline
|
|
275
|
+
// on the first tick of the boot. Each sample logs at debug so the next
|
|
276
|
+
// OOM is diagnosable from logs, not from a photo of a frozen Mac.
|
|
277
|
+
let rssRing = [];
|
|
278
|
+
let rssBaselineBytes = null;
|
|
279
|
+
if (rssBytes !== null && rssBytes > 0) {
|
|
280
|
+
setRssBootBaseline(rssBytes);
|
|
281
|
+
rssRing = pushRssSample(s.rssRing, rssBytes);
|
|
282
|
+
const boot = getRssBootTelemetry();
|
|
283
|
+
rssBaselineBytes = boot?.baselineBytes ?? null;
|
|
284
|
+
log.debug(`[context-heartbeat] rss=${(rssBytes / 1048576).toFixed(1)}MB ` +
|
|
285
|
+
`ring=${rssRing.length}/${RSS_RING_CAP} ` +
|
|
286
|
+
`baseline=${rssBaselineBytes !== null ? (rssBaselineBytes / 1048576).toFixed(1) + "MB" : "n/a"} ` +
|
|
287
|
+
`sustainedGrowth=${assessSustainedRssGrowth(rssRing, rssBaselineBytes)}`);
|
|
288
|
+
}
|
|
289
|
+
// Session file size (sessionManager already exposes its path).
|
|
290
|
+
let sessionFileSizeBytes = null;
|
|
291
|
+
let sessionId = "?";
|
|
292
|
+
try {
|
|
293
|
+
const sm = safeSessionManagerTyped(ctx);
|
|
294
|
+
const file = sm?.getSessionFile?.();
|
|
295
|
+
if (file) {
|
|
296
|
+
const st = fs.statSync(file, { throwIfNoEntry: false });
|
|
297
|
+
if (st)
|
|
298
|
+
sessionFileSizeBytes = st.size;
|
|
299
|
+
}
|
|
300
|
+
const sid = sm?.getSessionId?.();
|
|
301
|
+
if (typeof sid === "string" && sid.length > 0)
|
|
302
|
+
sessionId = sid;
|
|
303
|
+
}
|
|
304
|
+
catch {
|
|
305
|
+
/* keep nulls */
|
|
306
|
+
}
|
|
307
|
+
// Model id (bounded string; defensive — model is optional on ctx).
|
|
308
|
+
let model;
|
|
309
|
+
try {
|
|
310
|
+
const model_ = ctx.model;
|
|
311
|
+
const raw = typeof model_?.id === "string"
|
|
312
|
+
? model_.id
|
|
313
|
+
: typeof model_?.label === "string"
|
|
314
|
+
? model_.label
|
|
315
|
+
: "";
|
|
316
|
+
model = String(raw).slice(0, MAX_STRING_CHARS);
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
model = "";
|
|
320
|
+
}
|
|
321
|
+
// Per-class char totals + deltas since the previous tick.
|
|
322
|
+
const totals = classifyEntries(ctx);
|
|
323
|
+
const assistantCharsDelta = totals.assistantChars - s.lastAssistantChars;
|
|
324
|
+
const toolResultCharsDelta = totals.toolResultChars - s.lastToolResultChars;
|
|
325
|
+
const userCharsDelta = totals.userChars - s.lastUserChars;
|
|
326
|
+
const whisperCharsDelta = totals.whisperChars - s.lastWhisperChars;
|
|
327
|
+
const whisperCountDelta = totals.whisperCount - s.lastWhisperCount;
|
|
328
|
+
const contextTokensDelta = contextTokens !== null && s.lastContextTokens !== null
|
|
329
|
+
? contextTokens - s.lastContextTokens
|
|
330
|
+
: null;
|
|
331
|
+
// Roll the previous-tick state forward.
|
|
332
|
+
s.lastContextTokens = contextTokens;
|
|
333
|
+
s.lastAssistantChars = totals.assistantChars;
|
|
334
|
+
s.lastToolResultChars = totals.toolResultChars;
|
|
335
|
+
s.lastUserChars = totals.userChars;
|
|
336
|
+
s.lastWhisperChars = totals.whisperChars;
|
|
337
|
+
s.lastWhisperCount = totals.whisperCount;
|
|
338
|
+
const entry = {
|
|
339
|
+
ts: Date.now(),
|
|
340
|
+
source: opts.source ?? "heartbeat",
|
|
341
|
+
sessionId: sessionId.slice(0, MAX_STRING_CHARS),
|
|
342
|
+
model,
|
|
343
|
+
turnNumber: opts.turnNumber ?? null,
|
|
344
|
+
contextTokens,
|
|
345
|
+
contextWindow,
|
|
346
|
+
contextPercent,
|
|
347
|
+
rssBytes,
|
|
348
|
+
heapUsed,
|
|
349
|
+
sessionFileSizeBytes,
|
|
350
|
+
inputTokens: s.lastInputTokens,
|
|
351
|
+
outputTokens: s.lastOutputTokens,
|
|
352
|
+
cacheHitShare: s.lastCacheHitShare !== null ? Math.round(s.lastCacheHitShare * 10) / 10 : null,
|
|
353
|
+
tokensPerSec: s.lastTps !== null ? Math.round(s.lastTps * 10) / 10 : null,
|
|
354
|
+
tpsEma: s.tpsEma !== null ? Math.round(s.tpsEma * 10) / 10 : null,
|
|
355
|
+
contextTokensDelta,
|
|
356
|
+
assistantCharsDelta,
|
|
357
|
+
toolResultCharsDelta,
|
|
358
|
+
userCharsDelta,
|
|
359
|
+
whisperCharsDelta,
|
|
360
|
+
whisperCountTotal: totals.whisperCount,
|
|
361
|
+
whisperCountDelta,
|
|
362
|
+
messageCount: totals.totalEntries,
|
|
363
|
+
healthMode: opts.healthMode ?? null,
|
|
364
|
+
};
|
|
365
|
+
appendContextHeartbeatLine(entry, opts.sinkFile);
|
|
366
|
+
return {
|
|
367
|
+
entry,
|
|
368
|
+
lastAssistantDurationMs: s.lastAssistantDurationMs,
|
|
369
|
+
inputTokens: s.lastInputTokens ?? 0,
|
|
370
|
+
outputTokens: s.lastOutputTokens ?? 0,
|
|
371
|
+
tokensPerSec: s.lastTps,
|
|
372
|
+
tpsEma: s.tpsEma,
|
|
373
|
+
assistantCharsDelta,
|
|
374
|
+
toolResultCharsDelta,
|
|
375
|
+
userCharsDelta,
|
|
376
|
+
whisperCharsDelta,
|
|
377
|
+
whisperCountDelta,
|
|
378
|
+
rssRing,
|
|
379
|
+
rssBaselineBytes,
|
|
380
|
+
rssSustainedGrowth: assessSustainedRssGrowth(rssRing, rssBaselineBytes),
|
|
381
|
+
};
|
|
382
|
+
}
|
|
383
|
+
/**
|
|
384
|
+
* Sample the self-state metrics for the heartbeat self-state line.
|
|
385
|
+
* Reads per-session state keys owned by this module (telemetry) and the
|
|
386
|
+
* context-density evaluator (near-duplicates). Never throws — every read
|
|
387
|
+
* is wrapped; missing state yields null ("n/a" in the rendered line).
|
|
388
|
+
*/
|
|
389
|
+
export function getSelfStateSample(ctx) {
|
|
390
|
+
const sample = {
|
|
391
|
+
contextTokens: null,
|
|
392
|
+
cacheHitShare: null,
|
|
393
|
+
nearDupCount: null,
|
|
394
|
+
tpsEma: null,
|
|
395
|
+
hygieneActs: null,
|
|
396
|
+
};
|
|
397
|
+
try {
|
|
398
|
+
// Context tokens: live read (compaction-aware session-tree measure),
|
|
399
|
+
// not the last-tick snapshot — a summary rendered right after a slide
|
|
400
|
+
// must not report the pre-slide size. Falls back to the duck-typed
|
|
401
|
+
// accessor when the session tree is unavailable.
|
|
402
|
+
const live = measureLiveUsage(ctx);
|
|
403
|
+
const usage = live ?? getContextUsage(ctx);
|
|
404
|
+
if (usage && typeof usage.tokens === "number")
|
|
405
|
+
sample.contextTokens = usage.tokens;
|
|
406
|
+
}
|
|
407
|
+
catch {
|
|
408
|
+
/* keep null */
|
|
409
|
+
}
|
|
410
|
+
try {
|
|
411
|
+
const s = telemetryState(ctx);
|
|
412
|
+
sample.cacheHitShare =
|
|
413
|
+
s.lastCacheHitShare !== null ? Math.round(s.lastCacheHitShare * 10) / 10 : null;
|
|
414
|
+
sample.tpsEma = s.tpsEma !== null ? Math.round(s.tpsEma * 10) / 10 : null;
|
|
415
|
+
}
|
|
416
|
+
catch {
|
|
417
|
+
/* keep nulls */
|
|
418
|
+
}
|
|
419
|
+
try {
|
|
420
|
+
// Near-duplicates: written by context-lifecycle's density evaluator
|
|
421
|
+
// (policy-engine.ts generateDensitySignals) on every before_agent_start.
|
|
422
|
+
// Existence-gated: creating the bucket here would materialize a fake
|
|
423
|
+
// "duplicates: 0" healthy reading — absent state must stay n/a.
|
|
424
|
+
if (hasExtensionState(ctx, "context-density")) {
|
|
425
|
+
const densityState = getExtensionState(ctx, "context-density", () => ({ duplicates: 0 }));
|
|
426
|
+
if (densityState && typeof densityState.duplicates === "number") {
|
|
427
|
+
sample.nearDupCount = densityState.duplicates;
|
|
428
|
+
}
|
|
429
|
+
}
|
|
430
|
+
}
|
|
431
|
+
catch {
|
|
432
|
+
/* keep null */
|
|
433
|
+
}
|
|
434
|
+
try {
|
|
435
|
+
// Hygiene ACT counters: written by enforcement's turn-end hygiene act.
|
|
436
|
+
// Existence-gated like nearDupCount: absent state stays null ("n/a").
|
|
437
|
+
if (hasExtensionState(ctx, "enforcement")) {
|
|
438
|
+
const enf = getExtensionState(ctx, "enforcement", () => ({}));
|
|
439
|
+
const total = enf?.contextHygieneActs?.total;
|
|
440
|
+
if (typeof total === "number")
|
|
441
|
+
sample.hygieneActs = total;
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
catch {
|
|
445
|
+
/* keep null */
|
|
446
|
+
}
|
|
447
|
+
return sample;
|
|
448
|
+
}
|
|
449
|
+
//# sourceMappingURL=context-heartbeat.js.map
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Drift Signals - bounded per-session drift accumulator.
|
|
3
|
+
*
|
|
4
|
+
* Tracks lightweight drift signals (re-reads of previously-read files,
|
|
5
|
+
* goal-wording shift, stale/wrong file paths, repeated failure on the same
|
|
6
|
+
* target) so silent loss becomes visible via context_inspect / heartbeat
|
|
7
|
+
* analytics - the seed of the degradation detection loop.
|
|
8
|
+
*
|
|
9
|
+
* Design constraints:
|
|
10
|
+
* - Integer increments only. NO heuristic storm, NO string building, NO
|
|
11
|
+
* per-turn work beyond a counter bump. Detection/gating lives at the
|
|
12
|
+
* call sites (turn-analysis.ts, drift-handler.ts), not here.
|
|
13
|
+
* - Bounded accumulator: the counters are per-process totals plus a small
|
|
14
|
+
* ring of the most recent signals (RING_SIZE) for context/debugging.
|
|
15
|
+
*
|
|
16
|
+
* State note: like CompactionHealth in context-manager/handlers/shared.ts,
|
|
17
|
+
* this is a module-level `const` object mutated in place (not a `let`), under
|
|
18
|
+
* the same single-session-per-process assumption that governs the compaction
|
|
19
|
+
* telemetry singleton. Reset via resetDriftTelemetry() at session start / tests.
|
|
20
|
+
*/
|
|
21
|
+
export type DriftSignalKey = "rereads" | "goalShift" | "stalePaths" | "repeatedFailures";
|
|
22
|
+
export interface DriftCounters {
|
|
23
|
+
rereads: number;
|
|
24
|
+
goalShift: number;
|
|
25
|
+
stalePaths: number;
|
|
26
|
+
repeatedFailures: number;
|
|
27
|
+
/** Total drift signals recorded. */
|
|
28
|
+
total: number;
|
|
29
|
+
}
|
|
30
|
+
export interface DriftSignalEntry {
|
|
31
|
+
turn: number;
|
|
32
|
+
key: DriftSignalKey;
|
|
33
|
+
}
|
|
34
|
+
export declare function resetDriftTelemetry(): void;
|
|
35
|
+
/**
|
|
36
|
+
* Record one drift signal. Zero-cost apart from two integer bumps and a ring
|
|
37
|
+
* append. `turn` is the current turn number at the call site.
|
|
38
|
+
*/
|
|
39
|
+
export declare function recordDriftSignal(key: DriftSignalKey, turn: number): void;
|
|
40
|
+
/**
|
|
41
|
+
* One-line drift summary for context_inspect / heartbeat analytics.
|
|
42
|
+
* Returns null when no drift signals were recorded this process, so the
|
|
43
|
+
* quick inspector line can stay clean.
|
|
44
|
+
*/
|
|
45
|
+
export declare function formatDriftLine(): string | null;
|
|
46
|
+
//# sourceMappingURL=drift-signals.d.ts.map
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Drift Signals - bounded per-session drift accumulator.
|
|
3
|
+
*
|
|
4
|
+
* Tracks lightweight drift signals (re-reads of previously-read files,
|
|
5
|
+
* goal-wording shift, stale/wrong file paths, repeated failure on the same
|
|
6
|
+
* target) so silent loss becomes visible via context_inspect / heartbeat
|
|
7
|
+
* analytics - the seed of the degradation detection loop.
|
|
8
|
+
*
|
|
9
|
+
* Design constraints:
|
|
10
|
+
* - Integer increments only. NO heuristic storm, NO string building, NO
|
|
11
|
+
* per-turn work beyond a counter bump. Detection/gating lives at the
|
|
12
|
+
* call sites (turn-analysis.ts, drift-handler.ts), not here.
|
|
13
|
+
* - Bounded accumulator: the counters are per-process totals plus a small
|
|
14
|
+
* ring of the most recent signals (RING_SIZE) for context/debugging.
|
|
15
|
+
*
|
|
16
|
+
* State note: like CompactionHealth in context-manager/handlers/shared.ts,
|
|
17
|
+
* this is a module-level `const` object mutated in place (not a `let`), under
|
|
18
|
+
* the same single-session-per-process assumption that governs the compaction
|
|
19
|
+
* telemetry singleton. Reset via resetDriftTelemetry() at session start / tests.
|
|
20
|
+
*/
|
|
21
|
+
/** Small ring of the most recent drift signals (bounded). */
|
|
22
|
+
const RING_SIZE = 16;
|
|
23
|
+
const driftTelemetry = {
|
|
24
|
+
counters: { rereads: 0, goalShift: 0, stalePaths: 0, repeatedFailures: 0, total: 0 },
|
|
25
|
+
ring: [],
|
|
26
|
+
};
|
|
27
|
+
export function resetDriftTelemetry() {
|
|
28
|
+
driftTelemetry.counters = {
|
|
29
|
+
rereads: 0,
|
|
30
|
+
goalShift: 0,
|
|
31
|
+
stalePaths: 0,
|
|
32
|
+
repeatedFailures: 0,
|
|
33
|
+
total: 0,
|
|
34
|
+
};
|
|
35
|
+
driftTelemetry.ring = [];
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Record one drift signal. Zero-cost apart from two integer bumps and a ring
|
|
39
|
+
* append. `turn` is the current turn number at the call site.
|
|
40
|
+
*/
|
|
41
|
+
export function recordDriftSignal(key, turn) {
|
|
42
|
+
const c = driftTelemetry.counters;
|
|
43
|
+
switch (key) {
|
|
44
|
+
case "rereads":
|
|
45
|
+
c.rereads++;
|
|
46
|
+
break;
|
|
47
|
+
case "goalShift":
|
|
48
|
+
c.goalShift++;
|
|
49
|
+
break;
|
|
50
|
+
case "stalePaths":
|
|
51
|
+
c.stalePaths++;
|
|
52
|
+
break;
|
|
53
|
+
case "repeatedFailures":
|
|
54
|
+
c.repeatedFailures++;
|
|
55
|
+
break;
|
|
56
|
+
}
|
|
57
|
+
c.total++;
|
|
58
|
+
if (driftTelemetry.ring.length >= RING_SIZE) {
|
|
59
|
+
driftTelemetry.ring.shift();
|
|
60
|
+
}
|
|
61
|
+
driftTelemetry.ring.push({ turn, key });
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* One-line drift summary for context_inspect / heartbeat analytics.
|
|
65
|
+
* Returns null when no drift signals were recorded this process, so the
|
|
66
|
+
* quick inspector line can stay clean.
|
|
67
|
+
*/
|
|
68
|
+
export function formatDriftLine() {
|
|
69
|
+
if (driftTelemetry.counters.total === 0)
|
|
70
|
+
return null;
|
|
71
|
+
const c = driftTelemetry.counters;
|
|
72
|
+
return (`drift signals: ${c.rereads} re-reads, ${c.repeatedFailures} repeated failures, ` +
|
|
73
|
+
`${c.stalePaths} stale paths, ${c.goalShift} goal shifts`);
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=drift-signals.js.map
|