pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,938 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Braid Settings - unified reader for pi settings.json braid config.
|
|
3
|
+
*
|
|
4
|
+
* The settings.json file mixes pi-native settings with braid config under a
|
|
5
|
+
* top-level `braid` key. This module reads that config safely and provides
|
|
6
|
+
* a single source of truth for all braid-related feature flags.
|
|
7
|
+
*/
|
|
8
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
9
|
+
import { createLogger } from "../core/logger.js";
|
|
10
|
+
import { USAGE_COMPACT_MEDIUM, USAGE_WHISPER_CRITICAL, USAGE_WHISPER_WARNING, } from "../detection/context-thresholds.js";
|
|
11
|
+
import { MEMORY_WRITE_GATE_DEFAULTS, WRITE_GATE_SITES, } from "../memory/write-quality.js";
|
|
12
|
+
import { getSettingsPath } from "./per-tool-settings.js";
|
|
13
|
+
const _log = createLogger("braid-settings");
|
|
14
|
+
/** Read and parse settings.json. Not cached - always reads fresh to respect runtime changes. */
|
|
15
|
+
/** Warned once per process about an unreadable settings.json. */
|
|
16
|
+
let _warnedUnreadableSettings = false;
|
|
17
|
+
function readSettings() {
|
|
18
|
+
let result = {};
|
|
19
|
+
try {
|
|
20
|
+
if (existsSync(getSettingsPath())) {
|
|
21
|
+
result = JSON.parse(readFileSync(getSettingsPath(), "utf-8"));
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
catch (e) {
|
|
25
|
+
// Non-fatal: fall through to empty settings - but never silently: a
|
|
26
|
+
// corrupt file reverts every braid setting (context cap, write gate,
|
|
27
|
+
// timer redelivery bound, offload toggles) and that must be visible.
|
|
28
|
+
if (e?.code !== "ENOENT" && !_warnedUnreadableSettings) {
|
|
29
|
+
_warnedUnreadableSettings = true;
|
|
30
|
+
_log.warn("Cannot read settings.json - braid settings in it are ignored until " +
|
|
31
|
+
"the file is fixed (using defaults).", { error: e.message });
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
return result;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Whether cognitive nudges (enforcement whispers, heartbeat suggestions,
|
|
38
|
+
* feedback reminders) should be suppressed entirely.
|
|
39
|
+
*
|
|
40
|
+
* Controlled by braid.suppressNudges in settings.json.
|
|
41
|
+
* Default: false - nudges are ENABLED by default.
|
|
42
|
+
*
|
|
43
|
+
* A user who wants to skip Y/n prompts would set that in pi's native settings -
|
|
44
|
+
* this flag only affects braid's own cognitive nudges.
|
|
45
|
+
*/
|
|
46
|
+
export function areCognitiveNudgesDisabled() {
|
|
47
|
+
const settings = readSettings();
|
|
48
|
+
if (settings.braid?.suppressNudges !== undefined) {
|
|
49
|
+
return settings.braid.suppressNudges === true;
|
|
50
|
+
}
|
|
51
|
+
// Default: nudges are enabled (safe default - braid's value prop is ON)
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Read the raw braid.enforcement.nudgeConfigs block from settings.json.
|
|
56
|
+
*
|
|
57
|
+
* Returns an UNVALIDATED shape. Callers must pass the result through
|
|
58
|
+
* NudgeManager.validateNudgeConfig() (or parseNudgeConfigOverrides())
|
|
59
|
+
* before constructing a NudgeManager - the validation lives next to
|
|
60
|
+
* the NudgeType schema to keep the type knowledge in one place.
|
|
61
|
+
*
|
|
62
|
+
* Returns {} when:
|
|
63
|
+
* - settings.json doesn't exist
|
|
64
|
+
* - the braid key isn't present
|
|
65
|
+
* - the enforcement key isn't present
|
|
66
|
+
* - nudgeConfigs is missing or not an object
|
|
67
|
+
*/
|
|
68
|
+
export function getRawNudgeConfigOverrides() {
|
|
69
|
+
const settings = readSettings();
|
|
70
|
+
const raw = settings.braid?.enforcement?.nudgeConfigs;
|
|
71
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
72
|
+
return {};
|
|
73
|
+
}
|
|
74
|
+
return raw;
|
|
75
|
+
}
|
|
76
|
+
/** Default mode: off — the shipped default is inert. */
|
|
77
|
+
export const OVER_CORRECTION_GATE_DEFAULTS = { mode: "off" };
|
|
78
|
+
/** Warned once per process about an invalid overCorrectionGate.mode. */
|
|
79
|
+
let _warnedInvalidOverCorrectionGate = false;
|
|
80
|
+
function _warnInvalidOverCorrectionGate(value) {
|
|
81
|
+
if (_warnedInvalidOverCorrectionGate)
|
|
82
|
+
return;
|
|
83
|
+
_warnedInvalidOverCorrectionGate = true;
|
|
84
|
+
_log.warn("Invalid braid.enforcement.overCorrectionGate in settings.json - ignoring and " +
|
|
85
|
+
'using the default (mode "off"). Expected { mode: "off" | "shadow" | "on" }.', { value });
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* Pure resolver for braid.enforcement.overCorrectionGate. Absent block ⇒
|
|
89
|
+
* mode "off". A non-object block or a mode outside the enum warns once and
|
|
90
|
+
* falls back to "off", so a typo can never enable the gate. Kept pure so
|
|
91
|
+
* the default merge is unit-testable without touching live settings.json.
|
|
92
|
+
*/
|
|
93
|
+
export function resolveOverCorrectionGate(raw) {
|
|
94
|
+
if (raw === undefined || raw === null)
|
|
95
|
+
return { ...OVER_CORRECTION_GATE_DEFAULTS };
|
|
96
|
+
if (typeof raw !== "object" || Array.isArray(raw)) {
|
|
97
|
+
_warnInvalidOverCorrectionGate(raw);
|
|
98
|
+
return { ...OVER_CORRECTION_GATE_DEFAULTS };
|
|
99
|
+
}
|
|
100
|
+
const mode = raw.mode;
|
|
101
|
+
if (mode === "off" || mode === "shadow" || mode === "on")
|
|
102
|
+
return { mode };
|
|
103
|
+
_warnInvalidOverCorrectionGate(mode);
|
|
104
|
+
return { ...OVER_CORRECTION_GATE_DEFAULTS };
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Read the effective over-correction gate config from settings.json, fresh
|
|
108
|
+
* on every call (no caching), like the other readers. Default: mode "off".
|
|
109
|
+
*/
|
|
110
|
+
export function getOverCorrectionGateConfig() {
|
|
111
|
+
return resolveOverCorrectionGate(readSettings().braid?.enforcement?.overCorrectionGate);
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Read the braid.memory.writeGate block from settings.json.
|
|
115
|
+
*
|
|
116
|
+
* Returns MEMORY_WRITE_GATE_DEFAULTS (gate ON, mode "enforce") when the block
|
|
117
|
+
* is absent or any field is invalid — junk is not written unless an operator
|
|
118
|
+
* explicitly opts the gate out. Settings-only by design: no env vars
|
|
119
|
+
* (settings-over-env).
|
|
120
|
+
*/
|
|
121
|
+
export function getMemoryWriteGateConfig() {
|
|
122
|
+
const settings = readSettings();
|
|
123
|
+
return resolveMemoryWriteGateConfig(settings.braid?.memory?.writeGate);
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Pure resolver for the braid.memory.writeGate block. Absent/partial/invalid
|
|
127
|
+
* fields fall back to MEMORY_WRITE_GATE_DEFAULTS (mode "enforce", sites empty
|
|
128
|
+
* = every site gated). Unknown site keys and non-boolean opt-outs are dropped,
|
|
129
|
+
* so a typo cannot silently disable a writer. Kept pure so the default merge
|
|
130
|
+
* is unit-testable without touching live settings.json.
|
|
131
|
+
*/
|
|
132
|
+
export function resolveMemoryWriteGateConfig(raw) {
|
|
133
|
+
const enabled = typeof raw?.enabled === "boolean" ? raw.enabled : MEMORY_WRITE_GATE_DEFAULTS.enabled;
|
|
134
|
+
const cooldownMs = typeof raw?.cooldownMs === "number" && raw.cooldownMs >= 0
|
|
135
|
+
? raw.cooldownMs
|
|
136
|
+
: MEMORY_WRITE_GATE_DEFAULTS.cooldownMs;
|
|
137
|
+
const mode = raw?.mode === "warn" || raw?.mode === "enforce" ? raw.mode : MEMORY_WRITE_GATE_DEFAULTS.mode;
|
|
138
|
+
return { enabled, cooldownMs, mode, sites: normalizeWriteGateSites(raw?.sites) };
|
|
139
|
+
}
|
|
140
|
+
/** Keep only known site names with boolean values; absent = gated. */
|
|
141
|
+
function normalizeWriteGateSites(raw) {
|
|
142
|
+
const sites = {};
|
|
143
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw))
|
|
144
|
+
return sites;
|
|
145
|
+
for (const site of WRITE_GATE_SITES) {
|
|
146
|
+
const value = raw[site];
|
|
147
|
+
if (typeof value === "boolean")
|
|
148
|
+
sites[site] = value;
|
|
149
|
+
}
|
|
150
|
+
return sites;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* The owner time zone for all braid-facing time rendering (lib/utils/local-time.ts).
|
|
154
|
+
* braid.timezone in settings.json when set to a non-empty string; otherwise
|
|
155
|
+
* DEFAULT_TIME_ZONE (Europe/Moscow). Never throws; an invalid IANA name is
|
|
156
|
+
* the caller's concern (local-time.ts validates and falls back).
|
|
157
|
+
*/
|
|
158
|
+
export const DEFAULT_TIME_ZONE = "Europe/Moscow";
|
|
159
|
+
export function getOwnerTimeZone() {
|
|
160
|
+
const settings = readSettings();
|
|
161
|
+
const tz = settings.braid?.timezone;
|
|
162
|
+
return typeof tz === "string" && tz.trim() ? tz.trim() : DEFAULT_TIME_ZONE;
|
|
163
|
+
}
|
|
164
|
+
// ── stale toolResult offload (braid.context.staleToolResultOffload) ────
|
|
165
|
+
/**
|
|
166
|
+
* Sane defaults for the optional staleToolResultOffload params (defined next
|
|
167
|
+
* to the schema per the design contract). Investigation suggests a size
|
|
168
|
+
* floor of ~4k chars and a keep-recent window of ~20 calls; stalenessTurns
|
|
169
|
+
* adds a conservative age policy above the guard; maxOffloadCharsPerRun
|
|
170
|
+
* bounds the per-request rewrite to 64k chars.
|
|
171
|
+
*/
|
|
172
|
+
export const STALE_TOOL_RESULT_OFFLOAD_DEFAULTS = {
|
|
173
|
+
enabled: false,
|
|
174
|
+
minChars: 4_000,
|
|
175
|
+
stalenessTurns: 40,
|
|
176
|
+
keepRecentTurns: 20,
|
|
177
|
+
maxOffloadCharsPerRun: 65_536,
|
|
178
|
+
};
|
|
179
|
+
/** Warned once per process about an invalid braid.context.staleToolResultOffload. */
|
|
180
|
+
let _warnedInvalidStaleToolResultOffload = false;
|
|
181
|
+
function _warnInvalidStaleToolResultOffload(value) {
|
|
182
|
+
if (_warnedInvalidStaleToolResultOffload)
|
|
183
|
+
return;
|
|
184
|
+
_warnedInvalidStaleToolResultOffload = true;
|
|
185
|
+
_log.warn("Invalid braid.context.staleToolResultOffload in settings.json - ignoring " +
|
|
186
|
+
"invalid fields and using defaults (offloader stays OFF unless enabled is true).", { value });
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Pure resolver for the braid.context.staleToolResultOffload block.
|
|
190
|
+
* Absent → all defaults (enabled: false). Non-object shape, or any field
|
|
191
|
+
* violating its type/range, falls back to that field's default; the FIRST
|
|
192
|
+
* invalid input also emits a once-per-process warning (mirrors the
|
|
193
|
+
* log-once pattern). Kept pure so the default merge is unit-testable without
|
|
194
|
+
* touching live settings.json.
|
|
195
|
+
*/
|
|
196
|
+
export function resolveStaleToolResultOffloadConfig(raw) {
|
|
197
|
+
const defaults = STALE_TOOL_RESULT_OFFLOAD_DEFAULTS;
|
|
198
|
+
if (raw === undefined) {
|
|
199
|
+
return {
|
|
200
|
+
enabled: defaults.enabled,
|
|
201
|
+
minChars: defaults.minChars,
|
|
202
|
+
stalenessTurns: defaults.stalenessTurns,
|
|
203
|
+
keepRecentTurns: defaults.keepRecentTurns,
|
|
204
|
+
maxOffloadCharsPerRun: defaults.maxOffloadCharsPerRun,
|
|
205
|
+
};
|
|
206
|
+
}
|
|
207
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
208
|
+
_warnInvalidStaleToolResultOffload(raw);
|
|
209
|
+
return {
|
|
210
|
+
enabled: defaults.enabled,
|
|
211
|
+
minChars: defaults.minChars,
|
|
212
|
+
stalenessTurns: defaults.stalenessTurns,
|
|
213
|
+
keepRecentTurns: defaults.keepRecentTurns,
|
|
214
|
+
maxOffloadCharsPerRun: defaults.maxOffloadCharsPerRun,
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
const r = raw;
|
|
218
|
+
const d = STALE_TOOL_RESULT_OFFLOAD_DEFAULTS;
|
|
219
|
+
let invalid = false;
|
|
220
|
+
let enabled = d.enabled;
|
|
221
|
+
if (typeof r.enabled === "boolean") {
|
|
222
|
+
enabled = r.enabled;
|
|
223
|
+
}
|
|
224
|
+
else if (r.enabled !== undefined) {
|
|
225
|
+
invalid = true;
|
|
226
|
+
}
|
|
227
|
+
let minChars = d.minChars;
|
|
228
|
+
if (typeof r.minChars === "number" && Number.isFinite(r.minChars) && r.minChars >= 0) {
|
|
229
|
+
minChars = r.minChars;
|
|
230
|
+
}
|
|
231
|
+
else if (r.minChars !== undefined) {
|
|
232
|
+
invalid = true;
|
|
233
|
+
}
|
|
234
|
+
let stalenessTurns = d.stalenessTurns;
|
|
235
|
+
if (typeof r.stalenessTurns === "number" &&
|
|
236
|
+
Number.isInteger(r.stalenessTurns) &&
|
|
237
|
+
r.stalenessTurns >= 1) {
|
|
238
|
+
stalenessTurns = r.stalenessTurns;
|
|
239
|
+
}
|
|
240
|
+
else if (r.stalenessTurns !== undefined) {
|
|
241
|
+
invalid = true;
|
|
242
|
+
}
|
|
243
|
+
let keepRecentTurns = d.keepRecentTurns;
|
|
244
|
+
if (typeof r.keepRecentTurns === "number" &&
|
|
245
|
+
Number.isInteger(r.keepRecentTurns) &&
|
|
246
|
+
r.keepRecentTurns >= 0) {
|
|
247
|
+
keepRecentTurns = r.keepRecentTurns;
|
|
248
|
+
}
|
|
249
|
+
else if (r.keepRecentTurns !== undefined) {
|
|
250
|
+
invalid = true;
|
|
251
|
+
}
|
|
252
|
+
let maxOffloadCharsPerRun = d.maxOffloadCharsPerRun;
|
|
253
|
+
if (typeof r.maxOffloadCharsPerRun === "number" &&
|
|
254
|
+
Number.isFinite(r.maxOffloadCharsPerRun) &&
|
|
255
|
+
r.maxOffloadCharsPerRun >= 1) {
|
|
256
|
+
maxOffloadCharsPerRun = r.maxOffloadCharsPerRun;
|
|
257
|
+
}
|
|
258
|
+
else if (r.maxOffloadCharsPerRun !== undefined) {
|
|
259
|
+
invalid = true;
|
|
260
|
+
}
|
|
261
|
+
if (invalid)
|
|
262
|
+
_warnInvalidStaleToolResultOffload(raw);
|
|
263
|
+
return { enabled, minChars, stalenessTurns, keepRecentTurns, maxOffloadCharsPerRun };
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Read the effective staleToolResultOffload config from settings.json, fresh
|
|
267
|
+
* on every call (no caching), like the other readers. Default: all defaults
|
|
268
|
+
* with enabled=false (the offloader is a no-op unless the owner opts in).
|
|
269
|
+
*/
|
|
270
|
+
export function getStaleToolResultOffloadConfig() {
|
|
271
|
+
return resolveStaleToolResultOffloadConfig(readSettings().braid?.context?.staleToolResultOffload);
|
|
272
|
+
}
|
|
273
|
+
// ── emergency context-window offload (braid.context.contextEmergencyOffload) ──
|
|
274
|
+
/**
|
|
275
|
+
* Defaults for the P0-A emergency offloader. The size floor matches the P0-B
|
|
276
|
+
* capture cap (256KB): below that, a 413 is not caused by this class of blob.
|
|
277
|
+
* Per-run budget of 1MB chars covers several oversized results in one pass.
|
|
278
|
+
* keepRecentTurns=1: the immediately-latest toolResult stays visible so the
|
|
279
|
+
* agent keeps the freshest decision evidence; everything older is fair game
|
|
280
|
+
* in an emergency (sendability outranks recency, and the flush is lossless).
|
|
281
|
+
*/
|
|
282
|
+
export const CONTEXT_EMERGENCY_OFFLOAD_DEFAULTS = {
|
|
283
|
+
enabled: true,
|
|
284
|
+
minChars: 262_144,
|
|
285
|
+
maxCharsPerRun: 1_048_576,
|
|
286
|
+
keepRecentTurns: 1,
|
|
287
|
+
};
|
|
288
|
+
/** Warned once per process about an invalid braid.context.contextEmergencyOffload. */
|
|
289
|
+
let _warnedInvalidContextEmergencyOffload = false;
|
|
290
|
+
function _warnInvalidContextEmergencyOffload(value) {
|
|
291
|
+
if (_warnedInvalidContextEmergencyOffload)
|
|
292
|
+
return;
|
|
293
|
+
_warnedInvalidContextEmergencyOffload = true;
|
|
294
|
+
_log.warn("Invalid braid.context.contextEmergencyOffload in settings.json - ignoring " +
|
|
295
|
+
"invalid fields and using defaults (emergency offload stays ON unless " +
|
|
296
|
+
"enabled is explicitly false).", { value });
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* Pure resolver for the braid.context.contextEmergencyOffload block.
|
|
300
|
+
* Absent → all defaults (enabled: true — the 413 fix must be active by
|
|
301
|
+
* default). Non-object shape, or any field violating its type/range, falls
|
|
302
|
+
* back to that field's default; the FIRST invalid input also emits a
|
|
303
|
+
* once-per-process warning (mirrors the log-once pattern). Kept pure so
|
|
304
|
+
* the default merge is unit-testable without touching live settings.json.
|
|
305
|
+
*/
|
|
306
|
+
export function resolveContextEmergencyOffloadConfig(raw) {
|
|
307
|
+
const defaults = CONTEXT_EMERGENCY_OFFLOAD_DEFAULTS;
|
|
308
|
+
if (raw === undefined) {
|
|
309
|
+
return { ...defaults };
|
|
310
|
+
}
|
|
311
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
312
|
+
_warnInvalidContextEmergencyOffload(raw);
|
|
313
|
+
return { ...defaults };
|
|
314
|
+
}
|
|
315
|
+
const r = raw;
|
|
316
|
+
const d = CONTEXT_EMERGENCY_OFFLOAD_DEFAULTS;
|
|
317
|
+
let invalid = false;
|
|
318
|
+
let enabled = d.enabled;
|
|
319
|
+
if (typeof r.enabled === "boolean") {
|
|
320
|
+
enabled = r.enabled;
|
|
321
|
+
}
|
|
322
|
+
else if (r.enabled !== undefined) {
|
|
323
|
+
invalid = true;
|
|
324
|
+
}
|
|
325
|
+
let minChars = d.minChars;
|
|
326
|
+
if (typeof r.minChars === "number" && Number.isFinite(r.minChars) && r.minChars >= 1) {
|
|
327
|
+
minChars = r.minChars;
|
|
328
|
+
}
|
|
329
|
+
else if (r.minChars !== undefined) {
|
|
330
|
+
invalid = true;
|
|
331
|
+
}
|
|
332
|
+
let maxCharsPerRun = d.maxCharsPerRun;
|
|
333
|
+
if (typeof r.maxCharsPerRun === "number" &&
|
|
334
|
+
Number.isFinite(r.maxCharsPerRun) &&
|
|
335
|
+
r.maxCharsPerRun >= minChars) {
|
|
336
|
+
maxCharsPerRun = r.maxCharsPerRun;
|
|
337
|
+
}
|
|
338
|
+
else if (r.maxCharsPerRun !== undefined) {
|
|
339
|
+
invalid = true;
|
|
340
|
+
}
|
|
341
|
+
let keepRecentTurns = d.keepRecentTurns;
|
|
342
|
+
if (typeof r.keepRecentTurns === "number" &&
|
|
343
|
+
Number.isInteger(r.keepRecentTurns) &&
|
|
344
|
+
r.keepRecentTurns >= 0) {
|
|
345
|
+
keepRecentTurns = r.keepRecentTurns;
|
|
346
|
+
}
|
|
347
|
+
else if (r.keepRecentTurns !== undefined) {
|
|
348
|
+
invalid = true;
|
|
349
|
+
}
|
|
350
|
+
if (invalid)
|
|
351
|
+
_warnInvalidContextEmergencyOffload(raw);
|
|
352
|
+
return { enabled, minChars, maxCharsPerRun, keepRecentTurns };
|
|
353
|
+
}
|
|
354
|
+
/**
|
|
355
|
+
* Read the effective contextEmergencyOffload config from settings.json, fresh
|
|
356
|
+
* on every call (no caching), like the other readers. Default: enabled=true.
|
|
357
|
+
*/
|
|
358
|
+
export function getContextEmergencyOffloadConfig() {
|
|
359
|
+
return resolveContextEmergencyOffloadConfig(readSettings().braid?.context?.contextEmergencyOffload);
|
|
360
|
+
}
|
|
361
|
+
// ── capture-time toolResult size cap (braid.context.toolResultSizeCap) ─
|
|
362
|
+
/**
|
|
363
|
+
* Defaults for the P0-B capture cap: 256KB (chars) — a blob over this is a
|
|
364
|
+
* screenshot/base64-class payload that never belongs in context. Default ON:
|
|
365
|
+
* capture-time substitution is lossless (full content flushed to disk first)
|
|
366
|
+
* and strictly cheaper than the 413 loops it prevents.
|
|
367
|
+
*/
|
|
368
|
+
export const TOOL_RESULT_SIZE_CAP_DEFAULTS = {
|
|
369
|
+
enabled: true,
|
|
370
|
+
maxChars: 262_144,
|
|
371
|
+
};
|
|
372
|
+
/** Warned once per process about an invalid braid.context.toolResultSizeCap. */
|
|
373
|
+
let _warnedInvalidToolResultSizeCap = false;
|
|
374
|
+
function _warnInvalidToolResultSizeCap(value) {
|
|
375
|
+
if (_warnedInvalidToolResultSizeCap)
|
|
376
|
+
return;
|
|
377
|
+
_warnedInvalidToolResultSizeCap = true;
|
|
378
|
+
_log.warn("Invalid braid.context.toolResultSizeCap in settings.json - ignoring " +
|
|
379
|
+
"invalid fields and using defaults (capture cap stays ON unless " +
|
|
380
|
+
"enabled is explicitly false).", { value });
|
|
381
|
+
}
|
|
382
|
+
/**
|
|
383
|
+
* Pure resolver for the braid.context.toolResultSizeCap block.
|
|
384
|
+
* Absent → all defaults (enabled: true). Non-object shape, or any field
|
|
385
|
+
* violating its type/range, falls back to that field's default with a
|
|
386
|
+
* once-per-process warning. Kept pure for unit-testability.
|
|
387
|
+
*/
|
|
388
|
+
export function resolveToolResultSizeCapConfig(raw) {
|
|
389
|
+
const defaults = TOOL_RESULT_SIZE_CAP_DEFAULTS;
|
|
390
|
+
if (raw === undefined) {
|
|
391
|
+
return { ...defaults };
|
|
392
|
+
}
|
|
393
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
394
|
+
_warnInvalidToolResultSizeCap(raw);
|
|
395
|
+
return { ...defaults };
|
|
396
|
+
}
|
|
397
|
+
const r = raw;
|
|
398
|
+
const d = TOOL_RESULT_SIZE_CAP_DEFAULTS;
|
|
399
|
+
let invalid = false;
|
|
400
|
+
let enabled = d.enabled;
|
|
401
|
+
if (typeof r.enabled === "boolean") {
|
|
402
|
+
enabled = r.enabled;
|
|
403
|
+
}
|
|
404
|
+
else if (r.enabled !== undefined) {
|
|
405
|
+
invalid = true;
|
|
406
|
+
}
|
|
407
|
+
let maxChars = d.maxChars;
|
|
408
|
+
if (typeof r.maxChars === "number" && Number.isFinite(r.maxChars) && r.maxChars >= 1) {
|
|
409
|
+
maxChars = r.maxChars;
|
|
410
|
+
}
|
|
411
|
+
else if (r.maxChars !== undefined) {
|
|
412
|
+
invalid = true;
|
|
413
|
+
}
|
|
414
|
+
if (invalid)
|
|
415
|
+
_warnInvalidToolResultSizeCap(raw);
|
|
416
|
+
return { enabled, maxChars };
|
|
417
|
+
}
|
|
418
|
+
/**
|
|
419
|
+
* Read the effective toolResultSizeCap config from settings.json, fresh on
|
|
420
|
+
* every call (no caching), like the other readers. Default: enabled=true.
|
|
421
|
+
*/
|
|
422
|
+
export function getToolResultSizeCapConfig() {
|
|
423
|
+
return resolveToolResultSizeCapConfig(readSettings().braid?.context?.toolResultSizeCap);
|
|
424
|
+
}
|
|
425
|
+
// ── usage-driven auto-arm of a slide compaction (braid.context.contextAutoCompact) ─
|
|
426
|
+
/**
|
|
427
|
+
* Defaults for the usage-driven auto-arm. Default ON: an armed cleanup that
|
|
428
|
+
* never lands while a run stays alive is the failure mode this exists to
|
|
429
|
+
* close, and the armed action is the deterministic slide (no LLM call, cut
|
|
430
|
+
* bounded by the keep window). confirmTicks=2 makes "crosses and STAYS there"
|
|
431
|
+
* the arming condition — a transient spike never arms.
|
|
432
|
+
*/
|
|
433
|
+
export const AUTO_COMPACT_DEFAULTS = {
|
|
434
|
+
enabled: true,
|
|
435
|
+
armPercent: 60,
|
|
436
|
+
confirmTicks: 2,
|
|
437
|
+
};
|
|
438
|
+
/** Warned once per process about an invalid braid.context.contextAutoCompact. */
|
|
439
|
+
let _warnedInvalidAutoCompact = false;
|
|
440
|
+
function _warnInvalidAutoCompact(value) {
|
|
441
|
+
if (_warnedInvalidAutoCompact)
|
|
442
|
+
return;
|
|
443
|
+
_warnedInvalidAutoCompact = true;
|
|
444
|
+
_log.warn("Invalid braid.context.contextAutoCompact in settings.json - ignoring " +
|
|
445
|
+
"invalid fields and using defaults (auto-arm stays ON unless " +
|
|
446
|
+
"enabled is explicitly false).", { value });
|
|
447
|
+
}
|
|
448
|
+
/**
|
|
449
|
+
* Pure resolver for the braid.context.contextAutoCompact block.
|
|
450
|
+
* Absent → all defaults. Non-object shape, or any field violating its
|
|
451
|
+
* type/range (armPercent must be 1..100, confirmTicks an integer >= 1), falls
|
|
452
|
+
* back to that field's default with a once-per-process warning. Kept pure for
|
|
453
|
+
* unit-testability.
|
|
454
|
+
*/
|
|
455
|
+
export function resolveAutoCompactConfig(raw) {
|
|
456
|
+
const d = AUTO_COMPACT_DEFAULTS;
|
|
457
|
+
if (raw === undefined) {
|
|
458
|
+
return { ...d };
|
|
459
|
+
}
|
|
460
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
461
|
+
_warnInvalidAutoCompact(raw);
|
|
462
|
+
return { ...d };
|
|
463
|
+
}
|
|
464
|
+
const r = raw;
|
|
465
|
+
let invalid = false;
|
|
466
|
+
let enabled = d.enabled;
|
|
467
|
+
if (typeof r.enabled === "boolean") {
|
|
468
|
+
enabled = r.enabled;
|
|
469
|
+
}
|
|
470
|
+
else if (r.enabled !== undefined) {
|
|
471
|
+
invalid = true;
|
|
472
|
+
}
|
|
473
|
+
let armPercent = d.armPercent;
|
|
474
|
+
if (typeof r.armPercent === "number" &&
|
|
475
|
+
Number.isFinite(r.armPercent) &&
|
|
476
|
+
r.armPercent >= 1 &&
|
|
477
|
+
r.armPercent <= 100) {
|
|
478
|
+
armPercent = r.armPercent;
|
|
479
|
+
}
|
|
480
|
+
else if (r.armPercent !== undefined) {
|
|
481
|
+
invalid = true;
|
|
482
|
+
}
|
|
483
|
+
let confirmTicks = d.confirmTicks;
|
|
484
|
+
if (typeof r.confirmTicks === "number" &&
|
|
485
|
+
Number.isInteger(r.confirmTicks) &&
|
|
486
|
+
r.confirmTicks >= 1) {
|
|
487
|
+
confirmTicks = r.confirmTicks;
|
|
488
|
+
}
|
|
489
|
+
else if (r.confirmTicks !== undefined) {
|
|
490
|
+
invalid = true;
|
|
491
|
+
}
|
|
492
|
+
if (invalid)
|
|
493
|
+
_warnInvalidAutoCompact(raw);
|
|
494
|
+
return { enabled, armPercent, confirmTicks };
|
|
495
|
+
}
|
|
496
|
+
/**
|
|
497
|
+
* Read the effective contextAutoCompact config from settings.json, fresh on
|
|
498
|
+
* every call (no caching), like the other readers. Default: enabled=true.
|
|
499
|
+
*/
|
|
500
|
+
export function getAutoCompactConfig() {
|
|
501
|
+
return resolveAutoCompactConfig(readSettings().braid?.context?.contextAutoCompact);
|
|
502
|
+
}
|
|
503
|
+
// ── wake-retry redelivery cap (braid.timers.maxWakeAttempts) ─────────
|
|
504
|
+
/** Default redelivery bound for a failed wake fire. */
|
|
505
|
+
export const MAX_WAKE_ATTEMPTS_DEFAULT = 3;
|
|
506
|
+
/** Upper bound for the braid.timers.maxWakeAttempts setting. */
|
|
507
|
+
export const MAX_WAKE_ATTEMPTS_MAX = 10;
|
|
508
|
+
/** Warned once per process about an invalid braid.timers.maxWakeAttempts. */
|
|
509
|
+
let _warnedInvalidMaxWakeAttempts = false;
|
|
510
|
+
function _warnInvalidMaxWakeAttempts(value) {
|
|
511
|
+
if (_warnedInvalidMaxWakeAttempts)
|
|
512
|
+
return;
|
|
513
|
+
_warnedInvalidMaxWakeAttempts = true;
|
|
514
|
+
_log.warn("Invalid braid.timers.maxWakeAttempts in settings.json - ignoring and " +
|
|
515
|
+
`using the default (${MAX_WAKE_ATTEMPTS_DEFAULT}). Expected an integer 1..${MAX_WAKE_ATTEMPTS_MAX}.`, { value });
|
|
516
|
+
}
|
|
517
|
+
/**
|
|
518
|
+
* Pure resolver for braid.timers.maxWakeAttempts. Absent →
|
|
519
|
+
* MAX_WAKE_ATTEMPTS_DEFAULT; an integer 1..MAX_WAKE_ATTEMPTS_MAX passes
|
|
520
|
+
* through; anything else warns once and falls back to the default. Kept pure
|
|
521
|
+
* so the validation is unit-testable without touching live settings.json.
|
|
522
|
+
*/
|
|
523
|
+
export function resolveMaxWakeAttempts(raw) {
|
|
524
|
+
if (raw === undefined)
|
|
525
|
+
return MAX_WAKE_ATTEMPTS_DEFAULT;
|
|
526
|
+
if (typeof raw === "number" &&
|
|
527
|
+
Number.isInteger(raw) &&
|
|
528
|
+
raw >= 1 &&
|
|
529
|
+
raw <= MAX_WAKE_ATTEMPTS_MAX) {
|
|
530
|
+
return raw;
|
|
531
|
+
}
|
|
532
|
+
_warnInvalidMaxWakeAttempts(raw);
|
|
533
|
+
return MAX_WAKE_ATTEMPTS_DEFAULT;
|
|
534
|
+
}
|
|
535
|
+
/**
|
|
536
|
+
* Read the effective wake-retry redelivery cap from settings.json, fresh on
|
|
537
|
+
* every call (no caching), like the other readers. Default:
|
|
538
|
+
* MAX_WAKE_ATTEMPTS_DEFAULT (3).
|
|
539
|
+
*/
|
|
540
|
+
export function getMaxWakeAttempts() {
|
|
541
|
+
return resolveMaxWakeAttempts(readSettings().braid?.timers?.maxWakeAttempts);
|
|
542
|
+
}
|
|
543
|
+
// ── terminal-error wake breaker (braid.session.terminalBreaker) ──────────
|
|
544
|
+
/** Default terminal-error count before timer wakes stop starting turns. */
|
|
545
|
+
export const TERMINAL_BREAKER_DEFAULT_THRESHOLD = 3;
|
|
546
|
+
/** Upper bound for a configured threshold (guards a typo'd huge value). */
|
|
547
|
+
export const TERMINAL_BREAKER_THRESHOLD_MAX = 20;
|
|
548
|
+
/** Warned once per process about an invalid terminalBreaker.threshold. */
|
|
549
|
+
let _warnedInvalidTerminalBreakerThreshold = false;
|
|
550
|
+
/**
|
|
551
|
+
* Pure resolver for braid.session.terminalBreaker. Absent block ⇒ default-on
|
|
552
|
+
* with threshold 3. `enabled: false` ⇒ the gate is off. A threshold that is
|
|
553
|
+
* not an integer 1..TERMINAL_BREAKER_THRESHOLD_MAX warns once and falls back
|
|
554
|
+
* to the default. Kept pure so the validation is unit-testable without
|
|
555
|
+
* touching live settings.json.
|
|
556
|
+
*/
|
|
557
|
+
export function resolveTerminalBreaker(raw) {
|
|
558
|
+
if (raw === undefined || raw === null || typeof raw !== "object") {
|
|
559
|
+
return { enabled: true, threshold: TERMINAL_BREAKER_DEFAULT_THRESHOLD };
|
|
560
|
+
}
|
|
561
|
+
const block = raw;
|
|
562
|
+
const enabled = block.enabled !== false;
|
|
563
|
+
const threshold = block.threshold;
|
|
564
|
+
if (threshold === undefined) {
|
|
565
|
+
return { enabled, threshold: TERMINAL_BREAKER_DEFAULT_THRESHOLD };
|
|
566
|
+
}
|
|
567
|
+
if (typeof threshold === "number" &&
|
|
568
|
+
Number.isInteger(threshold) &&
|
|
569
|
+
threshold >= 1 &&
|
|
570
|
+
threshold <= TERMINAL_BREAKER_THRESHOLD_MAX) {
|
|
571
|
+
return { enabled, threshold };
|
|
572
|
+
}
|
|
573
|
+
if (!_warnedInvalidTerminalBreakerThreshold) {
|
|
574
|
+
_warnedInvalidTerminalBreakerThreshold = true;
|
|
575
|
+
_log.warn("Invalid braid.session.terminalBreaker.threshold in settings.json - ignoring and " +
|
|
576
|
+
`using the default (${TERMINAL_BREAKER_DEFAULT_THRESHOLD}). Expected an integer 1..${TERMINAL_BREAKER_THRESHOLD_MAX}.`, { value: threshold });
|
|
577
|
+
}
|
|
578
|
+
return { enabled, threshold: TERMINAL_BREAKER_DEFAULT_THRESHOLD };
|
|
579
|
+
}
|
|
580
|
+
/**
|
|
581
|
+
* Read the effective terminal-error wake-breaker config from settings.json,
|
|
582
|
+
* fresh on every call (no caching), like the other readers. The wake path
|
|
583
|
+
* reads this once per fire.
|
|
584
|
+
*/
|
|
585
|
+
export function getTerminalBreakerConfig() {
|
|
586
|
+
return resolveTerminalBreaker(readSettings().braid?.session?.terminalBreaker);
|
|
587
|
+
}
|
|
588
|
+
// ── wake-delivery stall alert (braid.timers.wakeAlert) ───────────────
|
|
589
|
+
/** Default wake-delivery alerting: on, page after 2 outcome timeouts. */
|
|
590
|
+
export const WAKE_DELIVERY_ALERT_DEFAULT = {
|
|
591
|
+
mode: "on",
|
|
592
|
+
outcomeTimeouts: 2,
|
|
593
|
+
};
|
|
594
|
+
/** Upper bound for the outcome-timeout page threshold. */
|
|
595
|
+
export const WAKE_ALERT_OUTCOME_TIMEOUTS_MAX = 10;
|
|
596
|
+
/** Warned once per process about an invalid braid.timers.wakeAlert. */
|
|
597
|
+
let _warnedInvalidWakeAlert = false;
|
|
598
|
+
function _warnInvalidWakeAlert(value) {
|
|
599
|
+
if (_warnedInvalidWakeAlert)
|
|
600
|
+
return;
|
|
601
|
+
_warnedInvalidWakeAlert = true;
|
|
602
|
+
_log.warn("Invalid braid.timers.wakeAlert in settings.json - ignoring it and using " +
|
|
603
|
+
`the defaults (mode ${WAKE_DELIVERY_ALERT_DEFAULT.mode}, outcomeTimeouts ` +
|
|
604
|
+
`${WAKE_DELIVERY_ALERT_DEFAULT.outcomeTimeouts}). Expected { mode: "on" | "off", ` +
|
|
605
|
+
`outcomeTimeouts: integer 2..${WAKE_ALERT_OUTCOME_TIMEOUTS_MAX} }.`, { value });
|
|
606
|
+
}
|
|
607
|
+
/**
|
|
608
|
+
* Pure resolver for braid.timers.wakeAlert. Absent → defaults; mode
|
|
609
|
+
* "on"/"off" passes through; outcomeTimeouts must be an integer 2..MAX (1
|
|
610
|
+
* would page on every normal long turn — the flood the 240s outcome window
|
|
611
|
+
* exists to prevent). An invalid present value warns once and falls back to
|
|
612
|
+
* the default for that field. Kept pure so the validation is unit-testable
|
|
613
|
+
* without touching live settings.json.
|
|
614
|
+
*/
|
|
615
|
+
export function resolveWakeDeliveryAlertConfig(raw) {
|
|
616
|
+
const cfg = { ...WAKE_DELIVERY_ALERT_DEFAULT };
|
|
617
|
+
if (raw === undefined)
|
|
618
|
+
return cfg;
|
|
619
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
|
|
620
|
+
_warnInvalidWakeAlert(raw);
|
|
621
|
+
return cfg;
|
|
622
|
+
}
|
|
623
|
+
const r = raw;
|
|
624
|
+
if (r.mode === "on" || r.mode === "off")
|
|
625
|
+
cfg.mode = r.mode;
|
|
626
|
+
else if (r.mode !== undefined)
|
|
627
|
+
_warnInvalidWakeAlert(raw);
|
|
628
|
+
const t = r.outcomeTimeouts;
|
|
629
|
+
if (typeof t === "number" &&
|
|
630
|
+
Number.isInteger(t) &&
|
|
631
|
+
t >= 2 &&
|
|
632
|
+
t <= WAKE_ALERT_OUTCOME_TIMEOUTS_MAX) {
|
|
633
|
+
cfg.outcomeTimeouts = t;
|
|
634
|
+
}
|
|
635
|
+
else if (t !== undefined) {
|
|
636
|
+
_warnInvalidWakeAlert(raw);
|
|
637
|
+
}
|
|
638
|
+
return cfg;
|
|
639
|
+
}
|
|
640
|
+
/**
|
|
641
|
+
* Read the effective wake-delivery alert config from settings.json, fresh on
|
|
642
|
+
* every call (no caching), like the other readers. Default: mode "on",
|
|
643
|
+
* outcomeTimeouts 2.
|
|
644
|
+
*/
|
|
645
|
+
export function getWakeDeliveryAlertConfig() {
|
|
646
|
+
return resolveWakeDeliveryAlertConfig(readSettings().braid?.timers?.wakeAlert);
|
|
647
|
+
}
|
|
648
|
+
// ── pi-core auto-retry budget (top-level `retry` key) ─────────────────
|
|
649
|
+
/** Upper bound for the wake-retry hold window (a hold must stay bounded). */
|
|
650
|
+
export const WAKE_RETRY_HOLD_MAX_MS = 300_000;
|
|
651
|
+
/**
|
|
652
|
+
* Pure resolver for the wake-retry hold window: pi-core auto-retries a
|
|
653
|
+
* retryable provider failure inside the SAME run with backoff
|
|
654
|
+
* `baseDelayMs * 2^attempt` up to maxRetries (settings-manager
|
|
655
|
+
* .getRetrySettings defaults: 2000ms, 3 retries). The hold window mirrors
|
|
656
|
+
* that budget: baseDelayMs * 2^maxRetries (16s with pi-core defaults),
|
|
657
|
+
* clamped to [0, WAKE_RETRY_HOLD_MAX_MS]. Kept pure for unit-testability.
|
|
658
|
+
*/
|
|
659
|
+
export function resolveWakeRetryHoldMs(raw) {
|
|
660
|
+
const maxRetries = typeof raw?.maxRetries === "number" && Number.isFinite(raw.maxRetries) && raw.maxRetries >= 0
|
|
661
|
+
? Math.floor(raw.maxRetries)
|
|
662
|
+
: 3;
|
|
663
|
+
const baseDelayMs = typeof raw?.baseDelayMs === "number" && Number.isFinite(raw.baseDelayMs) && raw.baseDelayMs >= 0
|
|
664
|
+
? raw.baseDelayMs
|
|
665
|
+
: 2000;
|
|
666
|
+
const budget = baseDelayMs * 2 ** Math.min(maxRetries, 16);
|
|
667
|
+
return Math.min(Math.max(Math.floor(budget), 0), WAKE_RETRY_HOLD_MAX_MS);
|
|
668
|
+
}
|
|
669
|
+
/**
|
|
670
|
+
* The effective wake-retry hold window, read fresh on every call (no
|
|
671
|
+
* caching): pi-core's `retry` budget from settings.json, clamped.
|
|
672
|
+
*/
|
|
673
|
+
export function getWakeRetryHoldMs() {
|
|
674
|
+
return resolveWakeRetryHoldMs(readSettings().retry);
|
|
675
|
+
}
|
|
676
|
+
// ── effective context window (contextLimitTokens) ──────────────────────
|
|
677
|
+
/** Warned once per process about an invalid braid.context.contextLimitTokens. */
|
|
678
|
+
let _warnedInvalidContextLimitTokens = false;
|
|
679
|
+
/**
|
|
680
|
+
* Pure resolver for the effective context window. Precedence:
|
|
681
|
+
*
|
|
682
|
+
* 1. `contextLimitTokens` when it is a positive finite number - a
|
|
683
|
+
* CEILING, not a blind rewrite: min(cap, provider window) when the
|
|
684
|
+
* provider window is known positive, the cap alone otherwise.
|
|
685
|
+
* 2. `providerContextWindow` (model/provider truth) when positive finite.
|
|
686
|
+
* 3. undefined — caller applies its own terminal default.
|
|
687
|
+
*
|
|
688
|
+
* The cap can never widen a model past its catalog size: a manual pick
|
|
689
|
+
* whose true window is below the cap keeps that true window. Unset
|
|
690
|
+
* (`undefined`) silently falls through to provider truth; any other
|
|
691
|
+
* non-conforming value (0, negative, non-number, non-finite) is ignored with
|
|
692
|
+
* a once-per-process warning and also falls through. Kept pure so the
|
|
693
|
+
* precedence merge is unit-testable without touching live settings.json.
|
|
694
|
+
*/
|
|
695
|
+
export function resolveContextLimitTokens(raw, providerContextWindow) {
|
|
696
|
+
const provider = typeof providerContextWindow === "number" &&
|
|
697
|
+
Number.isFinite(providerContextWindow) &&
|
|
698
|
+
providerContextWindow > 0
|
|
699
|
+
? providerContextWindow
|
|
700
|
+
: undefined;
|
|
701
|
+
if (typeof raw === "number" && Number.isFinite(raw) && raw > 0) {
|
|
702
|
+
return provider !== undefined ? Math.min(raw, provider) : raw;
|
|
703
|
+
}
|
|
704
|
+
if (raw !== undefined && !_warnedInvalidContextLimitTokens) {
|
|
705
|
+
_warnedInvalidContextLimitTokens = true;
|
|
706
|
+
_log.warn("Invalid braid.context.contextLimitTokens in settings.json - ignoring " +
|
|
707
|
+
"and using the provider context window instead.", { value: raw });
|
|
708
|
+
}
|
|
709
|
+
return provider;
|
|
710
|
+
}
|
|
711
|
+
/**
|
|
712
|
+
* The effective context window braid uses for its computations, resolved
|
|
713
|
+
* through the ONE resolver: braid.context.contextLimitTokens override,
|
|
714
|
+
* else the provider/model context window. Returns undefined when neither is
|
|
715
|
+
* known - callers apply their own terminal default (e.g. 200000, 100_000).
|
|
716
|
+
* Reads settings fresh on every call (no caching), like the other readers.
|
|
717
|
+
*/
|
|
718
|
+
export function getResolvedContextWindow(providerContextWindow) {
|
|
719
|
+
return resolveContextLimitTokens(readSettings().braid?.context?.contextLimitTokens, providerContextWindow);
|
|
720
|
+
}
|
|
721
|
+
/**
|
|
722
|
+
* The RAW configured window override (braid.context.contextLimitTokens),
|
|
723
|
+
* undefined when unset. Separated from getResolvedContextWindow so callers
|
|
724
|
+
* that must label the window source (configured vs provider) can read the
|
|
725
|
+
* override directly instead of reverse-engineering it from the merged value.
|
|
726
|
+
*/
|
|
727
|
+
export function getConfiguredContextLimitTokens() {
|
|
728
|
+
const raw = readSettings().braid?.context?.contextLimitTokens;
|
|
729
|
+
return typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : undefined;
|
|
730
|
+
}
|
|
731
|
+
// ── plumb the configured window into pi-core (the executed invariant) ──
|
|
732
|
+
/** Warned once per process when the configured window could not be applied. */
|
|
733
|
+
let _warnedUnapplyableContextWindow = false;
|
|
734
|
+
/**
|
|
735
|
+
* Make the session model report the configured window so pi-core's OWN
|
|
736
|
+
* compaction decisions use it. pi-core reads `model.contextWindow` at every
|
|
737
|
+
* window-dependent decision point (threshold compaction in
|
|
738
|
+
* `_compactBeforeNextAssistantResponse` / `_checkCompaction` via
|
|
739
|
+
* `shouldCompact`, overflow detection, usage percent); it never sees braid's
|
|
740
|
+
* setting today, so when `contextLimitTokens < provider window` no automatic
|
|
741
|
+
* actor can fire and the configured cap is enforced by nobody.
|
|
742
|
+
*
|
|
743
|
+
* This is the write side of the ONE resolver: same setting, same validation
|
|
744
|
+
* (`getConfiguredContextLimitTokens`), same ceiling merge. The value written
|
|
745
|
+
* is the resolver's effective window, so the setting can never widen a model
|
|
746
|
+
* past its true window (configured 1M over a 202752 model leaves 202752 in
|
|
747
|
+
* place); only an unknown true window takes the cap alone. When the setting
|
|
748
|
+
* is unset or invalid this is a no-op and pi-core keeps provider-window
|
|
749
|
+
* semantics. The model object is the live `agent.state.model` instance
|
|
750
|
+
* pi-core hands to the extension context, so patching it in place steers
|
|
751
|
+
* every downstream reader; a frozen object (models.json-derived catalogs)
|
|
752
|
+
* degrades to a once-per-process warning and provider semantics rather than
|
|
753
|
+
* throwing mid-run.
|
|
754
|
+
*
|
|
755
|
+
* Idempotent: callers may re-apply on every run start (also re-arms after a
|
|
756
|
+
* model switch, since the newly selected model carries the provider window).
|
|
757
|
+
*/
|
|
758
|
+
export function applyConfiguredContextWindow(ctx) {
|
|
759
|
+
const configured = getConfiguredContextLimitTokens();
|
|
760
|
+
if (configured === undefined)
|
|
761
|
+
return { applied: false, reason: "unset" };
|
|
762
|
+
const model = ctx?.model;
|
|
763
|
+
if (!model || typeof model !== "object")
|
|
764
|
+
return { applied: false, reason: "no-model" };
|
|
765
|
+
const target = resolveContextLimitTokens(configured, model.contextWindow) ?? configured;
|
|
766
|
+
if (model.contextWindow === target) {
|
|
767
|
+
return { applied: false, reason: "unchanged", contextWindow: target };
|
|
768
|
+
}
|
|
769
|
+
try {
|
|
770
|
+
model.contextWindow = target;
|
|
771
|
+
return { applied: true, contextWindow: target };
|
|
772
|
+
}
|
|
773
|
+
catch {
|
|
774
|
+
if (!_warnedUnapplyableContextWindow) {
|
|
775
|
+
_warnedUnapplyableContextWindow = true;
|
|
776
|
+
_log.warn("Could not apply braid.context.contextLimitTokens to the session model " +
|
|
777
|
+
"(read-only model object): native threshold compaction keeps using the " +
|
|
778
|
+
"provider window for this model.");
|
|
779
|
+
}
|
|
780
|
+
return { applied: false, reason: "frozen", contextWindow: model.contextWindow };
|
|
781
|
+
}
|
|
782
|
+
}
|
|
783
|
+
// ── compaction reserve coherence with the configured window ────────────
|
|
784
|
+
/**
|
|
785
|
+
* Floor for the derived reserve: pi-core's own shipped default
|
|
786
|
+
* (DEFAULT_COMPACTION_SETTINGS.reserveTokens). The reserve doubles as the
|
|
787
|
+
* budget for the post-compaction summary request (pi-core caps it at 80% of
|
|
788
|
+
* the reserve), so a thinner one starts failing the compaction it exists to
|
|
789
|
+
* fund; the derivation never goes below it.
|
|
790
|
+
*/
|
|
791
|
+
export const MIN_COMPACTION_RESERVE_TOKENS = 16384;
|
|
792
|
+
/**
|
|
793
|
+
* Pure resolver for the compaction reserve that puts native threshold
|
|
794
|
+
* compaction at USAGE_WHISPER_CRITICAL of the window: reserve = window −
|
|
795
|
+
* trigger, i.e. the same 75/25 split the usage bands already treat as
|
|
796
|
+
* coherent (compaction at USAGE_WHISPER_CRITICAL, before the archiving band
|
|
797
|
+
* opens at USAGE_COMPACT_MEDIUM). pi-core's shouldCompact() compares raw
|
|
798
|
+
* token counts (contextTokens > contextWindow − reserveTokens), never
|
|
799
|
+
* percents, so a reserve that is not a fixed share of the plumbed window
|
|
800
|
+
* silently re-anchors the trigger — that is the incoherence this derives
|
|
801
|
+
* away.
|
|
802
|
+
*
|
|
803
|
+
* Returns undefined when no reserve can be derived: a non-number, non-finite
|
|
804
|
+
* or non-positive window, or a window so small that even the floor reserve
|
|
805
|
+
* (MIN_COMPACTION_RESERVE_TOKENS) leaves no room to compact into. Kept pure
|
|
806
|
+
* so the split is unit-testable without touching live settings.json.
|
|
807
|
+
*/
|
|
808
|
+
export function resolveCompactionReserveTokens(window) {
|
|
809
|
+
if (typeof window !== "number" || !Number.isFinite(window) || window <= 0) {
|
|
810
|
+
return undefined;
|
|
811
|
+
}
|
|
812
|
+
const target = Math.round((window * USAGE_WHISPER_CRITICAL) / 100);
|
|
813
|
+
const reserveTokens = Math.max(window - target, MIN_COMPACTION_RESERVE_TOKENS);
|
|
814
|
+
if (reserveTokens >= window)
|
|
815
|
+
return undefined;
|
|
816
|
+
const triggerTokens = window - reserveTokens;
|
|
817
|
+
return {
|
|
818
|
+
reserveTokens,
|
|
819
|
+
triggerTokens,
|
|
820
|
+
triggerPercent: (triggerTokens / window) * 100,
|
|
821
|
+
};
|
|
822
|
+
}
|
|
823
|
+
/**
|
|
824
|
+
* The reserve pi-core would actually use for this model: the per-model
|
|
825
|
+
* `compaction.modelOverrides[provider/id].reserveTokens` first, then
|
|
826
|
+
* `compaction.reserveTokens`, else undefined (pi-core's own default, i.e.
|
|
827
|
+
* MIN_COMPACTION_RESERVE_TOKENS). Reads settings fresh, like the other
|
|
828
|
+
* readers.
|
|
829
|
+
*/
|
|
830
|
+
export function getConfiguredCompactionReserveTokens(provider, modelId) {
|
|
831
|
+
const compaction = readSettings().compaction;
|
|
832
|
+
if (!compaction || typeof compaction !== "object")
|
|
833
|
+
return undefined;
|
|
834
|
+
const key = provider && modelId ? `${provider}/${modelId}` : undefined;
|
|
835
|
+
const override = key !== undefined ? compaction.modelOverrides?.[key]?.reserveTokens : undefined;
|
|
836
|
+
const candidate = typeof override === "number" ? override : compaction.reserveTokens;
|
|
837
|
+
return typeof candidate === "number" && Number.isFinite(candidate) && candidate > 0
|
|
838
|
+
? candidate
|
|
839
|
+
: undefined;
|
|
840
|
+
}
|
|
841
|
+
/** Warned once per process about each compaction-reserve coherence class. */
|
|
842
|
+
let _warnedUnderivableCompactionReserve = false;
|
|
843
|
+
let _warnedIncoherentCompactionReserve = false;
|
|
844
|
+
let _warnedUnreachableCompactionReserve = false;
|
|
845
|
+
/**
|
|
846
|
+
* Derive the compaction reserve that makes pi-core's native threshold
|
|
847
|
+
* compaction fire at the SAME share of the window braid's usage bands assume.
|
|
848
|
+
* applyConfiguredContextWindow() gives pi-core the braid window; this pairs
|
|
849
|
+
* with it, because pi-core then decides WHEN to compact from its own
|
|
850
|
+
* independent `compaction.reserveTokens` (a fixed token count, default
|
|
851
|
+
* 16384) - untouched, that count re-anchors the trigger to an arbitrary
|
|
852
|
+
* percent of the plumbed window. The window here is the effective one the
|
|
853
|
+
* plumb writes or keeps (`min(cap, true window)` when the true window is
|
|
854
|
+
* known), never the raw cap, so the two sides cannot size against different
|
|
855
|
+
* windows.
|
|
856
|
+
*
|
|
857
|
+
* The derivation is computed, but it cannot be APPLIED from an extension on
|
|
858
|
+
* pi 1.0.2: ctx.sessionManager is pi-core's session manager and carries no
|
|
859
|
+
* settings object, and the ExtensionAPI's only settings surface,
|
|
860
|
+
* getSettings(), returns a structuredClone of the effective settings - a
|
|
861
|
+
* write would never reach pi-core's compaction reader. The operator-facing
|
|
862
|
+
* warning is therefore the channel: it fires once per process and spells out
|
|
863
|
+
* the value to set.
|
|
864
|
+
*
|
|
865
|
+
* Warnings (each once per process): an incoherent CONFIGURED reserve (its
|
|
866
|
+
* trigger falls outside the USAGE_WHISPER_WARNING..USAGE_COMPACT_MEDIUM band
|
|
867
|
+
* the usage layers work in) and an unappliable reserve - the owner has to set
|
|
868
|
+
* the value by hand.
|
|
869
|
+
*/
|
|
870
|
+
export function applyCompactionReserveTokens(ctx) {
|
|
871
|
+
const configured = getConfiguredContextLimitTokens();
|
|
872
|
+
if (configured === undefined)
|
|
873
|
+
return { reason: "unset" };
|
|
874
|
+
const model = ctx?.model;
|
|
875
|
+
// Same effective window the plumb writes or keeps (see
|
|
876
|
+
// applyConfiguredContextWindow): min(cap, true window) when the true window
|
|
877
|
+
// is known, the cap alone otherwise. The raw cap would size a reserve
|
|
878
|
+
// against a window pi-core never sees whenever the ceiling binds.
|
|
879
|
+
const window = resolveContextLimitTokens(configured, model?.contextWindow) ?? configured;
|
|
880
|
+
const derivation = resolveCompactionReserveTokens(window);
|
|
881
|
+
if (!derivation) {
|
|
882
|
+
if (!_warnedUnderivableCompactionReserve) {
|
|
883
|
+
_warnedUnderivableCompactionReserve = true;
|
|
884
|
+
_log.warn("braid.context.contextLimitTokens leaves no room for a compaction reserve " +
|
|
885
|
+
"(a 25% reserve does not fit and pi-core's own floor consumes the whole " +
|
|
886
|
+
"window) - native threshold compaction keeps its defaults.", { window, floorReserve: MIN_COMPACTION_RESERVE_TOKENS });
|
|
887
|
+
}
|
|
888
|
+
return { reason: "no-derivation" };
|
|
889
|
+
}
|
|
890
|
+
const { reserveTokens, triggerTokens, triggerPercent } = derivation;
|
|
891
|
+
const configuredReserve = getConfiguredCompactionReserveTokens(model?.provider, model?.id) ??
|
|
892
|
+
MIN_COMPACTION_RESERVE_TOKENS;
|
|
893
|
+
const configuredTrigger = window - configuredReserve;
|
|
894
|
+
const configuredPercent = (configuredTrigger / window) * 100;
|
|
895
|
+
const belowBand = configuredPercent <= USAGE_WHISPER_WARNING;
|
|
896
|
+
const aboveBand = configuredPercent >= USAGE_COMPACT_MEDIUM;
|
|
897
|
+
if (configuredReserve !== reserveTokens &&
|
|
898
|
+
(belowBand || aboveBand) &&
|
|
899
|
+
!_warnedIncoherentCompactionReserve) {
|
|
900
|
+
_warnedIncoherentCompactionReserve = true;
|
|
901
|
+
const where = belowBand
|
|
902
|
+
? `before the ${USAGE_WHISPER_WARNING}% warning band`
|
|
903
|
+
: `inside the archiving band (${USAGE_COMPACT_MEDIUM}%+), where braid archives instead`;
|
|
904
|
+
_log.warn(`Compaction reserve ${configuredReserve} is incoherent with the ${window}-token ` +
|
|
905
|
+
`window: native compaction fires at ${configuredTrigger} tokens ` +
|
|
906
|
+
`(${configuredPercent.toFixed(1)}%), ${where} - the coherent reserve is ` +
|
|
907
|
+
`${reserveTokens} (trigger ${triggerTokens}, ${triggerPercent.toFixed(1)}%).`, {
|
|
908
|
+
window,
|
|
909
|
+
configuredReserve,
|
|
910
|
+
configuredTrigger,
|
|
911
|
+
configuredPercent,
|
|
912
|
+
derivedReserve: reserveTokens,
|
|
913
|
+
derivedTrigger: triggerTokens,
|
|
914
|
+
});
|
|
915
|
+
}
|
|
916
|
+
if (model && typeof model === "object" && model.contextWindow !== window) {
|
|
917
|
+
return { reason: "window-not-plumbed", reserveTokens, triggerTokens, triggerPercent };
|
|
918
|
+
}
|
|
919
|
+
if (configuredReserve === reserveTokens) {
|
|
920
|
+
return { reason: "unchanged", reserveTokens, triggerTokens, triggerPercent };
|
|
921
|
+
}
|
|
922
|
+
// No writable settings handle exists to steer: pi-core hands the extension a
|
|
923
|
+
// session manager without settings, and getSettings() returns a copy. The
|
|
924
|
+
// warning is the honest channel - it names the value for the operator once
|
|
925
|
+
// per process.
|
|
926
|
+
if (!_warnedUnreachableCompactionReserve) {
|
|
927
|
+
_warnedUnreachableCompactionReserve = true;
|
|
928
|
+
_log.warn("Native threshold compaction cannot be re-anchored from an extension here: " +
|
|
929
|
+
"pi-core exposes no writable settings handle (ctx.sessionManager carries none; " +
|
|
930
|
+
`pi.getSettings() returns a copy), so the derived reserve ` +
|
|
931
|
+
`${reserveTokens} was not applied to the ${window}-token window (reserve stays ` +
|
|
932
|
+
`${configuredReserve}, trigger ${configuredTrigger}). Set ` +
|
|
933
|
+
`compaction.reserveTokens = ${reserveTokens} in settings.json for a ` +
|
|
934
|
+
`${triggerPercent.toFixed(1)}% trigger.`, { window, configuredReserve, derivedReserve: reserveTokens, derivedTrigger: triggerTokens });
|
|
935
|
+
}
|
|
936
|
+
return { reason: "unreachable", reserveTokens, triggerTokens, triggerPercent };
|
|
937
|
+
}
|
|
938
|
+
//# sourceMappingURL=braid-settings.js.map
|