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,741 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared global state utilities for pi-braid.
|
|
3
|
+
*
|
|
4
|
+
* Module-level state shared between extensions that can't use
|
|
5
|
+
* getExtensionState() because they span separate extension contexts.
|
|
6
|
+
*
|
|
7
|
+
* IMPORTANT: These should only be used when module-level state won't work.
|
|
8
|
+
* Prefer getExtensionState() for per-session state. Slots that must be
|
|
9
|
+
* visible across module instances (src-tree vs compiled-dist imports) use
|
|
10
|
+
* globalThis keys instead - see CUSTOM_MODEL_KEYS_KEY below for the
|
|
11
|
+
* cross-bundle hazard.
|
|
12
|
+
*/
|
|
13
|
+
// globalThis (not a module-level let/const) because the polyfill extension is
|
|
14
|
+
// loaded from the TS SOURCE tree (src/extensions/core/polyfill/index.ts →
|
|
15
|
+
// src/lib/state/global-state.ts) while contrib's model-resolver imports the
|
|
16
|
+
// compiled DIST (dist/lib/state/global-state.js via the pi-braid/lib export).
|
|
17
|
+
// That yields TWO module instances of this file in one process; a module-level
|
|
18
|
+
// Map would be populated by the src instance and read (empty) by the dist
|
|
19
|
+
// instance — the visionModel custom key would fall through to priority-3
|
|
20
|
+
// first-available (MiniMax 429). Same cross-bundle hazard as
|
|
21
|
+
// KEY_RING_FEEDBACK_KEY above; the slot must also survive /reload.
|
|
22
|
+
export const CUSTOM_MODEL_KEYS_KEY = "__braid_custom_model_keys";
|
|
23
|
+
/**
|
|
24
|
+
* Get the shared custom model keys map.
|
|
25
|
+
* polyfill writes to it (/vision-model command).
|
|
26
|
+
* model-resolver reads from it (model resolution).
|
|
27
|
+
*/
|
|
28
|
+
export function getCustomModelKeys() {
|
|
29
|
+
const slot = globalThis;
|
|
30
|
+
if (!slot[CUSTOM_MODEL_KEYS_KEY]) {
|
|
31
|
+
slot[CUSTOM_MODEL_KEYS_KEY] = new Map();
|
|
32
|
+
}
|
|
33
|
+
return slot[CUSTOM_MODEL_KEYS_KEY];
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Read a custom model key (e.g. "utilityModel", "visionModel"): a pattern or an
|
|
37
|
+
* ordered list of them.
|
|
38
|
+
*/
|
|
39
|
+
export function getCustomModelKey(key) {
|
|
40
|
+
return getCustomModelKeys().get(key);
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Set a custom model key: one pattern or an ordered list. Used by polyfill for
|
|
44
|
+
* /utility-model and /vision-model.
|
|
45
|
+
*/
|
|
46
|
+
export function setCustomModelKey(key, value) {
|
|
47
|
+
getCustomModelKeys().set(key, value);
|
|
48
|
+
}
|
|
49
|
+
// The vision role is deprecated: the key keeps priority-1 status as an alias
|
|
50
|
+
// for one release, after which the merged role supplies image-capable models.
|
|
51
|
+
export const VISION_MODEL_KEY = "visionModel";
|
|
52
|
+
export const UTILITY_MODEL_KEY = "utilityModel";
|
|
53
|
+
// The max-power role is folded into utility; the constant survives so the
|
|
54
|
+
// polyfill can recognize and clean the legacy key from settings.json; nothing
|
|
55
|
+
// resolves it as a live role.
|
|
56
|
+
export const MAX_POWER_MODEL_KEY = "maxPowerModel";
|
|
57
|
+
/**
|
|
58
|
+
* One-shot latch for the maxPowerModel deprecation notice. Process-global for
|
|
59
|
+
* the same reason as the keys above: a src-loaded and a dist-loaded instance
|
|
60
|
+
* of this module must agree on whether the notice already fired.
|
|
61
|
+
*/
|
|
62
|
+
const MAX_POWER_NOTICE_KEY = "__braid_max_power_deprecation_notice";
|
|
63
|
+
/** True the first time it is called in this process, false afterwards. */
|
|
64
|
+
export function consumeMaxPowerDeprecationNotice() {
|
|
65
|
+
const slot = globalThis;
|
|
66
|
+
if (slot[MAX_POWER_NOTICE_KEY])
|
|
67
|
+
return false;
|
|
68
|
+
slot[MAX_POWER_NOTICE_KEY] = true;
|
|
69
|
+
return true;
|
|
70
|
+
}
|
|
71
|
+
function createDefaultRotationState() {
|
|
72
|
+
return {
|
|
73
|
+
lastRotationTimestamp: Date.now(),
|
|
74
|
+
turnsSinceRotation: 0,
|
|
75
|
+
rotationCount: 0,
|
|
76
|
+
pendingRotation: false,
|
|
77
|
+
continuationSummary: "",
|
|
78
|
+
lastNudgeTimestamp: 0,
|
|
79
|
+
lastNudgeTurn: 0,
|
|
80
|
+
lastDeepBranchWhisperTimestamp: 0,
|
|
81
|
+
lastDeepBranchWhisperTurn: 0,
|
|
82
|
+
nudgeCount: 0,
|
|
83
|
+
actionTaken: false,
|
|
84
|
+
actionTakenAtTurn: 0,
|
|
85
|
+
emergencyRotation: false,
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
let _rotationState;
|
|
89
|
+
/** Get the shared rotation state object. */
|
|
90
|
+
export function getRotationState() {
|
|
91
|
+
if (!_rotationState) {
|
|
92
|
+
_rotationState = createDefaultRotationState();
|
|
93
|
+
}
|
|
94
|
+
return _rotationState;
|
|
95
|
+
}
|
|
96
|
+
function createDefaultNudgeAnalyticsFallback() {
|
|
97
|
+
return {
|
|
98
|
+
nudgesSent: 0,
|
|
99
|
+
nudgesSuppressed: 0,
|
|
100
|
+
abVariant: "control",
|
|
101
|
+
contextDensity: 0,
|
|
102
|
+
wasDegraded: false,
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
let _nudgeAnalyticsFallback;
|
|
106
|
+
/** Get the shared nudge-analytics fallback object (process-global mirror). */
|
|
107
|
+
export function getNudgeAnalyticsFallback() {
|
|
108
|
+
if (!_nudgeAnalyticsFallback) {
|
|
109
|
+
_nudgeAnalyticsFallback = createDefaultNudgeAnalyticsFallback();
|
|
110
|
+
}
|
|
111
|
+
return _nudgeAnalyticsFallback;
|
|
112
|
+
}
|
|
113
|
+
let _cognitiveMemoryInstance = null;
|
|
114
|
+
/** Set the shared CognitiveMemory instance (called once at first use). */
|
|
115
|
+
export function setCognitiveMemoryInstance(instance) {
|
|
116
|
+
_cognitiveMemoryInstance = instance;
|
|
117
|
+
}
|
|
118
|
+
/** Get the shared CognitiveMemory instance (or null if not yet initialized). */
|
|
119
|
+
export function getCognitiveMemoryInstance() {
|
|
120
|
+
return _cognitiveMemoryInstance;
|
|
121
|
+
}
|
|
122
|
+
//
|
|
123
|
+
// pi-ai v0.80 moved `completeSimple` from the top-level export to the
|
|
124
|
+
// `/compat` subpath (deprecated); `createModels()` gives a `Models` instance,
|
|
125
|
+
// which is the forward-looking API. This slot holds the process-global Models
|
|
126
|
+
// instance created by models-init.ts at startup.
|
|
127
|
+
//
|
|
128
|
+
// Nothing on the auxiliary LLM path reads it: lib/ai/llm-call.ts dispatches
|
|
129
|
+
// through the session's ctx.modelRegistry (see the completion-dispatch block
|
|
130
|
+
// in that module), which resolves credential, provider headers and transport
|
|
131
|
+
// inside pi-core.
|
|
132
|
+
//
|
|
133
|
+
// Opaque type pattern (same as CognitiveMemoryInstance): the Models type is
|
|
134
|
+
// intentionally not imported here — the slot is typed `unknown`.
|
|
135
|
+
let _modelsInstance = null;
|
|
136
|
+
/** Set the shared pi-ai Models instance (called once at startup). */
|
|
137
|
+
export function setModelsInstance(instance) {
|
|
138
|
+
_modelsInstance = instance;
|
|
139
|
+
}
|
|
140
|
+
/** Get the shared pi-ai Models instance (or null if not yet initialized). */
|
|
141
|
+
export function getModelsInstance() {
|
|
142
|
+
return _modelsInstance;
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* Default per-LLM-tier timeout for post-loop classify() calls, consumed by
|
|
146
|
+
* lib/ai/post-loop-classify.ts via getPostLoopTimeoutMs(). The post-loop
|
|
147
|
+
* path runs at session end, when the session model may be busy with
|
|
148
|
+
* finalization. A 10-minute budget per tier (20 min worst-case when both
|
|
149
|
+
* utility and session are tried) is the current tuning: real provider
|
|
150
|
+
* issues surface as real errors, while signal-driven aborts (ESC, session
|
|
151
|
+
* shutdown) remain the normal cancellation path - the timeout is a
|
|
152
|
+
* fallback for orphaned calls, not the cancellation mechanism.
|
|
153
|
+
*/
|
|
154
|
+
export const DEFAULT_POST_LOOP_TIMEOUT_MS = 600_000;
|
|
155
|
+
let _postLoopTimeoutMs;
|
|
156
|
+
/**
|
|
157
|
+
* Get the per-LLM-tier timeout for post-loop classify() calls.
|
|
158
|
+
* Defaults to DEFAULT_POST_LOOP_TIMEOUT_MS (600_000). Tunable via
|
|
159
|
+
* setPostLoopTimeoutMs() - typically called from a /command or
|
|
160
|
+
* startup config so the value can be changed without code changes.
|
|
161
|
+
*/
|
|
162
|
+
export function getPostLoopTimeoutMs() {
|
|
163
|
+
if (_postLoopTimeoutMs === undefined) {
|
|
164
|
+
_postLoopTimeoutMs = DEFAULT_POST_LOOP_TIMEOUT_MS;
|
|
165
|
+
}
|
|
166
|
+
return _postLoopTimeoutMs;
|
|
167
|
+
}
|
|
168
|
+
/** Override the post-loop timeout. Pass a positive number in ms. */
|
|
169
|
+
export function setPostLoopTimeoutMs(value) {
|
|
170
|
+
if (!Number.isFinite(value) || value <= 0) {
|
|
171
|
+
throw new Error(`setPostLoopTimeoutMs: value must be a positive finite number, got ${value}`);
|
|
172
|
+
}
|
|
173
|
+
_postLoopTimeoutMs = value;
|
|
174
|
+
}
|
|
175
|
+
let _llmErrorListener = null;
|
|
176
|
+
let _llmSuccessListener = null;
|
|
177
|
+
/** Set the current LLM call listeners. Pass `null` to clear a slot. */
|
|
178
|
+
export function setLlmCallListeners(listeners) {
|
|
179
|
+
if (listeners.onError !== undefined) {
|
|
180
|
+
_llmErrorListener = listeners.onError ?? null;
|
|
181
|
+
}
|
|
182
|
+
if (listeners.onSuccess !== undefined) {
|
|
183
|
+
_llmSuccessListener = listeners.onSuccess ?? null;
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
/** Read-only access to the current error listener (for the callLlm() body). */
|
|
187
|
+
export function getLlmErrorListener() {
|
|
188
|
+
return _llmErrorListener;
|
|
189
|
+
}
|
|
190
|
+
/** Read-only access to the current success listener (for the callLlm() body). */
|
|
191
|
+
export function getLlmSuccessListener() {
|
|
192
|
+
return _llmSuccessListener;
|
|
193
|
+
}
|
|
194
|
+
/** Clear all listeners. Test helper. */
|
|
195
|
+
export function resetLlmCallListeners() {
|
|
196
|
+
_llmErrorListener = null;
|
|
197
|
+
_llmSuccessListener = null;
|
|
198
|
+
}
|
|
199
|
+
// The pi-braid-providers extension owns the API key rings; core's callLlm and
|
|
200
|
+
// contrib's vision wrapper make direct LLM calls that never emit message_end,
|
|
201
|
+
// so a 429/403 from them must feed back into the ring that owns that
|
|
202
|
+
// provider/model to rotate off a dead key (the ring would otherwise serve the
|
|
203
|
+
// same dead key forever on those paths). providers publishes its handler into
|
|
204
|
+
// this process-global slot at extension load (providers/ring-lifecycle.ts
|
|
205
|
+
// publishKeyRingFeedback).
|
|
206
|
+
//
|
|
207
|
+
// globalThis (not a module-level let) because the two packages cannot import
|
|
208
|
+
// each other — providers stays standalone (no pi-core import) and has no
|
|
209
|
+
// exports map — and the slot must survive /reload. KEY_RING_FEEDBACK_KEY is
|
|
210
|
+
// THE one deliberate cross-package seam; keep the literal in sync with
|
|
211
|
+
// packages/providers/ring-lifecycle.ts.
|
|
212
|
+
export const KEY_RING_FEEDBACK_KEY = "__braid_key_ring_feedback_handler";
|
|
213
|
+
/** Read the ring-feedback handler published by the providers extension. */
|
|
214
|
+
export function getKeyRingFeedbackHandler() {
|
|
215
|
+
const h = globalThis[KEY_RING_FEEDBACK_KEY];
|
|
216
|
+
return h && typeof h === "object" ? h : null;
|
|
217
|
+
}
|
|
218
|
+
/** Override/clear the ring-feedback handler. Test + registration helper. */
|
|
219
|
+
export function setKeyRingFeedbackHandler(handler) {
|
|
220
|
+
globalThis[KEY_RING_FEEDBACK_KEY] = handler ?? null;
|
|
221
|
+
}
|
|
222
|
+
/** Clear the slot. Test helper. */
|
|
223
|
+
export function resetKeyRingFeedbackHandler() {
|
|
224
|
+
globalThis[KEY_RING_FEEDBACK_KEY] = null;
|
|
225
|
+
}
|
|
226
|
+
// The telegram package owns the poller's consecutive getUpdates-failure counter
|
|
227
|
+
// and emits tunnel-down/up transitions through a process-global hub; the core
|
|
228
|
+
// watchdog subscribes here and surfaces the down/recovery whispers. Same
|
|
229
|
+
// deliberate cross-package seam style as KEY_RING_FEEDBACK_KEY — the
|
|
230
|
+
// WATCHDOG_TUNNEL_KEY literal AND the hub protocol MUST stay in sync with
|
|
231
|
+
// packages/telegram/src/lib/watchdog-tunnel.ts (whichever side runs first
|
|
232
|
+
// get-or-creates the hub at the same slot; telegram publishes, core
|
|
233
|
+
// subscribes). If the literal or protocol drifts, tunnel signals silently
|
|
234
|
+
// stop reaching the watchdog.
|
|
235
|
+
export const WATCHDOG_TUNNEL_KEY = "__braid_watchdog_tunnel";
|
|
236
|
+
function createWatchdogTunnelHub() {
|
|
237
|
+
const subs = new Set();
|
|
238
|
+
let status = "unknown";
|
|
239
|
+
let failures = 0;
|
|
240
|
+
let lastError;
|
|
241
|
+
const hub = {
|
|
242
|
+
get status() {
|
|
243
|
+
return status;
|
|
244
|
+
},
|
|
245
|
+
get failures() {
|
|
246
|
+
return failures;
|
|
247
|
+
},
|
|
248
|
+
get lastError() {
|
|
249
|
+
return lastError;
|
|
250
|
+
},
|
|
251
|
+
publish(event) {
|
|
252
|
+
status = event.status;
|
|
253
|
+
failures = event.failures;
|
|
254
|
+
if (event.lastError !== undefined)
|
|
255
|
+
lastError = event.lastError;
|
|
256
|
+
for (const fn of [...subs]) {
|
|
257
|
+
try {
|
|
258
|
+
fn(event);
|
|
259
|
+
}
|
|
260
|
+
catch {
|
|
261
|
+
// A subscriber must never break the bus — the canary keeps running.
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
},
|
|
265
|
+
subscribe(fn) {
|
|
266
|
+
subs.add(fn);
|
|
267
|
+
return () => {
|
|
268
|
+
subs.delete(fn);
|
|
269
|
+
};
|
|
270
|
+
},
|
|
271
|
+
};
|
|
272
|
+
return hub;
|
|
273
|
+
}
|
|
274
|
+
/** Get-or-create the shared watchdog tunnel hub (see WATCHDOG_TUNNEL_KEY). */
|
|
275
|
+
export function getWatchdogTunnelHub() {
|
|
276
|
+
const g = globalThis;
|
|
277
|
+
const existing = g[WATCHDOG_TUNNEL_KEY];
|
|
278
|
+
if (existing && typeof existing?.publish === "function")
|
|
279
|
+
return existing;
|
|
280
|
+
const hub = createWatchdogTunnelHub();
|
|
281
|
+
g[WATCHDOG_TUNNEL_KEY] = hub;
|
|
282
|
+
return hub;
|
|
283
|
+
}
|
|
284
|
+
/** Current tunnel status ("unknown" when telegram never published). */
|
|
285
|
+
export function getWatchdogTunnelStatus() {
|
|
286
|
+
return getWatchdogTunnelHub().status;
|
|
287
|
+
}
|
|
288
|
+
/** Subscribe to tunnel transitions; returns an unsubscribe function. */
|
|
289
|
+
export function subscribeWatchdogTunnel(fn) {
|
|
290
|
+
return getWatchdogTunnelHub().subscribe(fn);
|
|
291
|
+
}
|
|
292
|
+
// The core watchdog's escalation "keeps the remote canary warm" with an
|
|
293
|
+
// optional 1-line compact tg ping when the channel is up. telegram/index.ts
|
|
294
|
+
// publishes a plain-text sender here when the channel is enabled; an absent
|
|
295
|
+
// slot (telegram not loaded) makes the optional signal a silent no-op. The
|
|
296
|
+
// literal MUST stay in sync with packages/telegram/src/index.ts
|
|
297
|
+
// WATCHDOG_TG_SIGNAL_KEY.
|
|
298
|
+
export const WATCHDOG_TG_SIGNAL_KEY = "__braid_watchdog_tg_signal";
|
|
299
|
+
/** Read the optional tg-signal sender published by the telegram extension. */
|
|
300
|
+
export function getWatchdogTgSignalSender() {
|
|
301
|
+
const fn = globalThis[WATCHDOG_TG_SIGNAL_KEY];
|
|
302
|
+
return typeof fn === "function" ? fn : null;
|
|
303
|
+
}
|
|
304
|
+
// Dead wake delivery is KNOWN first in the timer's wake-retry queue (repeated
|
|
305
|
+
// outcome timeouts for one timer id, exhausted redelivery chains) — but the
|
|
306
|
+
// episode latch + escalation belong to the watchdog (it owns
|
|
307
|
+
// liveness/stall/escalation and already carries the tg-signal alert path).
|
|
308
|
+
// Extensions must not import sibling extensions, so the watchdog publishes a
|
|
309
|
+
// feed object into a process-global slot at engine build time — the same
|
|
310
|
+
// pattern as WATCHDOG_TG_SIGNAL_KEY above — and the timer forwards
|
|
311
|
+
// threshold-crossing facts into it lossy-safe (absent slot → no-op).
|
|
312
|
+
export const WATCHDOG_WAKE_DELIVERY_FEED_KEY = "__braid_watchdog_wake_delivery_feed";
|
|
313
|
+
/** Publish (or clear with null) the wake-delivery feed. */
|
|
314
|
+
export function setWatchdogWakeDeliveryFeed(feed) {
|
|
315
|
+
globalThis[WATCHDOG_WAKE_DELIVERY_FEED_KEY] = feed;
|
|
316
|
+
}
|
|
317
|
+
/** Read the wake-delivery feed published by the watchdog extension. */
|
|
318
|
+
export function getWatchdogWakeDeliveryFeed() {
|
|
319
|
+
const feed = globalThis[WATCHDOG_WAKE_DELIVERY_FEED_KEY];
|
|
320
|
+
return feed && typeof feed === "object" ? feed : null;
|
|
321
|
+
}
|
|
322
|
+
// A due timer/wake is a legitimate reason for a session to look quiet: the
|
|
323
|
+
// wake is about to start a turn. The fact lives with the scheduler (only it
|
|
324
|
+
// knows what is due); the watchdog's stall classifier is the consumer. The
|
|
325
|
+
// scheduling layer may not import the watchdog, so — same pattern as the
|
|
326
|
+
// wake-delivery feed above — it publishes a plain question into a
|
|
327
|
+
// process-global slot and the watchdog asks it before classifying a silent
|
|
328
|
+
// turn dead. Absent slot ⇒ not due (a stall must not be suppressed by a
|
|
329
|
+
// provider that never loaded).
|
|
330
|
+
export const WATCHDOG_WAKE_DUE_PROVIDER_KEY = "__braid_watchdog_wake_due_provider";
|
|
331
|
+
/** Publish (or clear with null) the wake-due provider. */
|
|
332
|
+
export function setWatchdogWakeDueProvider(provider) {
|
|
333
|
+
globalThis[WATCHDOG_WAKE_DUE_PROVIDER_KEY] = provider;
|
|
334
|
+
}
|
|
335
|
+
/** Read the wake-due provider published by the scheduler. */
|
|
336
|
+
export function getWatchdogWakeDueProvider() {
|
|
337
|
+
const fn = globalThis[WATCHDOG_WAKE_DUE_PROVIDER_KEY];
|
|
338
|
+
return typeof fn === "function" ? fn : null;
|
|
339
|
+
}
|
|
340
|
+
// Whether a new turn should start against the current session's route is a
|
|
341
|
+
// health fact OWNED by the enforcement layer (it sees the classified LLM
|
|
342
|
+
// errors); the scheduling wake path is the CONSUMER that must act on it. The
|
|
343
|
+
// scheduler's layer may not import an extension sibling, so — same pattern as
|
|
344
|
+
// the wake-delivery feed above — the enforcement layer publishes a small
|
|
345
|
+
// mechanism-only object into a process-global slot and the scheduler asks it
|
|
346
|
+
// one question. Absent slot ⇒ never blocked (a wake must fail open).
|
|
347
|
+
//
|
|
348
|
+
// Names here carry no provider, status code or error category: the shape is
|
|
349
|
+
// only "may a turn start" + "a turn ended cleanly", so a generic layer cannot
|
|
350
|
+
// learn a domain fact from it.
|
|
351
|
+
export const TURN_START_GATE_KEY = "__braid_turn_start_gate";
|
|
352
|
+
/** Publish (or clear with null) the turn-start gate. */
|
|
353
|
+
export function setTurnStartGate(gate) {
|
|
354
|
+
globalThis[TURN_START_GATE_KEY] = gate;
|
|
355
|
+
}
|
|
356
|
+
/** Read the turn-start gate published by the enforcement extension. */
|
|
357
|
+
export function getTurnStartGate() {
|
|
358
|
+
const gate = globalThis[TURN_START_GATE_KEY];
|
|
359
|
+
return gate && typeof gate === "object" ? gate : null;
|
|
360
|
+
}
|
|
361
|
+
// The anti-sycophancy detector computes the acceptance (validation-before-
|
|
362
|
+
// correction) verdict at message_end; the over-correction gate needs the
|
|
363
|
+
// SAME already-computed verdict at tool-call time, from the enforcement
|
|
364
|
+
// extension. Extensions must not import each other's handlers, so — same
|
|
365
|
+
// pattern as TURN_START_GATE_KEY above — the detector publishes the verdict
|
|
366
|
+
// into a process-global slot and the gate reads it lossy-safe. The signal
|
|
367
|
+
// carries the producing session and a wall-clock stamp: another session's
|
|
368
|
+
// signal and an expired signal both read cold. Absent slot ⇒ no signal.
|
|
369
|
+
export const ACCEPTANCE_SIGNAL_KEY = "__braid_acceptance_signal";
|
|
370
|
+
/** Publish (or clear with null) the latest acceptance signal. */
|
|
371
|
+
export function setAcceptanceSignal(signal) {
|
|
372
|
+
globalThis[ACCEPTANCE_SIGNAL_KEY] = signal;
|
|
373
|
+
}
|
|
374
|
+
/** Read the acceptance signal published by the sycophancy detector. */
|
|
375
|
+
export function getAcceptanceSignal() {
|
|
376
|
+
const signal = globalThis[ACCEPTANCE_SIGNAL_KEY];
|
|
377
|
+
if (!signal || typeof signal !== "object")
|
|
378
|
+
return null;
|
|
379
|
+
const s = signal;
|
|
380
|
+
if (typeof s.atMs !== "number" || !Number.isFinite(s.atMs))
|
|
381
|
+
return null;
|
|
382
|
+
return s;
|
|
383
|
+
}
|
|
384
|
+
//
|
|
385
|
+
// The emergency offloader (context-manager/handlers/context-emergency.ts)
|
|
386
|
+
// must be callable from code that lives OUTSIDE the context-manager extension
|
|
387
|
+
// tree: llm-call's retry path (lib/ai), the heartbeat consolidation gate, and
|
|
388
|
+
// the providers pre-send guard. Those consumers cannot import the extension
|
|
389
|
+
// module directly (layering + heavy import chain), so — like KEY_RING_FEEDBACK_
|
|
390
|
+
// KEY above — context-manager publishes a runner into a process-global slot
|
|
391
|
+
// and consumers read it lossy-safe (absent → no-op).
|
|
392
|
+
export const CONTEXT_EMERGENCY_OFFLOAD_RUNNER_KEY = "__braid_context_emergency_offload_runner";
|
|
393
|
+
/** Publish the emergency-offload runner (called by context-manager at load). */
|
|
394
|
+
export function setContextEmergencyOffloadRunner(runner) {
|
|
395
|
+
globalThis[CONTEXT_EMERGENCY_OFFLOAD_RUNNER_KEY] = runner;
|
|
396
|
+
}
|
|
397
|
+
/**
|
|
398
|
+
* Read the published emergency-offload runner. Null when context-manager has
|
|
399
|
+
* not loaded (or was reloaded without re-publishing) — callers treat this as
|
|
400
|
+
* "cannot shrink" and proceed with their normal failure path.
|
|
401
|
+
*/
|
|
402
|
+
export function getContextEmergencyOffloadRunner() {
|
|
403
|
+
const fn = globalThis[CONTEXT_EMERGENCY_OFFLOAD_RUNNER_KEY];
|
|
404
|
+
return typeof fn === "function" ? fn : null;
|
|
405
|
+
}
|
|
406
|
+
/** Clear the slot. Test helper. */
|
|
407
|
+
export function resetContextEmergencyOffloadRunner() {
|
|
408
|
+
delete globalThis[CONTEXT_EMERGENCY_OFFLOAD_RUNNER_KEY];
|
|
409
|
+
}
|
|
410
|
+
/**
|
|
411
|
+
* ExtensionContext provider. Modules under lib/ have no ctx of their own, so
|
|
412
|
+
* the enforcement session-start handler publishes a closure over the CURRENT
|
|
413
|
+
* session's ctx. Consumers: the emergency-offload retry path in llm-call.ts,
|
|
414
|
+
* and the auxiliary LLM path's registry/auth lookup in the same module.
|
|
415
|
+
* Single-session design, same as the LLM call listeners slot above.
|
|
416
|
+
*
|
|
417
|
+
* The name is general because the slot carries the whole context, not one
|
|
418
|
+
* consumer's slice of it: a second consumer must not need a second slot.
|
|
419
|
+
*/
|
|
420
|
+
export const EXTENSION_CTX_PROVIDER_KEY = "__braid_extension_ctx_provider";
|
|
421
|
+
/** Publish the ctx provider (called by enforcement's session-start handler). */
|
|
422
|
+
export function setExtensionCtxProvider(provider) {
|
|
423
|
+
globalThis[EXTENSION_CTX_PROVIDER_KEY] = provider;
|
|
424
|
+
}
|
|
425
|
+
/** Read the published ctx provider (null when enforcement has not loaded). */
|
|
426
|
+
export function getExtensionCtxProvider() {
|
|
427
|
+
const fn = globalThis[EXTENSION_CTX_PROVIDER_KEY];
|
|
428
|
+
return typeof fn === "function" ? fn : null;
|
|
429
|
+
}
|
|
430
|
+
/** Clear the slot. Test helper. */
|
|
431
|
+
export function resetExtensionCtxProvider() {
|
|
432
|
+
delete globalThis[EXTENSION_CTX_PROVIDER_KEY];
|
|
433
|
+
}
|
|
434
|
+
/**
|
|
435
|
+
* Emergency-offload spellings of the accessors above. Same one slot: the
|
|
436
|
+
* context-emergency retry path was built against these names, and a test that
|
|
437
|
+
* publishes through one name must be visible through the other.
|
|
438
|
+
*/
|
|
439
|
+
export function setContextEmergencyCtxProvider(provider) {
|
|
440
|
+
setExtensionCtxProvider(provider);
|
|
441
|
+
}
|
|
442
|
+
/** @see setContextEmergencyCtxProvider */
|
|
443
|
+
export function getContextEmergencyCtxProvider() {
|
|
444
|
+
return getExtensionCtxProvider();
|
|
445
|
+
}
|
|
446
|
+
/** @see setContextEmergencyCtxProvider */
|
|
447
|
+
export function resetContextEmergencyCtxProvider() {
|
|
448
|
+
resetExtensionCtxProvider();
|
|
449
|
+
}
|
|
450
|
+
//
|
|
451
|
+
// llm-call.ts dispatches auxiliary calls through the published extension
|
|
452
|
+
// context (ctx.modelRegistry). When nothing has published a context it
|
|
453
|
+
// degrades to pi-ai's compat transport, which carries the model's credential
|
|
454
|
+
// but neither the session id nor configured provider headers. That degradation
|
|
455
|
+
// is announced once per process, never per call. globalThis-backed rather than
|
|
456
|
+
// a module-level `let`: the extension module tree is re-evaluated on /reload,
|
|
457
|
+
// so a module-level flag would be lost and the same degradation announced
|
|
458
|
+
// again.
|
|
459
|
+
const AUX_DEGRADED_TRANSPORT_WARNED_KEY = "__braid_aux_degraded_transport_warned";
|
|
460
|
+
/** True once the auxiliary-call degraded-transport warning has been emitted. */
|
|
461
|
+
export function hasWarnedAuxDegradedTransport() {
|
|
462
|
+
return globalThis[AUX_DEGRADED_TRANSPORT_WARNED_KEY] === true;
|
|
463
|
+
}
|
|
464
|
+
/** Record that the auxiliary-call degraded-transport warning has been emitted. */
|
|
465
|
+
export function markAuxDegradedTransportWarned() {
|
|
466
|
+
globalThis[AUX_DEGRADED_TRANSPORT_WARNED_KEY] = true;
|
|
467
|
+
}
|
|
468
|
+
/** Clear the latch. Test helper. */
|
|
469
|
+
export function resetAuxDegradedTransportWarning() {
|
|
470
|
+
delete globalThis[AUX_DEGRADED_TRANSPORT_WARNED_KEY];
|
|
471
|
+
}
|
|
472
|
+
function createDefaultTimerExtensionFactoryState() {
|
|
473
|
+
return { callCount: 0 };
|
|
474
|
+
}
|
|
475
|
+
let _timerExtensionFactoryState;
|
|
476
|
+
/**
|
|
477
|
+
* Get the shared timer-extension-factory counter.
|
|
478
|
+
*
|
|
479
|
+
* The timer extension increments this on every `timerExtension(pi)` call
|
|
480
|
+
* and logs a warning when the count exceeds 1 (signaling an accidental
|
|
481
|
+
* double-registration that would break the single-process-per-session
|
|
482
|
+
* assumption).
|
|
483
|
+
*/
|
|
484
|
+
export function getTimerExtensionFactoryState() {
|
|
485
|
+
if (!_timerExtensionFactoryState) {
|
|
486
|
+
_timerExtensionFactoryState = createDefaultTimerExtensionFactoryState();
|
|
487
|
+
}
|
|
488
|
+
return _timerExtensionFactoryState;
|
|
489
|
+
}
|
|
490
|
+
// The discoverability handler in enforcement runs on every session_start and
|
|
491
|
+
// emits a bundled whisper with prior-session hints. On /reload, the extension
|
|
492
|
+
// module IS re-evaluated (so module-level `let` in the handler doesn't persist).
|
|
493
|
+
// _This_ module is also in the extension import tree, so a module-level `let`
|
|
494
|
+
// here would also be lost on reload. We use `globalThis` instead, which is the
|
|
495
|
+
// Node.js process global and survives any module re-evaluation.
|
|
496
|
+
//
|
|
497
|
+
// Key: process-global (not module-global). A fresh `pi` process starts with
|
|
498
|
+
// an empty Set (everything is "new"). Within the same process, the Set persists
|
|
499
|
+
// across any number of /reload calls.
|
|
500
|
+
//
|
|
501
|
+
// Two layers:
|
|
502
|
+
// 1. Bundle-text dedup: `_GLOBAL_KEY` (`__braid_discoverability_shown`).
|
|
503
|
+
// Old approach. Fragile: dynamic content changes (openPlans
|
|
504
|
+
// count, goal slice) cause the bundle string to vary, missing the Set.has.
|
|
505
|
+
// 2. Per-signal dedup: `_GLOBAL_SIGNAL_KEY` (`__braid_shown_signal_types`).
|
|
506
|
+
// Added. Stable across content variations. Each signal TYPE
|
|
507
|
+
// is a semantic key; content changes don't affect dedup.
|
|
508
|
+
//
|
|
509
|
+
// The SUPPRESSION TRUTH is now the session branch (`_GLOBAL_BRANCH_SIGNAL_KEY`
|
|
510
|
+
// below, rebuilt from `braid_shown_signal` entries at session_start). The
|
|
511
|
+
// per-project disk file is a derived write-through index, kept for
|
|
512
|
+
// cross-session readers and never consulted for dedup - see the branch-durable
|
|
513
|
+
// section below for why (a rewound branch must not inherit a project's history).
|
|
514
|
+
import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
|
|
515
|
+
import { dirname } from "node:path";
|
|
516
|
+
import { shownSignalsFilePath } from "../config/braid-paths.js";
|
|
517
|
+
const _GLOBAL_KEY = "__braid_discoverability_shown";
|
|
518
|
+
/**
|
|
519
|
+
* Get the shared discoverability dedup set. Created lazily on first access.
|
|
520
|
+
* The Set is stored in `globalThis` (process-global) so it survives module
|
|
521
|
+
* re-evaluation on /reload.
|
|
522
|
+
*/
|
|
523
|
+
export function getShownDiscoveryBundles() {
|
|
524
|
+
if (!globalThis[_GLOBAL_KEY]) {
|
|
525
|
+
globalThis[_GLOBAL_KEY] = new Set();
|
|
526
|
+
}
|
|
527
|
+
return globalThis[_GLOBAL_KEY];
|
|
528
|
+
}
|
|
529
|
+
/** Reset the dedup set. Test helper. */
|
|
530
|
+
export function resetShownDiscoveryBundles() {
|
|
531
|
+
delete globalThis[_GLOBAL_KEY];
|
|
532
|
+
}
|
|
533
|
+
// Bundle-text dedup misses when ANY dynamic content in the bundle changes
|
|
534
|
+
// (openPlans count, goal slice, tag list, etc.). Per-signal dedup tracks
|
|
535
|
+
// individual signal TYPES (semantic keys), so the same signal type is
|
|
536
|
+
// skipped on re-emission even if its content varies.
|
|
537
|
+
// Used by register-session-start-discoverability.ts.
|
|
538
|
+
const _GLOBAL_SIGNAL_KEY = "__braid_shown_signal_types";
|
|
539
|
+
/** Get the shared shown-signal-types set (process-global, survives /reload). */
|
|
540
|
+
export function getShownSignals() {
|
|
541
|
+
if (!globalThis[_GLOBAL_SIGNAL_KEY]) {
|
|
542
|
+
globalThis[_GLOBAL_SIGNAL_KEY] = new Set();
|
|
543
|
+
}
|
|
544
|
+
return globalThis[_GLOBAL_SIGNAL_KEY];
|
|
545
|
+
}
|
|
546
|
+
/** Reset the shown-signal set. Test helper. */
|
|
547
|
+
export function resetShownSignals() {
|
|
548
|
+
delete globalThis[_GLOBAL_SIGNAL_KEY];
|
|
549
|
+
}
|
|
550
|
+
/** Check if a signal type has been shown in this process. */
|
|
551
|
+
export function isSignalShown(t) {
|
|
552
|
+
return getShownSignals().has(t);
|
|
553
|
+
}
|
|
554
|
+
/** Mark a signal type as shown in this process. */
|
|
555
|
+
export function markSignalShown(t) {
|
|
556
|
+
getShownSignals().add(t);
|
|
557
|
+
}
|
|
558
|
+
// The on-disk file at <braid>/shown-signals.json is a derived index of every
|
|
559
|
+
// signal mark this project has ever written. Suppression decisions do NOT
|
|
560
|
+
// read it: the ACTIVE BRANCH decides what this session has already shown
|
|
561
|
+
// (see the branch-durable section below). The file is kept as a cross-session
|
|
562
|
+
// index for readers that ask "has this project ever shown X" - it is written
|
|
563
|
+
// through on every mark and can over-report after a rewind by design.
|
|
564
|
+
//
|
|
565
|
+
// History: this layer was added for session-resume flooding, before the
|
|
566
|
+
// branch entries existed. The branch covers resume natively, so the file
|
|
567
|
+
// stopped being consulted for dedup; keeping it as an index preserves the
|
|
568
|
+
// accumulated project history without letting it override the branch.
|
|
569
|
+
const _GLOBAL_PROJECT_SIGNAL_KEY = "__braid_project_shown_signals";
|
|
570
|
+
/**
|
|
571
|
+
* Get the per-project shown-signals map from disk.
|
|
572
|
+
* Internal cache keyed by project slug. The on-disk file is a flat JSON
|
|
573
|
+
* object: `{ "<project-slug>": ["signal_type1", ...] }`.
|
|
574
|
+
*/
|
|
575
|
+
function loadProjectShownSignalsFromDisk() {
|
|
576
|
+
try {
|
|
577
|
+
const file = shownSignalsFilePath();
|
|
578
|
+
if (existsSync(file)) {
|
|
579
|
+
const raw = readFileSync(file, "utf-8");
|
|
580
|
+
return JSON.parse(raw);
|
|
581
|
+
}
|
|
582
|
+
}
|
|
583
|
+
catch {
|
|
584
|
+
// File corrupt or missing — start fresh
|
|
585
|
+
}
|
|
586
|
+
return {};
|
|
587
|
+
}
|
|
588
|
+
function persistProjectShownSignalsToDisk(data) {
|
|
589
|
+
try {
|
|
590
|
+
const file = shownSignalsFilePath();
|
|
591
|
+
const dir = dirname(file);
|
|
592
|
+
if (!existsSync(dir))
|
|
593
|
+
mkdirSync(dir, { recursive: true });
|
|
594
|
+
writeFileSync(file, JSON.stringify(data), "utf-8");
|
|
595
|
+
}
|
|
596
|
+
catch {
|
|
597
|
+
// Non-fatal — persistence is a best-effort optimization
|
|
598
|
+
}
|
|
599
|
+
}
|
|
600
|
+
/**
|
|
601
|
+
* Get the process-global cache of per-project shown signals (derived index).
|
|
602
|
+
* Lazily loaded from disk on first access.
|
|
603
|
+
* Structure: { "<slug>": Set<signal_type> }
|
|
604
|
+
*/
|
|
605
|
+
function getProjectShownSignalsCache() {
|
|
606
|
+
if (!globalThis[_GLOBAL_PROJECT_SIGNAL_KEY]) {
|
|
607
|
+
const fromDisk = loadProjectShownSignalsFromDisk();
|
|
608
|
+
const map = new Map();
|
|
609
|
+
for (const [slug, types] of Object.entries(fromDisk)) {
|
|
610
|
+
map.set(slug, new Set(types));
|
|
611
|
+
}
|
|
612
|
+
globalThis[_GLOBAL_PROJECT_SIGNAL_KEY] = map;
|
|
613
|
+
}
|
|
614
|
+
return globalThis[_GLOBAL_PROJECT_SIGNAL_KEY];
|
|
615
|
+
}
|
|
616
|
+
// Session-scoped state must follow the active branch: each mark appends a
|
|
617
|
+
// durable custom entry (`SHOWN_SIGNAL_ENTRY_TYPE`), and session_start rebuilds
|
|
618
|
+
// the shown set from `ctx.sessionManager.getBranch()`. Without this, a signal
|
|
619
|
+
// the rewound branch never saw stayed suppressed by the project-level file -
|
|
620
|
+
// the file records project history, the branch records this conversation.
|
|
621
|
+
/** Custom entry type for durable shown-signal records. Stable across releases. */
|
|
622
|
+
export const SHOWN_SIGNAL_ENTRY_TYPE = "braid_shown_signal";
|
|
623
|
+
const _GLOBAL_BRANCH_SIGNAL_KEY = "__braid_branch_shown_signals";
|
|
624
|
+
/**
|
|
625
|
+
* Collect shown signals from branch entries into a slug -> types map.
|
|
626
|
+
* Malformed payloads are skipped rather than trusted. Only the ACTIVE branch
|
|
627
|
+
* is passed in (getBranch returns the leaf path), so abandoned-branch entries
|
|
628
|
+
* are never replayed.
|
|
629
|
+
*/
|
|
630
|
+
export function readShownSignalsFromBranch(entries) {
|
|
631
|
+
const map = new Map();
|
|
632
|
+
for (const raw of entries) {
|
|
633
|
+
const entry = raw;
|
|
634
|
+
if (entry?.type !== "custom" || entry.customType !== SHOWN_SIGNAL_ENTRY_TYPE)
|
|
635
|
+
continue;
|
|
636
|
+
const data = entry.data;
|
|
637
|
+
if (!data || typeof data !== "object")
|
|
638
|
+
continue;
|
|
639
|
+
if (typeof data.slug !== "string" || typeof data.type !== "string")
|
|
640
|
+
continue;
|
|
641
|
+
let set = map.get(data.slug);
|
|
642
|
+
if (!set) {
|
|
643
|
+
set = new Set();
|
|
644
|
+
map.set(data.slug, set);
|
|
645
|
+
}
|
|
646
|
+
set.add(data.type);
|
|
647
|
+
}
|
|
648
|
+
return map;
|
|
649
|
+
}
|
|
650
|
+
/**
|
|
651
|
+
* Replace the branch-reconstructed shown-signal map. Called at session_start
|
|
652
|
+
* (before the discoverability handler filters its signals); replacement, not
|
|
653
|
+
* merge: the branch is the source of truth.
|
|
654
|
+
*/
|
|
655
|
+
export function reconstructShownSignalsFromBranch(entries) {
|
|
656
|
+
globalThis[_GLOBAL_BRANCH_SIGNAL_KEY] = readShownSignalsFromBranch(entries);
|
|
657
|
+
}
|
|
658
|
+
function getBranchShownSignals() {
|
|
659
|
+
if (!globalThis[_GLOBAL_BRANCH_SIGNAL_KEY]) {
|
|
660
|
+
globalThis[_GLOBAL_BRANCH_SIGNAL_KEY] = new Map();
|
|
661
|
+
}
|
|
662
|
+
return globalThis[_GLOBAL_BRANCH_SIGNAL_KEY];
|
|
663
|
+
}
|
|
664
|
+
/**
|
|
665
|
+
* Check if a signal type has been shown for a project slug ON THE ACTIVE
|
|
666
|
+
* BRANCH. The branch decides: a rewound branch that never saw the signal
|
|
667
|
+
* answers false, so the signal is shown again for that branch.
|
|
668
|
+
*/
|
|
669
|
+
export function isProjectSignalShown(slug, t) {
|
|
670
|
+
const projectSet = getBranchShownSignals().get(slug);
|
|
671
|
+
return projectSet ? projectSet.has(t) : false;
|
|
672
|
+
}
|
|
673
|
+
/**
|
|
674
|
+
* Mark a signal type as shown for a project slug: update the branch map (fast
|
|
675
|
+
* path), append the durable entry through the extension API's appendEntry
|
|
676
|
+
* seam, and write through to the derived disk index (cross-session readers;
|
|
677
|
+
* never consulted for suppression). Both side effects are best-effort - the
|
|
678
|
+
* in-memory map already suppresses the current session.
|
|
679
|
+
*/
|
|
680
|
+
export function markProjectSignalShown(slug, t, appender) {
|
|
681
|
+
const map = getBranchShownSignals();
|
|
682
|
+
let projectSet = map.get(slug);
|
|
683
|
+
if (!projectSet) {
|
|
684
|
+
projectSet = new Set();
|
|
685
|
+
map.set(slug, projectSet);
|
|
686
|
+
}
|
|
687
|
+
projectSet.add(t);
|
|
688
|
+
if (appender) {
|
|
689
|
+
try {
|
|
690
|
+
appender.appendEntry(SHOWN_SIGNAL_ENTRY_TYPE, {
|
|
691
|
+
slug,
|
|
692
|
+
type: t,
|
|
693
|
+
timestamp: Date.now(),
|
|
694
|
+
});
|
|
695
|
+
}
|
|
696
|
+
catch {
|
|
697
|
+
// Non-fatal — the in-memory branch map still suppresses this session.
|
|
698
|
+
}
|
|
699
|
+
}
|
|
700
|
+
// Write-through derived index: accumulate into the disk cache and persist.
|
|
701
|
+
const cache = getProjectShownSignalsCache();
|
|
702
|
+
let cacheSet = cache.get(slug);
|
|
703
|
+
if (!cacheSet) {
|
|
704
|
+
cacheSet = new Set();
|
|
705
|
+
cache.set(slug, cacheSet);
|
|
706
|
+
}
|
|
707
|
+
cacheSet.add(t);
|
|
708
|
+
const data = {};
|
|
709
|
+
for (const [s, set] of cache) {
|
|
710
|
+
data[s] = Array.from(set);
|
|
711
|
+
}
|
|
712
|
+
persistProjectShownSignalsToDisk(data);
|
|
713
|
+
}
|
|
714
|
+
let _rssBootTelemetry = undefined;
|
|
715
|
+
export function getRssBootTelemetry() {
|
|
716
|
+
return _rssBootTelemetry;
|
|
717
|
+
}
|
|
718
|
+
/** Set the boot baseline on the first heartbeat tick. Never overwrites. */
|
|
719
|
+
export function setRssBootBaseline(bytes) {
|
|
720
|
+
if (!_rssBootTelemetry) {
|
|
721
|
+
_rssBootTelemetry = { baselineBytes: bytes, growthWhisperShown: false };
|
|
722
|
+
}
|
|
723
|
+
}
|
|
724
|
+
/** Latch the sustained-growth advisory as delivered (one per boot). */
|
|
725
|
+
export function markRssGrowthWhisperShown() {
|
|
726
|
+
if (_rssBootTelemetry) {
|
|
727
|
+
_rssBootTelemetry.growthWhisperShown = true;
|
|
728
|
+
}
|
|
729
|
+
else {
|
|
730
|
+
_rssBootTelemetry = { baselineBytes: 0, growthWhisperShown: true };
|
|
731
|
+
}
|
|
732
|
+
}
|
|
733
|
+
/** Reset both (test helper only). */
|
|
734
|
+
export function resetRssBootTelemetry() {
|
|
735
|
+
_rssBootTelemetry = undefined;
|
|
736
|
+
}
|
|
737
|
+
/** Whether the sustained-growth advisory already fired this boot. */
|
|
738
|
+
export function getRssGrowthWhisperShown() {
|
|
739
|
+
return _rssBootTelemetry?.growthWhisperShown ?? false;
|
|
740
|
+
}
|
|
741
|
+
//# sourceMappingURL=global-state.js.map
|