pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated Topic Critic -- single LLM call for all 3 topic-drift checks.
|
|
3
|
+
*
|
|
4
|
+
* Replaces 3 parallel classify() calls (topicCoverage, topicDivergence,
|
|
5
|
+
* topicCompleteness) with one structured-output LLM call that returns all
|
|
6
|
+
* three verdicts as JSON. Falls back to conservative heuristic fallbacks
|
|
7
|
+
* (topicDriftFallback -> "no" for all dimensions) on failure.
|
|
8
|
+
*
|
|
9
|
+
* Benefits:
|
|
10
|
+
* - 3x fewer LLM calls -> ~66% latency reduction at turn_end
|
|
11
|
+
* - Single system prompt shared across all three dimensions
|
|
12
|
+
* - Model can cross-reference dimensions (e.g., divergence vs coverage)
|
|
13
|
+
* - Same return interface -- drop-in replacement for both call sites
|
|
14
|
+
* (lib/detection/topic-drift-detector.ts and the extension handler)
|
|
15
|
+
*
|
|
16
|
+
* Output budget: the answer is ~40 tokens of JSON, but thinking tokens count
|
|
17
|
+
* against max_tokens on every reasoning model braid routes to, and the channel
|
|
18
|
+
* cannot be switched off for a model whose thinkingLevelMap declares no "off"
|
|
19
|
+
* level (pi-ai clamps "off" to the lowest declared level). So a small explicit
|
|
20
|
+
* ceiling is a ceiling on thinking and the JSON body never gets written. The
|
|
21
|
+
* mechanism that answers this - first completion with no maxTokens, one
|
|
22
|
+
* enlarged-budget retry when a completion ends at its ceiling without a
|
|
23
|
+
* verdict - lives in lib/ai/judge-budget.ts and is shared with the other two
|
|
24
|
+
* consolidated judges.
|
|
25
|
+
*/
|
|
26
|
+
import { extractJson } from "../../lib/utils/extract-json.js";
|
|
27
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
28
|
+
import { judgeAcrossTiers, } from "../../lib/ai/judge-budget.js";
|
|
29
|
+
const log = createLogger("consolidated-topic-critic");
|
|
30
|
+
// ── Consolidated Prompt ──────────────────────────────────────────────────────
|
|
31
|
+
const SYSTEM_PROMPT = "You are a topic-drift analyzer. You do one thing: " +
|
|
32
|
+
"read an original request and an agent response inside XML tags, " +
|
|
33
|
+
"and rate the response on three binary dimensions. " +
|
|
34
|
+
"Respond with a valid JSON object containing exactly these three fields. " +
|
|
35
|
+
"No explanation, no markdown, no other text.";
|
|
36
|
+
const USER_PROMPT = "Analyze the response against the original request. Respond with valid JSON only:\n" +
|
|
37
|
+
"{\n" +
|
|
38
|
+
' "coversTopic": true|false, // Does the response still address the original request? (true = yes, still relevant)\n' +
|
|
39
|
+
' "hasDiverged": true|false, // Has the response shifted to a substantially different topic? (true = yes, drifted away)\n' +
|
|
40
|
+
' "isComplete": true|false // Does the response cover all key topics from the request? (true = complete)\n' +
|
|
41
|
+
"}\n\n" +
|
|
42
|
+
"<original>\n{{original}}\n</original>\n\n" +
|
|
43
|
+
"<response>\n{{response}}\n</response>";
|
|
44
|
+
// ── Main Function ────────────────────────────────────────────────────────────
|
|
45
|
+
/**
|
|
46
|
+
* Consolidated topic critique -- single LLM call for all 3 drift dimensions.
|
|
47
|
+
*
|
|
48
|
+
* Model tier strategy (modelPreference: "quality"):
|
|
49
|
+
* 1. Try session model (cheap, may already be powerful)
|
|
50
|
+
* 2. If session fails, try utility model
|
|
51
|
+
* 3. If both fail, try max-power model (accuracy-critical safety net)
|
|
52
|
+
* 4. If all fail, use conservative defaults (no drift detected)
|
|
53
|
+
*/
|
|
54
|
+
export async function consolidatedTopicCritique(original, response, ctx) {
|
|
55
|
+
const truncatedOriginal = original.length > 2000 ? original.slice(0, 2000) + "..." : original;
|
|
56
|
+
const truncatedResponse = response.length > 2000 ? response.slice(0, 2000) + "..." : response;
|
|
57
|
+
const start = Date.now();
|
|
58
|
+
// ── Attempt consolidated LLM call ──────────────────────────────────────
|
|
59
|
+
const verdict = await tryConsolidatedCall(truncatedOriginal, truncatedResponse, ctx);
|
|
60
|
+
if (verdict) {
|
|
61
|
+
const latency = Date.now() - start;
|
|
62
|
+
log.debug(`[consolidated-topic] OK ${latency}ms: ${JSON.stringify(verdict)}`);
|
|
63
|
+
return {
|
|
64
|
+
// coverage="no" -> bad (does NOT address request), so invert coversTopic
|
|
65
|
+
coverage: verdict.coversTopic,
|
|
66
|
+
divergence: verdict.hasDiverged,
|
|
67
|
+
completeness: verdict.isComplete,
|
|
68
|
+
classifierDown: false,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
// ── Fallback: conservative defaults (no drift) ─────────────────────────
|
|
72
|
+
log.debug("[consolidated-topic] LLM failed, using conservative defaults");
|
|
73
|
+
return {
|
|
74
|
+
coverage: true,
|
|
75
|
+
divergence: false,
|
|
76
|
+
completeness: true,
|
|
77
|
+
classifierDown: true,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
// ── Internal Helpers ─────────────────────────────────────────────────────────
|
|
81
|
+
/**
|
|
82
|
+
* The consolidated judge, across the model tiers, on the shared output-budget
|
|
83
|
+
* contract (lib/ai/judge-budget.ts): session model first, then utility, then
|
|
84
|
+
* max-power as safety net, each with at most one enlarged-budget retry.
|
|
85
|
+
*/
|
|
86
|
+
async function tryConsolidatedCall(original, response, ctx) {
|
|
87
|
+
const userMessage = USER_PROMPT.replace("{{original}}", original).replace("{{response}}", response);
|
|
88
|
+
const outcome = await judgeAcrossTiers({
|
|
89
|
+
ctx,
|
|
90
|
+
systemPrompt: SYSTEM_PROMPT,
|
|
91
|
+
userMessage,
|
|
92
|
+
read: readTopicVerdict,
|
|
93
|
+
label: "consolidated-topic",
|
|
94
|
+
});
|
|
95
|
+
return outcome.ok ? outcome.verdict : null;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Read one completion as a topic-drift verdict. The mapping from "what the
|
|
99
|
+
* model said" to "why there is no verdict" is this judge's business; the retry
|
|
100
|
+
* decision above it is not.
|
|
101
|
+
*/
|
|
102
|
+
function readTopicVerdict(view) {
|
|
103
|
+
const jsonStr = extractJson(view.text);
|
|
104
|
+
if (!jsonStr) {
|
|
105
|
+
log.debug(`[consolidated-topic] No JSON found from ${view.model.id} ${view.elapsedMs}ms: ${view.text.slice(0, 100)}`);
|
|
106
|
+
return {
|
|
107
|
+
ok: false,
|
|
108
|
+
reason: view.atCeiling ? "budget-exhausted" : "unparseable",
|
|
109
|
+
detail: `${view.text.length} chars of response, no JSON`,
|
|
110
|
+
};
|
|
111
|
+
}
|
|
112
|
+
let parsed;
|
|
113
|
+
try {
|
|
114
|
+
parsed = JSON.parse(jsonStr);
|
|
115
|
+
}
|
|
116
|
+
catch {
|
|
117
|
+
log.debug(`[consolidated-topic] Unparseable JSON from ${view.model.id}: ${jsonStr.slice(0, 100)}`);
|
|
118
|
+
return {
|
|
119
|
+
ok: false,
|
|
120
|
+
reason: view.atCeiling ? "budget-exhausted" : "unparseable",
|
|
121
|
+
detail: `enclosed object is not parseable JSON`,
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
if (typeof parsed.coversTopic === "boolean" &&
|
|
125
|
+
typeof parsed.hasDiverged === "boolean" &&
|
|
126
|
+
typeof parsed.isComplete === "boolean") {
|
|
127
|
+
return { ok: true, verdict: parsed };
|
|
128
|
+
}
|
|
129
|
+
log.debug(`[consolidated-topic] Invalid fields from ${view.model.id}: ${jsonStr}`);
|
|
130
|
+
return { ok: false, reason: "invalid-fields", detail: `JSON without the three boolean fields` };
|
|
131
|
+
}
|
|
132
|
+
//# sourceMappingURL=consolidated-topic-critic.js.map
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Information Density Evaluator
|
|
3
|
+
*
|
|
4
|
+
* Measures signal-to-noise ratio in context to predict when context management
|
|
5
|
+
* is needed. Based on:
|
|
6
|
+
* - SimpleMem (2601.02553): 30x token reduction via semantic structured compression
|
|
7
|
+
* - GenericAgent (2604.17091): Information density, not length, determines performance
|
|
8
|
+
*
|
|
9
|
+
* Key insight: Count-based thresholds miss the real problem. A 50-message context with
|
|
10
|
+
* high signal is better than a 10-message context with mostly boilerplate.
|
|
11
|
+
*
|
|
12
|
+
* Density evaluation uses a two-tier approach:
|
|
13
|
+
* Tier 1 (default): Fast heuristic - token counting + sample-based LLM judge
|
|
14
|
+
* Tier 2 (opt-in): Full LLM judge via contextDensity critic for overall assessment
|
|
15
|
+
*/
|
|
16
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
17
|
+
export interface DensityResult {
|
|
18
|
+
/** Signal / (signal + noise), 0-1. Higher = more informative context. */
|
|
19
|
+
density: number;
|
|
20
|
+
/** Messages with meaningful, non-boilerplate content. */
|
|
21
|
+
signalMessages: number;
|
|
22
|
+
/** Messages that are pure boilerplate, duplication, or noise. */
|
|
23
|
+
noisyMessages: number;
|
|
24
|
+
/** Messages that appear nearly identical to previous messages. */
|
|
25
|
+
duplicates: number;
|
|
26
|
+
/** Estimated token count of context. */
|
|
27
|
+
totalTokens: number;
|
|
28
|
+
/** tokens / tokenLimit, 0-1. */
|
|
29
|
+
tokenRatio: number;
|
|
30
|
+
/** LLM judge density label if evaluateContextDensityWithJudge was used. */
|
|
31
|
+
judgeLabel?: "HIGH" | "MEDIUM" | "LOW";
|
|
32
|
+
}
|
|
33
|
+
export type CompressionStrategy = "aggressive" | "semantic" | "conservative" | "none";
|
|
34
|
+
/**
|
|
35
|
+
* Evaluate the information density of a session's context.
|
|
36
|
+
*
|
|
37
|
+
* Uses fast heuristic (token counting + hash-based dedup). For semantic
|
|
38
|
+
* density assessment, call evaluateContextDensityWithJudge() instead.
|
|
39
|
+
*
|
|
40
|
+
* @param ctx - ExtensionContext to access session entries
|
|
41
|
+
* @returns DensityResult with aggregate metrics
|
|
42
|
+
*/
|
|
43
|
+
export declare function evaluateContextDensity(ctx: ExtensionContext): DensityResult;
|
|
44
|
+
/**
|
|
45
|
+
* Evaluate context density using an LLM judge for semantic assessment.
|
|
46
|
+
*
|
|
47
|
+
* Samples messages from the context and uses classify() with the
|
|
48
|
+
* contextDensity critic to assess signal-to-noise ratio holistically.
|
|
49
|
+
* Falls back to fast heuristic when LLM is unavailable.
|
|
50
|
+
*
|
|
51
|
+
* Call this when you need a deeper understanding of context quality
|
|
52
|
+
* (e.g., before deciding whether to compress or archive).
|
|
53
|
+
*
|
|
54
|
+
* NOTE: Defined but never called. The context-density heuristic path
|
|
55
|
+
* (evaluateContextDensity) is used instead. Kept for future wiring
|
|
56
|
+
* when LLM-based density assessment is needed.
|
|
57
|
+
*
|
|
58
|
+
* @param ctx - ExtensionContext
|
|
59
|
+
* @returns DensityResult with an additional judgeLabel field
|
|
60
|
+
*/
|
|
61
|
+
export declare function evaluateContextDensityWithJudge(ctx: ExtensionContext): Promise<DensityResult>;
|
|
62
|
+
/**
|
|
63
|
+
* Recommend a compression strategy based on context density.
|
|
64
|
+
*
|
|
65
|
+
* Low density (< 0.4): Aggressive pruning - remove noise, keep signal
|
|
66
|
+
* Medium density (0.4-0.7): Semantic compression - summarize without losing meaning
|
|
67
|
+
* High density (> 0.7): Conservative - only compress if context is large
|
|
68
|
+
*/
|
|
69
|
+
export declare function recommendCompressionStrategy(density: DensityResult): CompressionStrategy;
|
|
70
|
+
//# sourceMappingURL=context-density.d.ts.map
|
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Information Density Evaluator
|
|
3
|
+
*
|
|
4
|
+
* Measures signal-to-noise ratio in context to predict when context management
|
|
5
|
+
* is needed. Based on:
|
|
6
|
+
* - SimpleMem (2601.02553): 30x token reduction via semantic structured compression
|
|
7
|
+
* - GenericAgent (2604.17091): Information density, not length, determines performance
|
|
8
|
+
*
|
|
9
|
+
* Key insight: Count-based thresholds miss the real problem. A 50-message context with
|
|
10
|
+
* high signal is better than a 10-message context with mostly boilerplate.
|
|
11
|
+
*
|
|
12
|
+
* Density evaluation uses a two-tier approach:
|
|
13
|
+
* Tier 1 (default): Fast heuristic - token counting + sample-based LLM judge
|
|
14
|
+
* Tier 2 (opt-in): Full LLM judge via contextDensity critic for overall assessment
|
|
15
|
+
*/
|
|
16
|
+
import { classify } from "../ai/text-classifier.js";
|
|
17
|
+
import { CRITICS } from "../ai/critic-registry.js";
|
|
18
|
+
import { getResolvedContextWindow } from "../config/braid-settings.js";
|
|
19
|
+
const MIN_SIGNAL_LENGTH = 30;
|
|
20
|
+
const CHARS_PER_TOKEN = 4;
|
|
21
|
+
function countTokens(text) {
|
|
22
|
+
return Math.ceil(text.length / CHARS_PER_TOKEN);
|
|
23
|
+
}
|
|
24
|
+
/** Simple string hash for duplicate detection. */
|
|
25
|
+
function simpleHash(s) {
|
|
26
|
+
let h = 0;
|
|
27
|
+
for (let i = 0; i < Math.min(s.length, 200); i++) {
|
|
28
|
+
h = (Math.imul(31, h) + s.charCodeAt(i)) | 0;
|
|
29
|
+
}
|
|
30
|
+
return h;
|
|
31
|
+
}
|
|
32
|
+
// ── Main Evaluator (heuristic + optional LLM judge) ──────────────────────────
|
|
33
|
+
/**
|
|
34
|
+
* Evaluate the information density of a session's context.
|
|
35
|
+
*
|
|
36
|
+
* Uses fast heuristic (token counting + hash-based dedup). For semantic
|
|
37
|
+
* density assessment, call evaluateContextDensityWithJudge() instead.
|
|
38
|
+
*
|
|
39
|
+
* @param ctx - ExtensionContext to access session entries
|
|
40
|
+
* @returns DensityResult with aggregate metrics
|
|
41
|
+
*/
|
|
42
|
+
export function evaluateContextDensity(ctx) {
|
|
43
|
+
let entries = [];
|
|
44
|
+
try {
|
|
45
|
+
entries = ctx.sessionManager?.getEntries?.() ?? [];
|
|
46
|
+
}
|
|
47
|
+
catch {
|
|
48
|
+
/* fallback: empty */
|
|
49
|
+
}
|
|
50
|
+
let totalTokens = 0;
|
|
51
|
+
let signalMessages = 0;
|
|
52
|
+
let noisyMessages = 0;
|
|
53
|
+
let duplicates = 0;
|
|
54
|
+
// Deduplication: track recent message hashes
|
|
55
|
+
const recentHashes = new Set();
|
|
56
|
+
const MAX_RECENT = 20;
|
|
57
|
+
for (const entry of entries) {
|
|
58
|
+
let content = "";
|
|
59
|
+
if (entry.type === "message" && entry.message) {
|
|
60
|
+
const msg = entry.message;
|
|
61
|
+
content =
|
|
62
|
+
typeof msg.content === "string"
|
|
63
|
+
? msg.content
|
|
64
|
+
: Array.isArray(msg.content)
|
|
65
|
+
? msg.content.map((c) => c.text ?? "").join(" ")
|
|
66
|
+
: "";
|
|
67
|
+
}
|
|
68
|
+
else if (entry.type === "tool_result" && entry.result) {
|
|
69
|
+
content = typeof entry.result === "string" ? entry.result : JSON.stringify(entry.result);
|
|
70
|
+
}
|
|
71
|
+
else if (entry.type === "custom") {
|
|
72
|
+
// Skip custom entries (memory, retry state, etc.)
|
|
73
|
+
continue;
|
|
74
|
+
}
|
|
75
|
+
if (!content)
|
|
76
|
+
continue;
|
|
77
|
+
const tokens = countTokens(content);
|
|
78
|
+
const clean = content.trim();
|
|
79
|
+
const isTooShort = clean.length < MIN_SIGNAL_LENGTH;
|
|
80
|
+
// Duplicate detection: hash of first 200 chars + length
|
|
81
|
+
const hashKey = `${simpleHash(clean)}:${clean.length}`;
|
|
82
|
+
const isDuplicate = recentHashes.has(hashKey);
|
|
83
|
+
if (isDuplicate)
|
|
84
|
+
duplicates++;
|
|
85
|
+
recentHashes.add(hashKey);
|
|
86
|
+
if (recentHashes.size > MAX_RECENT) {
|
|
87
|
+
const first = recentHashes.values().next().value;
|
|
88
|
+
if (first !== undefined)
|
|
89
|
+
recentHashes.delete(first);
|
|
90
|
+
}
|
|
91
|
+
totalTokens += tokens;
|
|
92
|
+
if (isTooShort || isDuplicate)
|
|
93
|
+
noisyMessages++;
|
|
94
|
+
else
|
|
95
|
+
signalMessages++;
|
|
96
|
+
}
|
|
97
|
+
// Effective window via the ONE resolver - braid.context.contextLimitTokens
|
|
98
|
+
// override, else the model's provider-truth window. 100k only when neither is
|
|
99
|
+
// known (the former hardcoded default; it fired density triggers ~3x too early
|
|
100
|
+
// at a 262k window).
|
|
101
|
+
const tokenLimit = getResolvedContextWindow(ctx.model?.contextWindow) ?? 100_000;
|
|
102
|
+
const tokenRatio = tokenLimit > 0 ? Math.min(totalTokens / tokenLimit, 1) : 0;
|
|
103
|
+
const totalMessages = signalMessages + noisyMessages;
|
|
104
|
+
const density = totalMessages > 0 ? signalMessages / totalMessages : 1;
|
|
105
|
+
return { density, signalMessages, noisyMessages, duplicates, totalTokens, tokenRatio };
|
|
106
|
+
}
|
|
107
|
+
// ── LLM Judge Evaluation ─────────────────────────────────────────────────────
|
|
108
|
+
/**
|
|
109
|
+
* Evaluate context density using an LLM judge for semantic assessment.
|
|
110
|
+
*
|
|
111
|
+
* Samples messages from the context and uses classify() with the
|
|
112
|
+
* contextDensity critic to assess signal-to-noise ratio holistically.
|
|
113
|
+
* Falls back to fast heuristic when LLM is unavailable.
|
|
114
|
+
*
|
|
115
|
+
* Call this when you need a deeper understanding of context quality
|
|
116
|
+
* (e.g., before deciding whether to compress or archive).
|
|
117
|
+
*
|
|
118
|
+
* NOTE: Defined but never called. The context-density heuristic path
|
|
119
|
+
* (evaluateContextDensity) is used instead. Kept for future wiring
|
|
120
|
+
* when LLM-based density assessment is needed.
|
|
121
|
+
*
|
|
122
|
+
* @param ctx - ExtensionContext
|
|
123
|
+
* @returns DensityResult with an additional judgeLabel field
|
|
124
|
+
*/
|
|
125
|
+
export async function evaluateContextDensityWithJudge(ctx) {
|
|
126
|
+
const base = evaluateContextDensity(ctx);
|
|
127
|
+
// Build a sample of message content for the judge
|
|
128
|
+
let entries = [];
|
|
129
|
+
try {
|
|
130
|
+
entries = ctx.sessionManager?.getEntries?.() ?? [];
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
/* fallback */
|
|
134
|
+
}
|
|
135
|
+
// Sample up to 10 messages: evenly spaced across the context
|
|
136
|
+
const sampleSize = Math.min(10, entries.length);
|
|
137
|
+
const step = entries.length > sampleSize ? Math.floor(entries.length / sampleSize) : 1;
|
|
138
|
+
const sample = [];
|
|
139
|
+
for (let i = 0; i < entries.length && sample.length < sampleSize; i += step) {
|
|
140
|
+
const entry = entries[i];
|
|
141
|
+
let text = "";
|
|
142
|
+
if (entry.type === "message" && entry.message) {
|
|
143
|
+
const msg = entry.message;
|
|
144
|
+
text =
|
|
145
|
+
typeof msg.content === "string"
|
|
146
|
+
? msg.content.slice(0, 200)
|
|
147
|
+
: Array.isArray(msg.content)
|
|
148
|
+
? msg.content.map((c) => (c.text ?? "").slice(0, 100)).join(" ")
|
|
149
|
+
: "";
|
|
150
|
+
}
|
|
151
|
+
else if (entry.type === "tool_result" && entry.result) {
|
|
152
|
+
text = (typeof entry.result === "string" ? entry.result : JSON.stringify(entry.result)).slice(0, 200);
|
|
153
|
+
}
|
|
154
|
+
if (text.trim())
|
|
155
|
+
sample.push(`[${entry.type}] ${text}`);
|
|
156
|
+
}
|
|
157
|
+
const messagesText = sample.map((m, i) => `--- Message ${i + 1} ---\n${m}`).join("\n\n");
|
|
158
|
+
try {
|
|
159
|
+
const result = await classify(ctx, CRITICS.contextDensity.criteria, { sampleCount: String(sample.length), messages: messagesText }, { timeoutMs: 60_000, label: CRITICS.contextDensity.label });
|
|
160
|
+
const label = result.label.toUpperCase();
|
|
161
|
+
const judgeLabel = label === "HIGH" || label === "MEDIUM" || label === "LOW" ? label : undefined;
|
|
162
|
+
return { ...base, judgeLabel };
|
|
163
|
+
}
|
|
164
|
+
catch {
|
|
165
|
+
// LLM unavailable - return base heuristic result
|
|
166
|
+
return base;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
// ── Compression Strategy Recommendation ───────────────────────────────────────────
|
|
170
|
+
/**
|
|
171
|
+
* Recommend a compression strategy based on context density.
|
|
172
|
+
*
|
|
173
|
+
* Low density (< 0.4): Aggressive pruning - remove noise, keep signal
|
|
174
|
+
* Medium density (0.4-0.7): Semantic compression - summarize without losing meaning
|
|
175
|
+
* High density (> 0.7): Conservative - only compress if context is large
|
|
176
|
+
*/
|
|
177
|
+
export function recommendCompressionStrategy(density) {
|
|
178
|
+
// If LLM judge says LOW density, escalate
|
|
179
|
+
if (density.judgeLabel === "LOW")
|
|
180
|
+
return "aggressive";
|
|
181
|
+
if (density.tokenRatio > 0.85) {
|
|
182
|
+
return density.density < 0.4 ? "aggressive" : "semantic";
|
|
183
|
+
}
|
|
184
|
+
if (density.tokenRatio > 0.6) {
|
|
185
|
+
if (density.density < 0.4)
|
|
186
|
+
return "semantic";
|
|
187
|
+
if (density.density < 0.6)
|
|
188
|
+
return "conservative";
|
|
189
|
+
return "none";
|
|
190
|
+
}
|
|
191
|
+
return "none";
|
|
192
|
+
}
|
|
193
|
+
//# sourceMappingURL=context-density.js.map
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Management Thresholds - single source of truth.
|
|
3
|
+
*
|
|
4
|
+
* Separates two semantically distinct concepts:
|
|
5
|
+
* CONTEXT_USAGE - how full the token window is (% of limit filled)
|
|
6
|
+
* DENSITY - signal-to-noise ratio of content (0-1)
|
|
7
|
+
*
|
|
8
|
+
* Tune these values to adjust reminder cadence without hunting through 6+ files.
|
|
9
|
+
*/
|
|
10
|
+
/** First soft whisper - inspect context, start tracking. */
|
|
11
|
+
export declare const USAGE_WHISPER_SOFT = 30;
|
|
12
|
+
/** Advisory - suggest light pruning or archiving completed work. */
|
|
13
|
+
export declare const USAGE_WHISPER_ADVISORY = 50;
|
|
14
|
+
/** Warning - suggest deep compaction and compression. */
|
|
15
|
+
export declare const USAGE_WHISPER_WARNING = 65;
|
|
16
|
+
/** Critical - high priority, force immediate hygiene. */
|
|
17
|
+
export declare const USAGE_WHISPER_CRITICAL = 75;
|
|
18
|
+
/** Auto-compaction: medium level at this usage. */
|
|
19
|
+
export declare const USAGE_COMPACT_MEDIUM = 80;
|
|
20
|
+
/** Auto-compaction: aggressive level at this usage. */
|
|
21
|
+
export declare const USAGE_COMPACT_AGGRESSIVE = 90;
|
|
22
|
+
/** Reset the fired-threshold set when usage drops below this. */
|
|
23
|
+
export declare const USAGE_FIRED_RESET_BELOW = 50;
|
|
24
|
+
/**
|
|
25
|
+
* Compaction hard-refuse threshold: above this usage percent, destructive
|
|
26
|
+
* AI-supervised compaction is refused/redirected to deterministic slide-mode
|
|
27
|
+
* (max-call-stack crash + session-corruption guard at high usage).
|
|
28
|
+
*
|
|
29
|
+
* Single home for the 70% compaction-refusal literals: the context_compress(action="compact")
|
|
30
|
+
* refusal, the session_before_compact slide guard, the compaction
|
|
31
|
+
* summarization-aggressiveness tier, the audit branching trigger, and the
|
|
32
|
+
* context_inspect steer bands. Consumers import this constant; do not
|
|
33
|
+
* restate the number. Behavior note: it is a hard ceiling for LLM-supervised
|
|
34
|
+
* compaction, NOT an auto-compact trigger (that is USAGE_COMPACT_MEDIUM).
|
|
35
|
+
*/
|
|
36
|
+
export declare const CONTEXT_COMPACT_REFUSE_PERCENT = 70;
|
|
37
|
+
/**
|
|
38
|
+
* Turn-end ACT re-arm: the token arm that gates the hygiene act
|
|
39
|
+
* (min(0.60W, ACT_ARM_TOKEN_CEILING)).
|
|
40
|
+
*/
|
|
41
|
+
export declare function USAGE_TOKENS_CRITICAL(window?: number | null): number;
|
|
42
|
+
/**
|
|
43
|
+
* Turn-end auto-compact HARD BACKSTOP (0.90W): bounds runaway growth the
|
|
44
|
+
* re-arm spacing could otherwise sail past between checks.
|
|
45
|
+
*/
|
|
46
|
+
export declare function HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(window?: number | null): number;
|
|
47
|
+
/**
|
|
48
|
+
* ADVISORY ESCALATION BAND (0.85W): distinct from the backstop so both arms
|
|
49
|
+
* can be evaluated in order; escalate wording fires first, backstop acts.
|
|
50
|
+
*/
|
|
51
|
+
export declare function USAGE_TOKENS_ESCALATE(window?: number | null): number;
|
|
52
|
+
/**
|
|
53
|
+
* Turn-end auto-compact re-arm spacing (turns between hygiene ACTs).
|
|
54
|
+
* The ACT may fire again once this many turns have passed since the last
|
|
55
|
+
* attempt, for every arm (token, percent, backstop): the turn-based
|
|
56
|
+
* cooldown guarantees the act cannot run every turn.
|
|
57
|
+
*/
|
|
58
|
+
export declare const HYGIENE_AUTO_COMPACT_MIN_TURNS = 3;
|
|
59
|
+
/** Below this -> "low density" signal emitted -> suggest pruning. */
|
|
60
|
+
export declare const DENSITY_LOW = 0.4;
|
|
61
|
+
/** Below this -> high-priority density whisper. */
|
|
62
|
+
export declare const DENSITY_VERY_LOW = 0.25;
|
|
63
|
+
/** Above this (when token ratio also high) -> "high density" signal. */
|
|
64
|
+
export declare const DENSITY_HIGH = 0.7;
|
|
65
|
+
/** Token ratio above this -> large-context whisper fires alongside density checks. */
|
|
66
|
+
export declare const TOKEN_RATIO_LARGE_CONTEXT = 0.6;
|
|
67
|
+
/** Analytics: emit context_full event when density exceeds this (NOT usage). */
|
|
68
|
+
export declare const ANALYTICS_DENSITY_FULL_EVENT = 70;
|
|
69
|
+
/** Consecutive low-density ticks before suggesting auto-compact. */
|
|
70
|
+
export declare const HYGIENE_LOW_DENSITY_CONSECUTIVE_MIN = 2;
|
|
71
|
+
/** Cooldown between low-density whisphers (turns). */
|
|
72
|
+
export declare const HYGIENE_DENSITY_WHISPER_COOLDOWN_TURNS = 20;
|
|
73
|
+
/** Cooldown between large-context whispers (turns). */
|
|
74
|
+
export declare const HYGIENE_LARGE_CONTEXT_COOLDOWN_TURNS = 15;
|
|
75
|
+
/**
|
|
76
|
+
* Cooldown between auto-compact SUGGESTION whispers (heartbeat context-hygiene
|
|
77
|
+
* module cadence). The turn-end hygiene ACT itself spaces acts with
|
|
78
|
+
* HYGIENE_AUTO_COMPACT_MIN_TURNS across all arms.
|
|
79
|
+
*/
|
|
80
|
+
export declare const HYGIENE_AUTO_COMPACT_COOLDOWN_TURNS = 15;
|
|
81
|
+
/**
|
|
82
|
+
* Watchdog escalation injection budget per condition per session: after this many escalation injections for one
|
|
83
|
+
* condition, only a crossing of the final REWARN_MILESTONE (500) still
|
|
84
|
+
* escalates. Caps the watchdog's own contribution to context mass (the
|
|
85
|
+
* measured 143-escalation flap storm carried 33.6k chars, 5.1% of peak).
|
|
86
|
+
*/
|
|
87
|
+
export declare const WATCHDOG_ESCALATION_BUDGET_PER_SESSION = 12;
|
|
88
|
+
//# sourceMappingURL=context-thresholds.d.ts.map
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { tokenArms } from "./context-usage.js";
|
|
2
|
+
/**
|
|
3
|
+
* Context Management Thresholds - single source of truth.
|
|
4
|
+
*
|
|
5
|
+
* Separates two semantically distinct concepts:
|
|
6
|
+
* CONTEXT_USAGE - how full the token window is (% of limit filled)
|
|
7
|
+
* DENSITY - signal-to-noise ratio of content (0-1)
|
|
8
|
+
*
|
|
9
|
+
* Tune these values to adjust reminder cadence without hunting through 6+ files.
|
|
10
|
+
*/
|
|
11
|
+
// CONTEXT USAGE THRESHOLDS (% of context window filled)
|
|
12
|
+
/** First soft whisper - inspect context, start tracking. */
|
|
13
|
+
export const USAGE_WHISPER_SOFT = 30;
|
|
14
|
+
/** Advisory - suggest light pruning or archiving completed work. */
|
|
15
|
+
export const USAGE_WHISPER_ADVISORY = 50;
|
|
16
|
+
/** Warning - suggest deep compaction and compression. */
|
|
17
|
+
export const USAGE_WHISPER_WARNING = 65;
|
|
18
|
+
/** Critical - high priority, force immediate hygiene. */
|
|
19
|
+
export const USAGE_WHISPER_CRITICAL = 75;
|
|
20
|
+
/** Auto-compaction: medium level at this usage. */
|
|
21
|
+
export const USAGE_COMPACT_MEDIUM = 80;
|
|
22
|
+
/** Auto-compaction: aggressive level at this usage. */
|
|
23
|
+
export const USAGE_COMPACT_AGGRESSIVE = 90;
|
|
24
|
+
/** Reset the fired-threshold set when usage drops below this. */
|
|
25
|
+
export const USAGE_FIRED_RESET_BELOW = 50;
|
|
26
|
+
/**
|
|
27
|
+
* Compaction hard-refuse threshold: above this usage percent, destructive
|
|
28
|
+
* AI-supervised compaction is refused/redirected to deterministic slide-mode
|
|
29
|
+
* (max-call-stack crash + session-corruption guard at high usage).
|
|
30
|
+
*
|
|
31
|
+
* Single home for the 70% compaction-refusal literals: the context_compress(action="compact")
|
|
32
|
+
* refusal, the session_before_compact slide guard, the compaction
|
|
33
|
+
* summarization-aggressiveness tier, the audit branching trigger, and the
|
|
34
|
+
* context_inspect steer bands. Consumers import this constant; do not
|
|
35
|
+
* restate the number. Behavior note: it is a hard ceiling for LLM-supervised
|
|
36
|
+
* compaction, NOT an auto-compact trigger (that is USAGE_COMPACT_MEDIUM).
|
|
37
|
+
*/
|
|
38
|
+
export const CONTEXT_COMPACT_REFUSE_PERCENT = 70;
|
|
39
|
+
// TOKEN-COUNT THRESHOLDS (absolute tokens, model-agnostic early warnings)
|
|
40
|
+
// Percent arms fire too late on large or configured windows, so the token
|
|
41
|
+
// ladder is expressed as fractions of the resolved window W (the same value
|
|
42
|
+
// the live metric reports): soft 0.18W, advisory 0.30W, warning 0.45W,
|
|
43
|
+
// act min(0.60W, ACT_ARM_TOKEN_CEILING), escalate 0.85W, backstop 0.90W.
|
|
44
|
+
// The numeric table lives in lib/detection/context-usage.ts (tokenArms);
|
|
45
|
+
// these thin accessors keep the long-standing names. A configured window change
|
|
46
|
+
// is reflected without a code edit because the resolver reads settings on
|
|
47
|
+
// every call.
|
|
48
|
+
/**
|
|
49
|
+
* Turn-end ACT re-arm: the token arm that gates the hygiene act
|
|
50
|
+
* (min(0.60W, ACT_ARM_TOKEN_CEILING)).
|
|
51
|
+
*/
|
|
52
|
+
export function USAGE_TOKENS_CRITICAL(window) {
|
|
53
|
+
return tokenArms(window).act;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Turn-end auto-compact HARD BACKSTOP (0.90W): bounds runaway growth the
|
|
57
|
+
* re-arm spacing could otherwise sail past between checks.
|
|
58
|
+
*/
|
|
59
|
+
export function HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(window) {
|
|
60
|
+
return tokenArms(window).backstop;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* ADVISORY ESCALATION BAND (0.85W): distinct from the backstop so both arms
|
|
64
|
+
* can be evaluated in order; escalate wording fires first, backstop acts.
|
|
65
|
+
*/
|
|
66
|
+
export function USAGE_TOKENS_ESCALATE(window) {
|
|
67
|
+
return tokenArms(window).escalate;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Turn-end auto-compact re-arm spacing (turns between hygiene ACTs).
|
|
71
|
+
* The ACT may fire again once this many turns have passed since the last
|
|
72
|
+
* attempt, for every arm (token, percent, backstop): the turn-based
|
|
73
|
+
* cooldown guarantees the act cannot run every turn.
|
|
74
|
+
*/
|
|
75
|
+
export const HYGIENE_AUTO_COMPACT_MIN_TURNS = 3;
|
|
76
|
+
// DENSITY THRESHOLDS (signal/noise ratio, 0-1)
|
|
77
|
+
/** Below this -> "low density" signal emitted -> suggest pruning. */
|
|
78
|
+
export const DENSITY_LOW = 0.4;
|
|
79
|
+
/** Below this -> high-priority density whisper. */
|
|
80
|
+
export const DENSITY_VERY_LOW = 0.25;
|
|
81
|
+
/** Above this (when token ratio also high) -> "high density" signal. */
|
|
82
|
+
export const DENSITY_HIGH = 0.7;
|
|
83
|
+
/** Token ratio above this -> large-context whisper fires alongside density checks. */
|
|
84
|
+
export const TOKEN_RATIO_LARGE_CONTEXT = 0.6;
|
|
85
|
+
/** Analytics: emit context_full event when density exceeds this (NOT usage). */
|
|
86
|
+
export const ANALYTICS_DENSITY_FULL_EVENT = 70;
|
|
87
|
+
// CONTEXT HYGIENE MODULE CONSTANTS
|
|
88
|
+
/** Consecutive low-density ticks before suggesting auto-compact. */
|
|
89
|
+
export const HYGIENE_LOW_DENSITY_CONSECUTIVE_MIN = 2;
|
|
90
|
+
/** Cooldown between low-density whisphers (turns). */
|
|
91
|
+
export const HYGIENE_DENSITY_WHISPER_COOLDOWN_TURNS = 20;
|
|
92
|
+
/** Cooldown between large-context whispers (turns). */
|
|
93
|
+
export const HYGIENE_LARGE_CONTEXT_COOLDOWN_TURNS = 15;
|
|
94
|
+
/**
|
|
95
|
+
* Cooldown between auto-compact SUGGESTION whispers (heartbeat context-hygiene
|
|
96
|
+
* module cadence). The turn-end hygiene ACT itself spaces acts with
|
|
97
|
+
* HYGIENE_AUTO_COMPACT_MIN_TURNS across all arms.
|
|
98
|
+
*/
|
|
99
|
+
export const HYGIENE_AUTO_COMPACT_COOLDOWN_TURNS = 15;
|
|
100
|
+
/**
|
|
101
|
+
* Watchdog escalation injection budget per condition per session: after this many escalation injections for one
|
|
102
|
+
* condition, only a crossing of the final REWARN_MILESTONE (500) still
|
|
103
|
+
* escalates. Caps the watchdog's own contribution to context mass (the
|
|
104
|
+
* measured 143-escalation flap storm carried 33.6k chars, 5.1% of peak).
|
|
105
|
+
*/
|
|
106
|
+
export const WATCHDOG_ESCALATION_BUDGET_PER_SESSION = 12;
|
|
107
|
+
//# sourceMappingURL=context-thresholds.js.map
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context-usage → tier nudge resolution + duck-typed extraction.
|
|
3
|
+
*
|
|
4
|
+
* centralization (). The context-usage→tier nudge cascade
|
|
5
|
+
* (percent tiers soft/advisory/warning/critical/compact → message) and the
|
|
6
|
+
* `getContextUsage()` duck-typed extraction were duplicated across:
|
|
7
|
+
* - extensions/heartbeat/heartbeat-scheduler/policies.ts
|
|
8
|
+
* - extensions/enforcement/handlers/register-turn-end-hygiene.ts
|
|
9
|
+
* - extensions/enforcement/handlers/turn-end-handler.ts
|
|
10
|
+
* - extensions/core/prompt-builder/context-section.ts
|
|
11
|
+
* - extensions/memory/context-manager/analysis.ts
|
|
12
|
+
* - extensions/memory/context-manager/handlers/tools/context-navigate.ts
|
|
13
|
+
* - extensions/memory/context-lifecycle/helpers.ts
|
|
14
|
+
*
|
|
15
|
+
* Threshold VALUES still live in context-thresholds.ts (the existing
|
|
16
|
+
* single source of truth). This module maps a usage percent onto the
|
|
17
|
+
* tier ladder (tier labels + verbal priority per tier) and owns the ONE
|
|
18
|
+
* duck-typed getContextUsage() accessor. Each site keeps its own
|
|
19
|
+
* default/fallback semantics by applying them to the raw usage object
|
|
20
|
+
* returned here, so behavior is preserved per site.
|
|
21
|
+
*
|
|
22
|
+
* The enforcement nudge message text is byte-identical across the three
|
|
23
|
+
* enforcement cascade sites (verified in by grid-checking every
|
|
24
|
+
* site's cascade over usage/token samples), so the message text lives
|
|
25
|
+
* here in a single copy too. Sites with different copy (heartbeat
|
|
26
|
+
* policies) keep their own messages and only share the tier mapping.
|
|
27
|
+
*/
|
|
28
|
+
export type ContextUsageTier = "compact" | "critical" | "warning" | "advisory" | "soft";
|
|
29
|
+
export type ContextUsagePriority = "high" | "medium" | "low";
|
|
30
|
+
export interface ContextUsageTierInfo {
|
|
31
|
+
tier: ContextUsageTier;
|
|
32
|
+
/** Percent threshold for this tier (from context-thresholds.ts). */
|
|
33
|
+
threshold: number;
|
|
34
|
+
/** Verbal priority used by nudge copy (heartbeat policies ladder). */
|
|
35
|
+
priority: ContextUsagePriority;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Tier ladder, highest first: compact(80) → critical(75) → warning(65)
|
|
39
|
+
* → advisory(50) → soft(30). Thresholds come from context-thresholds.ts.
|
|
40
|
+
*/
|
|
41
|
+
export declare const CONTEXT_USAGE_TIERS: readonly ContextUsageTierInfo[];
|
|
42
|
+
/**
|
|
43
|
+
* The highest tier reached by the given usage percent, or null when below
|
|
44
|
+
* soft. Equates to the enforcement cascades' if/else-if order
|
|
45
|
+
* (compact → critical → warning → advisory → soft).
|
|
46
|
+
*/
|
|
47
|
+
export declare function contextUsageTier(usagePercent: number): ContextUsageTierInfo | null;
|
|
48
|
+
/** Percent-tier nudge message text (identical at every enforcement site). */
|
|
49
|
+
export declare function contextUsageTierMessage(tier: ContextUsageTier, usagePercent: number): string;
|
|
50
|
+
/**
|
|
51
|
+
* Token-tier nudge message text (identical at every enforcement site).
|
|
52
|
+
* `level` mirrors the tier reached by the token-count check; arms are
|
|
53
|
+
* fractions of the resolved window (0.45W warning, 0.18W soft).
|
|
54
|
+
*/
|
|
55
|
+
export declare function contextUsageTokenMessage(level: "warning" | "soft", usagePercent: number, usageTokens: number): string;
|
|
56
|
+
/**
|
|
57
|
+
* Combined enforcement cascade: token tiers first (0.45W/0.18W — fire earlier
|
|
58
|
+
* for large context windows), then the percent tiers (30/50/65/75/80).
|
|
59
|
+
* Returns null when no tier is reached.
|
|
60
|
+
*/
|
|
61
|
+
export declare function contextUsageNudgeMessage(usagePercent: number, usageTokens: number, window?: number | null): string | null;
|
|
62
|
+
/** The duck-typed usage shape current sites read. percent may be null (no data). */
|
|
63
|
+
export interface ContextUsageLike {
|
|
64
|
+
percent?: number | null;
|
|
65
|
+
tokens?: number;
|
|
66
|
+
contextWindow?: number;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* ONE duck-typed `getContextUsage()` extraction. Mirrors the fallbacks
|
|
70
|
+
* used by every current site: a missing ctx, a non-function accessor, or
|
|
71
|
+
* an accessor that throws all yield undefined. Each caller applies its own
|
|
72
|
+
* defaulting (percent ?? 0, contextWindow ?? 200000, etc.), exactly as the
|
|
73
|
+
* inline sites did — nothing is flattened away here. The one normalization
|
|
74
|
+
* applied here: the reported `contextWindow` is the effective window
|
|
75
|
+
* from the single contextLimitTokens resolver — braid.context.contextLimitTokens
|
|
76
|
+
* overrides the accessor's provider-truth window, and `percent` is recomputed
|
|
77
|
+
* against it when `tokens` is known so the two stay consistent.
|
|
78
|
+
*/
|
|
79
|
+
export declare function getContextUsage(ctx: unknown): ContextUsageLike | undefined;
|
|
80
|
+
//# sourceMappingURL=context-tiers.d.ts.map
|