pi-braid 0.0.0-stage → 0.40.1
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 +266 -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 +166 -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 +502 -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,143 @@
|
|
|
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 { nextId } from "../../../lib/utils/id.js";
|
|
9
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
10
|
+
const log = createLogger("timer-manager");
|
|
11
|
+
export class TimerManager {
|
|
12
|
+
timersBySession = new Map();
|
|
13
|
+
setTimer(sessionId, delayMs, reason, tag, wake = true, intervalMs, count, firedCount) {
|
|
14
|
+
const id = nextId("timer");
|
|
15
|
+
const firesAt = Date.now() + delayMs;
|
|
16
|
+
const recurring = !!(intervalMs && intervalMs > 0);
|
|
17
|
+
let sessionTimers = this.timersBySession.get(sessionId);
|
|
18
|
+
if (!sessionTimers) {
|
|
19
|
+
sessionTimers = new Map();
|
|
20
|
+
this.timersBySession.set(sessionId, sessionTimers);
|
|
21
|
+
}
|
|
22
|
+
sessionTimers.set(id, {
|
|
23
|
+
id,
|
|
24
|
+
firesAt,
|
|
25
|
+
reason,
|
|
26
|
+
tag,
|
|
27
|
+
createdAt: Date.now(),
|
|
28
|
+
wake,
|
|
29
|
+
sessionId,
|
|
30
|
+
...(recurring
|
|
31
|
+
? {
|
|
32
|
+
intervalMs,
|
|
33
|
+
fires: firedCount ?? 0,
|
|
34
|
+
...(count !== undefined ? { count } : {}),
|
|
35
|
+
}
|
|
36
|
+
: {}),
|
|
37
|
+
});
|
|
38
|
+
const repeatTail = recurring
|
|
39
|
+
? ` every ${Math.round(intervalMs / 1000)}s${count !== undefined ? ` x${count}` : " (until cancelled)"}`
|
|
40
|
+
: "";
|
|
41
|
+
log.info(`[timer] set: ${id} session=${sessionId} fires in ${Math.round(delayMs / 1000)}s - ${reason}${wake ? " (wake)" : " (silent)"}${repeatTail}`);
|
|
42
|
+
return id;
|
|
43
|
+
}
|
|
44
|
+
cancelTimer(sessionId, id) {
|
|
45
|
+
const sessionTimers = this.timersBySession.get(sessionId);
|
|
46
|
+
if (!sessionTimers)
|
|
47
|
+
return false;
|
|
48
|
+
const deleted = sessionTimers.delete(id);
|
|
49
|
+
if (deleted)
|
|
50
|
+
log.info(`[timer] cancelled: ${id} (session=${sessionId})`);
|
|
51
|
+
return deleted;
|
|
52
|
+
}
|
|
53
|
+
clearSession(sessionId) {
|
|
54
|
+
const sessionTimers = this.timersBySession.get(sessionId);
|
|
55
|
+
if (!sessionTimers)
|
|
56
|
+
return 0;
|
|
57
|
+
const n = sessionTimers.size;
|
|
58
|
+
this.timersBySession.delete(sessionId);
|
|
59
|
+
if (n > 0)
|
|
60
|
+
log.info(`[timer] cleared session ${sessionId}: ${n} timer(s)`);
|
|
61
|
+
return n;
|
|
62
|
+
}
|
|
63
|
+
listTimers(sessionId) {
|
|
64
|
+
const sessionTimers = this.timersBySession.get(sessionId);
|
|
65
|
+
if (!sessionTimers)
|
|
66
|
+
return [];
|
|
67
|
+
return Array.from(sessionTimers.values()).sort((a, b) => a.firesAt - b.firesAt);
|
|
68
|
+
}
|
|
69
|
+
checkExpired(sessionId, nowMs) {
|
|
70
|
+
const sessionTimers = this.timersBySession.get(sessionId);
|
|
71
|
+
if (!sessionTimers)
|
|
72
|
+
return [];
|
|
73
|
+
const expired = [];
|
|
74
|
+
for (const [id, timer] of sessionTimers) {
|
|
75
|
+
if (timer.firesAt <= nowMs) {
|
|
76
|
+
if (timer.intervalMs && timer.intervalMs > 0) {
|
|
77
|
+
// Recurring timer: keep it in the session map and re-arm to the
|
|
78
|
+
// next cadence. Math.max(prev + interval, now + interval) means a
|
|
79
|
+
// timer that is many intervals overdue (poll gap, busy guard,
|
|
80
|
+
// compaction, process sleep) fires ONE tick and re-arms from
|
|
81
|
+
// "now + interval" — never a catch-up burst of N missed ticks.
|
|
82
|
+
// The re-arm is done synchronously/in-place on the live map entry,
|
|
83
|
+
// so any second checkExpired() call in the same tick sees the
|
|
84
|
+
// future firesAt and cannot double-fire or double-advance.
|
|
85
|
+
const fires = (timer.fires ?? 0) + 1;
|
|
86
|
+
// The delivered snapshot carries the fire number for THIS delivery
|
|
87
|
+
// and keeps the ORIGINAL firesAt (the fire time — used for
|
|
88
|
+
// elapsed-time metadata).
|
|
89
|
+
const snapshot = { ...timer, fires };
|
|
90
|
+
if (timer.count !== undefined && fires >= timer.count) {
|
|
91
|
+
// Count exhausted (bounded recurrence): like a one-shot,
|
|
92
|
+
// delete-on-detection removes it permanently. The fire path
|
|
93
|
+
// removes the disk entry too, so it cannot resurrect on reload.
|
|
94
|
+
sessionTimers.delete(id);
|
|
95
|
+
log.info(`[timer] fired + completed: ${id} (session=${sessionId}) - ${timer.reason} (${fires}/${timer.count})`);
|
|
96
|
+
}
|
|
97
|
+
else {
|
|
98
|
+
timer.fires = fires;
|
|
99
|
+
timer.firesAt = Math.max(timer.firesAt + timer.intervalMs, nowMs + timer.intervalMs);
|
|
100
|
+
log.info(`[timer] fired + re-armed: ${id} (session=${sessionId}) - ${timer.reason} (${fires}/${timer.count ?? "∞"}) next in ${Math.round(timer.intervalMs / 1000)}s`);
|
|
101
|
+
}
|
|
102
|
+
expired.push(snapshot);
|
|
103
|
+
}
|
|
104
|
+
else {
|
|
105
|
+
// One-shot (default): delete-on-detection keeps exactly-once
|
|
106
|
+
// semantics — no poll tick can return the same timer twice.
|
|
107
|
+
const snapshot = { ...timer };
|
|
108
|
+
sessionTimers.delete(id);
|
|
109
|
+
log.info(`[timer] fired: ${id} (session=${sessionId}) - ${timer.reason}`);
|
|
110
|
+
expired.push(snapshot);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
return expired;
|
|
115
|
+
}
|
|
116
|
+
cancelTimersByTag(sessionId, tag) {
|
|
117
|
+
const sessionTimers = this.timersBySession.get(sessionId);
|
|
118
|
+
if (!sessionTimers)
|
|
119
|
+
return 0;
|
|
120
|
+
let cancelled = 0;
|
|
121
|
+
for (const [id, t] of sessionTimers) {
|
|
122
|
+
if (t.tag === tag) {
|
|
123
|
+
sessionTimers.delete(id);
|
|
124
|
+
cancelled++;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
if (cancelled > 0) {
|
|
128
|
+
log.info(`[timer] cancelled ${cancelled} timer(s) with tag="${tag}" (session=${sessionId})`);
|
|
129
|
+
}
|
|
130
|
+
return cancelled;
|
|
131
|
+
}
|
|
132
|
+
getActiveCount(sessionId) {
|
|
133
|
+
return this.timersBySession.get(sessionId)?.size ?? 0;
|
|
134
|
+
}
|
|
135
|
+
getTotalCount() {
|
|
136
|
+
let n = 0;
|
|
137
|
+
for (const s of this.timersBySession.values())
|
|
138
|
+
n += s.size;
|
|
139
|
+
return n;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
export const timerManager = new TimerManager();
|
|
143
|
+
//# sourceMappingURL=timer-manager.js.map
|
|
@@ -0,0 +1,455 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wake-retry queue — timer wake reliability.
|
|
3
|
+
*
|
|
4
|
+
* Four related guarantees live here:
|
|
5
|
+
*
|
|
6
|
+
* 1. FAILED-WAKE RETRY: a wake fire (triggerTurn:true) whose turn
|
|
7
|
+
* FAILS with a provider/auth error (assistant stopReason "error") must not
|
|
8
|
+
* sit in history until an unrelated turn processes it, surfacing hours
|
|
9
|
+
* later. The queue tracks every delivered wake fire as "outstanding"; a
|
|
10
|
+
* failed run (onAgentEnd(true) + onAgentSettled()) re-arms it for
|
|
11
|
+
* redelivery with bounded exponential backoff (5s/15s/45s/2m/5m, capped —
|
|
12
|
+
* default 3 redeliveries, braid.timers.maxWakeAttempts). A wake whose turn
|
|
13
|
+
* never produced an outcome (pi-core pre-flight abort emits NO extension
|
|
14
|
+
* event) times out after WAKE_OUTCOME_TIMEOUT_MS and retries anyway. A
|
|
15
|
+
* wake fire is therefore never silently lost.
|
|
16
|
+
*
|
|
17
|
+
* 1b. BUSY-SEND DEFERRAL: a wake whose SEND was held back because the
|
|
18
|
+
* session was busy at send time (isAgentBusy() — compaction or run
|
|
19
|
+
* bookkeeping; a raw triggerTurn there would start a competing agent
|
|
20
|
+
* run) re-enters this queue via deferBusyWake() and redelivers on the
|
|
21
|
+
* same bounded ladder, with an honest "held while busy" cause so the
|
|
22
|
+
* redelivery text does not claim a failed turn. The outstanding entry is
|
|
23
|
+
* marked busy-deferred until a redelivery actually sends: a settle of an
|
|
24
|
+
* unrelated run that merely overlaps the deferral window must not
|
|
25
|
+
* resolve the wake as delivered. When the bounded ladder is spent and
|
|
26
|
+
* nothing FAILED, the fire is PARKED (parkedBusy) rather than dropped:
|
|
27
|
+
* drainParkedBusy() hands it to one late delivery at the next idle tick
|
|
28
|
+
* (the settle's own drain), with the hold duration in the text. The cap
|
|
29
|
+
* bounds the retries, not the delivery — a session busy longer than the
|
|
30
|
+
* ladder still receives the fire exactly once, and a busy-held fire
|
|
31
|
+
* never enters the exhausted set (the watchdog's "permanently
|
|
32
|
+
* undelivered" page stays reserved for genuinely unsalvageable cases).
|
|
33
|
+
*
|
|
34
|
+
* 2. RECOVERED-FIRE DEFERRAL: recoverPersistedTimers
|
|
35
|
+
* (scheduling/timer/recovery.ts) must not deliver expired persisted fires
|
|
36
|
+
* INLINE inside before_agent_start — a turn is already starting, so a
|
|
37
|
+
* triggerTurn there races the pre-flight (pi-core activeRun guard) and a
|
|
38
|
+
* steer dies with the run if the pre-flight aborts. Recovery parks fires
|
|
39
|
+
* via deferRecoveredFire(); the timer extension's agent_settled handler
|
|
40
|
+
* calls flushRecoveredFires(), which delivers AFTER the run has fully
|
|
41
|
+
* settled — where a wake:true fire safely starts its own turn — and feeds
|
|
42
|
+
* failed deliveries into the retry machinery above.
|
|
43
|
+
*
|
|
44
|
+
* 3. DRAIN LIVENESS: the retry queue is drained by the SAME ticks
|
|
45
|
+
* that fire expired timers (TimerPoller poll tick and the
|
|
46
|
+
* TOOL_EXECUTION_END / TURN_END fireExpired path) — retries never wait
|
|
47
|
+
* for a user turn.
|
|
48
|
+
*
|
|
49
|
+
* 4. HONEST ATTRIBUTION, CANCEL RETIREMENT, LONG-RUN GRACE: a redelivery
|
|
50
|
+
* carries a WakeRetryCause rendered verbatim in its text — "failed"
|
|
51
|
+
* (the turn's settle was a provider/auth error), "busy" (the send was
|
|
52
|
+
* deferred), or "timeout" (the outcome window elapsed with no settle and
|
|
53
|
+
* no run in flight). The outcome timeout must not claim a failed turn.
|
|
54
|
+
* LONG-RUN GRACE: drainDue does not arm (or count) an outcome timeout
|
|
55
|
+
* while an agent run is active for a wake whose send was not busy-
|
|
56
|
+
* deferred — the run is plausibly the wake's own turn and a merely-long
|
|
57
|
+
* run is not a lost send; the 240s window keeps its job for the send
|
|
58
|
+
* that never started a turn (pre-flight abort). The active-run predicate
|
|
59
|
+
* is wired by timer/index.ts from the captured session ctx; absent or
|
|
60
|
+
* throwing it degrades to the pre-grace arming (never suppress retries
|
|
61
|
+
* on a broken reader). CANCEL RETIREMENT: cancelTimer/cancelTimersByTag
|
|
62
|
+
* (and the session-shutdown clear) withdraw the fire with the timer —
|
|
63
|
+
* retireTimer/retireTimersWhere drop the outstanding wake, the armed
|
|
64
|
+
* ladder, parked recovered fires, and the timeout-count bookkeeping, and
|
|
65
|
+
* mark the id retired so an in-flight deferred send (fireTimer or a
|
|
66
|
+
* popped redelivery) is suppressed at send time. Retirement is a
|
|
67
|
+
* WITHDRAWAL, not a delivery: stats.succeeded stays untouched.
|
|
68
|
+
*
|
|
69
|
+
* Mitigations (wake-retry flood):
|
|
70
|
+
*
|
|
71
|
+
* a. Outcome window: legitimate wake turns run 2-4min; a shorter window
|
|
72
|
+
* arms spurious "false timeout" retries mid-turn (the 5s backoff usually
|
|
73
|
+
* drains before the settle's success-clear can cancel).
|
|
74
|
+
*
|
|
75
|
+
* b. Retryable-failure hold: pi-core auto-retries a RETRYABLE provider
|
|
76
|
+
* failure (transport/timeout/5xx — RETRYABLE_PROVIDER_ERROR_PATTERN
|
|
77
|
+
* classes) inside the SAME run, and those auto_retry_start/end events
|
|
78
|
+
* are NOT surfaceable to extensions (absent from ExtensionAPI's
|
|
79
|
+
* ExtensionEvent union), so the queue instead mirrors pi-core's
|
|
80
|
+
* retryable classes (isRetryableWakeError) and HOLDS the outcome
|
|
81
|
+
* timeout for a bounded window matching pi-core's retry budget
|
|
82
|
+
* (baseDelayMs * 2^maxRetries, read from settings.json `retry` —
|
|
83
|
+
* getWakeRetryHoldMs). While the hold is active, drainDue cannot arm a
|
|
84
|
+
* mid-cycle redelivery; the settle (which fires only after pi-core's
|
|
85
|
+
* retry loop is done) is the sole arming authority for retryable
|
|
86
|
+
* failures — final failure arms exactly one ladder, success clears
|
|
87
|
+
* everything. A hold expires harmlessly: the next drainDue tick
|
|
88
|
+
* after expiry re-checks the (still missing) outcome and arms.
|
|
89
|
+
*
|
|
90
|
+
* c. Redelivery cap (WAKE_RETRY_MAX_ATTEMPTS), owner-tunable via
|
|
91
|
+
* braid.timers.maxWakeAttempts (braid-settings.ts) — a deep ladder on a
|
|
92
|
+
* flaky provider out-floods the session.
|
|
93
|
+
*
|
|
94
|
+
* Failure detection: agent_end carries the run's messages; the LAST assistant
|
|
95
|
+
* message's stopReason === "error" marks the run failed (provider 401/413/5xx
|
|
96
|
+
* path). "aborted" is deliberate user action — the content is already in
|
|
97
|
+
* history, so it resolves as delivered, not retried.
|
|
98
|
+
*
|
|
99
|
+
* All pi event wiring lives in timer/index.ts; this module holds no event
|
|
100
|
+
* listeners and no module-level mutable state beyond the exported singleton
|
|
101
|
+
* (class instance — same pattern as timerManager).
|
|
102
|
+
*/
|
|
103
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
104
|
+
import type { ScheduledTimer } from "../../../lib/events/timer-types.js";
|
|
105
|
+
/** A wake fire awaiting its turn outcome (delivery -> agent_end/agent_settled). */
|
|
106
|
+
export interface OutstandingWake {
|
|
107
|
+
timer: ScheduledTimer;
|
|
108
|
+
/** 0 = original fire; N = the Nth redelivery. */
|
|
109
|
+
attempt: number;
|
|
110
|
+
sentAt: number;
|
|
111
|
+
/** A retry is already armed for this delivery — by the outcome timeout
|
|
112
|
+
* (the window elapsed with no settle; the entry is KEPT, not deleted, so
|
|
113
|
+
* the eventual settle of this delivery still resolves it: a success
|
|
114
|
+
* clears the armed retry, a failure re-arms at the same tier) or by a
|
|
115
|
+
* busy deferral (deferBusyWake). Cleared when the retry is popped
|
|
116
|
+
* (re-tracked fresh) or when the chain exhausts. */
|
|
117
|
+
timedOut?: boolean;
|
|
118
|
+
/** The send was deferred: the session was busy at send time, so no turn
|
|
119
|
+
* has run for this wake. Settles must not resolve it as delivered —
|
|
120
|
+
* the pending redelivery chain owns its liveness. */
|
|
121
|
+
busyDeferred?: boolean;
|
|
122
|
+
/** When the FIRST busy deferral of this delivery chain happened — the
|
|
123
|
+
* holder for the "held while the session was busy for X" late-delivery
|
|
124
|
+
* text. Survives re-tracking (trackWake) within the same fire's delivery
|
|
125
|
+
* chain so the reported hold is the whole held window, not just the last
|
|
126
|
+
* rung; a newer fire of the same timer id starts its own origin (see
|
|
127
|
+
* trackWake). */
|
|
128
|
+
heldSince?: number;
|
|
129
|
+
/** The busy ladder is spent; the fire waits for one late delivery at the
|
|
130
|
+
* next idle drain (drainParkedBusy) instead of being dropped. */
|
|
131
|
+
parkedBusy?: boolean;
|
|
132
|
+
/** A parked fire already handed to the late-delivery path; guards the
|
|
133
|
+
* in-flight window between the drain tick and the deferred send so one
|
|
134
|
+
* parked fire is handed off exactly once. */
|
|
135
|
+
parkedDelivering?: boolean;
|
|
136
|
+
}
|
|
137
|
+
/** Why a redelivery was armed: the wake's turn failed at its settle, its
|
|
138
|
+
* send was deferred because the session was busy at send time, or its
|
|
139
|
+
* outcome window elapsed with no settle and no run in flight. The cause is
|
|
140
|
+
* rendered verbatim in the redelivery text — a timeout-armed retry must
|
|
141
|
+
* never claim a failed turn (the turn may simply have never started). */
|
|
142
|
+
export type WakeRetryCause = "failed" | "busy" | "timeout";
|
|
143
|
+
/** An expired persisted timer parked by recoverPersistedTimers (fix 3). */
|
|
144
|
+
export interface RecoveredFire {
|
|
145
|
+
id: string;
|
|
146
|
+
sessionId?: string;
|
|
147
|
+
reason: string;
|
|
148
|
+
tag?: string;
|
|
149
|
+
createdAt?: number;
|
|
150
|
+
firesAt?: number;
|
|
151
|
+
wake: boolean;
|
|
152
|
+
}
|
|
153
|
+
/** Outcome window: a wake with no agent_end/agent_settled within this window
|
|
154
|
+
* (e.g. pi-core pre-flight abort — no extension event on that path) is
|
|
155
|
+
* re-armed for retry. 240s comfortably exceeds a normal long turn (babysit
|
|
156
|
+
* wake turns run 2-4min); a shorter window arms a spurious retry mid-run.
|
|
157
|
+
* A genuinely hung run is rarer than a long one. */
|
|
158
|
+
export declare const WAKE_OUTCOME_TIMEOUT_MS = 240000;
|
|
159
|
+
/** Backoff tiers between redelivery attempts (index = attempt - 1). */
|
|
160
|
+
export declare const WAKE_RETRY_BACKOFF_MS: number[];
|
|
161
|
+
/** Redelivery bound. Attempt > the effective cap (WAKE_RETRY_MAX_ATTEMPTS
|
|
162
|
+
* default, owner-tunable via braid.timers.maxWakeAttempts) exhausts the
|
|
163
|
+
* fire — a deep ladder on a flaky provider out-floods the session. */
|
|
164
|
+
export declare const WAKE_RETRY_MAX_ATTEMPTS = 3;
|
|
165
|
+
/** Whether an agent_end errorMessage belongs to a failure class pi-core
|
|
166
|
+
* auto-retries (hold the wake outcome); quota/auth-class errors never hold. */
|
|
167
|
+
export declare function isRetryableWakeError(errorMessage?: string): boolean;
|
|
168
|
+
/**
|
|
169
|
+
* Liveness observer for the wake-delivery watchdog feed. Production wiring
|
|
170
|
+
* lives in timer/index.ts: it forwards threshold-crossing facts to the
|
|
171
|
+
* watchdog's wake-delivery condition (published via the global-state seam),
|
|
172
|
+
* which owns the episode latch + out-of-band escalation. The queue itself
|
|
173
|
+
* stays notification-agnostic — the observer changes nothing about delivery
|
|
174
|
+
* (retry budgets, backoff, caps are untouched), and a throwing observer must
|
|
175
|
+
* never break redelivery (call sites guard).
|
|
176
|
+
*/
|
|
177
|
+
export interface WakeRetryObserver {
|
|
178
|
+
/** The outcome window elapsed with no settle for this timer — `timeouts`
|
|
179
|
+
* is the cumulative count for the timer id across its redelivery chain. */
|
|
180
|
+
onOutcomeTimeout?(timer: ScheduledTimer, timeouts: number): void;
|
|
181
|
+
/** A tracked wake resolved as delivered (its turn settled non-failed or
|
|
182
|
+
* its message landed) — the signal that wakes resumed. */
|
|
183
|
+
onWakeDelivered?(timer: ScheduledTimer): void;
|
|
184
|
+
/** A wake turn settled WITHOUT a failure outcome — a real clean turn, as
|
|
185
|
+
* opposed to an internal LLM call. The terminal-error breaker resets its
|
|
186
|
+
* counter here so only completed turns close it. */
|
|
187
|
+
onCleanTurn?(): void;
|
|
188
|
+
}
|
|
189
|
+
export interface WakeRetryStats {
|
|
190
|
+
/** Wake fires tracked (originals + redeliveries). */
|
|
191
|
+
tracked: number;
|
|
192
|
+
/** Wake fires resolved as delivered (successful or aborted run). */
|
|
193
|
+
succeeded: number;
|
|
194
|
+
/** Outstanding wakes that hit the outcome timeout. */
|
|
195
|
+
timedOut: number;
|
|
196
|
+
/** Fires dropped after exceeding WAKE_RETRY_MAX_ATTEMPTS. */
|
|
197
|
+
exhausted: number;
|
|
198
|
+
/** Busy-held fires parked for one late delivery (never dropped).
|
|
199
|
+
* Test-only today: no production reader consumes WakeRetryStats — the
|
|
200
|
+
* park logs its own line at park time — so this field is kept for the
|
|
201
|
+
* busy-hold tests and a future status surface to publish. */
|
|
202
|
+
heldBusy: number;
|
|
203
|
+
}
|
|
204
|
+
/** A retry due for redelivery (returned by drainDue). */
|
|
205
|
+
export interface DueRetry {
|
|
206
|
+
timer: ScheduledTimer;
|
|
207
|
+
attempt: number;
|
|
208
|
+
cause: WakeRetryCause;
|
|
209
|
+
}
|
|
210
|
+
/** A busy-held fire whose bounded ladder is spent and that is due for its
|
|
211
|
+
* one honest late delivery (returned by drainParkedBusy). */
|
|
212
|
+
export interface ParkedBusyDelivery {
|
|
213
|
+
timer: ScheduledTimer;
|
|
214
|
+
/** How long the send was held while the session was busy. */
|
|
215
|
+
heldMs: number;
|
|
216
|
+
}
|
|
217
|
+
export declare class WakeRetryQueue {
|
|
218
|
+
private outstanding;
|
|
219
|
+
private retries;
|
|
220
|
+
private exhaustedFires;
|
|
221
|
+
private deferredRecovered;
|
|
222
|
+
private lastRunFailed;
|
|
223
|
+
/** Timer ids whose injected messages were present in the just-ended run's
|
|
224
|
+
* messages (extracted from agent_end by the timer extension). A fire on
|
|
225
|
+
* this list was DELIVERED — a later run failure is the agent's own work
|
|
226
|
+
* failing, not the delivery, and must not re-arm it. */
|
|
227
|
+
private landedTimerIds;
|
|
228
|
+
private stats;
|
|
229
|
+
private now;
|
|
230
|
+
/** While set and not expired, the outcome timeout must not arm —
|
|
231
|
+
* pi-core may still be auto-retrying the run (outcome undecided). */
|
|
232
|
+
private retryHoldUntil;
|
|
233
|
+
/** Test hooks: pin the hold window / redelivery cap. null restores the
|
|
234
|
+
* settings-derived values (getWakeRetryHoldMs / braid.timers
|
|
235
|
+
* .maxWakeAttempts). */
|
|
236
|
+
private retryHoldOverrideMs;
|
|
237
|
+
private maxAttemptsOverride;
|
|
238
|
+
/** Cumulative outcome-timeout count per timer id, across the fire's whole
|
|
239
|
+
* redelivery chain (original + redeliveries). Feeds the repeated-timeout
|
|
240
|
+
* stall signal: one 240s window is a normal long turn, a SECOND one for
|
|
241
|
+
* the same fire is a wedged loop. Cleared when the fire resolves delivered
|
|
242
|
+
* or exhausts. Factory/instance state — never a module-level let. */
|
|
243
|
+
private timeoutCounts;
|
|
244
|
+
/** Optional liveness observer (timer/index.ts wires the watchdog feed). */
|
|
245
|
+
private wakeObserver;
|
|
246
|
+
/** Live read-only predicate: is an agent run (or its pre-flight /
|
|
247
|
+
* compaction tail) active right now? Wired by timer/index.ts from the
|
|
248
|
+
* captured session ctx. Absent or throwing = not active — the arming
|
|
249
|
+
* behavior degrades to the pre-grace form (a wake is never silently
|
|
250
|
+
* lost, so a broken reader must not suppress retries). */
|
|
251
|
+
private activeRunCheck;
|
|
252
|
+
/** Timer ids retired by a cancel (the fire and its ladder withdrawn by
|
|
253
|
+
* the owner). Guards the in-flight windows: a fire deferred inside the
|
|
254
|
+
* poller (checkExpired -> setTimeout(0)) and a redelivery popped from
|
|
255
|
+
* the ladder (drainDue -> setTimeout(0)) both re-check this mark at
|
|
256
|
+
* send time, so a cancel landing inside either window suppresses the
|
|
257
|
+
* send. Cleared by trackWake — a fresh fire of the same id (recovered
|
|
258
|
+
* after a restart, say) re-arms its own chain. */
|
|
259
|
+
private retired;
|
|
260
|
+
/** Set (or clear with null) the wake-liveness observer. Invoked at the
|
|
261
|
+
* timeout-arming and delivered-resolve points only; never on the send
|
|
262
|
+
* path. */
|
|
263
|
+
setWakeObserver(observer: WakeRetryObserver | null): void;
|
|
264
|
+
/** Test hook: pin the clock (backoff/timeout math). null restores Date.now(). */
|
|
265
|
+
_setClockForTests(fn: (() => number) | null): void;
|
|
266
|
+
/** Test hook: pin the retryable-failure hold window (ms). */
|
|
267
|
+
_setRetryHoldForTests(ms: number | null): void;
|
|
268
|
+
/** Test hook: pin the redelivery cap. */
|
|
269
|
+
_setMaxAttemptsForTests(n: number | null): void;
|
|
270
|
+
/** Wire (or clear with null) the live active-run predicate. Consulted by
|
|
271
|
+
* drainDue's outcome-timeout path: while a run is active for a wake whose
|
|
272
|
+
* send was NOT busy-deferred, the run is plausibly the wake's own turn —
|
|
273
|
+
* a merely-long run must not arm a redelivery (and via the observer, a
|
|
274
|
+
* page). See the long-run grace contract in the module header. */
|
|
275
|
+
setActiveRunCheck(fn: (() => boolean) | null): void;
|
|
276
|
+
private isFireTurnRunning;
|
|
277
|
+
/** Effective redelivery cap: braid.timers.maxWakeAttempts (default 3). */
|
|
278
|
+
getMaxAttempts(): number;
|
|
279
|
+
private holdWindowMs;
|
|
280
|
+
/**
|
|
281
|
+
* Track a wake fire BEFORE (or at) delivery so its turn outcome can be
|
|
282
|
+
* resolved. `attempt` 0 = original fire; the redelivery path re-tracks with
|
|
283
|
+
* the drained attempt number. Re-tracking the same timer id refreshes the
|
|
284
|
+
* outcome window (the newest delivery is the one whose outcome matters).
|
|
285
|
+
*
|
|
286
|
+
* `continueHold` marks an attempt-0 re-track that continues the SAME fire's
|
|
287
|
+
* delivery chain (the parked handoff in deliverParkedBusyFire) instead of
|
|
288
|
+
* starting a newer fire's. Only a chain continuation keeps a busy-deferred
|
|
289
|
+
* predecessor's hold origin; a numbered re-track (attempt >= 1) is one by
|
|
290
|
+
* construction, since the ladder redelivers the fire that armed it.
|
|
291
|
+
*/
|
|
292
|
+
trackWake(timer: ScheduledTimer, attempt?: number, options?: {
|
|
293
|
+
continueHold?: boolean;
|
|
294
|
+
}): void;
|
|
295
|
+
/**
|
|
296
|
+
* Record the outcome of the run that just ended. Called from agent_end.
|
|
297
|
+
* A retryable errorMessage (transport/timeout/5xx — pi-core
|
|
298
|
+
* auto-retries inside the SAME run) starts a hold window that defers the
|
|
299
|
+
* outcome-timeout arming in drainUntil the retry cycle resolves; the hold
|
|
300
|
+
* is refreshed on every retryable failure so a long multi-attempt cycle
|
|
301
|
+
* stays covered. Non-retryable failures (auth/quota) arm at settle
|
|
302
|
+
* immediately, as before.
|
|
303
|
+
*/
|
|
304
|
+
onAgentEnd(failed: boolean, errorMessage?: string, landedTimerIds?: ReadonlySet<string>): void;
|
|
305
|
+
/**
|
|
306
|
+
* Resolve outstanding wakes at the settle boundary (agent_settled — fired
|
|
307
|
+
* after retries/compaction/continuations are done, even for failed runs).
|
|
308
|
+
* A failed run re-arms every outstanding wake; anything else (success or
|
|
309
|
+
* user abort) counts as delivered. Idempotent: a second call with no
|
|
310
|
+
* outstanding wakes is a no-op, so multiple settle listeners cannot
|
|
311
|
+
* double-schedule.
|
|
312
|
+
*
|
|
313
|
+
* A SUCCESSFUL wake turn also clears the pending retry chain for its
|
|
314
|
+
* timer id. Without this, the outcome-timeout path (drainDue) can arm a
|
|
315
|
+
* retry for a fire whose turn is merely LONG (>60s), the turn then settles
|
|
316
|
+
* successfully, the armed retry still fires, and the chain re-delivers a
|
|
317
|
+
* fire whose failure no longer exists — burning the retry cap on
|
|
318
|
+
* duplicates. Only genuinely-failed fires keep retrying to the cap.
|
|
319
|
+
*/
|
|
320
|
+
onAgentSettled(): void;
|
|
321
|
+
/**
|
|
322
|
+
* Arm a redelivery for a wake whose SEND was deferred: the session was
|
|
323
|
+
* busy at send time (ctx.signal undefined while ctx.isIdle() is false —
|
|
324
|
+
* compaction / run bookkeeping; a raw triggerTurn there would start a
|
|
325
|
+
* competing agent run). Rides the same bounded backoff ladder and cap as
|
|
326
|
+
* failed-turn redeliveries; the redelivery text says "held while the
|
|
327
|
+
* session was busy" instead of claiming a failed turn. The outstanding
|
|
328
|
+
* entry is marked busy-deferred so a settle of an unrelated run that
|
|
329
|
+
* overlaps the deferral window cannot resolve the wake as delivered.
|
|
330
|
+
*
|
|
331
|
+
* When the ladder is spent the fire is PARKED, never dropped: nothing
|
|
332
|
+
* failed, so the exhausted path (and the watchdog's undelivered page) does
|
|
333
|
+
* not apply. drainParkedBusy() then hands it to one late delivery once the
|
|
334
|
+
* session is idle, with the full hold duration in the text.
|
|
335
|
+
*/
|
|
336
|
+
deferBusyWake(timer: ScheduledTimer, attempt: number): void;
|
|
337
|
+
/** Park a busy-held fire whose bounded ladder is spent. The fire is NOT
|
|
338
|
+
* dropped and NOT counted as exhausted: it waits for one late delivery at
|
|
339
|
+
* the next idle drain. An untracked deferral (a wiring defect — every wake
|
|
340
|
+
* path tracks before sending) is parked on a fresh entry so a held wake
|
|
341
|
+
* can never be lost here. */
|
|
342
|
+
private parkBusyFire;
|
|
343
|
+
/**
|
|
344
|
+
* Hand off parked busy-held fires that can be delivered now: the session is
|
|
345
|
+
* not positively busy (an active run / pre-flight / compaction keeps them
|
|
346
|
+
* parked — the send's own onBusy hook would only hold the fire again, so
|
|
347
|
+
* waiting keeps this to one handoff per settle rather than one attempt per
|
|
348
|
+
* poll tick). Each handed-off fire is marked in-flight so a concurrent tick
|
|
349
|
+
* cannot hand it off twice; the caller re-tracks it (trackWake) and a send
|
|
350
|
+
* that is deferred again is held again — one fresh rung, then a re-park once
|
|
351
|
+
* the cap is hit again.
|
|
352
|
+
*/
|
|
353
|
+
drainParkedBusy(): ParkedBusyDelivery[];
|
|
354
|
+
/** Forget a parked busy-held fire without a late delivery — its content was
|
|
355
|
+
* shown non-waking (terminal-error breaker) or the caller withdrew it. */
|
|
356
|
+
forgetParkedBusy(timerId: string): void;
|
|
357
|
+
/**
|
|
358
|
+
* Called on every poll tick / TOOL_EXECUTION_END / TURN_END (the same
|
|
359
|
+
* ticks that fire expired timers). First re-arms outstanding wakes that
|
|
360
|
+
* never got an outcome (timeout fallback), then returns retries whose
|
|
361
|
+
* backoff has elapsed. The CALLER performs the redelivery (deferred via
|
|
362
|
+
* setTimeout(0), like every fire-path send) and re-tracks the outcome via
|
|
363
|
+
* trackWake(timer, attempt).
|
|
364
|
+
*/
|
|
365
|
+
drainDue(): DueRetry[];
|
|
366
|
+
/** Fires dropped after exceeding the redelivery bound (for a final notice). */
|
|
367
|
+
takeExhausted(): ScheduledTimer[];
|
|
368
|
+
/** Park a recovered persisted fire for post-settle delivery (fix 3). */
|
|
369
|
+
deferRecoveredFire(fire: RecoveredFire): void;
|
|
370
|
+
/** Drain parked recovered fires (one-shot; re-park on delivery failure). */
|
|
371
|
+
takeRecoveredFires(): RecoveredFire[];
|
|
372
|
+
deferredRecoveredCount(): number;
|
|
373
|
+
outstandingCount(): number;
|
|
374
|
+
/**
|
|
375
|
+
* Whether any OUTSTANDING wake is a redelivery
|
|
376
|
+
* (attempt >= 1 — re-tracked via trackWake(timer, attempt) by the
|
|
377
|
+
* redelivery path). While true, a wake fire re-delivered after a failed
|
|
378
|
+
* turn is in flight and its outcome has not settled. Read-only query —
|
|
379
|
+
* NO redelivery behavior change (redelivery logic itself is out of scope
|
|
380
|
+
* for callers of this accessor).
|
|
381
|
+
*
|
|
382
|
+
* Precision note: if the wake-gate rewrote the retry into a queued steer
|
|
383
|
+
* inside an active run, this stays true until that run settles, so one
|
|
384
|
+
* unrelated mid-run judge opportunity may be skipped. A skipped judge is
|
|
385
|
+
* merely delayed (next non-redelivery turn judges); a false FAIL audit of
|
|
386
|
+
* a fragment turn is the failure mode this gate exists to prevent.
|
|
387
|
+
*/
|
|
388
|
+
hasOutstandingRedelivery(): boolean;
|
|
389
|
+
pendingRetryCount(): number;
|
|
390
|
+
/**
|
|
391
|
+
* Retire a cancelled timer's fire: drop its outstanding wake (if any), its
|
|
392
|
+
* armed ladder, any parked recovered fire for the id, and the repeated-
|
|
393
|
+
* timeout bookkeeping. Marks the id retired so an in-flight send is
|
|
394
|
+
* suppressed (see `retired`). Called from cancelTimer — including when the
|
|
395
|
+
* timer is no longer in the manager map (a fired one-shot is deleted from
|
|
396
|
+
* it at expiry, but its wake ladder may still be armed; the cancel must
|
|
397
|
+
* reach it). Retirement is a WITHDRAWAL, not a delivery: stats.succeeded
|
|
398
|
+
* stays untouched.
|
|
399
|
+
*/
|
|
400
|
+
retireTimer(timerId: string): void;
|
|
401
|
+
/**
|
|
402
|
+
* Retire every fire matching the predicate (tag/session-scoped cancels).
|
|
403
|
+
* Walks the queue's own records — the outstanding wakes, the armed
|
|
404
|
+
* ladders, and the parked recovered fires — so it also reaches fires that
|
|
405
|
+
* already left the manager map (fired one-shots; delete-on-detection).
|
|
406
|
+
* Returns the retired timer ids.
|
|
407
|
+
*/
|
|
408
|
+
retireTimersWhere(predicate: (t: ScheduledTimer) => boolean): string[];
|
|
409
|
+
/** Whether the id is retired (cancel guard for in-flight sends). */
|
|
410
|
+
isRetired(timerId: string): boolean;
|
|
411
|
+
/** Whether any live wake state exists for the id (outstanding wake, armed
|
|
412
|
+
* ladder, parked recovered fire). Read BEFORE a cancel so the caller can
|
|
413
|
+
* distinguish "nothing to cancel" from "the fire already left the timer
|
|
414
|
+
* map but its ladder was retired". */
|
|
415
|
+
hasWakeFireState(timerId: string): boolean;
|
|
416
|
+
getStats(): WakeRetryStats;
|
|
417
|
+
/** Reset all state. Test helper (process-lifetime singleton). */
|
|
418
|
+
resetForTests(): void;
|
|
419
|
+
/** Drop pending redeliveries for a timer id (success clears the chain). */
|
|
420
|
+
private cancelPendingRetries;
|
|
421
|
+
/**
|
|
422
|
+
* Arm (or replace) the pending redelivery for a fire. Replace-by-id —
|
|
423
|
+
* the outcome-timeout path may already have armed a retry while the failed
|
|
424
|
+
* turn was still running; a genuine settle-failure must escalate that entry
|
|
425
|
+
* in place, never stack a second redelivery for the same fire.
|
|
426
|
+
* Returns true if armed, false if the bound is exhausted.
|
|
427
|
+
*/
|
|
428
|
+
private scheduleRetry;
|
|
429
|
+
}
|
|
430
|
+
/** The process-wide queue (single pi session per process). */
|
|
431
|
+
export declare const wakeRetryQueue: WakeRetryQueue;
|
|
432
|
+
/**
|
|
433
|
+
* Read accessor: is a wake-retry redelivery (attempt >= 1)
|
|
434
|
+
* currently in flight (tracked, outcome not settled)? The enforcement
|
|
435
|
+
* verification judge uses this to SKIP auditing the redelivered tail turn —
|
|
436
|
+
* a fragment the judge would otherwise treat as the whole task. Read-only;
|
|
437
|
+
* no redelivery behavior change.
|
|
438
|
+
*/
|
|
439
|
+
export declare function isWakeRedeliveryInFlight(): boolean;
|
|
440
|
+
/**
|
|
441
|
+
* Deliver parked recovered fires post-settle. Called from
|
|
442
|
+
* agent_settled handlers (timer extension primary + prompt-builder fallback —
|
|
443
|
+
* takeRecoveredFires() drains, so double registration cannot double-deliver;
|
|
444
|
+
* onAgentSettled() is idempotent, so outcome resolution is order-safe).
|
|
445
|
+
*
|
|
446
|
+
* wake:true fires start their own turn (safe here: the run has fully settled
|
|
447
|
+
* and pi-core released activeRun; the triggerTurn deferral in
|
|
448
|
+
* sendTrackedMessage keeps the macrotask boundary). If the session is busy
|
|
449
|
+
* at flush time anyway (an overlapping compaction, say), the busy hook
|
|
450
|
+
* re-parks the fire — the next settle flushes it; never silently lost.
|
|
451
|
+
* wake:false fires ride as advisory steers, as before. Every delivered wake
|
|
452
|
+
* is tracked so a failed delivery retries with backoff.
|
|
453
|
+
*/
|
|
454
|
+
export declare function flushRecoveredFires(pi: ExtensionAPI, ctx?: unknown): void;
|
|
455
|
+
//# sourceMappingURL=wake-retry.d.ts.map
|