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,445 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Persisted-timer recovery — owning-session scoped.
|
|
3
|
+
*
|
|
4
|
+
* Lives here, in the timer module, because the invariant is the timer
|
|
5
|
+
* store's, not any caller's: the per-project store
|
|
6
|
+
* (pending-timers.jsonl, getTimerFilePath(cwd)) is SHARED by every session
|
|
7
|
+
* that runs in that project CWD — two panes each keep their own timers in
|
|
8
|
+
* this one file. Recovery sweeps the store at turn start; only records
|
|
9
|
+
* whose sessionId matches the current session may be delivered, re-armed,
|
|
10
|
+
* or restored into this process. A record from any other session must stay
|
|
11
|
+
* inert here: no whisper, no wake, no re-arm, no in-memory restoration
|
|
12
|
+
* (the predecessor session keeps servicing its own cadence with its own
|
|
13
|
+
* poller — a fresh session must never inherit its fires).
|
|
14
|
+
*
|
|
15
|
+
* Foreign-record pruning policy (why, and what it still admits):
|
|
16
|
+
*
|
|
17
|
+
* A foreign record is pruned from the store only when BOTH signals agree
|
|
18
|
+
* the owner is gone:
|
|
19
|
+
*
|
|
20
|
+
* 1. Overdue beyond FOREIGN_TIMER_PRUNE_OVERDUE_MS. A LIVE owner's poller
|
|
21
|
+
* services its own overdue timers within ~1s (the busy guard defers
|
|
22
|
+
* firing only for the duration of one tool call, far below the grace),
|
|
23
|
+
* and the fire path re-arms or removes the disk entry when it does.
|
|
24
|
+
* A record that sits overdue far past that grace is not being
|
|
25
|
+
* serviced by anyone.
|
|
26
|
+
* 2. The owner shows no session-store activity within
|
|
27
|
+
* FOREIGN_TIMER_PRUNE_OWNER_INACTIVITY_MS (pi-core's session files
|
|
28
|
+
* under ~/.pi/agent/sessions; missing file or stale mtime). The wide
|
|
29
|
+
* window keeps a live sibling that is mid-long-tool (fresh store
|
|
30
|
+
* writes stopped at tool start, timer overdue meanwhile) safely on the
|
|
31
|
+
* keep side.
|
|
32
|
+
*
|
|
33
|
+
* Unexpired foreign records are never touched: the owner may still be
|
|
34
|
+
* coming back to service them. Admitted failure mode: a foreign session
|
|
35
|
+
* whose process is paused (laptop asleep, SIGSTOP, hung) past BOTH
|
|
36
|
+
* windows loses its pending timer — it is indistinguishable from a dead
|
|
37
|
+
* session by store evidence alone. The next pruning sweep after the
|
|
38
|
+
* pause would remove a record the paused session would have fired on
|
|
39
|
+
* resume. A session file that cannot be located (never persisted,
|
|
40
|
+
* ephemeral mode, layout change) counts as "no evidence of life", so the
|
|
41
|
+
* same two windows decide.
|
|
42
|
+
*
|
|
43
|
+
* Legacy persisted shape: records without intervalMs are one-shots; every
|
|
44
|
+
* path here treats a missing/zero intervalMs as one-shot.
|
|
45
|
+
*/
|
|
46
|
+
import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
|
|
47
|
+
import { join } from "node:path";
|
|
48
|
+
import { getTimerFilePath, braidDir, AGENT } from "../../../lib/config/braid-paths.js";
|
|
49
|
+
import { writeTimerStore } from "./store-file.js";
|
|
50
|
+
import { restoreTimer, timerManager } from "./index.js";
|
|
51
|
+
import { wakeRetryQueue } from "./wake-retry.js";
|
|
52
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
53
|
+
const log = createLogger("timer-recovery");
|
|
54
|
+
/** Collapse stacked persisted timers before recovery. For each (sessionId,
|
|
55
|
+
* tag) group of TAGGED timers, keep only the newest entry (max createdAt,
|
|
56
|
+
* tiebreak max firesAt) and drop the rest. Untagged timers are distinct
|
|
57
|
+
* one-shots and are never deduped.
|
|
58
|
+
*
|
|
59
|
+
* Timer stacking: pending-timers.jsonl accumulated 5
|
|
60
|
+
* periodic-status timers across 3 sessions, and a single session carried
|
|
61
|
+
* BOTH the original (fires:0, expired) and the re-armed copy (fires:20, live)
|
|
62
|
+
* of the same logical timer — recovery re-armed every copy, so the original
|
|
63
|
+
* AND the re-armed copy both fired. Deduping by tag collapses the stack to
|
|
64
|
+
* the newest entry per (session, tag) before any fire/re-arm happens.
|
|
65
|
+
*/
|
|
66
|
+
export function dedupPersistedTimers(timers) {
|
|
67
|
+
const newestByKey = new Map();
|
|
68
|
+
const dropIds = new Set();
|
|
69
|
+
for (const t of timers) {
|
|
70
|
+
if (typeof t.tag !== "string" || t.tag.length === 0)
|
|
71
|
+
continue;
|
|
72
|
+
const key = `${t.sessionId ?? ""}\u0000${t.tag}`;
|
|
73
|
+
const existing = newestByKey.get(key);
|
|
74
|
+
if (!existing) {
|
|
75
|
+
newestByKey.set(key, t);
|
|
76
|
+
continue;
|
|
77
|
+
}
|
|
78
|
+
const keep = (t.createdAt ?? 0) > (existing.createdAt ?? 0) ||
|
|
79
|
+
((t.createdAt ?? 0) === (existing.createdAt ?? 0) &&
|
|
80
|
+
(t.firesAt ?? 0) > (existing.firesAt ?? 0));
|
|
81
|
+
if (keep) {
|
|
82
|
+
dropIds.add(existing.id);
|
|
83
|
+
newestByKey.set(key, t);
|
|
84
|
+
}
|
|
85
|
+
else {
|
|
86
|
+
dropIds.add(t.id);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
if (dropIds.size === 0)
|
|
90
|
+
return timers;
|
|
91
|
+
const deduped = timers.filter((t) => !dropIds.has(t.id));
|
|
92
|
+
log.info(`[timer] recovery: deduped ${timers.length - deduped.length} stacked persisted timer(s) by tag`);
|
|
93
|
+
return deduped;
|
|
94
|
+
}
|
|
95
|
+
/** True when the timer manager already holds a live equivalent of a persisted
|
|
96
|
+
* timer: same sessionId + tag (tagged timers are one-per-tag singletons), or
|
|
97
|
+
* same id for untagged timers (which are distinct per instance). When live,
|
|
98
|
+
* the poller owns firing and the fire path owns the disk entry (rearm/remove)
|
|
99
|
+
* — re-arming here would create a duplicate that ALSO fires. */
|
|
100
|
+
export function hasLiveEquivalent(t) {
|
|
101
|
+
const live = timerManager.listTimers(t.sessionId ?? "");
|
|
102
|
+
if (typeof t.tag === "string" && t.tag.length > 0) {
|
|
103
|
+
return live.some((x) => x.tag === t.tag);
|
|
104
|
+
}
|
|
105
|
+
return live.some((x) => x.id === t.id);
|
|
106
|
+
}
|
|
107
|
+
/** A foreign record must sit overdue longer than this before pruning is even
|
|
108
|
+
* considered: the owning process gets this long to service the fire itself
|
|
109
|
+
* (its poller re-arms/removes the disk entry when it does). Must comfortably
|
|
110
|
+
* exceed a busy sibling's longest tool call. */
|
|
111
|
+
export const FOREIGN_TIMER_PRUNE_OVERDUE_MS = 30 * 60_000;
|
|
112
|
+
/** The owning session must be silent in pi-core's session store at least this
|
|
113
|
+
* long before an overdue-beyond-grace foreign record may be pruned. Wide by
|
|
114
|
+
* design: a live sibling mid-long-tool writes nothing to the session store
|
|
115
|
+
* while its overdue fire waits. */
|
|
116
|
+
export const FOREIGN_TIMER_PRUNE_OWNER_INACTIVITY_MS = 24 * 60 * 60_000;
|
|
117
|
+
// Sessions dir indirection for tests only (no module-level let — the
|
|
118
|
+
// factoryState/sessionState object pattern): null = real sessions store.
|
|
119
|
+
const sessionsDirState = { override: null };
|
|
120
|
+
/** Test hook: pin the sessions store root for owner-liveness lookups.
|
|
121
|
+
* null restores the real store (AGENT/sessions). */
|
|
122
|
+
export function _setSessionsDirForTests(dir) {
|
|
123
|
+
sessionsDirState.override = dir;
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Last-activity evidence for one session id: the mtime of its session file
|
|
127
|
+
* in pi-core's store (files are named "..._<sessionId>.jsonl"), or null when
|
|
128
|
+
* no file can be found. Two-level readdir only — sessions/<project>/*.jsonl;
|
|
129
|
+
* a deeper future layout reads as "no evidence of life" (see the pruning
|
|
130
|
+
* policy's admitted failure mode). Called only for foreign records overdue
|
|
131
|
+
* beyond the servicing grace, never on the hot path.
|
|
132
|
+
*/
|
|
133
|
+
function sessionStoreMtime(sessionId) {
|
|
134
|
+
if (typeof sessionId !== "string" || sessionId.length === 0)
|
|
135
|
+
return null;
|
|
136
|
+
const dir = sessionsDirState.override ?? join(AGENT, "sessions");
|
|
137
|
+
let projects;
|
|
138
|
+
try {
|
|
139
|
+
projects = readdirSync(dir, { withFileTypes: true });
|
|
140
|
+
}
|
|
141
|
+
catch {
|
|
142
|
+
return null;
|
|
143
|
+
}
|
|
144
|
+
for (const p of projects) {
|
|
145
|
+
if (!p.isDirectory())
|
|
146
|
+
continue;
|
|
147
|
+
const projectDir = join(dir, p.name);
|
|
148
|
+
let files;
|
|
149
|
+
try {
|
|
150
|
+
files = readdirSync(projectDir);
|
|
151
|
+
}
|
|
152
|
+
catch {
|
|
153
|
+
continue;
|
|
154
|
+
}
|
|
155
|
+
for (const f of files) {
|
|
156
|
+
if (!f.endsWith(".jsonl") || !f.includes(sessionId))
|
|
157
|
+
continue;
|
|
158
|
+
try {
|
|
159
|
+
return statSync(join(projectDir, f)).mtimeMs;
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
return null;
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
return null;
|
|
167
|
+
}
|
|
168
|
+
/** Keep-or-prune verdict for a FOREIGN persisted record (never called for
|
|
169
|
+
* records owned by the current session). See the module header for the
|
|
170
|
+
* policy and its admitted failure mode. */
|
|
171
|
+
function foreignRecordVerdict(t, now) {
|
|
172
|
+
// Unexpired: the owner may still service it on return — never touch.
|
|
173
|
+
if (!(t.firesAt <= now))
|
|
174
|
+
return "keep";
|
|
175
|
+
if (now - t.firesAt <= FOREIGN_TIMER_PRUNE_OVERDUE_MS)
|
|
176
|
+
return "keep";
|
|
177
|
+
const mtime = sessionStoreMtime(t.sessionId);
|
|
178
|
+
if (mtime !== null && now - mtime <= FOREIGN_TIMER_PRUNE_OWNER_INACTIVITY_MS)
|
|
179
|
+
return "keep";
|
|
180
|
+
return "prune";
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* Retention sweep: bound the growth of EVERY per-project timer store under
|
|
184
|
+
* braidDir()/projects, including stores whose project no session ever runs
|
|
185
|
+
* in again. The per-turn sweep (recoverPersistedTimers) prunes foreign
|
|
186
|
+
* zombies only in the CURRENT project — a dormant store (e.g. a test cwd)
|
|
187
|
+
* accumulated fixture records for ever because no sweep ever runs there.
|
|
188
|
+
*
|
|
189
|
+
* The cap reuses the foreign-zombie policy's two signals, so "conservative"
|
|
190
|
+
* means "the same bar the store already applies, applied globally": a record
|
|
191
|
+
* is dropped only when it is overdue beyond FOREIGN_TIMER_PRUNE_OVERDUE_MS
|
|
192
|
+
* (30 min — a live owner's poller services its own fires within ~1s, so 30
|
|
193
|
+
* minutes means nobody is servicing it) AND its owner shows no session-store
|
|
194
|
+
* life within FOREIGN_TIMER_PRUNE_OWNER_INACTIVITY_MS (24 h) or has no
|
|
195
|
+
* session file at all. That bounds the population to records of dead-or-never-
|
|
196
|
+
* persisted sessions; live owners (fresh or recent store activity) and any
|
|
197
|
+
* unexpired record always survive.
|
|
198
|
+
*
|
|
199
|
+
* Never touched: the current session's own records (their owner file may not
|
|
200
|
+
* exist yet before the first persisted message, or be stale after a long
|
|
201
|
+
* sleep — recovery depends on them), unparsable lines (kept verbatim —
|
|
202
|
+
* never drop what cannot be classified), and non-number firesAt (reads as
|
|
203
|
+
* unexpired). Runs once per session_start, not per turn: dormant stores get
|
|
204
|
+
* serviced without adding cost to the hot turn path. Rewrites a store
|
|
205
|
+
* line-verbatim (no re-serialization of foreign records); a store pruned to
|
|
206
|
+
* nothing is removed, its directory with it. Non-fatal on any
|
|
207
|
+
* per-file error.
|
|
208
|
+
*/
|
|
209
|
+
export function sweepProjectStoresRetention(currentSessionId) {
|
|
210
|
+
try {
|
|
211
|
+
const projectsDir = join(braidDir(), "projects");
|
|
212
|
+
let projectDirs;
|
|
213
|
+
try {
|
|
214
|
+
projectDirs = readdirSync(projectsDir, { withFileTypes: true });
|
|
215
|
+
}
|
|
216
|
+
catch {
|
|
217
|
+
return; // no projects dir (fresh braid home) — nothing to sweep
|
|
218
|
+
}
|
|
219
|
+
const now = Date.now();
|
|
220
|
+
for (const p of projectDirs) {
|
|
221
|
+
if (!p.isDirectory())
|
|
222
|
+
continue;
|
|
223
|
+
const storeFile = join(projectsDir, p.name, "pending-timers.jsonl");
|
|
224
|
+
let raw;
|
|
225
|
+
try {
|
|
226
|
+
raw = readFileSync(storeFile, "utf-8");
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
continue; // no store in this project
|
|
230
|
+
}
|
|
231
|
+
const lines = raw.split("\n").filter((l) => l.length > 0);
|
|
232
|
+
const kept = [];
|
|
233
|
+
let dropped = 0;
|
|
234
|
+
for (const line of lines) {
|
|
235
|
+
let record;
|
|
236
|
+
try {
|
|
237
|
+
record = JSON.parse(line);
|
|
238
|
+
}
|
|
239
|
+
catch {
|
|
240
|
+
kept.push(line);
|
|
241
|
+
continue;
|
|
242
|
+
}
|
|
243
|
+
if (currentSessionId !== undefined && record?.sessionId === currentSessionId) {
|
|
244
|
+
kept.push(line);
|
|
245
|
+
continue;
|
|
246
|
+
}
|
|
247
|
+
if (foreignRecordVerdict(record, now) === "prune") {
|
|
248
|
+
dropped++;
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
kept.push(line);
|
|
252
|
+
}
|
|
253
|
+
if (dropped === 0)
|
|
254
|
+
continue;
|
|
255
|
+
// A pruned-to-nothing store is removed, not rewritten empty: the
|
|
256
|
+
// emptied file would leave its directory behind for ever.
|
|
257
|
+
writeTimerStore(storeFile, kept);
|
|
258
|
+
log.info(`[timer] retention: dropped ${dropped} unserviceable timer record(s) from ${p.name}`);
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
catch {
|
|
262
|
+
/* non-fatal: retention must never break session start */
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Recover persisted timers that expired during a process gap (e.g. /reload).
|
|
267
|
+
* Reads PENDING_TIMERS_FILE; expired ones are PARKED for post-settle delivery
|
|
268
|
+
* (deferRecoveredFire — never fired inline in before_agent_start, the
|
|
269
|
+
* competing-turn window) and the file is rewritten with only the unexpired
|
|
270
|
+
* timers remaining (removed once nothing remains). FlushRecoveredFires() (timer extension agent_settled
|
|
271
|
+
* handler + fallback listener) delivers the parked fires.
|
|
272
|
+
* Called once per before_agent_start (every turn) but cheap: empty file = no-op.
|
|
273
|
+
*
|
|
274
|
+
* ── OWNING-SESSION SCOPING ──────────────────────────────────────────────
|
|
275
|
+
* `currentSessionId` (the caller's ctx.sessionManager.getSessionId()) makes
|
|
276
|
+
* the sweep owner-scoped: records with a different sessionId are never
|
|
277
|
+
* delivered, re-armed, or restored into this process — they are kept on
|
|
278
|
+
* disk verbatim unless the pruning policy proves the owner gone. The
|
|
279
|
+
* per-project store is shared by sibling sessions; the shared invariant
|
|
280
|
+
* lives here (in the timer module), not in any caller.
|
|
281
|
+
*
|
|
282
|
+
* Legacy contract: called WITHOUT a session id (the direct test surface,
|
|
283
|
+
* where no session manager exists), the sweep runs unscoped over every
|
|
284
|
+
* record — the pre-scoping behavior. Production callers MUST pass the id;
|
|
285
|
+
* an unresolvable one (getSessionIdSafe's "?" sentinel) scopes to nothing,
|
|
286
|
+
* which is the safe direction: every record goes inert here.
|
|
287
|
+
*
|
|
288
|
+
* Hardening (stacking/double-fire):
|
|
289
|
+
* - dedupPersistedTimers collapses stacked copies of the same logical
|
|
290
|
+
* (session, tag) timer before processing, so a stale expired duplicate
|
|
291
|
+
* is dropped instead of fired alongside the live re-armed copy.
|
|
292
|
+
* Scoped mode dedups ONLY the owning session's records — a foreign
|
|
293
|
+
* record is never rewritten by another session's recovery.
|
|
294
|
+
* - hasLiveEquivalent skips fire/re-arm for a timer the poller already
|
|
295
|
+
* owns — recovery runs every turn, and re-arming a still-live timer
|
|
296
|
+
* created a duplicate (original + re-armed copy both fire).
|
|
297
|
+
* Expired fires defer to the agent_settled flush (never inline in
|
|
298
|
+
* before_agent_start, the competing-turn window) — a
|
|
299
|
+
* wake:true fire starts its own turn and failed deliveries retry with
|
|
300
|
+
* bounded backoff (wake-retry.ts).
|
|
301
|
+
*/
|
|
302
|
+
export function recoverPersistedTimers(_pi, currentSessionId) {
|
|
303
|
+
try {
|
|
304
|
+
const timerFile = getTimerFilePath(process.cwd());
|
|
305
|
+
if (!existsSync(timerFile))
|
|
306
|
+
return;
|
|
307
|
+
const raw = readFileSync(timerFile, "utf-8").trim();
|
|
308
|
+
if (!raw)
|
|
309
|
+
return;
|
|
310
|
+
const all = raw.split("\n").map((l) => JSON.parse(l));
|
|
311
|
+
let timers;
|
|
312
|
+
if (currentSessionId === undefined) {
|
|
313
|
+
// Legacy unscoped sweep: the owning session is unknown (direct test
|
|
314
|
+
// surface). Production always passes the id — that path never lands
|
|
315
|
+
// here.
|
|
316
|
+
timers = dedupPersistedTimers(all);
|
|
317
|
+
}
|
|
318
|
+
else {
|
|
319
|
+
// Dedup only the owning session's records; foreign records pass
|
|
320
|
+
// through verbatim (this process must not rewrite another session's
|
|
321
|
+
// entries).
|
|
322
|
+
timers = [
|
|
323
|
+
...dedupPersistedTimers(all.filter((t) => t.sessionId === currentSessionId)),
|
|
324
|
+
...all.filter((t) => t.sessionId !== currentSessionId),
|
|
325
|
+
];
|
|
326
|
+
}
|
|
327
|
+
const now = Date.now();
|
|
328
|
+
const remaining = [];
|
|
329
|
+
let fired = 0;
|
|
330
|
+
let restored = 0;
|
|
331
|
+
let foreignKept = 0;
|
|
332
|
+
let foreignPruned = 0;
|
|
333
|
+
for (const t of timers) {
|
|
334
|
+
// Foreign records: inert in this process.
|
|
335
|
+
// A record whose sessionId differs from the current session belongs
|
|
336
|
+
// to another session sharing this project store. Never delivered,
|
|
337
|
+
// never re-armed, never restored into memory — the poller below only
|
|
338
|
+
// ever fires the current session's bucket. Kept on disk unless the
|
|
339
|
+
// pruning policy (module header) proves the owner gone.
|
|
340
|
+
if (currentSessionId !== undefined && t.sessionId !== currentSessionId) {
|
|
341
|
+
if (foreignRecordVerdict(t, now) === "keep") {
|
|
342
|
+
remaining.push(t);
|
|
343
|
+
foreignKept++;
|
|
344
|
+
}
|
|
345
|
+
else {
|
|
346
|
+
foreignPruned++;
|
|
347
|
+
log.info(`[timer] recovery: pruned foreign timer ${t.id} (session=${t.sessionId ?? "none"}, ` +
|
|
348
|
+
`overdue ${Math.round((now - t.firesAt) / 60000)}m, owner inactive in session store)`);
|
|
349
|
+
}
|
|
350
|
+
continue;
|
|
351
|
+
}
|
|
352
|
+
// A live equivalent already exists in the timer manager (same session
|
|
353
|
+
// + tag, or same id for untagged): the poller owns it. Skip — re-arming
|
|
354
|
+
// would create a duplicate that ALSO fires (original +
|
|
355
|
+
// re-armed copy both fire). The live timer's fire path owns the disk
|
|
356
|
+
// entry (rearm/remove), so keep the entry as-is.
|
|
357
|
+
if (hasLiveEquivalent(t)) {
|
|
358
|
+
remaining.push(t);
|
|
359
|
+
continue;
|
|
360
|
+
}
|
|
361
|
+
const isRecurring = typeof t.intervalMs === "number" && t.intervalMs > 0;
|
|
362
|
+
if (t.firesAt <= now) {
|
|
363
|
+
// Do NOT deliver inline. This runs inside `before_agent_start`,
|
|
364
|
+
// where a turn is already starting: a triggerTurn here races the
|
|
365
|
+
// pre-flight (pi-core activeRun guard — the competing-turn bug), and
|
|
366
|
+
// a steer here dies with the run if the pre-flight aborts (provider
|
|
367
|
+
// 401: no agent loop, no event). Park the fire; the timer
|
|
368
|
+
// extension's agent_settled handler (plus the fallback listener
|
|
369
|
+
// registered below) flushes it POST-SETTLE via flushRecoveredFires()
|
|
370
|
+
// — where a wake:true fire safely starts its own turn and feeds the
|
|
371
|
+
// failed-wake retry queue. The [braid-whisper - timer] envelope stays
|
|
372
|
+
// canonical; no inline sub-tag.
|
|
373
|
+
try {
|
|
374
|
+
wakeRetryQueue.deferRecoveredFire({
|
|
375
|
+
id: t.id,
|
|
376
|
+
sessionId: t.sessionId,
|
|
377
|
+
reason: t.reason,
|
|
378
|
+
tag: t.tag,
|
|
379
|
+
createdAt: t.createdAt,
|
|
380
|
+
firesAt: t.firesAt,
|
|
381
|
+
wake: t.wake === true,
|
|
382
|
+
});
|
|
383
|
+
fired++;
|
|
384
|
+
if (isRecurring) {
|
|
385
|
+
// Recurring timer that expired during the process gap: fire the
|
|
386
|
+
// overdue tick but DON'T drop the recurrence — re-arm with the
|
|
387
|
+
// next cadence (same max() anti-catch-up formula as the live
|
|
388
|
+
// expiry path) so it keeps recurring after the reload. The fires
|
|
389
|
+
// counter advances too; a bounded recurrence whose count is now
|
|
390
|
+
// exhausted is DONE and is dropped (not re-armed, not kept on
|
|
391
|
+
// disk) so it cannot resurrect.
|
|
392
|
+
const fires = (typeof t.fires === "number" ? t.fires : 0) + 1;
|
|
393
|
+
if (t.count === undefined || fires < t.count) {
|
|
394
|
+
const nextFiresAt = Math.max(t.firesAt + t.intervalMs, now + t.intervalMs);
|
|
395
|
+
const newId = restoreTimer(t.sessionId, nextFiresAt - now, t.reason, t.tag, t.wake === true, t.intervalMs, t.count, fires);
|
|
396
|
+
remaining.push({
|
|
397
|
+
...t,
|
|
398
|
+
id: newId,
|
|
399
|
+
firesAt: nextFiresAt,
|
|
400
|
+
intervalMs: t.intervalMs,
|
|
401
|
+
count: t.count,
|
|
402
|
+
fires,
|
|
403
|
+
});
|
|
404
|
+
restored++;
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
}
|
|
408
|
+
catch {
|
|
409
|
+
remaining.push(t);
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
else {
|
|
413
|
+
// Re-arm unexpired timers into memory so the poller fires them on schedule.
|
|
414
|
+
// restoreTimer() returns a new id; rewrite the disk entry with it.
|
|
415
|
+
// intervalMs + count + fires are threaded through so a persisted
|
|
416
|
+
// recurring timer keeps recurring after the reload (not just the next
|
|
417
|
+
// single fire), and a bounded recurrence resumes mid-cadence.
|
|
418
|
+
try {
|
|
419
|
+
const newId = restoreTimer(t.sessionId, t.firesAt - now, t.reason, t.tag, t.wake === true, t.intervalMs, t.count, t.fires);
|
|
420
|
+
remaining.push({ ...t, id: newId });
|
|
421
|
+
restored++;
|
|
422
|
+
}
|
|
423
|
+
catch {
|
|
424
|
+
remaining.push(t);
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
writeTimerStore(timerFile, remaining.map((t) => JSON.stringify(t)));
|
|
429
|
+
if (fired > 0)
|
|
430
|
+
log.info(`[timer] deferred ${fired} recovered persisted timer(s) to post-settle flush`);
|
|
431
|
+
if (restored > 0)
|
|
432
|
+
log.info(`[timer] re-armed ${restored} unexpired persisted timer(s)`);
|
|
433
|
+
if (foreignKept > 0)
|
|
434
|
+
log.info(`[timer] recovery: ${foreignKept} foreign-session timer(s) left inert ` +
|
|
435
|
+
`(not owned by session ${currentSessionId})`);
|
|
436
|
+
if (foreignPruned > 0)
|
|
437
|
+
log.info(`[timer] recovery: pruned ${foreignPruned} foreign-session timer(s) ` +
|
|
438
|
+
`(overdue beyond ${Math.round(FOREIGN_TIMER_PRUNE_OVERDUE_MS / 60000)}m, ` +
|
|
439
|
+
`owner inactive ${Math.round(FOREIGN_TIMER_PRUNE_OWNER_INACTIVITY_MS / 3600000)}h)`);
|
|
440
|
+
}
|
|
441
|
+
catch {
|
|
442
|
+
/* non-fatal */
|
|
443
|
+
}
|
|
444
|
+
}
|
|
445
|
+
//# sourceMappingURL=recovery.js.map
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The per-project timer store's write path.
|
|
3
|
+
*
|
|
4
|
+
* The store lives at getTimerFilePath(cwd) — one pending-timers.jsonl per
|
|
5
|
+
* project CWD under braidDir()/projects/<sanitized-cwd>/. Every writer of
|
|
6
|
+
* that file goes through here, because the file and its directory are one
|
|
7
|
+
* artefact: a store with nothing to persist is not a store.
|
|
8
|
+
*
|
|
9
|
+
* Writing an empty store instead (mkdir + a file holding "\n" or "") leaves
|
|
10
|
+
* a file for ever, and the directory with it — one per cwd, including every
|
|
11
|
+
* cwd that only ever existed for the length of a test run. Deleting is
|
|
12
|
+
* behaviour-preserving for every reader:
|
|
13
|
+
*
|
|
14
|
+
* - loadPendingTimers (index.ts) returns [] for a missing file and for an
|
|
15
|
+
* empty one;
|
|
16
|
+
* - recoverPersistedTimers (recovery.ts) returns on !existsSync and on an
|
|
17
|
+
* empty read;
|
|
18
|
+
* - sweepProjectStoresRetention (recovery.ts) skips a directory with no
|
|
19
|
+
* store and a store with no lines alike.
|
|
20
|
+
*
|
|
21
|
+
* The path stays a generic mechanism: it keys on a cwd and knows nothing
|
|
22
|
+
* about which cwds are "real". Whether it may also remove the directory is
|
|
23
|
+
* decided by what the directory holds — a project directory that carries
|
|
24
|
+
* other per-cwd state (locks.json, workers.json) survives, because a
|
|
25
|
+
* non-recursive rmdir only succeeds on an empty one.
|
|
26
|
+
*/
|
|
27
|
+
/**
|
|
28
|
+
* Persist `lines` (already serialized records) as the store at `file`, or
|
|
29
|
+
* remove the store when there is nothing to persist.
|
|
30
|
+
*/
|
|
31
|
+
export declare function writeTimerStore(file: string, lines: string[]): void;
|
|
32
|
+
/**
|
|
33
|
+
* Remove the store file, and its directory when that leaves the directory
|
|
34
|
+
* empty. Only a per-project store directory is ever removed: the legacy flat
|
|
35
|
+
* store beside braidDir() must not take the braid home down with it.
|
|
36
|
+
*/
|
|
37
|
+
export declare function removeTimerStore(file: string): void;
|
|
38
|
+
//# sourceMappingURL=store-file.d.ts.map
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The per-project timer store's write path.
|
|
3
|
+
*
|
|
4
|
+
* The store lives at getTimerFilePath(cwd) — one pending-timers.jsonl per
|
|
5
|
+
* project CWD under braidDir()/projects/<sanitized-cwd>/. Every writer of
|
|
6
|
+
* that file goes through here, because the file and its directory are one
|
|
7
|
+
* artefact: a store with nothing to persist is not a store.
|
|
8
|
+
*
|
|
9
|
+
* Writing an empty store instead (mkdir + a file holding "\n" or "") leaves
|
|
10
|
+
* a file for ever, and the directory with it — one per cwd, including every
|
|
11
|
+
* cwd that only ever existed for the length of a test run. Deleting is
|
|
12
|
+
* behaviour-preserving for every reader:
|
|
13
|
+
*
|
|
14
|
+
* - loadPendingTimers (index.ts) returns [] for a missing file and for an
|
|
15
|
+
* empty one;
|
|
16
|
+
* - recoverPersistedTimers (recovery.ts) returns on !existsSync and on an
|
|
17
|
+
* empty read;
|
|
18
|
+
* - sweepProjectStoresRetention (recovery.ts) skips a directory with no
|
|
19
|
+
* store and a store with no lines alike.
|
|
20
|
+
*
|
|
21
|
+
* The path stays a generic mechanism: it keys on a cwd and knows nothing
|
|
22
|
+
* about which cwds are "real". Whether it may also remove the directory is
|
|
23
|
+
* decided by what the directory holds — a project directory that carries
|
|
24
|
+
* other per-cwd state (locks.json, workers.json) survives, because a
|
|
25
|
+
* non-recursive rmdir only succeeds on an empty one.
|
|
26
|
+
*/
|
|
27
|
+
import { rmSync, rmdirSync, mkdirSync, writeFileSync } from "node:fs";
|
|
28
|
+
import { dirname } from "node:path";
|
|
29
|
+
import { braidDir } from "../../../lib/config/braid-paths.js";
|
|
30
|
+
/**
|
|
31
|
+
* Persist `lines` (already serialized records) as the store at `file`, or
|
|
32
|
+
* remove the store when there is nothing to persist.
|
|
33
|
+
*/
|
|
34
|
+
export function writeTimerStore(file, lines) {
|
|
35
|
+
if (lines.length === 0) {
|
|
36
|
+
removeTimerStore(file);
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
40
|
+
writeFileSync(file, lines.join("\n") + "\n", "utf-8");
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Remove the store file, and its directory when that leaves the directory
|
|
44
|
+
* empty. Only a per-project store directory is ever removed: the legacy flat
|
|
45
|
+
* store beside braidDir() must not take the braid home down with it.
|
|
46
|
+
*/
|
|
47
|
+
export function removeTimerStore(file) {
|
|
48
|
+
rmSync(file, { force: true });
|
|
49
|
+
if (dirname(file) === braidDir())
|
|
50
|
+
return;
|
|
51
|
+
try {
|
|
52
|
+
rmdirSync(dirname(file));
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
// Directory still holds other per-cwd state (locks, workers), or is
|
|
56
|
+
// already gone: either way the store is removed, which is the job.
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=store-file.js.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Timer Manager - per-session timer store and CRUD operations.
|
|
3
|
+
*
|
|
4
|
+
* Manages scheduled timers keyed by sessionId. Each session has its own
|
|
5
|
+
* inner map, so cross-session operations are impossible. The outer map
|
|
6
|
+
* is a module-level singleton — this is the global registry.
|
|
7
|
+
*/
|
|
8
|
+
import type { ScheduledTimer } from "../../../lib/events/timer-types.js";
|
|
9
|
+
export declare class TimerManager {
|
|
10
|
+
private timersBySession;
|
|
11
|
+
setTimer(sessionId: string, delayMs: number, reason: string, tag?: string, wake?: boolean, intervalMs?: number, count?: number, firedCount?: number): string;
|
|
12
|
+
cancelTimer(sessionId: string, id: string): boolean;
|
|
13
|
+
clearSession(sessionId: string): number;
|
|
14
|
+
listTimers(sessionId: string): ScheduledTimer[];
|
|
15
|
+
checkExpired(sessionId: string, nowMs: number): ScheduledTimer[];
|
|
16
|
+
cancelTimersByTag(sessionId: string, tag: string): number;
|
|
17
|
+
getActiveCount(sessionId: string): number;
|
|
18
|
+
getTotalCount(): number;
|
|
19
|
+
}
|
|
20
|
+
export declare const timerManager: TimerManager;
|
|
21
|
+
//# sourceMappingURL=timer-manager.d.ts.map
|