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,318 @@
|
|
|
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
|
+
import { createLogger } from "../core/logger.js";
|
|
96
|
+
import { SESSION_BEFORE_COMPACT, SESSION_START, SESSION_SHUTDOWN } from "../core/event-names.js";
|
|
97
|
+
|
|
98
|
+
const log = createLogger("wake-gate");
|
|
99
|
+
|
|
100
|
+
// True while a session prompt is being prepared (pre-flight tail) so that a
|
|
101
|
+
// triggerTurn wake would start a COMPETING run. Cleared at agent_start: from
|
|
102
|
+
// then on pi-core's own isStreaming queueing takes over.
|
|
103
|
+
let _runRegionActive = false;
|
|
104
|
+
|
|
105
|
+
/** Structural slice of ExtensionContext the busy query needs. The getters
|
|
106
|
+
* are live: each ctx reads current runtime state at call time, so a
|
|
107
|
+
* captured ctx answers truthfully until the runner is invalidated (session
|
|
108
|
+
* replacement/reload — the call throws and the query fails open). */
|
|
109
|
+
interface AgentStateCtx {
|
|
110
|
+
isIdle: () => boolean;
|
|
111
|
+
signal: AbortSignal | undefined;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// The most recently observed session ctx, captured from wake-gate's own
|
|
115
|
+
// event handlers. Its getters stay live across events, so a ctx captured
|
|
116
|
+
// at session start still reads current state when a wake sends minutes
|
|
117
|
+
// later.
|
|
118
|
+
let _lastAgentCtx: AgentStateCtx | null = null;
|
|
119
|
+
|
|
120
|
+
function captureAgentCtx(ctx: unknown): void {
|
|
121
|
+
if (ctx && typeof ctx === "object") _lastAgentCtx = ctx as AgentStateCtx;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* Whether the session is busy in the state that makes a raw triggerTurn
|
|
126
|
+
* send dangerous: no streaming run holds the queue (`signal` undefined) but
|
|
127
|
+
* the session is not idle either (`isIdle` false — compaction, or run
|
|
128
|
+
* pre-flight/bookkeeping). pi-core's sendCustomMessage would route such a
|
|
129
|
+
* send to `_runAgentPrompt` and start a competing agent run.
|
|
130
|
+
*
|
|
131
|
+
* Fails open (false) unless busy is POSITIVELY determined: no ctx captured
|
|
132
|
+
* yet, a ctx without live readers, or a stale ctx (its getters throw after
|
|
133
|
+
* session replacement) all mean "unknown" — the region gate above stays the
|
|
134
|
+
* safety net for those.
|
|
135
|
+
*/
|
|
136
|
+
export function isAgentBusy(): boolean {
|
|
137
|
+
const ctx = _lastAgentCtx;
|
|
138
|
+
if (!ctx || typeof ctx.isIdle !== "function") return false;
|
|
139
|
+
try {
|
|
140
|
+
return ctx.signal === undefined && ctx.isIdle() === false;
|
|
141
|
+
} catch {
|
|
142
|
+
return false;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
// Fail-safe bound: how long a run region may stay armed without a release
|
|
147
|
+
// event before the gate auto-clears. Covers the legitimate pre-flight tail
|
|
148
|
+
// (sub-second) and a compaction summarization (session_before_compact re-arms
|
|
149
|
+
// the timer, so the bound only needs to exceed a single compaction). Guards
|
|
150
|
+
// against a pre-flight abort (auth/quota) leaving the gate stuck true, which
|
|
151
|
+
// rewrites every triggerTurn wake to a queued steer that never starts a turn.
|
|
152
|
+
export const RUN_REGION_MAX_MS = 120_000;
|
|
153
|
+
|
|
154
|
+
let _failSafeHandle: ReturnType<typeof setTimeout> | null = null;
|
|
155
|
+
// Test hook: override the fail-safe bound (null restores the default).
|
|
156
|
+
let _failSafeMsOverride: number | null = null;
|
|
157
|
+
|
|
158
|
+
function failSafeMs(): number {
|
|
159
|
+
return _failSafeMsOverride ?? RUN_REGION_MAX_MS;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
function clearFailSafe(): void {
|
|
163
|
+
if (_failSafeHandle) {
|
|
164
|
+
clearTimeout(_failSafeHandle);
|
|
165
|
+
_failSafeHandle = null;
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** Arm the gate (or re-arm it, resetting the fail-safe window). */
|
|
170
|
+
function armRunRegion(): void {
|
|
171
|
+
_runRegionActive = true;
|
|
172
|
+
clearFailSafe();
|
|
173
|
+
_failSafeHandle = setTimeout(() => {
|
|
174
|
+
_failSafeHandle = null;
|
|
175
|
+
_runRegionActive = false;
|
|
176
|
+
log.warn(
|
|
177
|
+
`[wake-gate] fail-safe: run region auto-cleared after ${failSafeMs()}ms without a release event ` +
|
|
178
|
+
`(pre-flight abort?) — triggerTurn wakes ungated again`,
|
|
179
|
+
);
|
|
180
|
+
}, failSafeMs());
|
|
181
|
+
// Do not keep the process alive for a stuck gate.
|
|
182
|
+
if (typeof (_failSafeHandle as { unref?: () => void } | null)?.unref === "function") {
|
|
183
|
+
(_failSafeHandle as { unref: () => void }).unref();
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** Release the gate and cancel the fail-safe timer. */
|
|
188
|
+
function releaseRunRegion(): void {
|
|
189
|
+
_runRegionActive = false;
|
|
190
|
+
clearFailSafe();
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** Whether a triggerTurn send should be gated (pre-flight tail in progress). */
|
|
194
|
+
export function isRunRegionActive(): boolean {
|
|
195
|
+
return _runRegionActive;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/** Test hook: reset module state between fixtures (also cancels the fail-safe). */
|
|
199
|
+
export function resetWakeGateForTests(): void {
|
|
200
|
+
releaseRunRegion();
|
|
201
|
+
_lastAgentCtx = null;
|
|
202
|
+
_failSafeMsOverride = null;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** Test hook: shorten/extend the fail-safe bound (null restores the default). */
|
|
206
|
+
export function _setWakeGateFailSafeMsForTests(ms: number | null): void {
|
|
207
|
+
_failSafeMsOverride = ms;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* Register the wake-gate event subscriptions. Call once per pi session
|
|
212
|
+
* (alongside registerInjectionTracker — the enforcement bootstrap in
|
|
213
|
+
* handler-registry.ts wires both).
|
|
214
|
+
*
|
|
215
|
+
* The local `on` type widens ExtensionAPI's overloaded on() so we can pass
|
|
216
|
+
* plain event names without TypeScript picking an overload.
|
|
217
|
+
*/
|
|
218
|
+
export function registerWakeGate(pi: {
|
|
219
|
+
on: (event: string, handler: (...args: any[]) => any) => void;
|
|
220
|
+
}): void {
|
|
221
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
222
|
+
"before_agent_start",
|
|
223
|
+
(_event: unknown, ctx: unknown) => {
|
|
224
|
+
captureAgentCtx(ctx);
|
|
225
|
+
armRunRegion();
|
|
226
|
+
},
|
|
227
|
+
);
|
|
228
|
+
// `input` fires at session.prompt() ENTRY — before the pre-flight
|
|
229
|
+
// (model/auth checks, _checkCompaction) and before before_agent_start.
|
|
230
|
+
// Arming here closes the prompt-entry competing-run window for
|
|
231
|
+
// extension-originated sends (a wake landing between prompt entry and
|
|
232
|
+
// before_agent_start was previously ungated). Arm ONLY when the prompt
|
|
233
|
+
// will start a NEW run: `streamingBehavior` is set exactly when the input
|
|
234
|
+
// is a steer/followUp into an ACTIVE run (pi-core queues it without
|
|
235
|
+
// starting a run, and agent_start will not re-fire) — arming there would
|
|
236
|
+
// leak the gate past the run's end until the fail-safe. Input arms use the
|
|
237
|
+
// same armRunRegion path, so the 120s fail-safe semantics apply unchanged.
|
|
238
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
239
|
+
"input",
|
|
240
|
+
(event: { streamingBehavior?: string }, ctx: unknown) => {
|
|
241
|
+
captureAgentCtx(ctx);
|
|
242
|
+
if (event?.streamingBehavior === undefined) armRunRegion();
|
|
243
|
+
},
|
|
244
|
+
);
|
|
245
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
246
|
+
SESSION_BEFORE_COMPACT,
|
|
247
|
+
(_event: unknown, ctx: unknown) => {
|
|
248
|
+
captureAgentCtx(ctx);
|
|
249
|
+
armRunRegion();
|
|
250
|
+
},
|
|
251
|
+
);
|
|
252
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
253
|
+
"agent_start",
|
|
254
|
+
(_event: unknown, ctx: unknown) => {
|
|
255
|
+
captureAgentCtx(ctx);
|
|
256
|
+
releaseRunRegion();
|
|
257
|
+
},
|
|
258
|
+
);
|
|
259
|
+
// Manual compaction: agent is aborted + idle (no run follows) — release so
|
|
260
|
+
// the post-compaction auto-resume wake passes through ungated.
|
|
261
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
262
|
+
"session_compact",
|
|
263
|
+
(_event: unknown, ctx: unknown) => {
|
|
264
|
+
captureAgentCtx(ctx);
|
|
265
|
+
releaseRunRegion();
|
|
266
|
+
},
|
|
267
|
+
);
|
|
268
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(
|
|
269
|
+
SESSION_START,
|
|
270
|
+
(_event: unknown, ctx: unknown) => {
|
|
271
|
+
captureAgentCtx(ctx);
|
|
272
|
+
releaseRunRegion();
|
|
273
|
+
},
|
|
274
|
+
);
|
|
275
|
+
(pi.on as (event: string, handler: (...args: any[]) => any) => void)(SESSION_SHUTDOWN, () => {
|
|
276
|
+
releaseRunRegion();
|
|
277
|
+
_lastAgentCtx = null; // no live session after shutdown: fail open until the next capture
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/** Delivery options handed to pi.sendMessage / sendTrackedMessage. */
|
|
282
|
+
export interface WakeDeliveryOptions {
|
|
283
|
+
triggerTurn?: boolean;
|
|
284
|
+
deliverAs?: string;
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
/**
|
|
288
|
+
* Gate a triggerTurn send on the run-region state.
|
|
289
|
+
*
|
|
290
|
+
* - Not a triggerTurn, or no run region active -> options unchanged (wake hits
|
|
291
|
+
* pi-core's triggerTurn branch exactly as before: idle wake preserved).
|
|
292
|
+
* - Run region active -> triggerTurn is dropped entirely and the send takes
|
|
293
|
+
* the funnel's live shape `{ deliverAs }` (steer by default, preserving an
|
|
294
|
+
* explicit deliverAs). pi-core 1.0.2 routes that shape by live state
|
|
295
|
+
* (dist/core/agent-session.js:1759-1782): while a run is streaming it steers
|
|
296
|
+
* into that run (branch 2); in the pre-flight (isStreaming false) it is
|
|
297
|
+
* appended to the session immediately (branch 5), so the imminent run reads
|
|
298
|
+
* it. Neither route starts a competing run. Returning
|
|
299
|
+
* `triggerTurn: false` instead would park the wake to the end-of-turn flush
|
|
300
|
+
* (branch 4) - pi 0.84.2 made that shape park (PR #8022), which is what
|
|
301
|
+
* this gate used to return.
|
|
302
|
+
*
|
|
303
|
+
* REVERT-PROOF contract: removing the gate (or never registering it) means
|
|
304
|
+
* `_runRegionActive` stays false and every triggerTurn send passes through
|
|
305
|
+
* ungated — the fixture test in test-wake-gate.mjs fails, pinning the gate.
|
|
306
|
+
*/
|
|
307
|
+
export function gateTriggerTurnOptions(
|
|
308
|
+
options: WakeDeliveryOptions | undefined,
|
|
309
|
+
): WakeDeliveryOptions | undefined {
|
|
310
|
+
if (!options?.triggerTurn) return options;
|
|
311
|
+
if (!_runRegionActive) return options;
|
|
312
|
+
log.info(
|
|
313
|
+
`[wake-gate] triggerTurn wake gated to live delivery (run region active) - deliverAs=${
|
|
314
|
+
options.deliverAs ?? "steer"
|
|
315
|
+
}`,
|
|
316
|
+
);
|
|
317
|
+
return { deliverAs: options.deliverAs ?? "steer" };
|
|
318
|
+
}
|
|
@@ -0,0 +1,120 @@
|
|
|
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
|
+
import { formatWhisperClock, nowOrOverride } from "./local-time.js";
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Format the universal envelope line for a given source.
|
|
36
|
+
* Returns "[braid-whisper - <subsystem> @ 17:05 MSK]" with no trailing
|
|
37
|
+
* whitespace.
|
|
38
|
+
*
|
|
39
|
+
* The subsystem is the first segment of the source path. If the source
|
|
40
|
+
* is empty or has no "/", the literal "system" is used as the fallback.
|
|
41
|
+
*
|
|
42
|
+
* The `@ HH:MM TZ` timestamp is the
|
|
43
|
+
* generation time in the owner time zone (lib/utils/local-time.ts) — it
|
|
44
|
+
* lets the agent tell a fresh whisper from a stale re-injection. It is
|
|
45
|
+
* rendered by the ONE formatter (formatWhisperClock) so whisper headers
|
|
46
|
+
* and body time strings never diverge.
|
|
47
|
+
*
|
|
48
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
49
|
+
* @param now clock instant (default now; test hook setLocalTimeClockForTests
|
|
50
|
+
* pins it for deterministic assertions)
|
|
51
|
+
*/
|
|
52
|
+
export function formatWhisperEnvelope(source: string, now: Date = nowOrOverride()): string {
|
|
53
|
+
const subsystem = source.split("/")[0] || "system";
|
|
54
|
+
return `[braid-whisper - ${subsystem} @ ${formatWhisperClock(now)}]`;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Format the explicit end-marker that closes every braid whisper.
|
|
59
|
+
* Returns "[braid-whisper-end]" with no trailing whitespace.
|
|
60
|
+
*
|
|
61
|
+
* The marker is delivered as its own final text element (see
|
|
62
|
+
* applyWhisperEnvelope) so a multiline whisper body has an
|
|
63
|
+
* unambiguous end boundary even when the body itself spans
|
|
64
|
+
* several lines.
|
|
65
|
+
*/
|
|
66
|
+
export function formatWhisperEndMarker(): string {
|
|
67
|
+
return "[braid-whisper-end]";
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Apply the universal envelope to a content array in place.
|
|
72
|
+
* Prepends the envelope line (with `@ HH:MM TZ` generation timestamp) to the
|
|
73
|
+
* first text element, separated by `\n` so the opening tag line carries
|
|
74
|
+
* nothing after `]` and the body starts on the next line. If no text element
|
|
75
|
+
* exists, a new text element is prepended. Always appends a final
|
|
76
|
+
* `[braid-whisper-end]` marker as the LAST text element so every whisper has
|
|
77
|
+
* an unambiguous end boundary.
|
|
78
|
+
*
|
|
79
|
+
* The end-marker is added as a separate trailing text element (rather
|
|
80
|
+
* than being appended inside the last element's text) so the envelope
|
|
81
|
+
* prefix on the first element is never clobbered and the marker always
|
|
82
|
+
* lands on its own line when pi renders multi-part text content.
|
|
83
|
+
*
|
|
84
|
+
* Mutates the input array. This is acceptable because all callers
|
|
85
|
+
* create the content array inline and do not reuse it after delivery.
|
|
86
|
+
*
|
|
87
|
+
* @param content message content array (mutated in place)
|
|
88
|
+
* @param source source path; first segment becomes the subsystem tag
|
|
89
|
+
* @param now clock instant for the header timestamp (default now;
|
|
90
|
+
* test hook pins it)
|
|
91
|
+
*
|
|
92
|
+
* Example:
|
|
93
|
+
* Input: [{ type: "text", text: "Error burst detected" }]
|
|
94
|
+
* Source: "enforcement/whisper"
|
|
95
|
+
* After: [
|
|
96
|
+
* { type: "text", text: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected" },
|
|
97
|
+
* { type: "text", text: "[braid-whisper-end]" },
|
|
98
|
+
* ]
|
|
99
|
+
* Rendered: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected\n[braid-whisper-end]"
|
|
100
|
+
*/
|
|
101
|
+
export function applyWhisperEnvelope(
|
|
102
|
+
content: { type: string; text?: string }[],
|
|
103
|
+
source: string,
|
|
104
|
+
now: Date = nowOrOverride(),
|
|
105
|
+
): void {
|
|
106
|
+
const envelope = formatWhisperEnvelope(source, now);
|
|
107
|
+
if (content.length === 0) {
|
|
108
|
+
content.unshift({ type: "text", text: `${envelope}\n` });
|
|
109
|
+
} else {
|
|
110
|
+
const firstText = content.find((c) => c.type === "text");
|
|
111
|
+
if (firstText) {
|
|
112
|
+
const currentText = (firstText as { text?: string }).text ?? "";
|
|
113
|
+
(firstText as { type: string; text?: string }).text =
|
|
114
|
+
currentText.length > 0 ? `${envelope}\n${currentText}` : `${envelope}\n`;
|
|
115
|
+
} else {
|
|
116
|
+
content.unshift({ type: "text", text: `${envelope}\n` });
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
content.push({ type: "text", text: formatWhisperEndMarker() });
|
|
120
|
+
}
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Coordination Checker.
|
|
3
|
+
*
|
|
4
|
+
* Tracks derived-from relationships between files (e.g., a generated file
|
|
5
|
+
* derives from its generator template). When a generator is edited, the
|
|
6
|
+
* checker warns if its derived files have not been updated since the edit.
|
|
7
|
+
*
|
|
8
|
+
* The failure mode: the agent fixes a generator template but forgets to
|
|
9
|
+
* regenerate the output file. This checker catches it before the agent
|
|
10
|
+
* claims done.
|
|
11
|
+
*
|
|
12
|
+
* Current status: `entries` is written only by `registerDerived`, which nothing
|
|
13
|
+
* in the tree calls: no build step or extension registers a relationship, and
|
|
14
|
+
* the state key is module-private, so it cannot be populated from elsewhere.
|
|
15
|
+
* `checkCoordination` therefore returns no warnings for any edit today; the
|
|
16
|
+
* edit path in extensions/enforcement/handlers/register-tool-call.ts is wired
|
|
17
|
+
* and starts warning as soon as a registration exists.
|
|
18
|
+
*
|
|
19
|
+
* Usage:
|
|
20
|
+
* import { registerDerived, checkCoordination, getCoordinationState } from "./coordination-checker.js";
|
|
21
|
+
*
|
|
22
|
+
* // In a build step: registerDerived(ctx, "template.tsx", "generated/Output.tsx");
|
|
23
|
+
* // On edit: const warnings = checkCoordination(ctx, "template.tsx", currentTurn);
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
27
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
28
|
+
import { createLogger } from "../core/logger.js";
|
|
29
|
+
|
|
30
|
+
const log = createLogger("verification:coordination");
|
|
31
|
+
|
|
32
|
+
// ── Types ──────────────────────────────────────────────────────────────────
|
|
33
|
+
|
|
34
|
+
export interface CoordinationEntry {
|
|
35
|
+
/** The generator file path (normalized). */
|
|
36
|
+
generator: string;
|
|
37
|
+
/** The derived/generated file path (normalized). */
|
|
38
|
+
derived: string;
|
|
39
|
+
/** Turn when this relationship was registered. */
|
|
40
|
+
registeredTurn: number;
|
|
41
|
+
/** Turn when the derived file was last known to be updated (0 = never). */
|
|
42
|
+
lastDerivedUpdatedTurn: number;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export interface CoordinationState {
|
|
46
|
+
/** Registered derived-from relationships. */
|
|
47
|
+
entries: CoordinationEntry[];
|
|
48
|
+
/** Set of turns when each file was last edited (from file-touch tracking). */
|
|
49
|
+
fileEditTurns: Map<string, number>;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export interface CoordinationWarning {
|
|
53
|
+
generator: string;
|
|
54
|
+
derived: string;
|
|
55
|
+
message: string;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
// ── Constants ──────────────────────────────────────────────────────────────
|
|
59
|
+
|
|
60
|
+
const COORDINATION_STATE_KEY = "verification-coordination";
|
|
61
|
+
|
|
62
|
+
// ── State Factory ──────────────────────────────────────────────────────────
|
|
63
|
+
|
|
64
|
+
function createState(): CoordinationState {
|
|
65
|
+
return {
|
|
66
|
+
entries: [],
|
|
67
|
+
fileEditTurns: new Map(),
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export function getCoordinationState(ctx: ExtensionContext): CoordinationState {
|
|
72
|
+
return getExtensionState(ctx, COORDINATION_STATE_KEY, createState);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
// ── Path Normalization ─────────────────────────────────────────────────────
|
|
76
|
+
|
|
77
|
+
function normalize(p: string): string {
|
|
78
|
+
return p.replace(/^\.\//, "").replace(/^\.\.\//, "");
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
// ── Public API ─────────────────────────────────────────────────────────────
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Register a derived-from relationship.
|
|
85
|
+
*
|
|
86
|
+
* @param ctx - Extension context
|
|
87
|
+
* @param generator - Path to the generator/template file (e.g., "src/template.tsx")
|
|
88
|
+
* @param derived - Path to the derived/generated file (e.g., "generated/Output.tsx")
|
|
89
|
+
*/
|
|
90
|
+
export function registerDerived(ctx: ExtensionContext, generator: string, derived: string): void {
|
|
91
|
+
const state = getCoordinationState(ctx);
|
|
92
|
+
const gen = normalize(generator);
|
|
93
|
+
const der = normalize(derived);
|
|
94
|
+
|
|
95
|
+
// Avoid duplicates
|
|
96
|
+
const exists = state.entries.some((e) => e.generator === gen && e.derived === der);
|
|
97
|
+
if (exists) return;
|
|
98
|
+
|
|
99
|
+
state.entries.push({
|
|
100
|
+
generator: gen,
|
|
101
|
+
derived: der,
|
|
102
|
+
registeredTurn: getCurrentTurn(ctx),
|
|
103
|
+
lastDerivedUpdatedTurn: 0,
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
log.info(`Registered derived: ${gen} -> ${der}`);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Record that a file was edited at the given turn.
|
|
111
|
+
* Called by the enforcement handler alongside recordFileTouch.
|
|
112
|
+
*/
|
|
113
|
+
export function recordCoordinationEdit(
|
|
114
|
+
ctx: ExtensionContext,
|
|
115
|
+
filePath: string,
|
|
116
|
+
turn: number,
|
|
117
|
+
): void {
|
|
118
|
+
const state = getCoordinationState(ctx);
|
|
119
|
+
state.fileEditTurns.set(normalize(filePath), turn);
|
|
120
|
+
|
|
121
|
+
// If an edited file is a derived file, update its lastDerivedUpdatedTurn
|
|
122
|
+
const fp = normalize(filePath);
|
|
123
|
+
for (const entry of state.entries) {
|
|
124
|
+
if (entry.derived === fp) {
|
|
125
|
+
entry.lastDerivedUpdatedTurn = turn;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* Check if editing a file would leave stale derived files behind.
|
|
132
|
+
* Returns warnings for each derived relationship where the generator
|
|
133
|
+
* was edited after the derived file was last updated.
|
|
134
|
+
*
|
|
135
|
+
* @param ctx - Extension context
|
|
136
|
+
* @param editedFile - The file that was just edited
|
|
137
|
+
* @param currentTurn - Current turn number
|
|
138
|
+
* @returns Array of coordination warnings (empty if none)
|
|
139
|
+
*/
|
|
140
|
+
export function checkCoordination(
|
|
141
|
+
ctx: ExtensionContext,
|
|
142
|
+
editedFile: string,
|
|
143
|
+
currentTurn: number,
|
|
144
|
+
): CoordinationWarning[] {
|
|
145
|
+
const state = getCoordinationState(ctx);
|
|
146
|
+
const fp = normalize(editedFile);
|
|
147
|
+
const warnings: CoordinationWarning[] = [];
|
|
148
|
+
|
|
149
|
+
const generatorEntries = state.entries.filter((e) => e.generator === fp);
|
|
150
|
+
|
|
151
|
+
for (const entry of generatorEntries) {
|
|
152
|
+
const editTurn = state.fileEditTurns.get(fp) ?? currentTurn;
|
|
153
|
+
|
|
154
|
+
// If the derived file was never updated, or was updated before this edit
|
|
155
|
+
if (entry.lastDerivedUpdatedTurn === 0 || entry.lastDerivedUpdatedTurn < editTurn) {
|
|
156
|
+
const warning: CoordinationWarning = {
|
|
157
|
+
generator: entry.generator,
|
|
158
|
+
derived: entry.derived,
|
|
159
|
+
message:
|
|
160
|
+
`Coordination: "${entry.generator}" was edited but derived file ` +
|
|
161
|
+
`"${entry.derived}" has not been updated since. ` +
|
|
162
|
+
`If "${entry.derived}" is generated from "${entry.generator}", ` +
|
|
163
|
+
`you may need to regenerate it.`,
|
|
164
|
+
};
|
|
165
|
+
warnings.push(warning);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
if (warnings.length > 0) {
|
|
170
|
+
log.info(`Coordination warnings for ${fp}: ${warnings.length}`);
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
return warnings;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Get the current turn number from the extension context.
|
|
178
|
+
* Falls back to 0 if not available.
|
|
179
|
+
*/
|
|
180
|
+
function getCurrentTurn(ctx: ExtensionContext): number {
|
|
181
|
+
const enforcementState = getExtensionState(ctx, "enforcement", () => ({})) as any;
|
|
182
|
+
return enforcementState.currentTurn ?? 0;
|
|
183
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/loader/ - Extension Loader + Subagent API
|
|
4
|
+
|
|
5
|
+
Runtime machinery that decides which extensions to load and exposes
|
|
6
|
+
runtime toggling to a researcher subagent.
|
|
7
|
+
|
|
8
|
+
This directory was previously named `src/modules/`. The rename clarifies
|
|
9
|
+
that it contains the **loader** (and the related subagent API), not
|
|
10
|
+
"module definitions" - the flat extension manifest lives in
|
|
11
|
+
`src/extensions/manifest.ts`.
|
|
12
|
+
|
|
13
|
+
## Files
|
|
14
|
+
|
|
15
|
+
| File | Purpose |
|
|
16
|
+
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
17
|
+
| `loader.ts` | Resolves `BRAID_MODULES` / `braid.modules` (pi global, pi project, braid's store) / runtime overrides into an enabled set, topologically sorts by dependency, and invokes each factory. |
|
|
18
|
+
| `api.ts` | Registers `/modules-enable`, `/modules-disable`, `/modules-toggle`, `/modules-list`, `/modules-status`, `/modules-reset` commands for the subagent API. |
|
|
19
|
+
|
|
20
|
+
## Layer position
|
|
21
|
+
|
|
22
|
+
Per `scripts/check-deps.mjs`:
|
|
23
|
+
|
|
24
|
+
- `loader/` may import from `lib/` and `extensions/` (it must read the manifest to know what to load).
|
|
25
|
+
- `loader/` may not import from other top-level layers.
|
|
26
|
+
- `lib/` and `extensions/` may not import from `loader/`.
|
|
27
|
+
|
|
28
|
+
## Local contracts
|
|
29
|
+
|
|
30
|
+
- The loader never imports from `extensions/` for _types_ - only the manifest file. This keeps the dependency direction clean.
|
|
31
|
+
- State is process-global (`_loaderState`). Don't put per-session data here.
|
|
32
|
+
- Persisted state lives in braid's own `braid.modules` store, not in a pi settings file: `getModuleOverridesFilePath()` resolves `braidDir()/projects/<project>/module-overrides.json` (`braidDir()/module-overrides.json` with no cwd), installed by a temp-file-plus-rename write. pi's global and project settings files are read as inputs, in that order, and never written.
|