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,251 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session Health State - one source of truth for "is the session healthy?".
|
|
3
|
+
*
|
|
4
|
+
* Owned by the enforcement layer. Heartbeat informs, context-manager
|
|
5
|
+
* executes, the recovery handler (Layer 3, deferred) decides what to do.
|
|
6
|
+
*
|
|
7
|
+
* State machine:
|
|
8
|
+
* healthy
|
|
9
|
+
* ├── (1+ transient) -> healthy (auto-cleared after N healthy turns)
|
|
10
|
+
* ├── (1 balance) -> balance (no auto-clear; user must act)
|
|
11
|
+
* ├── (3+ transient) -> degraded (cleared after 10 healthy turns)
|
|
12
|
+
* ├── (context_window)-> context_overflow (cleared after compaction)
|
|
13
|
+
* ├── (auth) -> auth (no auto-clear; user must act)
|
|
14
|
+
* └── (abort) -> aborted (cleared on next turn_start)
|
|
15
|
+
*
|
|
16
|
+
* The state is per-session via getExtensionState. Consumers read it via
|
|
17
|
+
* getSessionHealth(ctx); updates happen via recordLlmError / recordLlmSuccess
|
|
18
|
+
* or explicit setSessionHealthMode.
|
|
19
|
+
*
|
|
20
|
+
* Layer 2 of the session-recovery proposal. Skips the
|
|
21
|
+
* recovery handler (Layer 3) -- the state is populated, but the consumer
|
|
22
|
+
* of the state is downstream code (consolidation gate in heartbeat,
|
|
23
|
+
* the L1 environment hook, the session_health tool).
|
|
24
|
+
*/
|
|
25
|
+
import { getExtensionState } from "../../lib/state/extension-state.js";
|
|
26
|
+
function emptyCategoryCounts() {
|
|
27
|
+
return {
|
|
28
|
+
balance: 0,
|
|
29
|
+
rate_limit: 0,
|
|
30
|
+
context_window: 0,
|
|
31
|
+
transient: 0,
|
|
32
|
+
abort: 0,
|
|
33
|
+
auth: 0,
|
|
34
|
+
unknown: 0,
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
const DEFAULT_STATE = {
|
|
38
|
+
mode: "healthy",
|
|
39
|
+
consecutiveErrors: 0,
|
|
40
|
+
consecutiveHealthyTurns: 0,
|
|
41
|
+
providerErrorsByCategory: emptyCategoryCounts(),
|
|
42
|
+
providerSuccessCount: 0,
|
|
43
|
+
consolidationSkipsByMode: {},
|
|
44
|
+
terminalErrorsSinceHealthyTurn: 0,
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* Terminal-category errors (auth/balance) that must accumulate since the last
|
|
48
|
+
* clean turn before a wake fire stops starting a turn. Chosen to equal the
|
|
49
|
+
* watchdog's quotaErrors so the two guards cannot disagree about when a route
|
|
50
|
+
* is down; one terminal error is not evidence of a terminal route (a 401 was
|
|
51
|
+
* observed followed by a pass-through success, and 401/402 mix on one key).
|
|
52
|
+
*/
|
|
53
|
+
export const TERMINAL_BREAKER_N = 3;
|
|
54
|
+
const DEGRADED_THRESHOLD = 3; // N consecutive transient errors -> degraded
|
|
55
|
+
const HEALTHY_CLEAR_TURNS = 10; // N healthy turns to leave degraded
|
|
56
|
+
// Bounded re-probe cadence shared by balance AND auth: after this
|
|
57
|
+
// long without another error of the latched mode, tickSessionHealth clears
|
|
58
|
+
// the error window so the next LLM call re-probes the provider.
|
|
59
|
+
const HEALTH_PROBE_CLEAR_MS = 5 * 60 * 1000; // 5 min
|
|
60
|
+
export function getSessionHealth(ctx) {
|
|
61
|
+
const s = getExtensionState(ctx, "session-health", () => ({
|
|
62
|
+
...DEFAULT_STATE,
|
|
63
|
+
providerErrorsByCategory: emptyCategoryCounts(),
|
|
64
|
+
consolidationSkipsByMode: {},
|
|
65
|
+
}));
|
|
66
|
+
// Older in-session states predate these fields — backfill defensively.
|
|
67
|
+
if (!s.consolidationSkipsByMode)
|
|
68
|
+
s.consolidationSkipsByMode = {};
|
|
69
|
+
if (typeof s.terminalErrorsSinceHealthyTurn !== "number") {
|
|
70
|
+
s.terminalErrorsSinceHealthyTurn = 0;
|
|
71
|
+
}
|
|
72
|
+
return s;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Would a new turn start against a route this session has already seen fail
|
|
76
|
+
* terminally? Latch state only — no provider/model/error names, so callers in
|
|
77
|
+
* generic layers (the timer wake path) cannot learn a domain fact from it.
|
|
78
|
+
*
|
|
79
|
+
* `threshold` lets a caller pass the configured bound; the default keeps the
|
|
80
|
+
* built-in N. Open-ness is derived from the monotonic counter, which only the
|
|
81
|
+
* explicit reset signals (session_start, owner recovery, route change) and a
|
|
82
|
+
* clean wake turn lower — hence "latch".
|
|
83
|
+
*/
|
|
84
|
+
export function isTurnStartBlocked(ctx, threshold = TERMINAL_BREAKER_N) {
|
|
85
|
+
const s = getSessionHealth(ctx);
|
|
86
|
+
return s.terminalErrorsSinceHealthyTurn >= threshold;
|
|
87
|
+
}
|
|
88
|
+
/** Clear the latch and its counter (the reset signals share this). */
|
|
89
|
+
export function clearTerminalBreaker(ctx) {
|
|
90
|
+
const s = getSessionHealth(ctx);
|
|
91
|
+
s.terminalErrorsSinceHealthyTurn = 0;
|
|
92
|
+
s.breakerOpenedAt = undefined;
|
|
93
|
+
}
|
|
94
|
+
export function recordLlmError(ctx, err) {
|
|
95
|
+
const s = getSessionHealth(ctx);
|
|
96
|
+
s.lastError = err;
|
|
97
|
+
s.providerErrorsByCategory[err.category]++;
|
|
98
|
+
s.consecutiveErrors++;
|
|
99
|
+
s.consecutiveHealthyTurns = 0;
|
|
100
|
+
s.modeEnteredAt = s.modeEnteredAt ?? Date.now();
|
|
101
|
+
if (s.firstErrorAt == null)
|
|
102
|
+
s.firstErrorAt = Date.now();
|
|
103
|
+
// Terminal-category errors feed the wake breaker's own counter. It is
|
|
104
|
+
// deliberately independent of `mode` and of the transient streak: rate
|
|
105
|
+
// limits are excluded here (a throttled ring must not stop waking).
|
|
106
|
+
if (err.category === "auth" || err.category === "balance") {
|
|
107
|
+
s.terminalErrorsSinceHealthyTurn++;
|
|
108
|
+
if (s.breakerOpenedAt == null && s.terminalErrorsSinceHealthyTurn >= TERMINAL_BREAKER_N) {
|
|
109
|
+
s.breakerOpenedAt = Date.now();
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
// Mode transitions driven by error category. Terminal categories
|
|
113
|
+
// (balance, auth, context_window) jump immediately. Transient errors
|
|
114
|
+
// accumulate. Abort is informational -- does not change mode.
|
|
115
|
+
switch (err.category) {
|
|
116
|
+
case "balance":
|
|
117
|
+
s.mode = "balance";
|
|
118
|
+
s.modeEnteredAt = Date.now();
|
|
119
|
+
break;
|
|
120
|
+
case "auth":
|
|
121
|
+
s.mode = "auth";
|
|
122
|
+
s.modeEnteredAt = Date.now();
|
|
123
|
+
break;
|
|
124
|
+
case "context_window":
|
|
125
|
+
s.mode = "context_overflow";
|
|
126
|
+
s.modeEnteredAt = Date.now();
|
|
127
|
+
break;
|
|
128
|
+
case "abort":
|
|
129
|
+
s.mode = "aborted";
|
|
130
|
+
s.modeEnteredAt = Date.now();
|
|
131
|
+
break;
|
|
132
|
+
case "transient":
|
|
133
|
+
case "rate_limit":
|
|
134
|
+
case "unknown":
|
|
135
|
+
if (s.consecutiveErrors >= DEGRADED_THRESHOLD && s.mode === "healthy") {
|
|
136
|
+
s.mode = "degraded";
|
|
137
|
+
s.modeEnteredAt = Date.now();
|
|
138
|
+
}
|
|
139
|
+
break;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
export function recordLlmSuccess(ctx) {
|
|
143
|
+
const s = getSessionHealth(ctx);
|
|
144
|
+
s.providerSuccessCount++;
|
|
145
|
+
s.consecutiveErrors = 0;
|
|
146
|
+
s.consecutiveHealthyTurns++;
|
|
147
|
+
// Recover from degraded/aborted after enough healthy turns.
|
|
148
|
+
if (s.mode === "degraded" || s.mode === "aborted" || s.mode === "context_overflow") {
|
|
149
|
+
if (s.consecutiveHealthyTurns >= HEALTHY_CLEAR_TURNS) {
|
|
150
|
+
clearToHealthy(s);
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
// Balance and auth auto-clear via two bounded paths; without this, one
|
|
154
|
+
// 401 burst would latch auth for the whole session and skip heartbeat
|
|
155
|
+
// consolidation permanently.
|
|
156
|
+
// 1. Probe: tickSessionHealth cleared the error window (firstErrorAt
|
|
157
|
+
// gone) after the quiet period; a successful LLM call proves the
|
|
158
|
+
// provider is back. A fresh 401 re-latches immediately (recordLlmError
|
|
159
|
+
// case "auth" is unchanged — the initial escalation is not weakened).
|
|
160
|
+
// 2. Streak: without a probe tick, a sufficient consecutive-success
|
|
161
|
+
// streak is evidence the provider recovered.
|
|
162
|
+
if (s.mode === "balance" || s.mode === "auth") {
|
|
163
|
+
if (s.firstErrorAt == null || s.consecutiveHealthyTurns >= HEALTHY_CLEAR_TURNS) {
|
|
164
|
+
clearToHealthy(s);
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
/** Clear a blocking mode to healthy (shared by the recovery paths). */
|
|
169
|
+
function clearToHealthy(s) {
|
|
170
|
+
s.mode = "healthy";
|
|
171
|
+
s.modeEnteredAt = Date.now();
|
|
172
|
+
s.firstErrorAt = undefined;
|
|
173
|
+
s.lastError = undefined;
|
|
174
|
+
}
|
|
175
|
+
export function setSessionHealthMode(ctx, mode, reason) {
|
|
176
|
+
const s = getSessionHealth(ctx);
|
|
177
|
+
s.mode = mode;
|
|
178
|
+
s.modeEnteredAt = Date.now();
|
|
179
|
+
if (mode === "healthy") {
|
|
180
|
+
s.consecutiveErrors = 0;
|
|
181
|
+
s.consecutiveHealthyTurns = 0;
|
|
182
|
+
s.firstErrorAt = undefined;
|
|
183
|
+
s.lastError = undefined;
|
|
184
|
+
// Owner recovery is an explicit close signal for the wake breaker too.
|
|
185
|
+
clearTerminalBreaker(ctx);
|
|
186
|
+
}
|
|
187
|
+
// Reason is currently a no-op (kept for future audit log).
|
|
188
|
+
void reason;
|
|
189
|
+
}
|
|
190
|
+
/**
|
|
191
|
+
* Count a skipped heartbeat consolidation by health mode (called from the
|
|
192
|
+
* heartbeat agent_end gate). Diagnostic counter.
|
|
193
|
+
*/
|
|
194
|
+
export function recordConsolidationSkip(ctx, mode) {
|
|
195
|
+
const s = getSessionHealth(ctx);
|
|
196
|
+
if (!s.consolidationSkipsByMode)
|
|
197
|
+
s.consolidationSkipsByMode = {};
|
|
198
|
+
s.consolidationSkipsByMode[mode] = (s.consolidationSkipsByMode[mode] ?? 0) + 1;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Periodically re-check the balance/auth-mode exit condition.
|
|
202
|
+
* The 5-minute probe window is conservative -- if no error of the latched
|
|
203
|
+
* mode has fired in 5 minutes, the provider has probably recovered. Clearing
|
|
204
|
+
* the error window re-arms the probe: the next LLM call either succeeds
|
|
205
|
+
* (recordLlmSuccess clears the mode) or fails (the same error category
|
|
206
|
+
* re-latches immediately — a genuine 401 burst still latches fast).
|
|
207
|
+
* Hooked from enforcement's session_start LLM listeners (fires per LLM
|
|
208
|
+
* outcome; the success-streak path in recordLlmSuccess covers sessions
|
|
209
|
+
* where errors have simply stopped).
|
|
210
|
+
*/
|
|
211
|
+
export function tickSessionHealth(ctx) {
|
|
212
|
+
const s = getSessionHealth(ctx);
|
|
213
|
+
if (s.mode !== "balance" && s.mode !== "auth")
|
|
214
|
+
return;
|
|
215
|
+
if (!s.firstErrorAt)
|
|
216
|
+
return;
|
|
217
|
+
if (Date.now() - s.firstErrorAt < HEALTH_PROBE_CLEAR_MS)
|
|
218
|
+
return;
|
|
219
|
+
// Time has passed without another error of this mode. Probe by clearing
|
|
220
|
+
// the error window (mode stays latched until a call proves recovery).
|
|
221
|
+
s.firstErrorAt = undefined;
|
|
222
|
+
s.lastError = undefined;
|
|
223
|
+
s.consecutiveErrors = 0;
|
|
224
|
+
s.consecutiveHealthyTurns = 0;
|
|
225
|
+
s.modeEnteredAt = Date.now();
|
|
226
|
+
}
|
|
227
|
+
export function resetSessionHealth(ctx, opts = {}) {
|
|
228
|
+
const s = getSessionHealth(ctx);
|
|
229
|
+
clearTerminalBreaker(ctx);
|
|
230
|
+
if (opts.preserveHistory) {
|
|
231
|
+
// Keep category counts and success count for diagnostics, reset mode.
|
|
232
|
+
s.mode = "healthy";
|
|
233
|
+
s.consecutiveErrors = 0;
|
|
234
|
+
s.consecutiveHealthyTurns = 0;
|
|
235
|
+
s.firstErrorAt = undefined;
|
|
236
|
+
s.lastError = undefined;
|
|
237
|
+
s.modeEnteredAt = Date.now();
|
|
238
|
+
}
|
|
239
|
+
else {
|
|
240
|
+
s.mode = "healthy";
|
|
241
|
+
s.consecutiveErrors = 0;
|
|
242
|
+
s.consecutiveHealthyTurns = 0;
|
|
243
|
+
s.firstErrorAt = undefined;
|
|
244
|
+
s.lastError = undefined;
|
|
245
|
+
s.modeEnteredAt = Date.now();
|
|
246
|
+
s.providerErrorsByCategory = emptyCategoryCounts();
|
|
247
|
+
s.providerSuccessCount = 0;
|
|
248
|
+
s.consolidationSkipsByMode = {};
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
//# sourceMappingURL=session-health.js.map
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Signals - shared L1 signal state for prompt-builder.
|
|
3
|
+
*
|
|
4
|
+
* enforcementSignals is a writable object - prompt-builder reads it directly
|
|
5
|
+
* (same process, no IPC needed). Stale entries are cleaned up on each
|
|
6
|
+
* TURN_END via `pruneSignals(currentTurn)`: entries whose `turn` is more
|
|
7
|
+
* than 1 behind `currentTurn` are deleted. So the live set is bounded
|
|
8
|
+
* to signals from the current and previous turn.
|
|
9
|
+
*
|
|
10
|
+
* Why direct mutation instead of a Map wrapper: callers in 3+ handler
|
|
11
|
+
* files already use `enforcementSignals[key] = signal` and
|
|
12
|
+
* `delete enforcementSignals[key]`. A Map would be safer but require
|
|
13
|
+
* touching all those sites; the bounded set means no actual leak risk.
|
|
14
|
+
*
|
|
15
|
+
* Use `pruneSignals(currentTurn)` from the TURN_END handler to enforce
|
|
16
|
+
* the turn-keyed invariant.
|
|
17
|
+
/** A single signal entry keyed by semantic type */
|
|
18
|
+
export interface EnforcementSignalEntry {
|
|
19
|
+
turn: number;
|
|
20
|
+
text: string;
|
|
21
|
+
acted: boolean;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Known enforcement signal keys. Allows compile-time checking at static
|
|
25
|
+
* call sites while preserving a downcast escape hatch for the dynamic
|
|
26
|
+
* message-analysis pipeline (register-message-end.ts keys from
|
|
27
|
+
* analyzeMessage).
|
|
28
|
+
*
|
|
29
|
+
* Use `(enforcementSignals as Record<string, EnforcementSignalEntry>)`
|
|
30
|
+
* when the key is genuinely runtime-dynamic.
|
|
31
|
+
*/
|
|
32
|
+
export type EnforcementSignalKey = "probe" | "routing" | "stability" | "truth_seeking_trigger" | "unpersisted_learnings";
|
|
33
|
+
/**
|
|
34
|
+
* Source-of-truth map for signal keys that appear in multiple files.
|
|
35
|
+
* Using a typo in a literal (`SIGNAL_KEYS.unpersisted_lernings`) now
|
|
36
|
+
* fails at compile time.
|
|
37
|
+
*/
|
|
38
|
+
export declare const SIGNAL_KEYS: Record<string, EnforcementSignalKey>;
|
|
39
|
+
/**
|
|
40
|
+
* L1 enforcement signals for prompt-builder surfacing.
|
|
41
|
+
* Keyed by semantic type (probe, routing, stability,
|
|
42
|
+
* unpersisted_learnings). Dynamic keys from message-analysis use a
|
|
43
|
+
* downcast escape hatch.
|
|
44
|
+
*/
|
|
45
|
+
export declare const enforcementSignals: Partial<Record<EnforcementSignalKey, EnforcementSignalEntry>>;
|
|
46
|
+
/**
|
|
47
|
+
* Prune enforcement signals whose `turn` is more than
|
|
48
|
+
* `SIGNAL_RETENTION_TURNS` behind `currentTurn`. Call this from the
|
|
49
|
+
* TURN_END handler to enforce the "turn-keyed" invariant.
|
|
50
|
+
*
|
|
51
|
+
* Returns the number of entries deleted (useful for observability).
|
|
52
|
+
*/
|
|
53
|
+
export declare function pruneSignals(currentTurn: number): number;
|
|
54
|
+
//# sourceMappingURL=signals.d.ts.map
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How many turns behind `currentTurn` an entry can be before eviction.
|
|
3
|
+
*
|
|
4
|
+
* 3 covers the MARS lookback: `tool-usage-analyzer.ts` reads
|
|
5
|
+
* `stabilityTrend.slice(-3)` to detect a stability_decline pattern, so a
|
|
6
|
+
* retention of 1 leaves the trend incomplete by the time MARS fires —
|
|
7
|
+
* effectively dead code. The
|
|
8
|
+
* prompt-builder's RepE contrast consumer still works fine with the
|
|
9
|
+
* larger window; it reads the most-recent signal of each key.
|
|
10
|
+
*/
|
|
11
|
+
const SIGNAL_RETENTION_TURNS = 3;
|
|
12
|
+
/**
|
|
13
|
+
* Source-of-truth map for signal keys that appear in multiple files.
|
|
14
|
+
* Using a typo in a literal (`SIGNAL_KEYS.unpersisted_lernings`) now
|
|
15
|
+
* fails at compile time.
|
|
16
|
+
*/
|
|
17
|
+
export const SIGNAL_KEYS = {
|
|
18
|
+
unpersisted_learnings: "unpersisted_learnings",
|
|
19
|
+
truth_seeking_trigger: "truth_seeking_trigger",
|
|
20
|
+
};
|
|
21
|
+
/**
|
|
22
|
+
* L1 enforcement signals for prompt-builder surfacing.
|
|
23
|
+
* Keyed by semantic type (probe, routing, stability,
|
|
24
|
+
* unpersisted_learnings). Dynamic keys from message-analysis use a
|
|
25
|
+
* downcast escape hatch.
|
|
26
|
+
*/
|
|
27
|
+
export const enforcementSignals = {};
|
|
28
|
+
/**
|
|
29
|
+
* Prune enforcement signals whose `turn` is more than
|
|
30
|
+
* `SIGNAL_RETENTION_TURNS` behind `currentTurn`. Call this from the
|
|
31
|
+
* TURN_END handler to enforce the "turn-keyed" invariant.
|
|
32
|
+
*
|
|
33
|
+
* Returns the number of entries deleted (useful for observability).
|
|
34
|
+
*/
|
|
35
|
+
export function pruneSignals(currentTurn) {
|
|
36
|
+
const cutoff = currentTurn - SIGNAL_RETENTION_TURNS;
|
|
37
|
+
let deleted = 0;
|
|
38
|
+
const signals = enforcementSignals;
|
|
39
|
+
for (const key of Object.keys(signals)) {
|
|
40
|
+
if (signals[key].turn < cutoff) {
|
|
41
|
+
delete signals[key];
|
|
42
|
+
deleted++;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return deleted;
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=signals.js.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text similarity utilities for redundancy detection.
|
|
3
|
+
*
|
|
4
|
+
* Tokenizes text into lines and computes Jaccard similarity.
|
|
5
|
+
* Tracks known file contents across turns for detectRedundancySignal.
|
|
6
|
+
*/
|
|
7
|
+
export declare function computeSimilarity(text1: string, text2: string): number;
|
|
8
|
+
export interface KnownFileEntry {
|
|
9
|
+
content: string;
|
|
10
|
+
turn: number;
|
|
11
|
+
}
|
|
12
|
+
/** Map of file path -> { content, turn } */
|
|
13
|
+
export declare const knownFiles: Map<string, KnownFileEntry>;
|
|
14
|
+
export declare function loadFileContent(filePath: string): Promise<string | null>;
|
|
15
|
+
export declare function detectRedundancy(newContent: string, newPath: string): Promise<string | null>;
|
|
16
|
+
//# sourceMappingURL=similarity.d.ts.map
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text similarity utilities for redundancy detection.
|
|
3
|
+
*
|
|
4
|
+
* Tokenizes text into lines and computes Jaccard similarity.
|
|
5
|
+
* Tracks known file contents across turns for detectRedundancySignal.
|
|
6
|
+
*/
|
|
7
|
+
import * as fs from "node:fs/promises";
|
|
8
|
+
import * as path from "path";
|
|
9
|
+
function tokenize(text) {
|
|
10
|
+
return new Set(text
|
|
11
|
+
.split("\n")
|
|
12
|
+
.map((l) => l.trim())
|
|
13
|
+
.filter((l) => l.length > 0));
|
|
14
|
+
}
|
|
15
|
+
function jaccardSimilarity(a, b) {
|
|
16
|
+
if (a.size === 0 && b.size === 0)
|
|
17
|
+
return 0;
|
|
18
|
+
let intersection = 0;
|
|
19
|
+
for (const item of a) {
|
|
20
|
+
if (b.has(item))
|
|
21
|
+
intersection++;
|
|
22
|
+
}
|
|
23
|
+
const union = a.size + b.size - intersection;
|
|
24
|
+
return union === 0 ? 0 : intersection / union;
|
|
25
|
+
}
|
|
26
|
+
export function computeSimilarity(text1, text2) {
|
|
27
|
+
const set1 = tokenize(text1);
|
|
28
|
+
const set2 = tokenize(text2);
|
|
29
|
+
return jaccardSimilarity(set1, set2);
|
|
30
|
+
}
|
|
31
|
+
/** Map of file path -> { content, turn } */
|
|
32
|
+
export const knownFiles = new Map();
|
|
33
|
+
export async function loadFileContent(filePath) {
|
|
34
|
+
try {
|
|
35
|
+
const resolvedPath = path.isAbsolute(filePath)
|
|
36
|
+
? filePath
|
|
37
|
+
: path.resolve(process.cwd(), filePath);
|
|
38
|
+
try {
|
|
39
|
+
const stat = await fs.stat(resolvedPath);
|
|
40
|
+
if (stat.isDirectory())
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
return null;
|
|
45
|
+
}
|
|
46
|
+
return await fs.readFile(resolvedPath, "utf-8");
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return null;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
export async function detectRedundancy(newContent, newPath) {
|
|
53
|
+
const SIMILARITY_THRESHOLD = 0.7;
|
|
54
|
+
for (const [existingPath, { content: existingContent }] of knownFiles) {
|
|
55
|
+
if (existingPath === newPath)
|
|
56
|
+
continue;
|
|
57
|
+
const similarity = computeSimilarity(newContent, existingContent);
|
|
58
|
+
if (similarity >= SIMILARITY_THRESHOLD) {
|
|
59
|
+
return existingPath;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=similarity.js.map
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement state - session-scoped state management.
|
|
3
|
+
*
|
|
4
|
+
* Composed from focused sub-state interfaces instead of one flat factory.
|
|
5
|
+
* Each sub-state file owns its properties, factory, and reset logic.
|
|
6
|
+
* Sub-state files do NOT import state.ts (avoids circular dependency).
|
|
7
|
+
*
|
|
8
|
+
* ENFORCEMENT_PARAMS and EnforcementState live in `enforcement-types.ts`
|
|
9
|
+
* to break the state.ts <-> session-state.ts cycle.
|
|
10
|
+
*
|
|
11
|
+
* Sub-state files:
|
|
12
|
+
* tool-tracking-state.ts - tool usage, edit tracking, calibration
|
|
13
|
+
* error-tracking-state.ts - errors, validation failures, nudge cooldowns
|
|
14
|
+
* session-state.ts - turn tracking, config, drift detector
|
|
15
|
+
* memory-hygiene-state.ts - memory tool usage and nudges
|
|
16
|
+
* scratchpad-state.ts - scratchpad usage and verification nudges
|
|
17
|
+
* context-hygiene-state.ts - context usage, compaction, overflow
|
|
18
|
+
* thought-chain-state.ts - think() tracking and reflection gaps
|
|
19
|
+
* verification-judge-state.ts - judge/calibration helpers
|
|
20
|
+
*/
|
|
21
|
+
/** Consecutive error turns before a burst is declared. Centralized here. */
|
|
22
|
+
export declare const ERROR_BURST_THRESHOLD = 3;
|
|
23
|
+
/** Turns of grace after overflow recovery before signal priority resets. */
|
|
24
|
+
export declare const RECOVERY_GRACE_TURNS = 5;
|
|
25
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
26
|
+
import { type EnforcementState } from "./enforcement-types.js";
|
|
27
|
+
export { ENFORCEMENT_PARAMS, type EnforcementState } from "./enforcement-types.js";
|
|
28
|
+
import { type ScratchpadState } from "./substate/context-hygiene-state.js";
|
|
29
|
+
export { startJudge, completeJudge, shouldRunJudge, recordCalibration, } from "./substate/verification-judge-state.js";
|
|
30
|
+
export { markNudgeSent, resetNudge, recordContextTool, recordCompaction, inOverflowRecovery, } from "./substate/context-hygiene-state.js";
|
|
31
|
+
export { recordMemoryAccess, shouldNudgeForMemory, markMemoryNudgeSent, } from "./substate/memory-hygiene-state.js";
|
|
32
|
+
export { recordThink, incrementToolsSinceReflection } from "./substate/thought-chain-state.js";
|
|
33
|
+
export { isErrorBurst, updateErrorBurst } from "./substate/error-tracking-state.js";
|
|
34
|
+
export { recordToolChainCall, type CalibrationPair } from "./substate/tool-tracking-state.js";
|
|
35
|
+
export declare function createState(): EnforcementState;
|
|
36
|
+
export declare function getState(ctx: ExtensionContext): EnforcementState;
|
|
37
|
+
export declare function resetState(s: EnforcementState): void;
|
|
38
|
+
/** Reset scratchpad nudge timer (called when agent uses scratchpad). */
|
|
39
|
+
export declare function resetScratchpadNudge(s: ScratchpadState): void;
|
|
40
|
+
//# sourceMappingURL=state.d.ts.map
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement state - session-scoped state management.
|
|
3
|
+
*
|
|
4
|
+
* Composed from focused sub-state interfaces instead of one flat factory.
|
|
5
|
+
* Each sub-state file owns its properties, factory, and reset logic.
|
|
6
|
+
* Sub-state files do NOT import state.ts (avoids circular dependency).
|
|
7
|
+
*
|
|
8
|
+
* ENFORCEMENT_PARAMS and EnforcementState live in `enforcement-types.ts`
|
|
9
|
+
* to break the state.ts <-> session-state.ts cycle.
|
|
10
|
+
*
|
|
11
|
+
* Sub-state files:
|
|
12
|
+
* tool-tracking-state.ts - tool usage, edit tracking, calibration
|
|
13
|
+
* error-tracking-state.ts - errors, validation failures, nudge cooldowns
|
|
14
|
+
* session-state.ts - turn tracking, config, drift detector
|
|
15
|
+
* memory-hygiene-state.ts - memory tool usage and nudges
|
|
16
|
+
* scratchpad-state.ts - scratchpad usage and verification nudges
|
|
17
|
+
* context-hygiene-state.ts - context usage, compaction, overflow
|
|
18
|
+
* thought-chain-state.ts - think() tracking and reflection gaps
|
|
19
|
+
* verification-judge-state.ts - judge/calibration helpers
|
|
20
|
+
*/
|
|
21
|
+
/** Consecutive error turns before a burst is declared. Centralized here. */
|
|
22
|
+
export const ERROR_BURST_THRESHOLD = 3;
|
|
23
|
+
/** Turns of grace after overflow recovery before signal priority resets. */
|
|
24
|
+
export const RECOVERY_GRACE_TURNS = 5;
|
|
25
|
+
import { getExtensionState } from "../../lib/state/extension-state.js";
|
|
26
|
+
// Re-export shared types/constants (backward compat - consumers import from state.ts)
|
|
27
|
+
export { ENFORCEMENT_PARAMS } from "./enforcement-types.js";
|
|
28
|
+
import { createToolTrackingState, resetToolTrackingState } from "./substate/tool-tracking-state.js";
|
|
29
|
+
import { createErrorTrackingState, resetErrorTrackingState, } from "./substate/error-tracking-state.js";
|
|
30
|
+
import { createSessionState, resetSessionState } from "./substate/session-state.js";
|
|
31
|
+
import { createMemoryHygieneState, resetMemoryHygieneState, } from "./substate/memory-hygiene-state.js";
|
|
32
|
+
import { createScratchpadState, resetScratchpadState, createContextHygieneState, resetContextHygieneState, } from "./substate/context-hygiene-state.js";
|
|
33
|
+
import { createThoughtChainState, resetThoughtChainState } from "./substate/thought-chain-state.js";
|
|
34
|
+
// Re-export sub-module helpers (backward compat - consumers import from state.ts)
|
|
35
|
+
export { startJudge, completeJudge, shouldRunJudge, recordCalibration, } from "./substate/verification-judge-state.js";
|
|
36
|
+
export { markNudgeSent, resetNudge, recordContextTool, recordCompaction, inOverflowRecovery, } from "./substate/context-hygiene-state.js";
|
|
37
|
+
export { recordMemoryAccess, shouldNudgeForMemory, markMemoryNudgeSent, } from "./substate/memory-hygiene-state.js";
|
|
38
|
+
export { recordThink, incrementToolsSinceReflection } from "./substate/thought-chain-state.js";
|
|
39
|
+
export { isErrorBurst, updateErrorBurst } from "./substate/error-tracking-state.js";
|
|
40
|
+
export { recordToolChainCall } from "./substate/tool-tracking-state.js";
|
|
41
|
+
// State factory (composed from sub-states)
|
|
42
|
+
export function createState() {
|
|
43
|
+
// NOTE: No `as EnforcementState` cast here. If TypeScript reports an error,
|
|
44
|
+
// it means two sub-states have overlapping keys with incompatible types -
|
|
45
|
+
// which is a real bug the cast was hiding. Fix the sub-states, don't add the cast back.
|
|
46
|
+
const state = {
|
|
47
|
+
...createToolTrackingState(),
|
|
48
|
+
...createErrorTrackingState(),
|
|
49
|
+
...createSessionState(),
|
|
50
|
+
...createMemoryHygieneState(),
|
|
51
|
+
...createScratchpadState(),
|
|
52
|
+
...createContextHygieneState(),
|
|
53
|
+
...createThoughtChainState(),
|
|
54
|
+
};
|
|
55
|
+
return state;
|
|
56
|
+
}
|
|
57
|
+
export function getState(ctx) {
|
|
58
|
+
return getExtensionState(ctx, "enforcement", createState);
|
|
59
|
+
}
|
|
60
|
+
// Resets (delegates to each sub-state)
|
|
61
|
+
export function resetState(s) {
|
|
62
|
+
resetToolTrackingState(s);
|
|
63
|
+
resetErrorTrackingState(s);
|
|
64
|
+
resetSessionState(s);
|
|
65
|
+
resetMemoryHygieneState(s);
|
|
66
|
+
resetScratchpadState(s);
|
|
67
|
+
resetContextHygieneState(s);
|
|
68
|
+
resetThoughtChainState(s);
|
|
69
|
+
}
|
|
70
|
+
/** Reset scratchpad nudge timer (called when agent uses scratchpad). */
|
|
71
|
+
export function resetScratchpadNudge(s) {
|
|
72
|
+
s.lastScratchpadNudgeTurn = -100;
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=state.js.map
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Hygiene & Scratchpad - state interface and helpers for context usage
|
|
3
|
+
* tracking and scratchpad nudge timing. Merged because both track nudge timing
|
|
4
|
+
* and recordCompaction() already cross-references lastScratchpadNudgeTurn.
|
|
5
|
+
* Does NOT import state.ts (breaks circular dependency).
|
|
6
|
+
*/
|
|
7
|
+
export interface ScratchpadState {
|
|
8
|
+
lastScratchpadNudgeTurn: number;
|
|
9
|
+
claimsDetectedThisTurn: boolean;
|
|
10
|
+
claimsWithoutVerification: number;
|
|
11
|
+
verificationsDone: number;
|
|
12
|
+
lastThinkPerTurnNudge: number;
|
|
13
|
+
lastStartupNudge: number;
|
|
14
|
+
startupPlanShown: boolean;
|
|
15
|
+
toolsSinceLastPlan: number;
|
|
16
|
+
lastFinalizeNudge: number;
|
|
17
|
+
lastVerifyNudge: number;
|
|
18
|
+
lastInvestigationToolTurn: number;
|
|
19
|
+
lastPhaseNudgeTurn: number;
|
|
20
|
+
consecutiveInvestigationTurns: number;
|
|
21
|
+
taskComplexity: "simple" | "moderate" | "complex" | "unknown";
|
|
22
|
+
}
|
|
23
|
+
export declare function createScratchpadState(): ScratchpadState;
|
|
24
|
+
export declare function resetScratchpadState(s: ScratchpadState): void;
|
|
25
|
+
export interface ContextHygieneState {
|
|
26
|
+
contextNudgeSent: boolean;
|
|
27
|
+
lastContextCheckTurn: number;
|
|
28
|
+
lastCompactionTurn: number;
|
|
29
|
+
overflowRecently: number;
|
|
30
|
+
contextCheckInterval: number;
|
|
31
|
+
contextAuditThreshold: number;
|
|
32
|
+
/**
|
|
33
|
+
* Flag set by the context_compress tool before triggering compaction.
|
|
34
|
+
* The session_compact handler checks this flag to determine whether to
|
|
35
|
+
* auto-resume the agent (triggerTurn: true) after compaction.
|
|
36
|
+
* - If true (set by tool): auto-resume (agent-initiated compaction)
|
|
37
|
+
* - If false (unset): reason: "manual" means user typed /compress → skip
|
|
38
|
+
* reason: "threshold"|"overflow" means auto-compaction → auto-resume anyway
|
|
39
|
+
*/
|
|
40
|
+
autoResumeAfterCompaction: boolean;
|
|
41
|
+
/** Turn of the last post-cycle hygiene (auto-tag + inspect). Initialized to -100. */
|
|
42
|
+
lastPostCycleHygieneTurn: number;
|
|
43
|
+
/**
|
|
44
|
+
* Whether the turn immediately preceding the current state was a natural
|
|
45
|
+
* stop (assistant final response, stopReason "stop", no tool calls).
|
|
46
|
+
* Set on turn_end by dispatchTurnEndLoop (turn-end-handler.ts); cleared on
|
|
47
|
+
* turn_start so a new agent run after a natural stop (e.g. user re-prompt)
|
|
48
|
+
* does not carry a stale "natural stop" classification into a mid-work
|
|
49
|
+
* compaction. The session_compact re-orientation whisper reads this to
|
|
50
|
+
* decide triggerTurn: natural stop → advisory (no forced turn); mid-work
|
|
51
|
+
* → wake (compaction must hand the loop back).
|
|
52
|
+
*/
|
|
53
|
+
lastTurnWasNaturalStop: boolean;
|
|
54
|
+
/** Hygiene ACT counters: by trigger (token/percent/backstop) and kind (slide/summarize). */
|
|
55
|
+
contextHygieneActs: {
|
|
56
|
+
total: number;
|
|
57
|
+
byTrigger: Record<string, number>;
|
|
58
|
+
byKind: Record<string, number>;
|
|
59
|
+
lastDropped: number;
|
|
60
|
+
};
|
|
61
|
+
/** Turn-end hygiene checks skipped (no usage number, or compaction in progress). */
|
|
62
|
+
contextHygieneSkips: number;
|
|
63
|
+
/** Live usage tokens at turn end (last N samples, oldest first). */
|
|
64
|
+
liveUsageSamples: number[];
|
|
65
|
+
}
|
|
66
|
+
export declare function createContextHygieneState(): ContextHygieneState;
|
|
67
|
+
export declare function resetContextHygieneState(s: ContextHygieneState): void;
|
|
68
|
+
export type HygieneActTrigger = "token" | "percent" | "backstop";
|
|
69
|
+
export type HygieneActKind = "slide" | "summarize";
|
|
70
|
+
/** Record one hygiene ACT with its trigger, kind and dropped-entry count. */
|
|
71
|
+
export declare function recordHygieneAct(s: ContextHygieneState, trigger: HygieneActTrigger, kind: HygieneActKind, droppedEntries: number): void;
|
|
72
|
+
/** Count a turn-end hygiene check skipped without a usable usage number. */
|
|
73
|
+
export declare function recordHygieneSkip(s: ContextHygieneState): void;
|
|
74
|
+
/** Push one live-usage sample at turn end, keeping the last N. */
|
|
75
|
+
export declare function recordLiveUsageSample(s: ContextHygieneState, tokens: number): void;
|
|
76
|
+
/** Mark context nudge as sent (system sends nudge to agent). */
|
|
77
|
+
export declare function markNudgeSent(s: ContextHygieneState, turn: number): void;
|
|
78
|
+
/** Reset context nudge (e.g., after compaction freed space). */
|
|
79
|
+
export declare function resetNudge(s: ContextHygieneState): void;
|
|
80
|
+
/** Record that a context management tool was used. */
|
|
81
|
+
export declare function recordContextTool(s: ContextHygieneState, turn: number): void;
|
|
82
|
+
/** Record that compaction happened. Also resets scratchpad nudge timer. */
|
|
83
|
+
export declare function recordCompaction(s: ContextHygieneState & {
|
|
84
|
+
lastScratchpadNudgeTurn?: number;
|
|
85
|
+
}, turn: number): void;
|
|
86
|
+
/** Returns true if still in overflow recovery grace period. */
|
|
87
|
+
export declare function inOverflowRecovery(s: ContextHygieneState, currentTurn: number, graceTurns?: number): boolean;
|
|
88
|
+
//# sourceMappingURL=context-hygiene-state.d.ts.map
|