pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wake Gate - prevents triggerTurn wakes from re-entering pi-core's agent
|
|
3
|
+
* loop while a session prompt is being prepared (the pre-flight window).
|
|
4
|
+
*
|
|
5
|
+
* PROBLEM (pi-core 1.0.2):
|
|
6
|
+
* pi-core's sendCustomMessage routes triggerTurn:true to `_runAgentPrompt`
|
|
7
|
+
* whenever the SESSION-level isStreaming flag (`_isAgentRunActive`) is false.
|
|
8
|
+
* But `_isAgentRunActive` is only set inside `_runAgentPrompt`
|
|
9
|
+
* (agent-session.js) and cleared in `_emitAgentSettled`. The session
|
|
10
|
+
* `prompt()` PRE-FLIGHT (model/auth checks, `_checkCompaction`,
|
|
11
|
+
* `emitBeforeAgentStart`) runs with isStreaming=false. A triggerTurn wake
|
|
12
|
+
* that lands during that pre-flight starts a COMPETING agent run; when
|
|
13
|
+
* the outer `prompt()` then reaches `_runAgentPrompt` ->
|
|
14
|
+
* `agent.prompt()`, pi-agent-core's activeRun guard throws
|
|
15
|
+
* "Agent is already processing a prompt. Use steer() or followUp() ...".
|
|
16
|
+
* The compaction boundary is the worst offender: `_checkCompaction`'s LLM
|
|
17
|
+
* summarization is a multi-second await inside the pre-flight, so a
|
|
18
|
+
* deferred wake (timer fires are setTimeout(0)-deferred) has ample time to
|
|
19
|
+
* land there.
|
|
20
|
+
*
|
|
21
|
+
* GATE (this module): the pre-flight START is not observable by extensions,
|
|
22
|
+
* but its TAIL and the run itself are:
|
|
23
|
+
* - before_agent_start (mid pre-flight)
|
|
24
|
+
* - session_before_compact (compaction start)
|
|
25
|
+
* - agent_start (core run start)
|
|
26
|
+
* From the first of {input (idle), before_agent_start,
|
|
27
|
+
* session_before_compact} until agent_start (or session_compact, for the
|
|
28
|
+
* manual-compaction path where no run follows), a triggerTurn wake is gated
|
|
29
|
+
* into a live-delivery send instead of a raw re-entry: triggerTurn is
|
|
30
|
+
* dropped, so pi-core routes the wake by live state - steer (branch 2)
|
|
31
|
+
* while a run is streaming, session append (branch 5) in the pre-flight.
|
|
32
|
+
* Either route reaches the run that is active or imminent and neither
|
|
33
|
+
* starts a competing one. After agent_start the session isStreaming flag
|
|
34
|
+
* is true, so pi-core's own sendCustomMessage already queues wakes; the
|
|
35
|
+
* gate RELEASES at agent_start to keep the post-run settle window
|
|
36
|
+
* triggerTurn capable (a wake there is a safe re-entry: core has already
|
|
37
|
+
* released activeRun). session_compact also releases: in the MANUAL-
|
|
38
|
+
* compaction path the agent is aborted and idle (no run follows), so the
|
|
39
|
+
* post-compaction auto-resume wake (register-session-compact,
|
|
40
|
+
* triggerTurn:true) must pass through ungated - gating it would
|
|
41
|
+
* re-introduce the post-compaction loop stop. In the AUTO path
|
|
42
|
+
* isStreaming is true from _runAgentPrompt entry through the post-run
|
|
43
|
+
* loop, so releasing at session_compact is safe there too.
|
|
44
|
+
*
|
|
45
|
+
* STATE-BASED DEFERRAL (send-time busy check): the region flag is a
|
|
46
|
+
* heuristic window; the load-bearing decision is the LIVE agent state at
|
|
47
|
+
* wake send time. registerWakeGate captures the session ctx from the
|
|
48
|
+
* events it already subscribes to, and isAgentBusy() reads it live:
|
|
49
|
+
* `ctx.signal === undefined && !ctx.isIdle()` — the session is in run
|
|
50
|
+
* bookkeeping or compaction while NO streaming run holds pi-core's queue
|
|
51
|
+
* (isIdle is false through both; signal is undefined outside a run). A
|
|
52
|
+
* raw triggerTurn landing there routes to _runAgentPrompt and starts a
|
|
53
|
+
* COMPETING run (the activeRun guard throws). sendTrackedMessage's
|
|
54
|
+
* deferred macrotask consults isAgentBusy() and, when the caller supplied
|
|
55
|
+
* a re-queue hook (timer wakes: the wake-retry queue), parks the wake
|
|
56
|
+
* instead of sending; the redelivery re-checks and starts its own turn
|
|
57
|
+
* once the session is idle. Wakes without a hook (and an unreadable
|
|
58
|
+
* state) fail open to the region-gate behavior above. Mid-run steering is
|
|
59
|
+
* untouched: signal defined means the run is live and pi-core queues the
|
|
60
|
+
* send itself.
|
|
61
|
+
*
|
|
62
|
+
* RESIDUAL GAP (pi-core): pi-core emits `input` to extension handlers at
|
|
63
|
+
* session.prompt() ENTRY (before the auth/compaction pre-flight and before
|
|
64
|
+
* before_agent_start), so an idle prompt arms the gate from the first
|
|
65
|
+
* await of the pre-flight. The arm is conditional: `input` carries
|
|
66
|
+
* `streamingBehavior` ONLY when the prompt is a steer/followUp into an
|
|
67
|
+
* ACTIVE run; such a prompt queues and returns without starting a run,
|
|
68
|
+
* and agent_start will not re-fire for it, so arming there would leak the
|
|
69
|
+
* gate up to the 120s fail-safe past the run's end. The one uncovered
|
|
70
|
+
* slice is the synchronous pre-input section of prompt() (extension
|
|
71
|
+
* `/command` dispatch), which returns before any await. The definitive
|
|
72
|
+
* fix stays in pi-core: set `_isAgentRunActive` at session.prompt()
|
|
73
|
+
* entry, or gate sendCustomMessage's triggerTurn branch on the CORE
|
|
74
|
+
* activeRun (`this.agent.signal`).
|
|
75
|
+
*
|
|
76
|
+
* FAIL-SAFE: pi-core emits NO event when the pre-flight ABORTS (auth/quota
|
|
77
|
+
* errors: before_agent_start fires, then the pre-flight catch rethrows and
|
|
78
|
+
* agent_start is never emitted — no extension event on that path). Without
|
|
79
|
+
* a clear, a gate armed by an aborted turn stays true for the whole idle
|
|
80
|
+
* period: every wake:true timer fire routes to a queued steer that never
|
|
81
|
+
* starts a turn, and periodic fires batch behind the next user prompt. The
|
|
82
|
+
* fail-safe below auto-clears the gate RUN_REGION_MAX_MS after the last
|
|
83
|
+
* arming event, so a stuck gate self-heals without needing an abort event
|
|
84
|
+
* that pi-core does not provide. For wakes WITH a re-queue hook the
|
|
85
|
+
* fail-safe is not load-bearing: a fail-safe clear during a still-busy
|
|
86
|
+
* session does not re-expose the wake (the live-state check defers it, so
|
|
87
|
+
* a clear cannot cause a throw on that path); the region flag + fail-safe
|
|
88
|
+
* remain the catch-all rewrite for senders without a re-queue path.
|
|
89
|
+
*
|
|
90
|
+
* Scope: single-process-per-session (see injection-tracker.ts header) —
|
|
91
|
+
* module-level flag is process-global but every pi session registers once,
|
|
92
|
+
* so in practice it tracks the single live session.
|
|
93
|
+
*/
|
|
94
|
+
/**
|
|
95
|
+
* Whether the session is busy in the state that makes a raw triggerTurn
|
|
96
|
+
* send dangerous: no streaming run holds the queue (`signal` undefined) but
|
|
97
|
+
* the session is not idle either (`isIdle` false — compaction, or run
|
|
98
|
+
* pre-flight/bookkeeping). pi-core's sendCustomMessage would route such a
|
|
99
|
+
* send to `_runAgentPrompt` and start a competing agent run.
|
|
100
|
+
*
|
|
101
|
+
* Fails open (false) unless busy is POSITIVELY determined: no ctx captured
|
|
102
|
+
* yet, a ctx without live readers, or a stale ctx (its getters throw after
|
|
103
|
+
* session replacement) all mean "unknown" — the region gate above stays the
|
|
104
|
+
* safety net for those.
|
|
105
|
+
*/
|
|
106
|
+
export declare function isAgentBusy(): boolean;
|
|
107
|
+
export declare const RUN_REGION_MAX_MS = 120000;
|
|
108
|
+
/** Whether a triggerTurn send should be gated (pre-flight tail in progress). */
|
|
109
|
+
export declare function isRunRegionActive(): boolean;
|
|
110
|
+
/** Test hook: reset module state between fixtures (also cancels the fail-safe). */
|
|
111
|
+
export declare function resetWakeGateForTests(): void;
|
|
112
|
+
/** Test hook: shorten/extend the fail-safe bound (null restores the default). */
|
|
113
|
+
export declare function _setWakeGateFailSafeMsForTests(ms: number | null): void;
|
|
114
|
+
/**
|
|
115
|
+
* Register the wake-gate event subscriptions. Call once per pi session
|
|
116
|
+
* (alongside registerInjectionTracker — the enforcement bootstrap in
|
|
117
|
+
* handler-registry.ts wires both).
|
|
118
|
+
*
|
|
119
|
+
* The local `on` type widens ExtensionAPI's overloaded on() so we can pass
|
|
120
|
+
* plain event names without TypeScript picking an overload.
|
|
121
|
+
*/
|
|
122
|
+
export declare function registerWakeGate(pi: {
|
|
123
|
+
on: (event: string, handler: (...args: any[]) => any) => void;
|
|
124
|
+
}): void;
|
|
125
|
+
/** Delivery options handed to pi.sendMessage / sendTrackedMessage. */
|
|
126
|
+
export interface WakeDeliveryOptions {
|
|
127
|
+
triggerTurn?: boolean;
|
|
128
|
+
deliverAs?: string;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Gate a triggerTurn send on the run-region state.
|
|
132
|
+
*
|
|
133
|
+
* - Not a triggerTurn, or no run region active -> options unchanged (wake hits
|
|
134
|
+
* pi-core's triggerTurn branch exactly as before: idle wake preserved).
|
|
135
|
+
* - Run region active -> triggerTurn is dropped entirely and the send takes
|
|
136
|
+
* the funnel's live shape `{ deliverAs }` (steer by default, preserving an
|
|
137
|
+
* explicit deliverAs). pi-core 1.0.2 routes that shape by live state
|
|
138
|
+
* (dist/core/agent-session.js:1759-1782): while a run is streaming it steers
|
|
139
|
+
* into that run (branch 2); in the pre-flight (isStreaming false) it is
|
|
140
|
+
* appended to the session immediately (branch 5), so the imminent run reads
|
|
141
|
+
* it. Neither route starts a competing run. Returning
|
|
142
|
+
* `triggerTurn: false` instead would park the wake to the end-of-turn flush
|
|
143
|
+
* (branch 4) - pi 0.84.2 made that shape park (PR #8022), which is what
|
|
144
|
+
* this gate used to return.
|
|
145
|
+
*
|
|
146
|
+
* REVERT-PROOF contract: removing the gate (or never registering it) means
|
|
147
|
+
* `_runRegionActive` stays false and every triggerTurn send passes through
|
|
148
|
+
* ungated — the fixture test in test-wake-gate.mjs fails, pinning the gate.
|
|
149
|
+
*/
|
|
150
|
+
export declare function gateTriggerTurnOptions(options: WakeDeliveryOptions | undefined): WakeDeliveryOptions | undefined;
|
|
151
|
+
//# sourceMappingURL=wake-gate.d.ts.map
|
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Wake Gate - prevents triggerTurn wakes from re-entering pi-core's agent
|
|
3
|
+
* loop while a session prompt is being prepared (the pre-flight window).
|
|
4
|
+
*
|
|
5
|
+
* PROBLEM (pi-core 1.0.2):
|
|
6
|
+
* pi-core's sendCustomMessage routes triggerTurn:true to `_runAgentPrompt`
|
|
7
|
+
* whenever the SESSION-level isStreaming flag (`_isAgentRunActive`) is false.
|
|
8
|
+
* But `_isAgentRunActive` is only set inside `_runAgentPrompt`
|
|
9
|
+
* (agent-session.js) and cleared in `_emitAgentSettled`. The session
|
|
10
|
+
* `prompt()` PRE-FLIGHT (model/auth checks, `_checkCompaction`,
|
|
11
|
+
* `emitBeforeAgentStart`) runs with isStreaming=false. A triggerTurn wake
|
|
12
|
+
* that lands during that pre-flight starts a COMPETING agent run; when
|
|
13
|
+
* the outer `prompt()` then reaches `_runAgentPrompt` ->
|
|
14
|
+
* `agent.prompt()`, pi-agent-core's activeRun guard throws
|
|
15
|
+
* "Agent is already processing a prompt. Use steer() or followUp() ...".
|
|
16
|
+
* The compaction boundary is the worst offender: `_checkCompaction`'s LLM
|
|
17
|
+
* summarization is a multi-second await inside the pre-flight, so a
|
|
18
|
+
* deferred wake (timer fires are setTimeout(0)-deferred) has ample time to
|
|
19
|
+
* land there.
|
|
20
|
+
*
|
|
21
|
+
* GATE (this module): the pre-flight START is not observable by extensions,
|
|
22
|
+
* but its TAIL and the run itself are:
|
|
23
|
+
* - before_agent_start (mid pre-flight)
|
|
24
|
+
* - session_before_compact (compaction start)
|
|
25
|
+
* - agent_start (core run start)
|
|
26
|
+
* From the first of {input (idle), before_agent_start,
|
|
27
|
+
* session_before_compact} until agent_start (or session_compact, for the
|
|
28
|
+
* manual-compaction path where no run follows), a triggerTurn wake is gated
|
|
29
|
+
* into a live-delivery send instead of a raw re-entry: triggerTurn is
|
|
30
|
+
* dropped, so pi-core routes the wake by live state - steer (branch 2)
|
|
31
|
+
* while a run is streaming, session append (branch 5) in the pre-flight.
|
|
32
|
+
* Either route reaches the run that is active or imminent and neither
|
|
33
|
+
* starts a competing one. After agent_start the session isStreaming flag
|
|
34
|
+
* is true, so pi-core's own sendCustomMessage already queues wakes; the
|
|
35
|
+
* gate RELEASES at agent_start to keep the post-run settle window
|
|
36
|
+
* triggerTurn capable (a wake there is a safe re-entry: core has already
|
|
37
|
+
* released activeRun). session_compact also releases: in the MANUAL-
|
|
38
|
+
* compaction path the agent is aborted and idle (no run follows), so the
|
|
39
|
+
* post-compaction auto-resume wake (register-session-compact,
|
|
40
|
+
* triggerTurn:true) must pass through ungated - gating it would
|
|
41
|
+
* re-introduce the post-compaction loop stop. In the AUTO path
|
|
42
|
+
* isStreaming is true from _runAgentPrompt entry through the post-run
|
|
43
|
+
* loop, so releasing at session_compact is safe there too.
|
|
44
|
+
*
|
|
45
|
+
* STATE-BASED DEFERRAL (send-time busy check): the region flag is a
|
|
46
|
+
* heuristic window; the load-bearing decision is the LIVE agent state at
|
|
47
|
+
* wake send time. registerWakeGate captures the session ctx from the
|
|
48
|
+
* events it already subscribes to, and isAgentBusy() reads it live:
|
|
49
|
+
* `ctx.signal === undefined && !ctx.isIdle()` — the session is in run
|
|
50
|
+
* bookkeeping or compaction while NO streaming run holds pi-core's queue
|
|
51
|
+
* (isIdle is false through both; signal is undefined outside a run). A
|
|
52
|
+
* raw triggerTurn landing there routes to _runAgentPrompt and starts a
|
|
53
|
+
* COMPETING run (the activeRun guard throws). sendTrackedMessage's
|
|
54
|
+
* deferred macrotask consults isAgentBusy() and, when the caller supplied
|
|
55
|
+
* a re-queue hook (timer wakes: the wake-retry queue), parks the wake
|
|
56
|
+
* instead of sending; the redelivery re-checks and starts its own turn
|
|
57
|
+
* once the session is idle. Wakes without a hook (and an unreadable
|
|
58
|
+
* state) fail open to the region-gate behavior above. Mid-run steering is
|
|
59
|
+
* untouched: signal defined means the run is live and pi-core queues the
|
|
60
|
+
* send itself.
|
|
61
|
+
*
|
|
62
|
+
* RESIDUAL GAP (pi-core): pi-core emits `input` to extension handlers at
|
|
63
|
+
* session.prompt() ENTRY (before the auth/compaction pre-flight and before
|
|
64
|
+
* before_agent_start), so an idle prompt arms the gate from the first
|
|
65
|
+
* await of the pre-flight. The arm is conditional: `input` carries
|
|
66
|
+
* `streamingBehavior` ONLY when the prompt is a steer/followUp into an
|
|
67
|
+
* ACTIVE run; such a prompt queues and returns without starting a run,
|
|
68
|
+
* and agent_start will not re-fire for it, so arming there would leak the
|
|
69
|
+
* gate up to the 120s fail-safe past the run's end. The one uncovered
|
|
70
|
+
* slice is the synchronous pre-input section of prompt() (extension
|
|
71
|
+
* `/command` dispatch), which returns before any await. The definitive
|
|
72
|
+
* fix stays in pi-core: set `_isAgentRunActive` at session.prompt()
|
|
73
|
+
* entry, or gate sendCustomMessage's triggerTurn branch on the CORE
|
|
74
|
+
* activeRun (`this.agent.signal`).
|
|
75
|
+
*
|
|
76
|
+
* FAIL-SAFE: pi-core emits NO event when the pre-flight ABORTS (auth/quota
|
|
77
|
+
* errors: before_agent_start fires, then the pre-flight catch rethrows and
|
|
78
|
+
* agent_start is never emitted — no extension event on that path). Without
|
|
79
|
+
* a clear, a gate armed by an aborted turn stays true for the whole idle
|
|
80
|
+
* period: every wake:true timer fire routes to a queued steer that never
|
|
81
|
+
* starts a turn, and periodic fires batch behind the next user prompt. The
|
|
82
|
+
* fail-safe below auto-clears the gate RUN_REGION_MAX_MS after the last
|
|
83
|
+
* arming event, so a stuck gate self-heals without needing an abort event
|
|
84
|
+
* that pi-core does not provide. For wakes WITH a re-queue hook the
|
|
85
|
+
* fail-safe is not load-bearing: a fail-safe clear during a still-busy
|
|
86
|
+
* session does not re-expose the wake (the live-state check defers it, so
|
|
87
|
+
* a clear cannot cause a throw on that path); the region flag + fail-safe
|
|
88
|
+
* remain the catch-all rewrite for senders without a re-queue path.
|
|
89
|
+
*
|
|
90
|
+
* Scope: single-process-per-session (see injection-tracker.ts header) —
|
|
91
|
+
* module-level flag is process-global but every pi session registers once,
|
|
92
|
+
* so in practice it tracks the single live session.
|
|
93
|
+
*/
|
|
94
|
+
import { createLogger } from "../core/logger.js";
|
|
95
|
+
import { SESSION_BEFORE_COMPACT, SESSION_START, SESSION_SHUTDOWN } from "../core/event-names.js";
|
|
96
|
+
const log = createLogger("wake-gate");
|
|
97
|
+
// True while a session prompt is being prepared (pre-flight tail) so that a
|
|
98
|
+
// triggerTurn wake would start a COMPETING run. Cleared at agent_start: from
|
|
99
|
+
// then on pi-core's own isStreaming queueing takes over.
|
|
100
|
+
let _runRegionActive = false;
|
|
101
|
+
// The most recently observed session ctx, captured from wake-gate's own
|
|
102
|
+
// event handlers. Its getters stay live across events, so a ctx captured
|
|
103
|
+
// at session start still reads current state when a wake sends minutes
|
|
104
|
+
// later.
|
|
105
|
+
let _lastAgentCtx = null;
|
|
106
|
+
function captureAgentCtx(ctx) {
|
|
107
|
+
if (ctx && typeof ctx === "object")
|
|
108
|
+
_lastAgentCtx = ctx;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Whether the session is busy in the state that makes a raw triggerTurn
|
|
112
|
+
* send dangerous: no streaming run holds the queue (`signal` undefined) but
|
|
113
|
+
* the session is not idle either (`isIdle` false — compaction, or run
|
|
114
|
+
* pre-flight/bookkeeping). pi-core's sendCustomMessage would route such a
|
|
115
|
+
* send to `_runAgentPrompt` and start a competing agent run.
|
|
116
|
+
*
|
|
117
|
+
* Fails open (false) unless busy is POSITIVELY determined: no ctx captured
|
|
118
|
+
* yet, a ctx without live readers, or a stale ctx (its getters throw after
|
|
119
|
+
* session replacement) all mean "unknown" — the region gate above stays the
|
|
120
|
+
* safety net for those.
|
|
121
|
+
*/
|
|
122
|
+
export function isAgentBusy() {
|
|
123
|
+
const ctx = _lastAgentCtx;
|
|
124
|
+
if (!ctx || typeof ctx.isIdle !== "function")
|
|
125
|
+
return false;
|
|
126
|
+
try {
|
|
127
|
+
return ctx.signal === undefined && ctx.isIdle() === false;
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
return false;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
// Fail-safe bound: how long a run region may stay armed without a release
|
|
134
|
+
// event before the gate auto-clears. Covers the legitimate pre-flight tail
|
|
135
|
+
// (sub-second) and a compaction summarization (session_before_compact re-arms
|
|
136
|
+
// the timer, so the bound only needs to exceed a single compaction). Guards
|
|
137
|
+
// against a pre-flight abort (auth/quota) leaving the gate stuck true, which
|
|
138
|
+
// rewrites every triggerTurn wake to a queued steer that never starts a turn.
|
|
139
|
+
export const RUN_REGION_MAX_MS = 120_000;
|
|
140
|
+
let _failSafeHandle = null;
|
|
141
|
+
// Test hook: override the fail-safe bound (null restores the default).
|
|
142
|
+
let _failSafeMsOverride = null;
|
|
143
|
+
function failSafeMs() {
|
|
144
|
+
return _failSafeMsOverride ?? RUN_REGION_MAX_MS;
|
|
145
|
+
}
|
|
146
|
+
function clearFailSafe() {
|
|
147
|
+
if (_failSafeHandle) {
|
|
148
|
+
clearTimeout(_failSafeHandle);
|
|
149
|
+
_failSafeHandle = null;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
/** Arm the gate (or re-arm it, resetting the fail-safe window). */
|
|
153
|
+
function armRunRegion() {
|
|
154
|
+
_runRegionActive = true;
|
|
155
|
+
clearFailSafe();
|
|
156
|
+
_failSafeHandle = setTimeout(() => {
|
|
157
|
+
_failSafeHandle = null;
|
|
158
|
+
_runRegionActive = false;
|
|
159
|
+
log.warn(`[wake-gate] fail-safe: run region auto-cleared after ${failSafeMs()}ms without a release event ` +
|
|
160
|
+
`(pre-flight abort?) — triggerTurn wakes ungated again`);
|
|
161
|
+
}, failSafeMs());
|
|
162
|
+
// Do not keep the process alive for a stuck gate.
|
|
163
|
+
if (typeof _failSafeHandle?.unref === "function") {
|
|
164
|
+
_failSafeHandle.unref();
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
/** Release the gate and cancel the fail-safe timer. */
|
|
168
|
+
function releaseRunRegion() {
|
|
169
|
+
_runRegionActive = false;
|
|
170
|
+
clearFailSafe();
|
|
171
|
+
}
|
|
172
|
+
/** Whether a triggerTurn send should be gated (pre-flight tail in progress). */
|
|
173
|
+
export function isRunRegionActive() {
|
|
174
|
+
return _runRegionActive;
|
|
175
|
+
}
|
|
176
|
+
/** Test hook: reset module state between fixtures (also cancels the fail-safe). */
|
|
177
|
+
export function resetWakeGateForTests() {
|
|
178
|
+
releaseRunRegion();
|
|
179
|
+
_lastAgentCtx = null;
|
|
180
|
+
_failSafeMsOverride = null;
|
|
181
|
+
}
|
|
182
|
+
/** Test hook: shorten/extend the fail-safe bound (null restores the default). */
|
|
183
|
+
export function _setWakeGateFailSafeMsForTests(ms) {
|
|
184
|
+
_failSafeMsOverride = ms;
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Register the wake-gate event subscriptions. Call once per pi session
|
|
188
|
+
* (alongside registerInjectionTracker — the enforcement bootstrap in
|
|
189
|
+
* handler-registry.ts wires both).
|
|
190
|
+
*
|
|
191
|
+
* The local `on` type widens ExtensionAPI's overloaded on() so we can pass
|
|
192
|
+
* plain event names without TypeScript picking an overload.
|
|
193
|
+
*/
|
|
194
|
+
export function registerWakeGate(pi) {
|
|
195
|
+
pi.on("before_agent_start", (_event, ctx) => {
|
|
196
|
+
captureAgentCtx(ctx);
|
|
197
|
+
armRunRegion();
|
|
198
|
+
});
|
|
199
|
+
// `input` fires at session.prompt() ENTRY — before the pre-flight
|
|
200
|
+
// (model/auth checks, _checkCompaction) and before before_agent_start.
|
|
201
|
+
// Arming here closes the prompt-entry competing-run window for
|
|
202
|
+
// extension-originated sends (a wake landing between prompt entry and
|
|
203
|
+
// before_agent_start was previously ungated). Arm ONLY when the prompt
|
|
204
|
+
// will start a NEW run: `streamingBehavior` is set exactly when the input
|
|
205
|
+
// is a steer/followUp into an ACTIVE run (pi-core queues it without
|
|
206
|
+
// starting a run, and agent_start will not re-fire) — arming there would
|
|
207
|
+
// leak the gate past the run's end until the fail-safe. Input arms use the
|
|
208
|
+
// same armRunRegion path, so the 120s fail-safe semantics apply unchanged.
|
|
209
|
+
pi.on("input", (event, ctx) => {
|
|
210
|
+
captureAgentCtx(ctx);
|
|
211
|
+
if (event?.streamingBehavior === undefined)
|
|
212
|
+
armRunRegion();
|
|
213
|
+
});
|
|
214
|
+
pi.on(SESSION_BEFORE_COMPACT, (_event, ctx) => {
|
|
215
|
+
captureAgentCtx(ctx);
|
|
216
|
+
armRunRegion();
|
|
217
|
+
});
|
|
218
|
+
pi.on("agent_start", (_event, ctx) => {
|
|
219
|
+
captureAgentCtx(ctx);
|
|
220
|
+
releaseRunRegion();
|
|
221
|
+
});
|
|
222
|
+
// Manual compaction: agent is aborted + idle (no run follows) — release so
|
|
223
|
+
// the post-compaction auto-resume wake passes through ungated.
|
|
224
|
+
pi.on("session_compact", (_event, ctx) => {
|
|
225
|
+
captureAgentCtx(ctx);
|
|
226
|
+
releaseRunRegion();
|
|
227
|
+
});
|
|
228
|
+
pi.on(SESSION_START, (_event, ctx) => {
|
|
229
|
+
captureAgentCtx(ctx);
|
|
230
|
+
releaseRunRegion();
|
|
231
|
+
});
|
|
232
|
+
pi.on(SESSION_SHUTDOWN, () => {
|
|
233
|
+
releaseRunRegion();
|
|
234
|
+
_lastAgentCtx = null; // no live session after shutdown: fail open until the next capture
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* Gate a triggerTurn send on the run-region state.
|
|
239
|
+
*
|
|
240
|
+
* - Not a triggerTurn, or no run region active -> options unchanged (wake hits
|
|
241
|
+
* pi-core's triggerTurn branch exactly as before: idle wake preserved).
|
|
242
|
+
* - Run region active -> triggerTurn is dropped entirely and the send takes
|
|
243
|
+
* the funnel's live shape `{ deliverAs }` (steer by default, preserving an
|
|
244
|
+
* explicit deliverAs). pi-core 1.0.2 routes that shape by live state
|
|
245
|
+
* (dist/core/agent-session.js:1759-1782): while a run is streaming it steers
|
|
246
|
+
* into that run (branch 2); in the pre-flight (isStreaming false) it is
|
|
247
|
+
* appended to the session immediately (branch 5), so the imminent run reads
|
|
248
|
+
* it. Neither route starts a competing run. Returning
|
|
249
|
+
* `triggerTurn: false` instead would park the wake to the end-of-turn flush
|
|
250
|
+
* (branch 4) - pi 0.84.2 made that shape park (PR #8022), which is what
|
|
251
|
+
* this gate used to return.
|
|
252
|
+
*
|
|
253
|
+
* REVERT-PROOF contract: removing the gate (or never registering it) means
|
|
254
|
+
* `_runRegionActive` stays false and every triggerTurn send passes through
|
|
255
|
+
* ungated — the fixture test in test-wake-gate.mjs fails, pinning the gate.
|
|
256
|
+
*/
|
|
257
|
+
export function gateTriggerTurnOptions(options) {
|
|
258
|
+
if (!options?.triggerTurn)
|
|
259
|
+
return options;
|
|
260
|
+
if (!_runRegionActive)
|
|
261
|
+
return options;
|
|
262
|
+
log.info(`[wake-gate] triggerTurn wake gated to live delivery (run region active) - deliverAs=${options.deliverAs ?? "steer"}`);
|
|
263
|
+
return { deliverAs: options.deliverAs ?? "steer" };
|
|
264
|
+
}
|
|
265
|
+
//# sourceMappingURL=wake-gate.js.map
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whisper Envelope - Universal prefix for system-injected messages.
|
|
3
|
+
*
|
|
4
|
+
* Every message sent via `sendTrackedMessage` is wrapped with a
|
|
5
|
+
* `[braid-whisper - <subsystem> @ <time>]` envelope and closed with an
|
|
6
|
+
* explicit `[braid-whisper-end]` end-marker so the agent can reliably
|
|
7
|
+
* distinguish system-injected signals from human user input, can
|
|
8
|
+
* unambiguously detect where a (possibly multiline) whisper body ends,
|
|
9
|
+
* and can tell a fresh whisper from a stale re-injection (header clock).
|
|
10
|
+
*
|
|
11
|
+
* The envelope AND the end-marker are added centrally in
|
|
12
|
+
* `sendTrackedMessage` (the trunk) so all 30+ call sites automatically
|
|
13
|
+
* benefit without per-site changes.
|
|
14
|
+
*
|
|
15
|
+
* The subsystem is derived from the source path's first segment
|
|
16
|
+
* (e.g. "enforcement/whisper" -> "enforcement",
|
|
17
|
+
* "memory/context-manager" -> "memory",
|
|
18
|
+
* "cognitive/sycophancy-detector" -> "cognitive").
|
|
19
|
+
*
|
|
20
|
+
* The full source is preserved in the message metadata
|
|
21
|
+
* (`details._braidSource`) for debugging and analytics.
|
|
22
|
+
*
|
|
23
|
+
* Filters: the subsystem name is a substring of the envelope
|
|
24
|
+
* ("enforcement" matches "[braid-whisper - enforcement]"), so bare-name
|
|
25
|
+
* filters keep working; bracket-prefix filters
|
|
26
|
+
* (`grep '\[enforcement\]'`) need the canonical form
|
|
27
|
+
* `grep '\[braid-whisper - enforcement\]'`. Body-level sub-tags
|
|
28
|
+
* (`[<subsystem>-<event>]`) can still be added inside the message body
|
|
29
|
+
* as a second filter level - the envelope is one level above them.
|
|
30
|
+
*/
|
|
31
|
+
/**
|
|
32
|
+
* Format the universal envelope line for a given source.
|
|
33
|
+
* Returns "[braid-whisper - <subsystem> @ 17:05 MSK]" with no trailing
|
|
34
|
+
* whitespace.
|
|
35
|
+
*
|
|
36
|
+
* The subsystem is the first segment of the source path. If the source
|
|
37
|
+
* is empty or has no "/", the literal "system" is used as the fallback.
|
|
38
|
+
*
|
|
39
|
+
* The `@ HH:MM TZ` timestamp is the
|
|
40
|
+
* generation time in the owner time zone (lib/utils/local-time.ts) — it
|
|
41
|
+
* lets the agent tell a fresh whisper from a stale re-injection. It is
|
|
42
|
+
* rendered by the ONE formatter (formatWhisperClock) so whisper headers
|
|
43
|
+
* and body time strings never diverge.
|
|
44
|
+
*
|
|
45
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
46
|
+
* @param now clock instant (default now; test hook setLocalTimeClockForTests
|
|
47
|
+
* pins it for deterministic assertions)
|
|
48
|
+
*/
|
|
49
|
+
export declare function formatWhisperEnvelope(source: string, now?: Date): string;
|
|
50
|
+
/**
|
|
51
|
+
* Format the explicit end-marker that closes every braid whisper.
|
|
52
|
+
* Returns "[braid-whisper-end]" with no trailing whitespace.
|
|
53
|
+
*
|
|
54
|
+
* The marker is delivered as its own final text element (see
|
|
55
|
+
* applyWhisperEnvelope) so a multiline whisper body has an
|
|
56
|
+
* unambiguous end boundary even when the body itself spans
|
|
57
|
+
* several lines.
|
|
58
|
+
*/
|
|
59
|
+
export declare function formatWhisperEndMarker(): string;
|
|
60
|
+
/**
|
|
61
|
+
* Apply the universal envelope to a content array in place.
|
|
62
|
+
* Prepends the envelope line (with `@ HH:MM TZ` generation timestamp) to the
|
|
63
|
+
* first text element, separated by `\n` so the opening tag line carries
|
|
64
|
+
* nothing after `]` and the body starts on the next line. If no text element
|
|
65
|
+
* exists, a new text element is prepended. Always appends a final
|
|
66
|
+
* `[braid-whisper-end]` marker as the LAST text element so every whisper has
|
|
67
|
+
* an unambiguous end boundary.
|
|
68
|
+
*
|
|
69
|
+
* The end-marker is added as a separate trailing text element (rather
|
|
70
|
+
* than being appended inside the last element's text) so the envelope
|
|
71
|
+
* prefix on the first element is never clobbered and the marker always
|
|
72
|
+
* lands on its own line when pi renders multi-part text content.
|
|
73
|
+
*
|
|
74
|
+
* Mutates the input array. This is acceptable because all callers
|
|
75
|
+
* create the content array inline and do not reuse it after delivery.
|
|
76
|
+
*
|
|
77
|
+
* @param content message content array (mutated in place)
|
|
78
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
79
|
+
* @param now clock instant for the header timestamp (default now;
|
|
80
|
+
* test hook pins it)
|
|
81
|
+
*
|
|
82
|
+
* Example:
|
|
83
|
+
* Input: [{ type: "text", text: "Error burst detected" }]
|
|
84
|
+
* Source: "enforcement/whisper"
|
|
85
|
+
* After: [
|
|
86
|
+
* { type: "text", text: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected" },
|
|
87
|
+
* { type: "text", text: "[braid-whisper-end]" },
|
|
88
|
+
* ]
|
|
89
|
+
* Rendered: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected\n[braid-whisper-end]"
|
|
90
|
+
*/
|
|
91
|
+
export declare function applyWhisperEnvelope(content: {
|
|
92
|
+
type: string;
|
|
93
|
+
text?: string;
|
|
94
|
+
}[], source: string, now?: Date): void;
|
|
95
|
+
//# sourceMappingURL=whisper-format.d.ts.map
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whisper Envelope - Universal prefix for system-injected messages.
|
|
3
|
+
*
|
|
4
|
+
* Every message sent via `sendTrackedMessage` is wrapped with a
|
|
5
|
+
* `[braid-whisper - <subsystem> @ <time>]` envelope and closed with an
|
|
6
|
+
* explicit `[braid-whisper-end]` end-marker so the agent can reliably
|
|
7
|
+
* distinguish system-injected signals from human user input, can
|
|
8
|
+
* unambiguously detect where a (possibly multiline) whisper body ends,
|
|
9
|
+
* and can tell a fresh whisper from a stale re-injection (header clock).
|
|
10
|
+
*
|
|
11
|
+
* The envelope AND the end-marker are added centrally in
|
|
12
|
+
* `sendTrackedMessage` (the trunk) so all 30+ call sites automatically
|
|
13
|
+
* benefit without per-site changes.
|
|
14
|
+
*
|
|
15
|
+
* The subsystem is derived from the source path's first segment
|
|
16
|
+
* (e.g. "enforcement/whisper" -> "enforcement",
|
|
17
|
+
* "memory/context-manager" -> "memory",
|
|
18
|
+
* "cognitive/sycophancy-detector" -> "cognitive").
|
|
19
|
+
*
|
|
20
|
+
* The full source is preserved in the message metadata
|
|
21
|
+
* (`details._braidSource`) for debugging and analytics.
|
|
22
|
+
*
|
|
23
|
+
* Filters: the subsystem name is a substring of the envelope
|
|
24
|
+
* ("enforcement" matches "[braid-whisper - enforcement]"), so bare-name
|
|
25
|
+
* filters keep working; bracket-prefix filters
|
|
26
|
+
* (`grep '\[enforcement\]'`) need the canonical form
|
|
27
|
+
* `grep '\[braid-whisper - enforcement\]'`. Body-level sub-tags
|
|
28
|
+
* (`[<subsystem>-<event>]`) can still be added inside the message body
|
|
29
|
+
* as a second filter level - the envelope is one level above them.
|
|
30
|
+
*/
|
|
31
|
+
import { formatWhisperClock, nowOrOverride } from "./local-time.js";
|
|
32
|
+
/**
|
|
33
|
+
* Format the universal envelope line for a given source.
|
|
34
|
+
* Returns "[braid-whisper - <subsystem> @ 17:05 MSK]" with no trailing
|
|
35
|
+
* whitespace.
|
|
36
|
+
*
|
|
37
|
+
* The subsystem is the first segment of the source path. If the source
|
|
38
|
+
* is empty or has no "/", the literal "system" is used as the fallback.
|
|
39
|
+
*
|
|
40
|
+
* The `@ HH:MM TZ` timestamp is the
|
|
41
|
+
* generation time in the owner time zone (lib/utils/local-time.ts) — it
|
|
42
|
+
* lets the agent tell a fresh whisper from a stale re-injection. It is
|
|
43
|
+
* rendered by the ONE formatter (formatWhisperClock) so whisper headers
|
|
44
|
+
* and body time strings never diverge.
|
|
45
|
+
*
|
|
46
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
47
|
+
* @param now clock instant (default now; test hook setLocalTimeClockForTests
|
|
48
|
+
* pins it for deterministic assertions)
|
|
49
|
+
*/
|
|
50
|
+
export function formatWhisperEnvelope(source, now = nowOrOverride()) {
|
|
51
|
+
const subsystem = source.split("/")[0] || "system";
|
|
52
|
+
return `[braid-whisper - ${subsystem} @ ${formatWhisperClock(now)}]`;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Format the explicit end-marker that closes every braid whisper.
|
|
56
|
+
* Returns "[braid-whisper-end]" with no trailing whitespace.
|
|
57
|
+
*
|
|
58
|
+
* The marker is delivered as its own final text element (see
|
|
59
|
+
* applyWhisperEnvelope) so a multiline whisper body has an
|
|
60
|
+
* unambiguous end boundary even when the body itself spans
|
|
61
|
+
* several lines.
|
|
62
|
+
*/
|
|
63
|
+
export function formatWhisperEndMarker() {
|
|
64
|
+
return "[braid-whisper-end]";
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Apply the universal envelope to a content array in place.
|
|
68
|
+
* Prepends the envelope line (with `@ HH:MM TZ` generation timestamp) to the
|
|
69
|
+
* first text element, separated by `\n` so the opening tag line carries
|
|
70
|
+
* nothing after `]` and the body starts on the next line. If no text element
|
|
71
|
+
* exists, a new text element is prepended. Always appends a final
|
|
72
|
+
* `[braid-whisper-end]` marker as the LAST text element so every whisper has
|
|
73
|
+
* an unambiguous end boundary.
|
|
74
|
+
*
|
|
75
|
+
* The end-marker is added as a separate trailing text element (rather
|
|
76
|
+
* than being appended inside the last element's text) so the envelope
|
|
77
|
+
* prefix on the first element is never clobbered and the marker always
|
|
78
|
+
* lands on its own line when pi renders multi-part text content.
|
|
79
|
+
*
|
|
80
|
+
* Mutates the input array. This is acceptable because all callers
|
|
81
|
+
* create the content array inline and do not reuse it after delivery.
|
|
82
|
+
*
|
|
83
|
+
* @param content message content array (mutated in place)
|
|
84
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
85
|
+
* @param now clock instant for the header timestamp (default now;
|
|
86
|
+
* test hook pins it)
|
|
87
|
+
*
|
|
88
|
+
* Example:
|
|
89
|
+
* Input: [{ type: "text", text: "Error burst detected" }]
|
|
90
|
+
* Source: "enforcement/whisper"
|
|
91
|
+
* After: [
|
|
92
|
+
* { type: "text", text: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected" },
|
|
93
|
+
* { type: "text", text: "[braid-whisper-end]" },
|
|
94
|
+
* ]
|
|
95
|
+
* Rendered: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected\n[braid-whisper-end]"
|
|
96
|
+
*/
|
|
97
|
+
export function applyWhisperEnvelope(content, source, now = nowOrOverride()) {
|
|
98
|
+
const envelope = formatWhisperEnvelope(source, now);
|
|
99
|
+
if (content.length === 0) {
|
|
100
|
+
content.unshift({ type: "text", text: `${envelope}\n` });
|
|
101
|
+
}
|
|
102
|
+
else {
|
|
103
|
+
const firstText = content.find((c) => c.type === "text");
|
|
104
|
+
if (firstText) {
|
|
105
|
+
const currentText = firstText.text ?? "";
|
|
106
|
+
firstText.text =
|
|
107
|
+
currentText.length > 0 ? `${envelope}\n${currentText}` : `${envelope}\n`;
|
|
108
|
+
}
|
|
109
|
+
else {
|
|
110
|
+
content.unshift({ type: "text", text: `${envelope}\n` });
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
content.push({ type: "text", text: formatWhisperEndMarker() });
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=whisper-format.js.map
|