pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,489 @@
|
|
|
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 { type MemoryWriteGateConfig } from "../memory/write-quality.js";
|
|
9
|
+
/** Raw (unvalidated) owner settings for braid.context.contextAutoCompact. */
|
|
10
|
+
export interface AutoCompactSettings {
|
|
11
|
+
/** Master gate. Default true — sustained high usage must get relief. */
|
|
12
|
+
enabled?: boolean;
|
|
13
|
+
/** Usage percent at or above which an observation counts (1..100). */
|
|
14
|
+
armPercent?: number;
|
|
15
|
+
/** Consecutive above-threshold observations required before arming. */
|
|
16
|
+
confirmTicks?: number;
|
|
17
|
+
}
|
|
18
|
+
/** Raw (unvalidated) owner settings for braid.context.contextEmergencyOffload. */
|
|
19
|
+
export interface ContextEmergencyOffloadSettings {
|
|
20
|
+
/** Master gate. Default true — a 413 loop burns quota; shrinking must win. */
|
|
21
|
+
enabled?: boolean;
|
|
22
|
+
/** Minimum result size (chars) before a toolResult is eligible. */
|
|
23
|
+
minChars?: number;
|
|
24
|
+
/** Per-run cap on offloaded chars (bounds the rewrite of one context pass). */
|
|
25
|
+
maxCharsPerRun?: number;
|
|
26
|
+
/** Hard recency guard: never touch the last N tool results. */
|
|
27
|
+
keepRecentTurns?: number;
|
|
28
|
+
}
|
|
29
|
+
/** Raw (unvalidated) owner settings for braid.context.toolResultSizeCap. */
|
|
30
|
+
export interface ToolResultSizeCapSettings {
|
|
31
|
+
/** Master gate. Default true — oversized blobs must never enter context. */
|
|
32
|
+
enabled?: boolean;
|
|
33
|
+
/** Size threshold (chars) above which a toolResult is flushed + stubbed. */
|
|
34
|
+
maxChars?: number;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Raw (unvalidated) owner settings for braid.context.staleToolResultOffload.
|
|
38
|
+
* All fields optional; validation/defaults live in
|
|
39
|
+
* resolveStaleToolResultOffloadConfig.
|
|
40
|
+
*/
|
|
41
|
+
export interface StaleToolResultOffloadSettings {
|
|
42
|
+
/** Master gate. Default false — the offloader never runs unless opted in. */
|
|
43
|
+
enabled?: boolean;
|
|
44
|
+
/** Minimum result size (chars) before a toolResult is eligible. */
|
|
45
|
+
minChars?: number;
|
|
46
|
+
/** Minimum age (in toolResults-after) before a result is eligible. */
|
|
47
|
+
stalenessTurns?: number;
|
|
48
|
+
/** Hard recency guard: never touch the last N tool results. */
|
|
49
|
+
keepRecentTurns?: number;
|
|
50
|
+
/** Per-LLM-call cap on offloaded chars (prevents mass rewrites in one turn). */
|
|
51
|
+
maxOffloadCharsPerRun?: number;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Whether cognitive nudges (enforcement whispers, heartbeat suggestions,
|
|
55
|
+
* feedback reminders) should be suppressed entirely.
|
|
56
|
+
*
|
|
57
|
+
* Controlled by braid.suppressNudges in settings.json.
|
|
58
|
+
* Default: false - nudges are ENABLED by default.
|
|
59
|
+
*
|
|
60
|
+
* A user who wants to skip Y/n prompts would set that in pi's native settings -
|
|
61
|
+
* this flag only affects braid's own cognitive nudges.
|
|
62
|
+
*/
|
|
63
|
+
export declare function areCognitiveNudgesDisabled(): boolean;
|
|
64
|
+
/**
|
|
65
|
+
* Read the raw braid.enforcement.nudgeConfigs block from settings.json.
|
|
66
|
+
*
|
|
67
|
+
* Returns an UNVALIDATED shape. Callers must pass the result through
|
|
68
|
+
* NudgeManager.validateNudgeConfig() (or parseNudgeConfigOverrides())
|
|
69
|
+
* before constructing a NudgeManager - the validation lives next to
|
|
70
|
+
* the NudgeType schema to keep the type knowledge in one place.
|
|
71
|
+
*
|
|
72
|
+
* Returns {} when:
|
|
73
|
+
* - settings.json doesn't exist
|
|
74
|
+
* - the braid key isn't present
|
|
75
|
+
* - the enforcement key isn't present
|
|
76
|
+
* - nudgeConfigs is missing or not an object
|
|
77
|
+
*/
|
|
78
|
+
export declare function getRawNudgeConfigOverrides(): Record<string, unknown>;
|
|
79
|
+
/** Gate modes: off (inert), shadow (whisper only), on (whisper + block). */
|
|
80
|
+
export type OverCorrectionGateMode = "off" | "shadow" | "on";
|
|
81
|
+
export interface OverCorrectionGateConfig {
|
|
82
|
+
mode: OverCorrectionGateMode;
|
|
83
|
+
}
|
|
84
|
+
/** Default mode: off — the shipped default is inert. */
|
|
85
|
+
export declare const OVER_CORRECTION_GATE_DEFAULTS: OverCorrectionGateConfig;
|
|
86
|
+
/**
|
|
87
|
+
* Pure resolver for braid.enforcement.overCorrectionGate. Absent block ⇒
|
|
88
|
+
* mode "off". A non-object block or a mode outside the enum warns once and
|
|
89
|
+
* falls back to "off", so a typo can never enable the gate. Kept pure so
|
|
90
|
+
* the default merge is unit-testable without touching live settings.json.
|
|
91
|
+
*/
|
|
92
|
+
export declare function resolveOverCorrectionGate(raw: unknown): OverCorrectionGateConfig;
|
|
93
|
+
/**
|
|
94
|
+
* Read the effective over-correction gate config from settings.json, fresh
|
|
95
|
+
* on every call (no caching), like the other readers. Default: mode "off".
|
|
96
|
+
*/
|
|
97
|
+
export declare function getOverCorrectionGateConfig(): OverCorrectionGateConfig;
|
|
98
|
+
/**
|
|
99
|
+
* Read the braid.memory.writeGate block from settings.json.
|
|
100
|
+
*
|
|
101
|
+
* Returns MEMORY_WRITE_GATE_DEFAULTS (gate ON, mode "enforce") when the block
|
|
102
|
+
* is absent or any field is invalid — junk is not written unless an operator
|
|
103
|
+
* explicitly opts the gate out. Settings-only by design: no env vars
|
|
104
|
+
* (settings-over-env).
|
|
105
|
+
*/
|
|
106
|
+
export declare function getMemoryWriteGateConfig(): MemoryWriteGateConfig;
|
|
107
|
+
/** Raw settings block as read from JSON — every field validated in the resolver. */
|
|
108
|
+
interface RawWriteGateBlock {
|
|
109
|
+
enabled?: unknown;
|
|
110
|
+
cooldownMs?: unknown;
|
|
111
|
+
mode?: unknown;
|
|
112
|
+
sites?: unknown;
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Pure resolver for the braid.memory.writeGate block. Absent/partial/invalid
|
|
116
|
+
* fields fall back to MEMORY_WRITE_GATE_DEFAULTS (mode "enforce", sites empty
|
|
117
|
+
* = every site gated). Unknown site keys and non-boolean opt-outs are dropped,
|
|
118
|
+
* so a typo cannot silently disable a writer. Kept pure so the default merge
|
|
119
|
+
* is unit-testable without touching live settings.json.
|
|
120
|
+
*/
|
|
121
|
+
export declare function resolveMemoryWriteGateConfig(raw?: RawWriteGateBlock): MemoryWriteGateConfig;
|
|
122
|
+
/**
|
|
123
|
+
* The owner time zone for all braid-facing time rendering (lib/utils/local-time.ts).
|
|
124
|
+
* braid.timezone in settings.json when set to a non-empty string; otherwise
|
|
125
|
+
* DEFAULT_TIME_ZONE (Europe/Moscow). Never throws; an invalid IANA name is
|
|
126
|
+
* the caller's concern (local-time.ts validates and falls back).
|
|
127
|
+
*/
|
|
128
|
+
export declare const DEFAULT_TIME_ZONE = "Europe/Moscow";
|
|
129
|
+
export declare function getOwnerTimeZone(): string;
|
|
130
|
+
/**
|
|
131
|
+
* Sane defaults for the optional staleToolResultOffload params (defined next
|
|
132
|
+
* to the schema per the design contract). Investigation suggests a size
|
|
133
|
+
* floor of ~4k chars and a keep-recent window of ~20 calls; stalenessTurns
|
|
134
|
+
* adds a conservative age policy above the guard; maxOffloadCharsPerRun
|
|
135
|
+
* bounds the per-request rewrite to 64k chars.
|
|
136
|
+
*/
|
|
137
|
+
export declare const STALE_TOOL_RESULT_OFFLOAD_DEFAULTS: {
|
|
138
|
+
readonly enabled: false;
|
|
139
|
+
readonly minChars: 4000;
|
|
140
|
+
readonly stalenessTurns: 40;
|
|
141
|
+
readonly keepRecentTurns: 20;
|
|
142
|
+
readonly maxOffloadCharsPerRun: 65536;
|
|
143
|
+
};
|
|
144
|
+
/** The validated, effective staleToolResultOffload config. */
|
|
145
|
+
export interface ResolvedStaleToolResultOffloadConfig {
|
|
146
|
+
enabled: boolean;
|
|
147
|
+
minChars: number;
|
|
148
|
+
stalenessTurns: number;
|
|
149
|
+
keepRecentTurns: number;
|
|
150
|
+
maxOffloadCharsPerRun: number;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* Pure resolver for the braid.context.staleToolResultOffload block.
|
|
154
|
+
* Absent → all defaults (enabled: false). Non-object shape, or any field
|
|
155
|
+
* violating its type/range, falls back to that field's default; the FIRST
|
|
156
|
+
* invalid input also emits a once-per-process warning (mirrors the
|
|
157
|
+
* log-once pattern). Kept pure so the default merge is unit-testable without
|
|
158
|
+
* touching live settings.json.
|
|
159
|
+
*/
|
|
160
|
+
export declare function resolveStaleToolResultOffloadConfig(raw: unknown): ResolvedStaleToolResultOffloadConfig;
|
|
161
|
+
/**
|
|
162
|
+
* Read the effective staleToolResultOffload config from settings.json, fresh
|
|
163
|
+
* on every call (no caching), like the other readers. Default: all defaults
|
|
164
|
+
* with enabled=false (the offloader is a no-op unless the owner opts in).
|
|
165
|
+
*/
|
|
166
|
+
export declare function getStaleToolResultOffloadConfig(): ResolvedStaleToolResultOffloadConfig;
|
|
167
|
+
/**
|
|
168
|
+
* Defaults for the P0-A emergency offloader. The size floor matches the P0-B
|
|
169
|
+
* capture cap (256KB): below that, a 413 is not caused by this class of blob.
|
|
170
|
+
* Per-run budget of 1MB chars covers several oversized results in one pass.
|
|
171
|
+
* keepRecentTurns=1: the immediately-latest toolResult stays visible so the
|
|
172
|
+
* agent keeps the freshest decision evidence; everything older is fair game
|
|
173
|
+
* in an emergency (sendability outranks recency, and the flush is lossless).
|
|
174
|
+
*/
|
|
175
|
+
export declare const CONTEXT_EMERGENCY_OFFLOAD_DEFAULTS: {
|
|
176
|
+
readonly enabled: true;
|
|
177
|
+
readonly minChars: 262144;
|
|
178
|
+
readonly maxCharsPerRun: 1048576;
|
|
179
|
+
readonly keepRecentTurns: 1;
|
|
180
|
+
};
|
|
181
|
+
/** The validated, effective contextEmergencyOffload config. */
|
|
182
|
+
export interface ResolvedContextEmergencyOffloadConfig {
|
|
183
|
+
enabled: boolean;
|
|
184
|
+
minChars: number;
|
|
185
|
+
maxCharsPerRun: number;
|
|
186
|
+
keepRecentTurns: number;
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Pure resolver for the braid.context.contextEmergencyOffload block.
|
|
190
|
+
* Absent → all defaults (enabled: true — the 413 fix must be active by
|
|
191
|
+
* default). Non-object shape, or any field violating its type/range, falls
|
|
192
|
+
* back to that field's default; the FIRST invalid input also emits a
|
|
193
|
+
* once-per-process warning (mirrors the log-once pattern). Kept pure so
|
|
194
|
+
* the default merge is unit-testable without touching live settings.json.
|
|
195
|
+
*/
|
|
196
|
+
export declare function resolveContextEmergencyOffloadConfig(raw: unknown): ResolvedContextEmergencyOffloadConfig;
|
|
197
|
+
/**
|
|
198
|
+
* Read the effective contextEmergencyOffload config from settings.json, fresh
|
|
199
|
+
* on every call (no caching), like the other readers. Default: enabled=true.
|
|
200
|
+
*/
|
|
201
|
+
export declare function getContextEmergencyOffloadConfig(): ResolvedContextEmergencyOffloadConfig;
|
|
202
|
+
/**
|
|
203
|
+
* Defaults for the P0-B capture cap: 256KB (chars) — a blob over this is a
|
|
204
|
+
* screenshot/base64-class payload that never belongs in context. Default ON:
|
|
205
|
+
* capture-time substitution is lossless (full content flushed to disk first)
|
|
206
|
+
* and strictly cheaper than the 413 loops it prevents.
|
|
207
|
+
*/
|
|
208
|
+
export declare const TOOL_RESULT_SIZE_CAP_DEFAULTS: {
|
|
209
|
+
readonly enabled: true;
|
|
210
|
+
readonly maxChars: 262144;
|
|
211
|
+
};
|
|
212
|
+
/** The validated, effective toolResultSizeCap config. */
|
|
213
|
+
export interface ResolvedToolResultSizeCapConfig {
|
|
214
|
+
enabled: boolean;
|
|
215
|
+
maxChars: number;
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
* Pure resolver for the braid.context.toolResultSizeCap block.
|
|
219
|
+
* Absent → all defaults (enabled: true). Non-object shape, or any field
|
|
220
|
+
* violating its type/range, falls back to that field's default with a
|
|
221
|
+
* once-per-process warning. Kept pure for unit-testability.
|
|
222
|
+
*/
|
|
223
|
+
export declare function resolveToolResultSizeCapConfig(raw: unknown): ResolvedToolResultSizeCapConfig;
|
|
224
|
+
/**
|
|
225
|
+
* Read the effective toolResultSizeCap config from settings.json, fresh on
|
|
226
|
+
* every call (no caching), like the other readers. Default: enabled=true.
|
|
227
|
+
*/
|
|
228
|
+
export declare function getToolResultSizeCapConfig(): ResolvedToolResultSizeCapConfig;
|
|
229
|
+
/**
|
|
230
|
+
* Defaults for the usage-driven auto-arm. Default ON: an armed cleanup that
|
|
231
|
+
* never lands while a run stays alive is the failure mode this exists to
|
|
232
|
+
* close, and the armed action is the deterministic slide (no LLM call, cut
|
|
233
|
+
* bounded by the keep window). confirmTicks=2 makes "crosses and STAYS there"
|
|
234
|
+
* the arming condition — a transient spike never arms.
|
|
235
|
+
*/
|
|
236
|
+
export declare const AUTO_COMPACT_DEFAULTS: {
|
|
237
|
+
readonly enabled: true;
|
|
238
|
+
readonly armPercent: 60;
|
|
239
|
+
readonly confirmTicks: 2;
|
|
240
|
+
};
|
|
241
|
+
/** The validated, effective contextAutoCompact config. */
|
|
242
|
+
export interface ResolvedAutoCompactConfig {
|
|
243
|
+
enabled: boolean;
|
|
244
|
+
armPercent: number;
|
|
245
|
+
confirmTicks: number;
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* Pure resolver for the braid.context.contextAutoCompact block.
|
|
249
|
+
* Absent → all defaults. Non-object shape, or any field violating its
|
|
250
|
+
* type/range (armPercent must be 1..100, confirmTicks an integer >= 1), falls
|
|
251
|
+
* back to that field's default with a once-per-process warning. Kept pure for
|
|
252
|
+
* unit-testability.
|
|
253
|
+
*/
|
|
254
|
+
export declare function resolveAutoCompactConfig(raw: unknown): ResolvedAutoCompactConfig;
|
|
255
|
+
/**
|
|
256
|
+
* Read the effective contextAutoCompact config from settings.json, fresh on
|
|
257
|
+
* every call (no caching), like the other readers. Default: enabled=true.
|
|
258
|
+
*/
|
|
259
|
+
export declare function getAutoCompactConfig(): ResolvedAutoCompactConfig;
|
|
260
|
+
/** Default redelivery bound for a failed wake fire. */
|
|
261
|
+
export declare const MAX_WAKE_ATTEMPTS_DEFAULT = 3;
|
|
262
|
+
/** Upper bound for the braid.timers.maxWakeAttempts setting. */
|
|
263
|
+
export declare const MAX_WAKE_ATTEMPTS_MAX = 10;
|
|
264
|
+
/**
|
|
265
|
+
* Pure resolver for braid.timers.maxWakeAttempts. Absent →
|
|
266
|
+
* MAX_WAKE_ATTEMPTS_DEFAULT; an integer 1..MAX_WAKE_ATTEMPTS_MAX passes
|
|
267
|
+
* through; anything else warns once and falls back to the default. Kept pure
|
|
268
|
+
* so the validation is unit-testable without touching live settings.json.
|
|
269
|
+
*/
|
|
270
|
+
export declare function resolveMaxWakeAttempts(raw: unknown): number;
|
|
271
|
+
/**
|
|
272
|
+
* Read the effective wake-retry redelivery cap from settings.json, fresh on
|
|
273
|
+
* every call (no caching), like the other readers. Default:
|
|
274
|
+
* MAX_WAKE_ATTEMPTS_DEFAULT (3).
|
|
275
|
+
*/
|
|
276
|
+
export declare function getMaxWakeAttempts(): number;
|
|
277
|
+
/** Default terminal-error count before timer wakes stop starting turns. */
|
|
278
|
+
export declare const TERMINAL_BREAKER_DEFAULT_THRESHOLD = 3;
|
|
279
|
+
/** Upper bound for a configured threshold (guards a typo'd huge value). */
|
|
280
|
+
export declare const TERMINAL_BREAKER_THRESHOLD_MAX = 20;
|
|
281
|
+
export interface TerminalBreakerConfig {
|
|
282
|
+
/** Master gate. Default true. */
|
|
283
|
+
enabled: boolean;
|
|
284
|
+
/** Terminal-class errors before wakes stop waking. Default 3. */
|
|
285
|
+
threshold: number;
|
|
286
|
+
}
|
|
287
|
+
/**
|
|
288
|
+
* Pure resolver for braid.session.terminalBreaker. Absent block ⇒ default-on
|
|
289
|
+
* with threshold 3. `enabled: false` ⇒ the gate is off. A threshold that is
|
|
290
|
+
* not an integer 1..TERMINAL_BREAKER_THRESHOLD_MAX warns once and falls back
|
|
291
|
+
* to the default. Kept pure so the validation is unit-testable without
|
|
292
|
+
* touching live settings.json.
|
|
293
|
+
*/
|
|
294
|
+
export declare function resolveTerminalBreaker(raw: unknown): TerminalBreakerConfig;
|
|
295
|
+
/**
|
|
296
|
+
* Read the effective terminal-error wake-breaker config from settings.json,
|
|
297
|
+
* fresh on every call (no caching), like the other readers. The wake path
|
|
298
|
+
* reads this once per fire.
|
|
299
|
+
*/
|
|
300
|
+
export declare function getTerminalBreakerConfig(): TerminalBreakerConfig;
|
|
301
|
+
/** Default wake-delivery alerting: on, page after 2 outcome timeouts. */
|
|
302
|
+
export declare const WAKE_DELIVERY_ALERT_DEFAULT: WakeDeliveryAlertConfig;
|
|
303
|
+
/** Upper bound for the outcome-timeout page threshold. */
|
|
304
|
+
export declare const WAKE_ALERT_OUTCOME_TIMEOUTS_MAX = 10;
|
|
305
|
+
export interface WakeDeliveryAlertConfig {
|
|
306
|
+
/** "off" disables the timer→watchdog feed entirely. */
|
|
307
|
+
mode: "on" | "off";
|
|
308
|
+
/** Outcome timeouts for ONE fire before the early stall page. */
|
|
309
|
+
outcomeTimeouts: number;
|
|
310
|
+
}
|
|
311
|
+
/**
|
|
312
|
+
* Pure resolver for braid.timers.wakeAlert. Absent → defaults; mode
|
|
313
|
+
* "on"/"off" passes through; outcomeTimeouts must be an integer 2..MAX (1
|
|
314
|
+
* would page on every normal long turn — the flood the 240s outcome window
|
|
315
|
+
* exists to prevent). An invalid present value warns once and falls back to
|
|
316
|
+
* the default for that field. Kept pure so the validation is unit-testable
|
|
317
|
+
* without touching live settings.json.
|
|
318
|
+
*/
|
|
319
|
+
export declare function resolveWakeDeliveryAlertConfig(raw: unknown): WakeDeliveryAlertConfig;
|
|
320
|
+
/**
|
|
321
|
+
* Read the effective wake-delivery alert config from settings.json, fresh on
|
|
322
|
+
* every call (no caching), like the other readers. Default: mode "on",
|
|
323
|
+
* outcomeTimeouts 2.
|
|
324
|
+
*/
|
|
325
|
+
export declare function getWakeDeliveryAlertConfig(): WakeDeliveryAlertConfig;
|
|
326
|
+
/** Upper bound for the wake-retry hold window (a hold must stay bounded). */
|
|
327
|
+
export declare const WAKE_RETRY_HOLD_MAX_MS = 300000;
|
|
328
|
+
/**
|
|
329
|
+
* Pure resolver for the wake-retry hold window: pi-core auto-retries a
|
|
330
|
+
* retryable provider failure inside the SAME run with backoff
|
|
331
|
+
* `baseDelayMs * 2^attempt` up to maxRetries (settings-manager
|
|
332
|
+
* .getRetrySettings defaults: 2000ms, 3 retries). The hold window mirrors
|
|
333
|
+
* that budget: baseDelayMs * 2^maxRetries (16s with pi-core defaults),
|
|
334
|
+
* clamped to [0, WAKE_RETRY_HOLD_MAX_MS]. Kept pure for unit-testability.
|
|
335
|
+
*/
|
|
336
|
+
export declare function resolveWakeRetryHoldMs(raw?: {
|
|
337
|
+
maxRetries?: number;
|
|
338
|
+
baseDelayMs?: number;
|
|
339
|
+
}): number;
|
|
340
|
+
/**
|
|
341
|
+
* The effective wake-retry hold window, read fresh on every call (no
|
|
342
|
+
* caching): pi-core's `retry` budget from settings.json, clamped.
|
|
343
|
+
*/
|
|
344
|
+
export declare function getWakeRetryHoldMs(): number;
|
|
345
|
+
/**
|
|
346
|
+
* Pure resolver for the effective context window. Precedence:
|
|
347
|
+
*
|
|
348
|
+
* 1. `contextLimitTokens` when it is a positive finite number - a
|
|
349
|
+
* CEILING, not a blind rewrite: min(cap, provider window) when the
|
|
350
|
+
* provider window is known positive, the cap alone otherwise.
|
|
351
|
+
* 2. `providerContextWindow` (model/provider truth) when positive finite.
|
|
352
|
+
* 3. undefined — caller applies its own terminal default.
|
|
353
|
+
*
|
|
354
|
+
* The cap can never widen a model past its catalog size: a manual pick
|
|
355
|
+
* whose true window is below the cap keeps that true window. Unset
|
|
356
|
+
* (`undefined`) silently falls through to provider truth; any other
|
|
357
|
+
* non-conforming value (0, negative, non-number, non-finite) is ignored with
|
|
358
|
+
* a once-per-process warning and also falls through. Kept pure so the
|
|
359
|
+
* precedence merge is unit-testable without touching live settings.json.
|
|
360
|
+
*/
|
|
361
|
+
export declare function resolveContextLimitTokens(raw: unknown, providerContextWindow?: number | null): number | undefined;
|
|
362
|
+
/**
|
|
363
|
+
* The effective context window braid uses for its computations, resolved
|
|
364
|
+
* through the ONE resolver: braid.context.contextLimitTokens override,
|
|
365
|
+
* else the provider/model context window. Returns undefined when neither is
|
|
366
|
+
* known - callers apply their own terminal default (e.g. 200000, 100_000).
|
|
367
|
+
* Reads settings fresh on every call (no caching), like the other readers.
|
|
368
|
+
*/
|
|
369
|
+
export declare function getResolvedContextWindow(providerContextWindow?: number | null): number | undefined;
|
|
370
|
+
/**
|
|
371
|
+
* The RAW configured window override (braid.context.contextLimitTokens),
|
|
372
|
+
* undefined when unset. Separated from getResolvedContextWindow so callers
|
|
373
|
+
* that must label the window source (configured vs provider) can read the
|
|
374
|
+
* override directly instead of reverse-engineering it from the merged value.
|
|
375
|
+
*/
|
|
376
|
+
export declare function getConfiguredContextLimitTokens(): number | undefined;
|
|
377
|
+
export interface ConfiguredWindowApplyResult {
|
|
378
|
+
/** true = the session model now reports the configured window. */
|
|
379
|
+
applied: boolean;
|
|
380
|
+
/** The window pi-core reports for the session model after the call. */
|
|
381
|
+
contextWindow?: number;
|
|
382
|
+
/** Why nothing changed: unset | no-model | unchanged | frozen. */
|
|
383
|
+
reason?: "unset" | "no-model" | "unchanged" | "frozen";
|
|
384
|
+
}
|
|
385
|
+
/**
|
|
386
|
+
* Make the session model report the configured window so pi-core's OWN
|
|
387
|
+
* compaction decisions use it. pi-core reads `model.contextWindow` at every
|
|
388
|
+
* window-dependent decision point (threshold compaction in
|
|
389
|
+
* `_compactBeforeNextAssistantResponse` / `_checkCompaction` via
|
|
390
|
+
* `shouldCompact`, overflow detection, usage percent); it never sees braid's
|
|
391
|
+
* setting today, so when `contextLimitTokens < provider window` no automatic
|
|
392
|
+
* actor can fire and the configured cap is enforced by nobody.
|
|
393
|
+
*
|
|
394
|
+
* This is the write side of the ONE resolver: same setting, same validation
|
|
395
|
+
* (`getConfiguredContextLimitTokens`), same ceiling merge. The value written
|
|
396
|
+
* is the resolver's effective window, so the setting can never widen a model
|
|
397
|
+
* past its true window (configured 1M over a 202752 model leaves 202752 in
|
|
398
|
+
* place); only an unknown true window takes the cap alone. When the setting
|
|
399
|
+
* is unset or invalid this is a no-op and pi-core keeps provider-window
|
|
400
|
+
* semantics. The model object is the live `agent.state.model` instance
|
|
401
|
+
* pi-core hands to the extension context, so patching it in place steers
|
|
402
|
+
* every downstream reader; a frozen object (models.json-derived catalogs)
|
|
403
|
+
* degrades to a once-per-process warning and provider semantics rather than
|
|
404
|
+
* throwing mid-run.
|
|
405
|
+
*
|
|
406
|
+
* Idempotent: callers may re-apply on every run start (also re-arms after a
|
|
407
|
+
* model switch, since the newly selected model carries the provider window).
|
|
408
|
+
*/
|
|
409
|
+
export declare function applyConfiguredContextWindow(ctx: unknown): ConfiguredWindowApplyResult;
|
|
410
|
+
/**
|
|
411
|
+
* Floor for the derived reserve: pi-core's own shipped default
|
|
412
|
+
* (DEFAULT_COMPACTION_SETTINGS.reserveTokens). The reserve doubles as the
|
|
413
|
+
* budget for the post-compaction summary request (pi-core caps it at 80% of
|
|
414
|
+
* the reserve), so a thinner one starts failing the compaction it exists to
|
|
415
|
+
* fund; the derivation never goes below it.
|
|
416
|
+
*/
|
|
417
|
+
export declare const MIN_COMPACTION_RESERVE_TOKENS = 16384;
|
|
418
|
+
/** Derived reserve for one window, with the trigger it produces. */
|
|
419
|
+
export interface CompactionReserveDerivation {
|
|
420
|
+
/** Window − trigger, floored at MIN_COMPACTION_RESERVE_TOKENS. */
|
|
421
|
+
reserveTokens: number;
|
|
422
|
+
/** contextTokens above which pi-core's shouldCompact() fires. */
|
|
423
|
+
triggerTokens: number;
|
|
424
|
+
/** triggerTokens as a percent of the window (the coherence target). */
|
|
425
|
+
triggerPercent: number;
|
|
426
|
+
}
|
|
427
|
+
/**
|
|
428
|
+
* Pure resolver for the compaction reserve that puts native threshold
|
|
429
|
+
* compaction at USAGE_WHISPER_CRITICAL of the window: reserve = window −
|
|
430
|
+
* trigger, i.e. the same 75/25 split the usage bands already treat as
|
|
431
|
+
* coherent (compaction at USAGE_WHISPER_CRITICAL, before the archiving band
|
|
432
|
+
* opens at USAGE_COMPACT_MEDIUM). pi-core's shouldCompact() compares raw
|
|
433
|
+
* token counts (contextTokens > contextWindow − reserveTokens), never
|
|
434
|
+
* percents, so a reserve that is not a fixed share of the plumbed window
|
|
435
|
+
* silently re-anchors the trigger — that is the incoherence this derives
|
|
436
|
+
* away.
|
|
437
|
+
*
|
|
438
|
+
* Returns undefined when no reserve can be derived: a non-number, non-finite
|
|
439
|
+
* or non-positive window, or a window so small that even the floor reserve
|
|
440
|
+
* (MIN_COMPACTION_RESERVE_TOKENS) leaves no room to compact into. Kept pure
|
|
441
|
+
* so the split is unit-testable without touching live settings.json.
|
|
442
|
+
*/
|
|
443
|
+
export declare function resolveCompactionReserveTokens(window: number | null | undefined): CompactionReserveDerivation | undefined;
|
|
444
|
+
/**
|
|
445
|
+
* The reserve pi-core would actually use for this model: the per-model
|
|
446
|
+
* `compaction.modelOverrides[provider/id].reserveTokens` first, then
|
|
447
|
+
* `compaction.reserveTokens`, else undefined (pi-core's own default, i.e.
|
|
448
|
+
* MIN_COMPACTION_RESERVE_TOKENS). Reads settings fresh, like the other
|
|
449
|
+
* readers.
|
|
450
|
+
*/
|
|
451
|
+
export declare function getConfiguredCompactionReserveTokens(provider?: string | null, modelId?: string | null): number | undefined;
|
|
452
|
+
export interface CompactionReserveApplyResult {
|
|
453
|
+
/** Derived reserve (window − trigger); absent when no derivation exists. */
|
|
454
|
+
reserveTokens?: number;
|
|
455
|
+
/** Token count at which native threshold compaction fires under the derivation. */
|
|
456
|
+
triggerTokens?: number;
|
|
457
|
+
/** triggerTokens as a percent of the window (target: USAGE_WHISPER_CRITICAL). */
|
|
458
|
+
triggerPercent?: number;
|
|
459
|
+
/** Why nothing was applied. */
|
|
460
|
+
reason?: "unset" | "no-derivation" | "window-not-plumbed" | "unreachable" | "unchanged";
|
|
461
|
+
}
|
|
462
|
+
/**
|
|
463
|
+
* Derive the compaction reserve that makes pi-core's native threshold
|
|
464
|
+
* compaction fire at the SAME share of the window braid's usage bands assume.
|
|
465
|
+
* applyConfiguredContextWindow() gives pi-core the braid window; this pairs
|
|
466
|
+
* with it, because pi-core then decides WHEN to compact from its own
|
|
467
|
+
* independent `compaction.reserveTokens` (a fixed token count, default
|
|
468
|
+
* 16384) - untouched, that count re-anchors the trigger to an arbitrary
|
|
469
|
+
* percent of the plumbed window. The window here is the effective one the
|
|
470
|
+
* plumb writes or keeps (`min(cap, true window)` when the true window is
|
|
471
|
+
* known), never the raw cap, so the two sides cannot size against different
|
|
472
|
+
* windows.
|
|
473
|
+
*
|
|
474
|
+
* The derivation is computed, but it cannot be APPLIED from an extension on
|
|
475
|
+
* pi 1.0.2: ctx.sessionManager is pi-core's session manager and carries no
|
|
476
|
+
* settings object, and the ExtensionAPI's only settings surface,
|
|
477
|
+
* getSettings(), returns a structuredClone of the effective settings - a
|
|
478
|
+
* write would never reach pi-core's compaction reader. The operator-facing
|
|
479
|
+
* warning is therefore the channel: it fires once per process and spells out
|
|
480
|
+
* the value to set.
|
|
481
|
+
*
|
|
482
|
+
* Warnings (each once per process): an incoherent CONFIGURED reserve (its
|
|
483
|
+
* trigger falls outside the USAGE_WHISPER_WARNING..USAGE_COMPACT_MEDIUM band
|
|
484
|
+
* the usage layers work in) and an unappliable reserve - the owner has to set
|
|
485
|
+
* the value by hand.
|
|
486
|
+
*/
|
|
487
|
+
export declare function applyCompactionReserveTokens(ctx: unknown): CompactionReserveApplyResult;
|
|
488
|
+
export {};
|
|
489
|
+
//# sourceMappingURL=braid-settings.d.ts.map
|