pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-result-formatting — Structured Output Catalyst (MI-3)
|
|
3
|
+
*
|
|
4
|
+
* Wraps tool outputs for read/grep/find/ls in a consistent structured format
|
|
5
|
+
* to improve transformer processing. Uses the tool_result event's middleware
|
|
6
|
+
* chaining to modify content before delivery to the agent.
|
|
7
|
+
*
|
|
8
|
+
* Research backing: MDA (2601.21996) — repetitive structural data catalyzes
|
|
9
|
+
* induction head formation in transformer models.
|
|
10
|
+
*
|
|
11
|
+
* Opt-in: Set structuredToolOutput=true in pi settings.json to enable
|
|
12
|
+
* (read through pi.getSettings(); the key is braid-owned and not part of
|
|
13
|
+
* pi's typed settings schema). Disabled by default to preserve existing
|
|
14
|
+
* behavior.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
18
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
19
|
+
import { formatToolResult, TOOLS_TO_FORMAT } from "../../../lib/utils/format-tool-result.js";
|
|
20
|
+
|
|
21
|
+
type PermissiveAPI = ExtensionAPI & { on(event: string, handler: (...args: any[]) => any): void };
|
|
22
|
+
|
|
23
|
+
const log = createLogger("enforcement:tool-result-formatting");
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Braid-owned opt-in flag in pi's settings.json. pi's `Settings` schema does
|
|
27
|
+
* not declare it, so it is read through a narrowed view of the object
|
|
28
|
+
* `pi.getSettings()` returns; pi preserves unknown top-level keys across its
|
|
29
|
+
* own writes, and a file without the key keeps the feature off.
|
|
30
|
+
*/
|
|
31
|
+
interface FormattingSettings {
|
|
32
|
+
structuredToolOutput?: boolean;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Check if structured output formatting is enabled for this session.
|
|
37
|
+
* Reads the effective settings through the extension API accessor.
|
|
38
|
+
*/
|
|
39
|
+
function isFormattingEnabled(pi: ExtensionAPI): boolean {
|
|
40
|
+
try {
|
|
41
|
+
const settings = pi.getSettings() as FormattingSettings;
|
|
42
|
+
return settings?.structuredToolOutput === true;
|
|
43
|
+
} catch {
|
|
44
|
+
return false;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
export function registerToolResultFormatting(pi: ExtensionAPI): void {
|
|
49
|
+
(pi as PermissiveAPI).on("tool_result", async (event: any) => {
|
|
50
|
+
// Only format the tools we care about
|
|
51
|
+
const toolName = event?.toolName || "";
|
|
52
|
+
if (!TOOLS_TO_FORMAT.has(toolName)) return;
|
|
53
|
+
|
|
54
|
+
// Opt-in gate
|
|
55
|
+
if (!isFormattingEnabled(pi)) return;
|
|
56
|
+
|
|
57
|
+
if (!event.content || !Array.isArray(event.content) || event.content.length === 0) {
|
|
58
|
+
return;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
try {
|
|
62
|
+
const formatted = formatToolResult(toolName, event.content, !!event.isError);
|
|
63
|
+
log.debug(
|
|
64
|
+
`Formatted ${toolName} output (${event.content.length} blocks → ${formatted.length} blocks)`,
|
|
65
|
+
);
|
|
66
|
+
return { content: formatted };
|
|
67
|
+
} catch (err) {
|
|
68
|
+
log.error(`Failed to format tool result for ${toolName}: ${err}`);
|
|
69
|
+
// Don't block the tool result — return undefined to passthrough
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-result - Calibration tracking on tool results.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
6
|
+
import { addEvidence } from "../../../lib/store/evidence-pool.js";
|
|
7
|
+
import { emitSignal } from "../../../lib/reasoning/belief-policy-engine.js";
|
|
8
|
+
import { eventBus } from "../../../lib/events/event-bus.js";
|
|
9
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
10
|
+
import { getState, ERROR_BURST_THRESHOLD } from "../state.js";
|
|
11
|
+
import { noteToolOutcomeForBurst } from "../../../lib/detection/test-burst.js";
|
|
12
|
+
|
|
13
|
+
/** Flatten a tool_result content array to one bounded text snippet. */
|
|
14
|
+
function contentSnippet(content: unknown): string | undefined {
|
|
15
|
+
if (!Array.isArray(content)) return undefined;
|
|
16
|
+
for (const part of content) {
|
|
17
|
+
if (part && typeof part === "object" && (part as { type?: string }).type === "text") {
|
|
18
|
+
const text = (part as { text?: string }).text;
|
|
19
|
+
if (typeof text === "string" && text.length > 0) return text;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
return undefined;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export function registerToolResultHandler(pi: ExtensionAPI): void {
|
|
26
|
+
pi.on("tool_result", async (event: any, ctx: ExtensionContext) => {
|
|
27
|
+
const toolName = event?.toolName || "";
|
|
28
|
+
// Test-burst feed: record EVERY tool outcome (success + error) in the
|
|
29
|
+
// rollback-guard ring BEFORE any gate — the burst window must see the
|
|
30
|
+
// full stream to distinguish a failing-test loop from real degradation.
|
|
31
|
+
const isError = Boolean(event?.isError);
|
|
32
|
+
noteToolOutcomeForBurst(ctx, toolName, isError, {
|
|
33
|
+
command:
|
|
34
|
+
typeof event?.input?.command === "string"
|
|
35
|
+
? event.input.command
|
|
36
|
+
: typeof event?.input?.command === "object"
|
|
37
|
+
? JSON.stringify(event.input.command)
|
|
38
|
+
: undefined,
|
|
39
|
+
output: contentSnippet(event?.content),
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
if (!getState(ctx).enforcementActive) return;
|
|
43
|
+
const isBurst = getState(ctx).consecutiveErrorTurns >= ERROR_BURST_THRESHOLD;
|
|
44
|
+
if (!toolName || !toolName.trim()) return;
|
|
45
|
+
if (toolName === "think") return;
|
|
46
|
+
|
|
47
|
+
const predicted = getState(ctx).lastThinkConfidence;
|
|
48
|
+
if (predicted === null) return;
|
|
49
|
+
|
|
50
|
+
const actual = event?.isError ? 0 : 1;
|
|
51
|
+
getState(ctx).calibrationPairs.push({
|
|
52
|
+
predicted,
|
|
53
|
+
actual,
|
|
54
|
+
tool: toolName,
|
|
55
|
+
turn: getState(ctx).currentTurn,
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
if (getState(ctx).calibrationPairs.length > 50) {
|
|
59
|
+
getState(ctx).calibrationPairs = getState(ctx).calibrationPairs.slice(-50);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
addEvidence(
|
|
63
|
+
ctx,
|
|
64
|
+
`Tool ${toolName} ${event?.isError ? "failed" : "succeeded"}`,
|
|
65
|
+
"session",
|
|
66
|
+
`${toolName}: ${event?.isError ? "failure" : "success"} (confidence: ${predicted.toFixed(2)})`,
|
|
67
|
+
predicted,
|
|
68
|
+
);
|
|
69
|
+
|
|
70
|
+
if (event?.isError) {
|
|
71
|
+
// The event carries no error message field; the failure text is the
|
|
72
|
+
// result content (agent-session builds `content`, not `error`).
|
|
73
|
+
eventBus.emit({
|
|
74
|
+
type: "tool_error",
|
|
75
|
+
toolName,
|
|
76
|
+
error: (contentSnippet(event?.content) ?? `Tool ${toolName} failed`).slice(0, 500),
|
|
77
|
+
turn: getState(ctx).currentTurn,
|
|
78
|
+
timestamp: Date.now(),
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
const error_abs = Math.abs(predicted - actual);
|
|
83
|
+
if (!isBurst && getState(ctx).calibrationPairs.length >= 10 && error_abs > 0.4) {
|
|
84
|
+
const recent = getState(ctx).calibrationPairs.slice(-10);
|
|
85
|
+
const avgError =
|
|
86
|
+
recent.reduce((s, p) => s + Math.abs(p.predicted - p.actual), 0) / recent.length;
|
|
87
|
+
if (avgError > 0.5) {
|
|
88
|
+
const enState = getState(ctx);
|
|
89
|
+
const now = Date.now();
|
|
90
|
+
if (now - enState.lastCalibrationWhisperTime < 120_000) return;
|
|
91
|
+
enState.lastCalibrationWhisperTime = now;
|
|
92
|
+
|
|
93
|
+
emitSignal(ctx, "calibration", "high-error", "warn", false, {
|
|
94
|
+
error: avgError,
|
|
95
|
+
tool: toolName,
|
|
96
|
+
pairCount: getState(ctx).calibrationPairs.length,
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
sendEnforcementWhisper(
|
|
100
|
+
pi,
|
|
101
|
+
ctx,
|
|
102
|
+
`[calibration] High prediction error: ${(error_abs * 100).toFixed(0)}% off on last ${toolName}. ` +
|
|
103
|
+
`Avg error last 10 tools: ${(avgError * 100).toFixed(0)}%`,
|
|
104
|
+
);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
});
|
|
108
|
+
}
|
|
@@ -0,0 +1,456 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-turn-end-hygiene - Context hygiene on every turn_end.
|
|
3
|
+
*
|
|
4
|
+
* Fires on EVERY turn_end (not just when tools were called):
|
|
5
|
+
* 1. Checks context usage -- if high, emit hygiene whispers
|
|
6
|
+
* 2. Arms the hygiene act at token arms of the resolved window (act at
|
|
7
|
+
* min(0.60W, 130k), hard backstop at 0.90W) with a pre-save safety net (flush
|
|
8
|
+
* scratchpad + write resume.json) to guarantee zero data loss.
|
|
9
|
+
*
|
|
10
|
+
* Safety gates, checked in order:
|
|
11
|
+
* - Loop-done gate: the act never fires on a turn_end whose assistant
|
|
12
|
+
* stopReason is "toolUse" -- the agent loop is live (the next model
|
|
13
|
+
* call is pending) and ctx.compact() aborts it mid-run (manual
|
|
14
|
+
* compaction never retries or continues the interrupted turn). The
|
|
15
|
+
* only exception is the 0.90W backstop, which deliberately stops a
|
|
16
|
+
* runaway loop before overflow.
|
|
17
|
+
* - Mode awareness: the DETERMINISTIC slide path carries none of the
|
|
18
|
+
* abort/corruption risk that justifies standing down, so it fires at
|
|
19
|
+
* the act arm regardless of pi's compaction.enabled. Only the LLM
|
|
20
|
+
* summarize path is mode-gated: with pi's compaction.enabled (re-read
|
|
21
|
+
* per act decision from the merged settings), native compaction owns
|
|
22
|
+
* LLM compaction and the act stands down to nudge-only.
|
|
23
|
+
*
|
|
24
|
+
* ctx.compact() calls this._disconnectFromAgent() + this.abort() in pi-core
|
|
25
|
+
* (agent-session.js:1245). To keep the handler's synchronous part off the
|
|
26
|
+
* abort path, the compact call is deferred via setTimeout(0). Resume after
|
|
27
|
+
* the compaction is register-session-compact's decision, not ours.
|
|
28
|
+
*
|
|
29
|
+
* Discoverability (scratchpad/memory/episodes surfacing) fires from
|
|
30
|
+
* SESSION_START (register-session-start-discoverability.ts), before the
|
|
31
|
+
* first turn.
|
|
32
|
+
*/
|
|
33
|
+
|
|
34
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
35
|
+
import { SettingsManager, getAgentDir } from "@earendil-works/pi-coding-agent";
|
|
36
|
+
import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
|
|
37
|
+
import * as path from "node:path";
|
|
38
|
+
import { execSync } from "node:child_process";
|
|
39
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
40
|
+
import { registerTurnEndHandler } from "../../../lib/events/turn-end-coordinator.js";
|
|
41
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
42
|
+
import { getState } from "../state.js";
|
|
43
|
+
import { fileMutationQueue } from "../../../lib/utils/file-mutation-queue.js";
|
|
44
|
+
import { braidDir, scratchpadDir } from "../../../lib/config/braid-paths.js";
|
|
45
|
+
import { projectSlugFromCwd } from "../../memory/scratchpad/persistence.js";
|
|
46
|
+
import { flushPendingScratchpadWrites } from "../../memory/scratchpad/utils.js";
|
|
47
|
+
import { isCompactionActive, getCmState } from "../../memory/context-manager/handlers/shared.js";
|
|
48
|
+
import { snapBoundaryOutsideToolBatch } from "../../memory/context-manager/handlers/tool-batch-boundary.js";
|
|
49
|
+
import {
|
|
50
|
+
USAGE_COMPACT_AGGRESSIVE,
|
|
51
|
+
USAGE_FIRED_RESET_BELOW,
|
|
52
|
+
HYGIENE_AUTO_COMPACT_MIN_TURNS,
|
|
53
|
+
} from "../../../lib/detection/context-thresholds.js";
|
|
54
|
+
import { contextUsageNudgeMessage } from "../../../lib/detection/context-tiers.js";
|
|
55
|
+
import {
|
|
56
|
+
measureLiveUsage,
|
|
57
|
+
tokenArms,
|
|
58
|
+
formatTokensK,
|
|
59
|
+
} from "../../../lib/detection/context-usage.js";
|
|
60
|
+
import {
|
|
61
|
+
recordCompaction,
|
|
62
|
+
recordHygieneAct,
|
|
63
|
+
recordHygieneSkip,
|
|
64
|
+
recordLiveUsageSample,
|
|
65
|
+
type HygieneActTrigger,
|
|
66
|
+
type HygieneActKind,
|
|
67
|
+
} from "../substate/context-hygiene-state.js";
|
|
68
|
+
|
|
69
|
+
const log = createLogger("enforcement:turn-end-hygiene");
|
|
70
|
+
|
|
71
|
+
// Pre-save safety: flush scratchpad + write resume.json
|
|
72
|
+
|
|
73
|
+
function saveStateBeforeCompact(cwd: string, ctx: ExtensionContext): void {
|
|
74
|
+
try {
|
|
75
|
+
// 1. Flush file mutation queue + scratchpad debounced queue
|
|
76
|
+
// Pre-compaction flush is best-effort: a failed flush loses only the
|
|
77
|
+
// newest queued writes; blocking compaction would lose far more.
|
|
78
|
+
fileMutationQueue.flushAll().catch(() => {});
|
|
79
|
+
flushPendingScratchpadWrites().catch(() => {});
|
|
80
|
+
} catch {
|
|
81
|
+
// flush APIs themselves failed — compaction must still proceed
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
try {
|
|
85
|
+
// 2. Write resume.json: the same sink and the same discoverability reader
|
|
86
|
+
// as the SESSION_SHUTDOWN payload, with two key differences - this one
|
|
87
|
+
// adds `reason` (why the pre-save fired) and omits `recentLearnings` (the
|
|
88
|
+
// shutdown writer takes those from the scratchpad's learnings section).
|
|
89
|
+
// No reader consumes either key; the fields both writers carry are the
|
|
90
|
+
// ones the reader reads back.
|
|
91
|
+
const slug = projectSlugFromCwd(cwd);
|
|
92
|
+
let goal: string | null = null;
|
|
93
|
+
let openPlans: Array<{ id: string; text: string }> = [];
|
|
94
|
+
let recentDecisions: Array<{ id: string; text: string }> = [];
|
|
95
|
+
// Prior state is a READ: the scratchpad root is resolved on every call, so
|
|
96
|
+
// a pinned run reads the tree the scratchpad writer wrote to, and a
|
|
97
|
+
// segment rename in the accessor moves this reader with the writer. A
|
|
98
|
+
// refused root (no absolute braid home) or a corrupt section degrades to
|
|
99
|
+
// no prior-state section instead of failing the resume write below.
|
|
100
|
+
try {
|
|
101
|
+
const scratchpadFile = path.join(scratchpadDir(), slug, "latest.json");
|
|
102
|
+
if (existsSync(scratchpadFile)) {
|
|
103
|
+
const content = readFileSync(scratchpadFile, "utf-8");
|
|
104
|
+
const parsed = JSON.parse(content);
|
|
105
|
+
goal = parsed.goal ?? null;
|
|
106
|
+
openPlans = (Array.isArray(parsed.plans) ? parsed.plans : [])
|
|
107
|
+
.filter((p: any) => !p.done)
|
|
108
|
+
.slice(0, 10)
|
|
109
|
+
.map((p: any) => ({ id: p.id ?? "", text: p.text ?? "" }));
|
|
110
|
+
recentDecisions = (Array.isArray(parsed.decisions) ? parsed.decisions : [])
|
|
111
|
+
.slice(-5)
|
|
112
|
+
.map((d: any) => ({ id: d.id ?? "", text: d.text ?? d.content ?? "" }));
|
|
113
|
+
}
|
|
114
|
+
} catch (err) {
|
|
115
|
+
log.debug(`scratchpad prior-state read failed: ${err}`);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
let uncommittedFiles: string[] = [];
|
|
119
|
+
try {
|
|
120
|
+
// Scope to the project dir only. When ctx.cwd is missing, `cwd` is "" and
|
|
121
|
+
// git would otherwise run in the daemon's process.cwd() and record an
|
|
122
|
+
// unrelated project's dirty files.
|
|
123
|
+
if (cwd && existsSync(cwd)) {
|
|
124
|
+
const status = execSync("git status --porcelain", {
|
|
125
|
+
cwd,
|
|
126
|
+
encoding: "utf-8",
|
|
127
|
+
timeout: 5000,
|
|
128
|
+
stdio: ["pipe", "pipe", "pipe"],
|
|
129
|
+
});
|
|
130
|
+
uncommittedFiles = status
|
|
131
|
+
.split("\n")
|
|
132
|
+
.filter((l) => l.trim())
|
|
133
|
+
.map((l) => l.slice(3));
|
|
134
|
+
}
|
|
135
|
+
} catch {
|
|
136
|
+
// not a git repo
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
const state = getState(ctx);
|
|
140
|
+
const resumption = {
|
|
141
|
+
writtenAt: new Date().toISOString(),
|
|
142
|
+
cwd,
|
|
143
|
+
goal,
|
|
144
|
+
openPlans,
|
|
145
|
+
recentDecisions,
|
|
146
|
+
uncommittedFiles,
|
|
147
|
+
toolCallCount: state?.totalToolCalls ?? 0,
|
|
148
|
+
verificationCount: state?.verificationsDone ?? 0,
|
|
149
|
+
reason: "turn-end auto-compact pre-save",
|
|
150
|
+
};
|
|
151
|
+
|
|
152
|
+
const sessionsDir = path.join(braidDir(), "sessions", slug);
|
|
153
|
+
if (!existsSync(sessionsDir)) {
|
|
154
|
+
mkdirSync(sessionsDir, { recursive: true });
|
|
155
|
+
}
|
|
156
|
+
const resumeFile = path.join(sessionsDir, "resume.json");
|
|
157
|
+
writeFileSync(resumeFile, JSON.stringify(resumption, null, 2), "utf-8");
|
|
158
|
+
} catch {
|
|
159
|
+
// resume.json is a convenience: next session_start rebuilds resumption
|
|
160
|
+
// from live session state, so a failed write costs nothing durable.
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/**
|
|
165
|
+
* Recent-entries window kept by the deterministic slide the ACT arms.
|
|
166
|
+
* Matches the slide tool's default keep window in size class (the tool
|
|
167
|
+
* defaults to 50; the ACT keeps 40 so each act reclaims a comparable span).
|
|
168
|
+
*/
|
|
169
|
+
const ACT_SLIDE_KEEP_ENTRIES = 40;
|
|
170
|
+
|
|
171
|
+
/** The customInstructions marker the slide tool's compaction path consumes. */
|
|
172
|
+
const SLIDE_MODE_MARKER = "SLIDE_MODE:true";
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Read compaction.enabled the way pi resolves it (global settings merged
|
|
176
|
+
* with the project's .pi/settings.json), freshly per act decision -- never
|
|
177
|
+
* cached at registration. Defaults to true on any read failure, mirroring
|
|
178
|
+
* pi's own default (settings.compaction?.enabled ?? true): when the mode is
|
|
179
|
+
* unknown, native compaction is assumed to own the loop and the act stands
|
|
180
|
+
* down to nudge-only.
|
|
181
|
+
*/
|
|
182
|
+
function compactionEnabledPerCheck(ctx: ExtensionContext): boolean {
|
|
183
|
+
try {
|
|
184
|
+
const cwd = (ctx as { cwd?: string }).cwd || process.cwd();
|
|
185
|
+
return SettingsManager.create(cwd, getAgentDir()).getCompactionEnabled();
|
|
186
|
+
} catch {
|
|
187
|
+
return true;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
function checkContextUsage(pi: ExtensionAPI, ctx: ExtensionContext, event: any): void {
|
|
192
|
+
const state = getState(ctx);
|
|
193
|
+
if (!state?.enforcementActive) return;
|
|
194
|
+
|
|
195
|
+
const currentTurn =
|
|
196
|
+
typeof (event as any)?.turnIndex === "number"
|
|
197
|
+
? (event as any).turnIndex
|
|
198
|
+
: state.lastContextCheckTurn + 1;
|
|
199
|
+
|
|
200
|
+
// The live working set measured from the session tree (compaction-aware).
|
|
201
|
+
// turn_end carries no usage accessor (its `context` is a boundary preview,
|
|
202
|
+
// not an ExtensionContext), so this is the only source; when it yields no
|
|
203
|
+
// number the skip below records that rather than acting on a fabricated 0.
|
|
204
|
+
let usagePercent = 0;
|
|
205
|
+
let usageTokens = 0;
|
|
206
|
+
let usageWindow: number | undefined;
|
|
207
|
+
try {
|
|
208
|
+
const live = measureLiveUsage(ctx);
|
|
209
|
+
if (live) {
|
|
210
|
+
usagePercent = live.percent;
|
|
211
|
+
usageTokens = live.tokens;
|
|
212
|
+
usageWindow = live.contextWindow;
|
|
213
|
+
}
|
|
214
|
+
} catch {
|
|
215
|
+
/* live measurement unavailable - the skip below records it */
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
if (usagePercent <= 0 && usageTokens <= 0) {
|
|
219
|
+
// No usable number from either source: record the skip. Never act on a
|
|
220
|
+
// fabricated zero (a zero would read as "plenty of room").
|
|
221
|
+
recordHygieneSkip(state);
|
|
222
|
+
return;
|
|
223
|
+
}
|
|
224
|
+
// The previous usable turn's live sample (the soft tier's crossing
|
|
225
|
+
// witness), captured before this turn's sample replaces it.
|
|
226
|
+
const prevLiveTokens = state.liveUsageSamples[state.liveUsageSamples.length - 1];
|
|
227
|
+
recordLiveUsageSample(state, usageTokens);
|
|
228
|
+
|
|
229
|
+
// Re-arm the shared context-nudge latch when usage has dropped (e.g.,
|
|
230
|
+
// after compaction). The bar is the named policy value, not a literal.
|
|
231
|
+
// It governs the higher tiers only; the soft tier re-arms on its own arm
|
|
232
|
+
// crossing, gated at the cascade below.
|
|
233
|
+
if (state.contextNudgeSent && usagePercent < USAGE_FIRED_RESET_BELOW) {
|
|
234
|
+
state.contextNudgeSent = false;
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
// Auto-compact arms (fractions of the resolved window W)
|
|
238
|
+
// act (min(0.60W, 130k)) re-arms after HYGIENE_AUTO_COMPACT_MIN_TURNS turns; the
|
|
239
|
+
// percent arm (90%) keeps the same spacing; backstop (0.90W) bounds
|
|
240
|
+
// runaway growth and is subject to the same cooldown, so the act can
|
|
241
|
+
// never run every turn.
|
|
242
|
+
const turnSinceLastCompact = currentTurn - (state.lastCompactionTurn ?? -100);
|
|
243
|
+
const arms = tokenArms(usageWindow);
|
|
244
|
+
const atTokenReArm =
|
|
245
|
+
usageTokens >= arms.act && turnSinceLastCompact >= HYGIENE_AUTO_COMPACT_MIN_TURNS;
|
|
246
|
+
const atPercentThreshold =
|
|
247
|
+
usagePercent >= USAGE_COMPACT_AGGRESSIVE &&
|
|
248
|
+
turnSinceLastCompact >= HYGIENE_AUTO_COMPACT_MIN_TURNS;
|
|
249
|
+
const atHardBackstop = usageTokens >= arms.backstop;
|
|
250
|
+
|
|
251
|
+
if (atHardBackstop || atTokenReArm || atPercentThreshold) {
|
|
252
|
+
// Invariant: never act while a compaction is in progress, and keep the
|
|
253
|
+
// turn-based cooldown between acts.
|
|
254
|
+
if (turnSinceLastCompact < HYGIENE_AUTO_COMPACT_MIN_TURNS || isCompactionActive(ctx)) {
|
|
255
|
+
recordHygieneSkip(state);
|
|
256
|
+
return;
|
|
257
|
+
}
|
|
258
|
+
// Loop-done gate: "toolUse" means the agent loop is live -- the next
|
|
259
|
+
// model call is queued inside the running agent operation, and
|
|
260
|
+
// ctx.compact() aborts it (manual compaction never retries or continues
|
|
261
|
+
// the interrupted turn). Act only on a loop-done stop; the 0.90W
|
|
262
|
+
// backstop below still acts mid-loop to stop a runaway loop before
|
|
263
|
+
// overflow (its purpose).
|
|
264
|
+
const loopDone = (event as any)?.message?.stopReason !== "toolUse";
|
|
265
|
+
if (!loopDone && !atHardBackstop) {
|
|
266
|
+
recordHygieneSkip(state);
|
|
267
|
+
return;
|
|
268
|
+
}
|
|
269
|
+
// Path resolution BEFORE the mode gate: the deterministic slide is not
|
|
270
|
+
// LLM compaction and carries none of the abort/corruption risk that
|
|
271
|
+
// justifies the nudge-only downgrade, so it fires regardless of
|
|
272
|
+
// compaction.enabled. Only the summarize path is mode-gated: with pi's
|
|
273
|
+
// compaction.enabled (re-read per act decision) native compaction owns
|
|
274
|
+
// the loop and the act stands down to nudge-only.
|
|
275
|
+
const plan = resolveHygieneActPlan(ctx);
|
|
276
|
+
const compactionEnabled = compactionEnabledPerCheck(ctx);
|
|
277
|
+
if (compactionEnabled && plan.kind !== "slide") {
|
|
278
|
+
log.debug(
|
|
279
|
+
`turn-end-hygiene: act arm reached (${Math.round(usagePercent)}%, ` +
|
|
280
|
+
`${formatTokensK(usageTokens)}) but pi compaction.enabled=true and the act ` +
|
|
281
|
+
`path is LLM summarize -- native compaction owns the loop; nudging only`,
|
|
282
|
+
);
|
|
283
|
+
} else {
|
|
284
|
+
const trigger: HygieneActTrigger = atHardBackstop
|
|
285
|
+
? "backstop"
|
|
286
|
+
: atTokenReArm
|
|
287
|
+
? "token"
|
|
288
|
+
: "percent";
|
|
289
|
+
state.contextNudgeSent = true;
|
|
290
|
+
|
|
291
|
+
// Pre-save safety net before compaction
|
|
292
|
+
saveStateBeforeCompact((ctx as { cwd?: string }).cwd ?? "", ctx);
|
|
293
|
+
|
|
294
|
+
const kind = armHygieneAct(ctx, trigger, plan);
|
|
295
|
+
if (!kind) {
|
|
296
|
+
// The deterministic state could not be armed: stand down instead of
|
|
297
|
+
// compacting on an unintended path. The next turn re-evaluates.
|
|
298
|
+
log.debug("turn-end-hygiene: slide arming failed -- act stood down this turn");
|
|
299
|
+
return;
|
|
300
|
+
}
|
|
301
|
+
recordCompaction(state, currentTurn);
|
|
302
|
+
state.lastCompactionTurn = currentTurn;
|
|
303
|
+
|
|
304
|
+
// Status notice for an action already taken: park (no forced turn).
|
|
305
|
+
sendEnforcementWhisper(
|
|
306
|
+
pi,
|
|
307
|
+
ctx,
|
|
308
|
+
`Auto-compacting: context at ${Math.round(usagePercent)}% ` +
|
|
309
|
+
`(${formatTokensK(usageTokens)} tokens). State saved.`,
|
|
310
|
+
false,
|
|
311
|
+
{ delivery: "park" },
|
|
312
|
+
);
|
|
313
|
+
return;
|
|
314
|
+
}
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
if (state.contextNudgeSent) return;
|
|
318
|
+
|
|
319
|
+
// Progressive nudge: token tiers first, then percent tiers. Cascade shared
|
|
320
|
+
// from lib/detection/context-tiers.ts (contextUsageNudgeMessage):
|
|
321
|
+
// token arms 0.45W/0.18W fire earlier for large windows, then percent tiers
|
|
322
|
+
// soft (30%) -> advisory (50%) -> warning (65%) -> critical (75%) ->
|
|
323
|
+
// compact (80%).
|
|
324
|
+
const nudgeMessage = contextUsageNudgeMessage(usagePercent, usageTokens, usageWindow);
|
|
325
|
+
if (nudgeMessage) {
|
|
326
|
+
// Soft-tier crossing gate: the cascade's sub-warning level is the soft
|
|
327
|
+
// token text (the percent tiers are shadowed by the token arms, which
|
|
328
|
+
// fire first). It fires on the turn its arm is crossed from below, not
|
|
329
|
+
// on every turn inside the band. The shared latch above re-arms below
|
|
330
|
+
// USAGE_FIRED_RESET_BELOW, a bar above the soft arm, so without this
|
|
331
|
+
// gate the same whisper re-injected every turn from the soft arm up to
|
|
332
|
+
// the reset bar. The higher tiers keep the shared latch untouched.
|
|
333
|
+
if (usageTokens < arms.warning) {
|
|
334
|
+
const crossedSoftArm = prevLiveTokens === undefined || prevLiveTokens < arms.soft;
|
|
335
|
+
if (!crossedSoftArm) return;
|
|
336
|
+
}
|
|
337
|
+
state.contextNudgeSent = true;
|
|
338
|
+
sendEnforcementWhisper(pi, ctx, nudgeMessage);
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
/**
|
|
343
|
+
* The act's decided path from ONE branch snapshot: decide and arm from the
|
|
344
|
+
* same read so the branch cannot change between the two.
|
|
345
|
+
*/
|
|
346
|
+
interface HygieneActPlan {
|
|
347
|
+
kind: HygieneActKind;
|
|
348
|
+
/** Entries before the slide cut (0 on the summarize path). */
|
|
349
|
+
droppedEntries: number;
|
|
350
|
+
/** Branch id of the first kept entry (slide path only). */
|
|
351
|
+
cutEntryId?: string;
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
/**
|
|
355
|
+
* Resolve the act path from the live branch: the deterministic slide when
|
|
356
|
+
* the droppable range holds no owner/user turns (a silent cut would lose
|
|
357
|
+
* the conversation), otherwise the LLM summarize path.
|
|
358
|
+
*/
|
|
359
|
+
function resolveHygieneActPlan(ctx: ExtensionContext): HygieneActPlan {
|
|
360
|
+
try {
|
|
361
|
+
const branch =
|
|
362
|
+
(
|
|
363
|
+
ctx as {
|
|
364
|
+
sessionManager?: {
|
|
365
|
+
getBranch?: () => Array<{ id: string; type?: string; message?: { role?: string } }>;
|
|
366
|
+
};
|
|
367
|
+
}
|
|
368
|
+
).sessionManager?.getBranch?.() ?? [];
|
|
369
|
+
// The act arms a supplied compaction boundary: snap it out of any tool
|
|
370
|
+
// batch it lands in (HTTP 400: a kept slice that opens with a tool result
|
|
371
|
+
// has no preceding tool_calls).
|
|
372
|
+
const cutIndex = snapBoundaryOutsideToolBatch(
|
|
373
|
+
branch,
|
|
374
|
+
Math.max(0, branch.length - ACT_SLIDE_KEEP_ENTRIES),
|
|
375
|
+
);
|
|
376
|
+
const droppable = branch.slice(0, cutIndex);
|
|
377
|
+
const holdsUserTurns = droppable.some(
|
|
378
|
+
(e) => e?.type === "message" && e.message?.role === "user",
|
|
379
|
+
);
|
|
380
|
+
if (cutIndex > 0 && !holdsUserTurns) {
|
|
381
|
+
return { kind: "slide", droppedEntries: cutIndex, cutEntryId: branch[cutIndex]?.id };
|
|
382
|
+
}
|
|
383
|
+
return { kind: "summarize", droppedEntries: cutIndex };
|
|
384
|
+
} catch {
|
|
385
|
+
// Tree unavailable: summarize path without a dropped-count.
|
|
386
|
+
return { kind: "summarize", droppedEntries: 0 };
|
|
387
|
+
}
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
* Arm and schedule the decided act path. The act NEVER submits, injects or
|
|
392
|
+
* re-arms a prompt or turn: ctx.compact() runs after the handler returns and
|
|
393
|
+
* pi resumes through its own compaction flow.
|
|
394
|
+
*
|
|
395
|
+
* The slide path arms the slide state in the context-manager store the
|
|
396
|
+
* session_before_compact handler consumes (the SLIDE_MODE marker branch);
|
|
397
|
+
* that arming is the contract, so a failed arming stands the act down (the
|
|
398
|
+
* caller skips compact + whisper) instead of silently switching to the LLM
|
|
399
|
+
* path the mode gate may have just rejected. Returns the act kind, or null
|
|
400
|
+
* when the act stood down.
|
|
401
|
+
*/
|
|
402
|
+
function armHygieneAct(
|
|
403
|
+
ctx: ExtensionContext,
|
|
404
|
+
trigger: HygieneActTrigger,
|
|
405
|
+
plan: HygieneActPlan,
|
|
406
|
+
): HygieneActKind | null {
|
|
407
|
+
if (plan.kind === "slide") {
|
|
408
|
+
if (!plan.cutEntryId) return null;
|
|
409
|
+
try {
|
|
410
|
+
getCmState(ctx).slideMode = {
|
|
411
|
+
active: true,
|
|
412
|
+
cutEntryId: plan.cutEntryId,
|
|
413
|
+
keepCount: ACT_SLIDE_KEEP_ENTRIES,
|
|
414
|
+
droppedCount: plan.droppedEntries,
|
|
415
|
+
timestamp: Date.now(),
|
|
416
|
+
};
|
|
417
|
+
} catch {
|
|
418
|
+
return null;
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
recordHygieneAct(getState(ctx), trigger, plan.kind, plan.droppedEntries);
|
|
423
|
+
|
|
424
|
+
// Defer ctx.compact() to after the handler returns (register-session-compact
|
|
425
|
+
// owns what happens after the compaction). customInstructions carries
|
|
426
|
+
// SLIDE_MODE for the slide path; the summarize path keeps the pre-existing
|
|
427
|
+
// keep-recent note.
|
|
428
|
+
const instructions =
|
|
429
|
+
plan.kind === "slide" ? SLIDE_MODE_MARKER : "Keep the most recent 10 messages.";
|
|
430
|
+
setTimeout(() => {
|
|
431
|
+
try {
|
|
432
|
+
ctx.compact({ customInstructions: instructions });
|
|
433
|
+
} catch {
|
|
434
|
+
// agent already disconnected -- non-fatal
|
|
435
|
+
}
|
|
436
|
+
}, 0);
|
|
437
|
+
return plan.kind;
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
export function registerTurnEndHygiene(pi: ExtensionAPI): void {
|
|
441
|
+
registerTurnEndHandler("turn-end-hygiene", 5, async (event, ctx) => {
|
|
442
|
+
try {
|
|
443
|
+
checkContextUsage(pi, ctx, event);
|
|
444
|
+
} catch (err) {
|
|
445
|
+
log.error("turn-end-hygiene error:", err);
|
|
446
|
+
}
|
|
447
|
+
});
|
|
448
|
+
|
|
449
|
+
log.debug(
|
|
450
|
+
"turn-end-hygiene registered (priority 5) -- loop-done gate (no act on toolUse " +
|
|
451
|
+
"stops); act at min(0.60W, 130k) tokens (or >=90%) after " +
|
|
452
|
+
`${HYGIENE_AUTO_COMPACT_MIN_TURNS} turns; hard backstop 0.90W acts mid-loop; ` +
|
|
453
|
+
"deterministic slide fires regardless of pi compaction.enabled; summarize " +
|
|
454
|
+
"path is nudge-only when native compaction owns the loop",
|
|
455
|
+
);
|
|
456
|
+
}
|