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,451 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn End Handler - main enforcement loop.
|
|
3
|
+
*
|
|
4
|
+
* Fires on turn_end: error burst detection, context overflow, redundancy,
|
|
5
|
+
* critical signals, orphan chain detection, claim tracking, L2 signal bundling.
|
|
6
|
+
*/
|
|
7
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
8
|
+
import { detectMissingVerification, recordCodeChange } from "../detection/verification.js";
|
|
9
|
+
import { detectRedundancySignal, handleCriticalSignals, } from "./turn-analysis.js";
|
|
10
|
+
import { detectOrphanChains } from "./orphan-chains.js";
|
|
11
|
+
import { getNudgeManager } from "../nudge-manager.js";
|
|
12
|
+
import { getState, ERROR_BURST_THRESHOLD, RECOVERY_GRACE_TURNS, shouldNudgeForMemory, markMemoryNudgeSent, } from "../state.js";
|
|
13
|
+
import { recordNudgeSuppressed, getNudgeAnalytics, } from "../../../lib/reasoning/nudge-analytics.js";
|
|
14
|
+
import { recordTurnEnd, detectToolLoop, getToolLoopState, markLoopFired, } from "../../../lib/detection/tool-loop-detector.js";
|
|
15
|
+
import { getStopReason, getMessageContent } from "../../../lib/state/extension-state.js";
|
|
16
|
+
import { validateTurn } from "../validation.js";
|
|
17
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
18
|
+
import { knownFiles, loadFileContent } from "../similarity.js";
|
|
19
|
+
import { enforcementSignals, pruneSignals, SIGNAL_KEYS } from "../signals.js";
|
|
20
|
+
const log = createLogger("enforcement:turn-end");
|
|
21
|
+
// L2 sub-signals with a dedicated NudgeType use the
|
|
22
|
+
// type's own cooldown (memory: 45s, scratchpad: 60s, context: 90s).
|
|
23
|
+
// Sub-signals without a dedicated type fall through to `sessionSignals`
|
|
24
|
+
// with the subKey distinguishing them (think, localization).
|
|
25
|
+
const L2_NUDGE_TYPE = {
|
|
26
|
+
"memory": { type: "memory" },
|
|
27
|
+
"scratchpad": { type: "scratchpad" },
|
|
28
|
+
"context-tokens": { type: "context", subKey: "tokens" },
|
|
29
|
+
"context-percent": { type: "context", subKey: "percent" },
|
|
30
|
+
"think": { type: "sessionSignals", subKey: "think" },
|
|
31
|
+
"startup": { type: "sessionSignals", subKey: "startup" },
|
|
32
|
+
"finalize": { type: "sessionSignals", subKey: "finalize" },
|
|
33
|
+
"verify": { type: "sessionSignals", subKey: "verify" },
|
|
34
|
+
};
|
|
35
|
+
function nudgeTypeForKey(key) {
|
|
36
|
+
return L2_NUDGE_TYPE[key] ?? { type: "sessionSignals", subKey: key };
|
|
37
|
+
}
|
|
38
|
+
export async function dispatchTurnEndLoop(pi, event, ctx) {
|
|
39
|
+
if (!getState(ctx).enforcementActive)
|
|
40
|
+
return;
|
|
41
|
+
const actualTools = (event.toolResults || [])
|
|
42
|
+
.map((r) => r.toolName)
|
|
43
|
+
.filter((name) => name && name.trim().length > 0);
|
|
44
|
+
const erroredTools = new Set((event.toolResults || [])
|
|
45
|
+
.filter((r) => r.isError && r.toolName && r.toolName.trim().length > 0)
|
|
46
|
+
.map((r) => r.toolName));
|
|
47
|
+
const hadErrors = erroredTools.size > 0;
|
|
48
|
+
// Natural-stop tracking
|
|
49
|
+
// Records whether this turn was a natural agent stop: assistant final
|
|
50
|
+
// response with stopReason "stop" and no tool calls. The session_compact
|
|
51
|
+
// re-orientation whisper reads this to decide whether a post-compaction
|
|
52
|
+
// wake is needed — a natural stop must NOT be woken with triggerTurn:true
|
|
53
|
+
// (that is the forced-turn noise the user flagged); only mid-work turns
|
|
54
|
+
// (tool calls or a non-"stop" stopReason) get the wake. Cleared on
|
|
55
|
+
// turn_start (handler-registry.ts) so a re-prompt after a natural stop
|
|
56
|
+
// does not carry a stale classification into a mid-work compaction.
|
|
57
|
+
getState(ctx).lastTurnWasNaturalStop =
|
|
58
|
+
event.message.role === "assistant" &&
|
|
59
|
+
getStopReason(event.message) === "stop" &&
|
|
60
|
+
actualTools.length === 0;
|
|
61
|
+
// Tool output extraction (for verification judge)
|
|
62
|
+
// Every tool result gets an entry prefixed with [OK] or [FAIL] so the
|
|
63
|
+
// judge can verify exit status without regex-parsing truncated output.
|
|
64
|
+
// - Success with output: `bash [OK]: 42 passed, 0 failed`
|
|
65
|
+
// - Success with no stdout: `bash [OK]: (no output)`
|
|
66
|
+
// - Failure: `bash [FAIL]: Error: can't find ...`
|
|
67
|
+
const toolOutputs = [];
|
|
68
|
+
const MAX_OUTPUT_CHARS = 300;
|
|
69
|
+
for (const r of event.toolResults || []) {
|
|
70
|
+
const status = r.isError ? "FAIL" : "OK";
|
|
71
|
+
const outputText = (r.content || [])
|
|
72
|
+
.filter((c) => c?.type === "text")
|
|
73
|
+
.map((c) => c.text || "")
|
|
74
|
+
.join("\n")
|
|
75
|
+
.replace(/\n{3,}/g, "\n\n")
|
|
76
|
+
.trim();
|
|
77
|
+
if (outputText) {
|
|
78
|
+
const truncated = outputText.length > MAX_OUTPUT_CHARS
|
|
79
|
+
? outputText.slice(0, MAX_OUTPUT_CHARS) + "..."
|
|
80
|
+
: outputText;
|
|
81
|
+
toolOutputs.push(`${r.toolName} [${status}]: ${truncated}`);
|
|
82
|
+
}
|
|
83
|
+
else {
|
|
84
|
+
toolOutputs.push(`${r.toolName} [${status}]: (no output)`);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
// Error burst detection
|
|
88
|
+
if (hadErrors) {
|
|
89
|
+
const state = getState(ctx);
|
|
90
|
+
state.consecutiveErrorTurns++;
|
|
91
|
+
if (state.consecutiveErrorTurns === ERROR_BURST_THRESHOLD) {
|
|
92
|
+
sendEnforcementWhisper(pi, ctx, `Error burst detected: ${state.consecutiveErrorTurns} consecutive errors. Consider stepping back.`, true);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
getState(ctx).consecutiveErrorTurns = 0;
|
|
97
|
+
}
|
|
98
|
+
const isBurst = getState(ctx).consecutiveErrorTurns >= ERROR_BURST_THRESHOLD;
|
|
99
|
+
// Tool loop detection (per-turn tool sets)
|
|
100
|
+
if (!isBurst) {
|
|
101
|
+
const loopState = getToolLoopState(ctx);
|
|
102
|
+
recordTurnEnd(loopState);
|
|
103
|
+
const loopResult = detectToolLoop(loopState);
|
|
104
|
+
if (loopResult.isLoop) {
|
|
105
|
+
markLoopFired(loopState);
|
|
106
|
+
// Tool-loop whispers must NOT force a continuation turn: the whisper is
|
|
107
|
+
// delivered as the park class, which keeps the violation event for
|
|
108
|
+
// MARS/analytics but records the warning for the turn's end instead of
|
|
109
|
+
// steering. Without this, a tool-loop whisper
|
|
110
|
+
// creates turn N+1, which also loops, creating turn N+2 — a cascade
|
|
111
|
+
// that inflates the turn count and floods the session. The agent sees
|
|
112
|
+
// the warning on its next natural turn.
|
|
113
|
+
sendEnforcementWhisper(pi, ctx, loopResult.message, true, { delivery: "park" });
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
// Context overflow detection
|
|
117
|
+
const msgContent = getMessageContent(event.message);
|
|
118
|
+
const isOverflowTurn = event.message.role === "assistant" &&
|
|
119
|
+
"stopReason" in event.message &&
|
|
120
|
+
getStopReason(event.message) === "error" &&
|
|
121
|
+
msgContent
|
|
122
|
+
.filter((c) => c?.type === "text")
|
|
123
|
+
.map((c) => c?.text || "")
|
|
124
|
+
.join(" ")
|
|
125
|
+
.toLowerCase()
|
|
126
|
+
.includes("context") &&
|
|
127
|
+
msgContent
|
|
128
|
+
.filter((c) => c?.type === "text")
|
|
129
|
+
.map((c) => c?.text || "")
|
|
130
|
+
.join(" ")
|
|
131
|
+
.toLowerCase()
|
|
132
|
+
.includes("overflow");
|
|
133
|
+
if (isOverflowTurn) {
|
|
134
|
+
getState(ctx).overflowRecently = getState(ctx).currentTurn;
|
|
135
|
+
}
|
|
136
|
+
// Code change tracking
|
|
137
|
+
if (actualTools.some((t) => ["edit", "write"].includes(t))) {
|
|
138
|
+
recordCodeChange(getState(ctx).currentTurn, ctx);
|
|
139
|
+
}
|
|
140
|
+
if (!isBurst) {
|
|
141
|
+
detectMissingVerification(pi, ctx, getState(ctx).currentTurn);
|
|
142
|
+
}
|
|
143
|
+
const scratchpadUpdated = actualTools.includes("scratchpad");
|
|
144
|
+
if (scratchpadUpdated) {
|
|
145
|
+
getState(ctx).lastScratchpadNudgeTurn = -100;
|
|
146
|
+
}
|
|
147
|
+
const memoryUpdated = actualTools.some((t) => ["memory_store", "memory"].includes(t));
|
|
148
|
+
// Truth-seeking trigger: verify_claim/conflict_qa usage
|
|
149
|
+
// MI-2: When the agent uses verification tools, briefly surface TRUTH-SEEKING
|
|
150
|
+
// mode explicitly, confirming the correct epistemic stance.
|
|
151
|
+
const truthTools = actualTools.filter((t) => ["verify_claim", "conflict_qa"].includes(t));
|
|
152
|
+
if (truthTools.length > 0) {
|
|
153
|
+
enforcementSignals[SIGNAL_KEYS.truth_seeking_trigger] = {
|
|
154
|
+
turn: getState(ctx).currentTurn,
|
|
155
|
+
text: `Truth-seeking triggered by ${truthTools.join(", ")}`,
|
|
156
|
+
acted: true,
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
if (memoryUpdated && enforcementSignals[SIGNAL_KEYS.unpersisted_learnings]) {
|
|
160
|
+
delete enforcementSignals[SIGNAL_KEYS.unpersisted_learnings];
|
|
161
|
+
}
|
|
162
|
+
if (!memoryUpdated) {
|
|
163
|
+
if (actualTools.length > 0 && !hadErrors) {
|
|
164
|
+
getState(ctx).turnsSinceMemory++;
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
else {
|
|
168
|
+
getState(ctx).turnsSinceMemory = 0;
|
|
169
|
+
}
|
|
170
|
+
// Turn state recording
|
|
171
|
+
const turnState = {
|
|
172
|
+
turnIndex: getState(ctx).currentTurn,
|
|
173
|
+
plannedTools: [],
|
|
174
|
+
actualTools,
|
|
175
|
+
toolOutputs,
|
|
176
|
+
scratchpadUpdated,
|
|
177
|
+
memoryUpdated,
|
|
178
|
+
sequenceRepetitionCount: 0,
|
|
179
|
+
thinkCalledBeforeEdit: getState(ctx).toolChain.lastThinkCall >= getState(ctx).currentTurn - 2,
|
|
180
|
+
planCalledForBugFix: getState(ctx).toolChain.lastPlanCall >= getState(ctx).currentTurn - 3,
|
|
181
|
+
};
|
|
182
|
+
getState(ctx).turnHistory.set(getState(ctx).currentTurn, turnState);
|
|
183
|
+
if (getState(ctx).turnHistory.size > 50) {
|
|
184
|
+
const oldest = Math.min(...getState(ctx).turnHistory.keys());
|
|
185
|
+
getState(ctx).turnHistory.delete(oldest);
|
|
186
|
+
}
|
|
187
|
+
// Redundancy detection
|
|
188
|
+
if (actualTools.some((t) => ["edit", "write"].includes(t))) {
|
|
189
|
+
const tac = {
|
|
190
|
+
pi,
|
|
191
|
+
ctx,
|
|
192
|
+
state: getState(ctx),
|
|
193
|
+
event: {
|
|
194
|
+
role: event.message.role,
|
|
195
|
+
stopReason: getStopReason(event.message),
|
|
196
|
+
},
|
|
197
|
+
actualTools,
|
|
198
|
+
erroredTools,
|
|
199
|
+
hadErrors,
|
|
200
|
+
knownFiles,
|
|
201
|
+
enforcementSignals,
|
|
202
|
+
sendWhisper: (msg) => sendEnforcementWhisper(pi, ctx, msg),
|
|
203
|
+
loadFileContent,
|
|
204
|
+
};
|
|
205
|
+
if (!isBurst) {
|
|
206
|
+
await detectRedundancySignal(tac);
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
// L3: Critical signals
|
|
210
|
+
const prevTurn = getState(ctx).turnHistory.get(getState(ctx).currentTurn - 1);
|
|
211
|
+
const tac = {
|
|
212
|
+
pi,
|
|
213
|
+
ctx,
|
|
214
|
+
state: getState(ctx),
|
|
215
|
+
event: {
|
|
216
|
+
role: event.message.role,
|
|
217
|
+
stopReason: getStopReason(event.message),
|
|
218
|
+
},
|
|
219
|
+
actualTools,
|
|
220
|
+
erroredTools,
|
|
221
|
+
hadErrors,
|
|
222
|
+
knownFiles,
|
|
223
|
+
enforcementSignals,
|
|
224
|
+
sendWhisper: (msg) => sendEnforcementWhisper(pi, ctx, msg),
|
|
225
|
+
loadFileContent,
|
|
226
|
+
};
|
|
227
|
+
handleCriticalSignals(tac, prevTurn, turnState, getNudgeManager(ctx), validateTurn);
|
|
228
|
+
// Orphan thought chain detection
|
|
229
|
+
const orphanResult = detectOrphanChains(getState(ctx));
|
|
230
|
+
if (!isBurst && orphanResult) {
|
|
231
|
+
sendEnforcementWhisper(pi, ctx, orphanResult.suggestion);
|
|
232
|
+
}
|
|
233
|
+
// L2: Session Signals bundling
|
|
234
|
+
const abVariant = getNudgeAnalytics(ctx).abVariant;
|
|
235
|
+
const suppressNudges = abVariant === "no_nudges";
|
|
236
|
+
if (suppressNudges) {
|
|
237
|
+
const count = (getState(ctx).nudgeSuppressedCount || 0) + 1;
|
|
238
|
+
getState(ctx).nudgeSuppressedCount = count;
|
|
239
|
+
recordNudgeSuppressed(ctx);
|
|
240
|
+
if (count === 1) {
|
|
241
|
+
log.debug("Nudge suppression active - L2 signals will be collected but not delivered");
|
|
242
|
+
}
|
|
243
|
+
// Surface the count to the TUI every 5 suppressions
|
|
244
|
+
if (count % 5 === 0) {
|
|
245
|
+
try {
|
|
246
|
+
ctx.ui.setStatus("nudge-suppressed", `${count}`);
|
|
247
|
+
}
|
|
248
|
+
catch {
|
|
249
|
+
/* TUI not available */
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
// Each L2 session signal carries its own subKey so per-signal cooldowns
|
|
254
|
+
// and dedup are independent — adding or removing a signal never re-arms
|
|
255
|
+
// the others.
|
|
256
|
+
const sessionSignals = [];
|
|
257
|
+
// Memory signal
|
|
258
|
+
const inOverflowRecovery = getState(ctx).currentTurn - getState(ctx).overflowRecently < RECOVERY_GRACE_TURNS;
|
|
259
|
+
// D-57: memory usage is a static instruction — covered by memory_store tool description
|
|
260
|
+
// and MEMORY_AWARENESS system prompt. Keep the state counter for analytics but
|
|
261
|
+
// suppress the repetitive whisper.
|
|
262
|
+
if (!hadErrors &&
|
|
263
|
+
!inOverflowRecovery &&
|
|
264
|
+
shouldNudgeForMemory(getState(ctx), getState(ctx).currentTurn, 20)) {
|
|
265
|
+
markMemoryNudgeSent(getState(ctx));
|
|
266
|
+
// whisper suppressed — instruction lives in tool description
|
|
267
|
+
}
|
|
268
|
+
// Scratchpad signal - widened: fires on (a) write/edit without scratchpad,
|
|
269
|
+
// or (b) complex turn (3+ tools) without scratchpad
|
|
270
|
+
const madeFileChanges = actualTools.some((t) => ["edit", "write"].includes(t));
|
|
271
|
+
const isComplexTurn = actualTools.length >= 3;
|
|
272
|
+
const needsScratchpad = (madeFileChanges || isComplexTurn) && !scratchpadUpdated;
|
|
273
|
+
// D-57: scratchpad usage is a static instruction — covered by scratchpad tool description.
|
|
274
|
+
// Keep cooldown tracking for potential future use but suppress the repetitive whisper.
|
|
275
|
+
if (!hadErrors && !inOverflowRecovery && needsScratchpad) {
|
|
276
|
+
const cooldown = madeFileChanges ? 8 : 15;
|
|
277
|
+
if (getState(ctx).currentTurn - getState(ctx).lastScratchpadNudgeTurn >= cooldown) {
|
|
278
|
+
getState(ctx).lastScratchpadNudgeTurn = getState(ctx).currentTurn;
|
|
279
|
+
// whisper suppressed — instruction lives in tool description
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
// Planning signal: tool calls without scratchpad goal at any turn.
|
|
283
|
+
// Increments toolsSinceLastPlan when the agent makes tool calls without
|
|
284
|
+
// setting a scratchpad goal. Resets when scratchpad is used.
|
|
285
|
+
if (!hadErrors && !inOverflowRecovery && actualTools.length > 0) {
|
|
286
|
+
if (scratchpadUpdated) {
|
|
287
|
+
getState(ctx).toolsSinceLastPlan = 0;
|
|
288
|
+
}
|
|
289
|
+
else {
|
|
290
|
+
// Only increment if the agent actually did work (not just read/ls)
|
|
291
|
+
const workTools = actualTools.filter((t) => !["read", "ls", "grep", "find", "memory"].includes(t));
|
|
292
|
+
if (workTools.length > 0) {
|
|
293
|
+
getState(ctx).toolsSinceLastPlan += 1;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
// Think tool enforcement - session level: fires on (a) no think ever called by turn 5,
|
|
298
|
+
// or (b) high-stakes actions (edit/write/finalize) without prior think this session
|
|
299
|
+
const madeHighStakesAction = actualTools.some((t) => ["edit", "write", "finalize"].includes(t));
|
|
300
|
+
const noThinkThisSession = getState(ctx).toolChain.lastThinkCall === 0;
|
|
301
|
+
const thinkNeeded = (noThinkThisSession && getState(ctx).currentTurn >= 5 && getState(ctx).currentTurn % 5 === 0) ||
|
|
302
|
+
(madeHighStakesAction && noThinkThisSession && getState(ctx).currentTurn >= 3);
|
|
303
|
+
// D-57: think usage is a static instruction — covered by think tool description
|
|
304
|
+
// ("Required before editing, writing files, or making high-stakes changes").
|
|
305
|
+
// Keep the detection logic for potential analytics but suppress the whisper.
|
|
306
|
+
if (!hadErrors && !inOverflowRecovery && thinkNeeded) {
|
|
307
|
+
// whisper suppressed — instruction lives in tool description
|
|
308
|
+
}
|
|
309
|
+
// Per-turn think-before-edit enforcement
|
|
310
|
+
// Fires when edit/write is used in this turn but think was NOT called in this turn.
|
|
311
|
+
// Uses a 3-turn cooldown (faster than the session-level 5-turn check above).
|
|
312
|
+
if (!hadErrors && !inOverflowRecovery && getState(ctx).currentTurn >= 2) {
|
|
313
|
+
const madeEditThisTurn = actualTools.some((t) => ["edit", "write"].includes(t));
|
|
314
|
+
const thinkCalledThisTurn = getState(ctx).toolChain.lastThinkCall === getState(ctx).currentTurn;
|
|
315
|
+
if (madeEditThisTurn && !thinkCalledThisTurn) {
|
|
316
|
+
const perTurnCooldown = 3;
|
|
317
|
+
if (getState(ctx).currentTurn - getState(ctx).lastThinkPerTurnNudge >= perTurnCooldown) {
|
|
318
|
+
getState(ctx).lastThinkPerTurnNudge = getState(ctx).currentTurn;
|
|
319
|
+
// D-57: per-turn think whisper suppressed — instruction lives in tool description
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
}
|
|
323
|
+
// Finalize enforcement
|
|
324
|
+
// Fires when a turn has significant work (edit/write, or plans marked done)
|
|
325
|
+
// but finalize was not called. Uses a 5-turn cooldown.
|
|
326
|
+
if (!hadErrors && !inOverflowRecovery && getState(ctx).currentTurn >= 3) {
|
|
327
|
+
const hasCompletionWork = actualTools.some((t) => ["edit", "write", "finalize"].includes(t));
|
|
328
|
+
const calledFinalize = actualTools.includes("finalize");
|
|
329
|
+
if (hasCompletionWork && !calledFinalize) {
|
|
330
|
+
const finalizeCooldown = 5;
|
|
331
|
+
if (getState(ctx).currentTurn - getState(ctx).lastFinalizeNudge >= finalizeCooldown) {
|
|
332
|
+
getState(ctx).lastFinalizeNudge = getState(ctx).currentTurn;
|
|
333
|
+
// D-57: finalize whisper suppressed — instruction lives in tool description
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
// Fires when code was changed (edit/write) but verify was not called in the same turn.
|
|
338
|
+
// Uses a 5-turn cooldown.
|
|
339
|
+
if (!hadErrors && !inOverflowRecovery) {
|
|
340
|
+
const madeCodeChange = actualTools.some((t) => ["edit", "write"].includes(t));
|
|
341
|
+
const calledVerify = actualTools.some((t) => ["verify", "verify_claim"].includes(t));
|
|
342
|
+
if (madeCodeChange && !calledVerify) {
|
|
343
|
+
const verifyCooldown = 5;
|
|
344
|
+
if (getState(ctx).currentTurn - getState(ctx).lastVerifyNudge >= verifyCooldown) {
|
|
345
|
+
getState(ctx).lastVerifyNudge = getState(ctx).currentTurn;
|
|
346
|
+
// D-57: verify whisper suppressed — instruction lives in tool description
|
|
347
|
+
}
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
// Phase-aware enforcement: detect investigation→implementation transition
|
|
351
|
+
// When the agent has been investigating (read/grep/find/etc.) for 3+ consecutive
|
|
352
|
+
// turns and then switches to implementation (edit/write) without tagging position
|
|
353
|
+
// or finalizing, fire a phase-boundary whisper.
|
|
354
|
+
const INVESTIGATION_TOOLS = new Set([
|
|
355
|
+
"read",
|
|
356
|
+
"grep",
|
|
357
|
+
"find",
|
|
358
|
+
"ls",
|
|
359
|
+
"bash",
|
|
360
|
+
"fetch_content",
|
|
361
|
+
"browser_navigate",
|
|
362
|
+
"describe_image",
|
|
363
|
+
"document_parse",
|
|
364
|
+
"document_search",
|
|
365
|
+
"document_screenshot",
|
|
366
|
+
"codebase",
|
|
367
|
+
]);
|
|
368
|
+
const IMPLEMENTATION_TOOLS = new Set(["edit", "write"]);
|
|
369
|
+
const PHASE_TOOLS = new Set(["context_navigate", "context_compress", "finalize"]);
|
|
370
|
+
const usedInvestigation = actualTools.some((t) => INVESTIGATION_TOOLS.has(t));
|
|
371
|
+
const usedImplementation = actualTools.some((t) => IMPLEMENTATION_TOOLS.has(t));
|
|
372
|
+
const usedPhaseTool = actualTools.some((t) => PHASE_TOOLS.has(t));
|
|
373
|
+
if (usedInvestigation) {
|
|
374
|
+
getState(ctx).lastInvestigationToolTurn = getState(ctx).currentTurn;
|
|
375
|
+
getState(ctx).consecutiveInvestigationTurns++;
|
|
376
|
+
}
|
|
377
|
+
else {
|
|
378
|
+
getState(ctx).consecutiveInvestigationTurns = 0;
|
|
379
|
+
}
|
|
380
|
+
// Detect transition: was investigating for 3+ turns, now implementing,
|
|
381
|
+
// and hasn't used a phase management tool recently.
|
|
382
|
+
// Skip for simple tasks to avoid noise.
|
|
383
|
+
if (!hadErrors &&
|
|
384
|
+
!inOverflowRecovery &&
|
|
385
|
+
usedImplementation &&
|
|
386
|
+
!usedPhaseTool &&
|
|
387
|
+
getState(ctx).consecutiveInvestigationTurns >= 3 &&
|
|
388
|
+
getState(ctx).taskComplexity !== "simple") {
|
|
389
|
+
const phaseCooldown = 8;
|
|
390
|
+
if (getState(ctx).currentTurn - getState(ctx).lastPhaseNudgeTurn >= phaseCooldown) {
|
|
391
|
+
getState(ctx).lastPhaseNudgeTurn = getState(ctx).currentTurn;
|
|
392
|
+
sendEnforcementWhisper(pi, ctx, `**Phase transition detected:** You were investigating for ${getState(ctx).consecutiveInvestigationTurns} turns and are now implementing.\n\n` +
|
|
393
|
+
`Tag your position first: \`context_navigate(action="tag", name="before-implementation")\`\n` +
|
|
394
|
+
`Then archive the investigation: \`context_compress(action="archive", topic="investigation")\`\n` +
|
|
395
|
+
`This preserves your investigation summary so you can navigate back to it later.`, true, { deliverAs: "nextTurn" });
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
// Context usage signal: the agent called one of the live context
|
|
399
|
+
// management tools (context_inspect / context_compress / context_navigate /
|
|
400
|
+
// context_proposals). Bump the last-check turn and clear the nudge flag so
|
|
401
|
+
// the next threshold crossing can nudge again.
|
|
402
|
+
const contextToolNames = new Set([
|
|
403
|
+
"context_inspect",
|
|
404
|
+
"context_compress",
|
|
405
|
+
"context_navigate",
|
|
406
|
+
"context_proposals",
|
|
407
|
+
]);
|
|
408
|
+
if (actualTools.some((t) => contextToolNames.has(t))) {
|
|
409
|
+
getState(ctx).lastContextCheckTurn = getState(ctx).currentTurn;
|
|
410
|
+
getState(ctx).contextNudgeSent = false;
|
|
411
|
+
}
|
|
412
|
+
// BV1: Surface localization risk
|
|
413
|
+
if (getState(ctx).localizationRisk) {
|
|
414
|
+
sessionSignals.push({
|
|
415
|
+
key: "localization",
|
|
416
|
+
content: `[localization] ${getState(ctx).localizationRisk}`,
|
|
417
|
+
});
|
|
418
|
+
getState(ctx).localizationRisk = "";
|
|
419
|
+
}
|
|
420
|
+
// Suppress L2 signals during an error burst — only the L2 `sessionSignals`
|
|
421
|
+
// bundle freezes. L1 `enforcementSignals`, claim-tracker, verification judge,
|
|
422
|
+
// and conflict detection keep firing (the narrower scope is deliberate, so
|
|
423
|
+
// contributors do not assume broader suppression).
|
|
424
|
+
if (isBurst) {
|
|
425
|
+
sessionSignals.length = 0;
|
|
426
|
+
}
|
|
427
|
+
// Clean up stale enforcement signals (kept for cross-turn MARS readback)
|
|
428
|
+
if (sessionSignals.length > 0) {
|
|
429
|
+
pruneSignals(getState(ctx).currentTurn);
|
|
430
|
+
// Only bundle and send if nudges are not suppressed. Per-signal gating:
|
|
431
|
+
// each sub-signal has its own cooldown + dedup history keyed by `sig.key`,
|
|
432
|
+
// and the bundle is built from only the signals that pass the gate —
|
|
433
|
+
// adding a new signal does not re-arm previously-suppressed ones.
|
|
434
|
+
if (!suppressNudges) {
|
|
435
|
+
const nudgeManager = getNudgeManager(ctx);
|
|
436
|
+
const unsent = [];
|
|
437
|
+
for (const sig of sessionSignals) {
|
|
438
|
+
const { type, subKey } = nudgeTypeForKey(sig.key);
|
|
439
|
+
const { shouldSend } = nudgeManager.shouldSendNudge(type, sig.content, subKey);
|
|
440
|
+
if (shouldSend) {
|
|
441
|
+
unsent.push(sig.content);
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
if (unsent.length > 0) {
|
|
445
|
+
const bundled = `[Session Signals]\n${unsent.map((s) => `- ${s}`).join("\n")}`;
|
|
446
|
+
sendEnforcementWhisper(pi, ctx, bundled);
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
}
|
|
450
|
+
}
|
|
451
|
+
//# sourceMappingURL=turn-end-handler.js.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Extension - Smart Nudge Delivery with Semantic Interrupts
|
|
3
|
+
*
|
|
4
|
+
* Wiring file: registers all event handlers via handler-registry.ts.
|
|
5
|
+
* The actual handler implementations are in:
|
|
6
|
+
* - handler-registry.ts (all pi.on() registrations)
|
|
7
|
+
* - handlers/ (per-handler logic: blocking, tool-tracker, etc.)
|
|
8
|
+
* - detection/ (malformed, verification, dangerous tool detection)
|
|
9
|
+
* - similarity.ts (text similarity for redundancy detection)
|
|
10
|
+
* - signals.ts (L1 enforcement signals + RepE contrast mode)
|
|
11
|
+
*/
|
|
12
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
13
|
+
export { enforcementSignals, pruneSignals } from "./signals.js";
|
|
14
|
+
export default function enforcementExtension(pi: ExtensionAPI): void;
|
|
15
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Extension - Smart Nudge Delivery with Semantic Interrupts
|
|
3
|
+
*
|
|
4
|
+
* Wiring file: registers all event handlers via handler-registry.ts.
|
|
5
|
+
* The actual handler implementations are in:
|
|
6
|
+
* - handler-registry.ts (all pi.on() registrations)
|
|
7
|
+
* - handlers/ (per-handler logic: blocking, tool-tracker, etc.)
|
|
8
|
+
* - detection/ (malformed, verification, dangerous tool detection)
|
|
9
|
+
* - similarity.ts (text similarity for redundancy detection)
|
|
10
|
+
* - signals.ts (L1 enforcement signals + RepE contrast mode)
|
|
11
|
+
*/
|
|
12
|
+
import { registerHandlers } from "./handler-registry.js";
|
|
13
|
+
const log = createLogger("enforcement");
|
|
14
|
+
export { enforcementSignals, pruneSignals } from "./signals.js";
|
|
15
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
16
|
+
export default function enforcementExtension(pi) {
|
|
17
|
+
// NudgeManager is now per-session via getNudgeManager(ctx). Handlers
|
|
18
|
+
// retrieve the real instance via ctx.
|
|
19
|
+
registerHandlers(pi);
|
|
20
|
+
log.info("Enforcement extension registered.");
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared Judge Infrastructure
|
|
3
|
+
*
|
|
4
|
+
* Common utilities for both response analysis (judge.ts) and
|
|
5
|
+
* work verification (verification-judge.ts).
|
|
6
|
+
*
|
|
7
|
+
* LLM calls are delegated to the shared callLlm utility (src/lib/llm-call.ts)
|
|
8
|
+
* which provides two-tier retry + rate-limit circuit breaker.
|
|
9
|
+
*
|
|
10
|
+
* extractJson is re-exported from the shared location at
|
|
11
|
+
* `../../../lib/utils/extract-json.js` so both the enforcement
|
|
12
|
+
* pipeline and other consumers (metacognition verify) use the
|
|
13
|
+
* same robust implementation.
|
|
14
|
+
*
|
|
15
|
+
* This module retains judge-specific logic:
|
|
16
|
+
* - getJudgeModel() - picks a non-reasoning model when the session model is reasoning
|
|
17
|
+
* - extractJson() - parses structured JSON from LLM output
|
|
18
|
+
* - clamp() - number clamping
|
|
19
|
+
*/
|
|
20
|
+
import type { Api, Model } from "@earendil-works/pi-ai";
|
|
21
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
22
|
+
import type { LlmCallOptions } from "../../lib/ai/llm-call.js";
|
|
23
|
+
export type { LlmCallOptions };
|
|
24
|
+
/**
|
|
25
|
+
* Get a suitable model for judge analysis.
|
|
26
|
+
* Uses the session's current model (ctx.model).
|
|
27
|
+
* If the current model is a reasoning model, falls back to the cheapest
|
|
28
|
+
* non-reasoning model to avoid expensive judge calls.
|
|
29
|
+
*/
|
|
30
|
+
export declare function getJudgeModel(ctx: ExtensionContext): Model<Api> | undefined;
|
|
31
|
+
/**
|
|
32
|
+
* Make a judge LLM call with model resolution, two-tier retry, and
|
|
33
|
+
* rate-limit circuit breaker.
|
|
34
|
+
*
|
|
35
|
+
* Resolves model via getJudgeModel() and API key automatically.
|
|
36
|
+
*
|
|
37
|
+
* Tier fallback:
|
|
38
|
+
* 1. Merged role model (utilityModel, if configured — cheapest, fastest
|
|
39
|
+
* for judgment)
|
|
40
|
+
* 2. Judge/session model (fallback when no role model is set, or when the
|
|
41
|
+
* role tier failed)
|
|
42
|
+
*/
|
|
43
|
+
export declare function callLlm(ctx: ExtensionContext, systemPrompt: string, userPrompt: string, options?: LlmCallOptions): Promise<{
|
|
44
|
+
text: string;
|
|
45
|
+
} | {
|
|
46
|
+
error: string;
|
|
47
|
+
}>;
|
|
48
|
+
/**
|
|
49
|
+
* Extract and clean JSON from LLM output.
|
|
50
|
+
*
|
|
51
|
+
* Handles three wrappers in order:
|
|
52
|
+
* 1. Markdown code blocks: ```json ... ```
|
|
53
|
+
* 2. Leading prose / explanations before the JSON starts
|
|
54
|
+
* 3. Trailing prose / explanations after the JSON ends
|
|
55
|
+
*
|
|
56
|
+
* The trailing-prose trim is the subtle part: we can't just use
|
|
57
|
+
* `lastIndexOf("}")` because a JSON string value may legitimately
|
|
58
|
+
* contain a `}` character (e.g. `{"key": "a}b"}`). Instead we walk
|
|
59
|
+
* the string tracking string context (with backslash-escape handling)
|
|
60
|
+
* and depth, returning the substring from the opening bracket to the
|
|
61
|
+
* matching closing bracket.
|
|
62
|
+
*
|
|
63
|
+
* Returns null if no balanced JSON object/array is found.
|
|
64
|
+
*
|
|
65
|
+
* Canonical implementation lives in `src/lib/utils/extract-json.ts`;
|
|
66
|
+
* re-exported here for backward compatibility with existing imports.
|
|
67
|
+
*/
|
|
68
|
+
export { extractJson } from "../../lib/utils/extract-json.js";
|
|
69
|
+
/**
|
|
70
|
+
* Clamp a number to a range.
|
|
71
|
+
*/
|
|
72
|
+
export declare function clamp(value: number, min: number, max: number): number;
|
|
73
|
+
//# sourceMappingURL=judge-utils.d.ts.map
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared Judge Infrastructure
|
|
3
|
+
*
|
|
4
|
+
* Common utilities for both response analysis (judge.ts) and
|
|
5
|
+
* work verification (verification-judge.ts).
|
|
6
|
+
*
|
|
7
|
+
* LLM calls are delegated to the shared callLlm utility (src/lib/llm-call.ts)
|
|
8
|
+
* which provides two-tier retry + rate-limit circuit breaker.
|
|
9
|
+
*
|
|
10
|
+
* extractJson is re-exported from the shared location at
|
|
11
|
+
* `../../../lib/utils/extract-json.js` so both the enforcement
|
|
12
|
+
* pipeline and other consumers (metacognition verify) use the
|
|
13
|
+
* same robust implementation.
|
|
14
|
+
*
|
|
15
|
+
* This module retains judge-specific logic:
|
|
16
|
+
* - getJudgeModel() - picks a non-reasoning model when the session model is reasoning
|
|
17
|
+
* - extractJson() - parses structured JSON from LLM output
|
|
18
|
+
* - clamp() - number clamping
|
|
19
|
+
*/
|
|
20
|
+
import { resolveUtilityModel, tryModelChain } from "../../lib/ai/model-resolver.js";
|
|
21
|
+
/**
|
|
22
|
+
* Get a suitable model for judge analysis.
|
|
23
|
+
* Uses the session's current model (ctx.model).
|
|
24
|
+
* If the current model is a reasoning model, falls back to the cheapest
|
|
25
|
+
* non-reasoning model to avoid expensive judge calls.
|
|
26
|
+
*/
|
|
27
|
+
export function getJudgeModel(ctx) {
|
|
28
|
+
let model = ctx.model;
|
|
29
|
+
if (model?.reasoning) {
|
|
30
|
+
const availableModels = ctx.modelRegistry.getAvailable();
|
|
31
|
+
const nonReasoning = availableModels.filter((m) => !m.reasoning);
|
|
32
|
+
nonReasoning.sort((a, b) => (a.cost?.input ?? 0) +
|
|
33
|
+
(a.cost?.output ?? 0) -
|
|
34
|
+
((b.cost?.input ?? 0) + (b.cost?.output ?? 0)));
|
|
35
|
+
model = nonReasoning[0];
|
|
36
|
+
}
|
|
37
|
+
return model;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Make a judge LLM call with model resolution, two-tier retry, and
|
|
41
|
+
* rate-limit circuit breaker.
|
|
42
|
+
*
|
|
43
|
+
* Resolves model via getJudgeModel() and API key automatically.
|
|
44
|
+
*
|
|
45
|
+
* Tier fallback:
|
|
46
|
+
* 1. Merged role model (utilityModel, if configured — cheapest, fastest
|
|
47
|
+
* for judgment)
|
|
48
|
+
* 2. Judge/session model (fallback when no role model is set, or when the
|
|
49
|
+
* role tier failed)
|
|
50
|
+
*/
|
|
51
|
+
export async function callLlm(ctx, systemPrompt, userPrompt, options = {}) {
|
|
52
|
+
// Fallback-only chain: merged role (cheapest) → judge/session model.
|
|
53
|
+
// The role tier leads; the judge model closes the chain.
|
|
54
|
+
return tryModelChain(ctx, [() => resolveUtilityModel(ctx), () => getJudgeModel(ctx)], systemPrompt, userPrompt, options);
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Extract and clean JSON from LLM output.
|
|
58
|
+
*
|
|
59
|
+
* Handles three wrappers in order:
|
|
60
|
+
* 1. Markdown code blocks: ```json ... ```
|
|
61
|
+
* 2. Leading prose / explanations before the JSON starts
|
|
62
|
+
* 3. Trailing prose / explanations after the JSON ends
|
|
63
|
+
*
|
|
64
|
+
* The trailing-prose trim is the subtle part: we can't just use
|
|
65
|
+
* `lastIndexOf("}")` because a JSON string value may legitimately
|
|
66
|
+
* contain a `}` character (e.g. `{"key": "a}b"}`). Instead we walk
|
|
67
|
+
* the string tracking string context (with backslash-escape handling)
|
|
68
|
+
* and depth, returning the substring from the opening bracket to the
|
|
69
|
+
* matching closing bracket.
|
|
70
|
+
*
|
|
71
|
+
* Returns null if no balanced JSON object/array is found.
|
|
72
|
+
*
|
|
73
|
+
* Canonical implementation lives in `src/lib/utils/extract-json.ts`;
|
|
74
|
+
* re-exported here for backward compatibility with existing imports.
|
|
75
|
+
*/
|
|
76
|
+
export { extractJson } from "../../lib/utils/extract-json.js";
|
|
77
|
+
/**
|
|
78
|
+
* Clamp a number to a range.
|
|
79
|
+
*/
|
|
80
|
+
export function clamp(value, min, max) {
|
|
81
|
+
return Math.min(max, Math.max(min, value));
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=judge-utils.js.map
|