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,388 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-message-end - Conflict detection -> message analysis -> verification judge.
|
|
3
|
+
*/
|
|
4
|
+
import { onEvent } from "../../../lib/events/event-types.js";
|
|
5
|
+
import { getUnresolvedConflicts, detectConflicts, formatConflictMessage, resolveConflict, pruneResolvedEvidence, classifyConflictsWithLLM, detectSemanticConflicts, } from "../../../lib/store/evidence-pool.js";
|
|
6
|
+
import { processConflicts as processConflictQAs, formatConflictWhisper, checkResponseForResolution, } from "../../../lib/store/conflict-qa.js";
|
|
7
|
+
import { emitSignal } from "../../../lib/reasoning/belief-policy-engine.js";
|
|
8
|
+
import { detectMalformedToolCalls } from "../detection/malformed.js";
|
|
9
|
+
import { analyzeMessage } from "./message-analysis.js";
|
|
10
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
11
|
+
import { getState, ERROR_BURST_THRESHOLD, startJudge, completeJudge } from "../state.js";
|
|
12
|
+
import { runVerificationJudge, formatVerificationNudge } from "../verification-judge.js";
|
|
13
|
+
import { collectTaskEvidence, renderTaskEvidence, summarizeTaskEvidence, } from "../task-evidence.js";
|
|
14
|
+
import { isWakeRedeliveryInFlight } from "../../scheduling/timer/wake-retry.js";
|
|
15
|
+
import { enforcementSignals } from "../signals.js";
|
|
16
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
17
|
+
import { MESSAGE_END } from "../../../lib/core/event-names.js";
|
|
18
|
+
import { getDeliverablesFilePath } from "../../../lib/config/braid-paths.js";
|
|
19
|
+
import { mapInsertBounded } from "../../../lib/utils/bounded.js";
|
|
20
|
+
import { execSync } from "node:child_process";
|
|
21
|
+
import * as fs from "node:fs";
|
|
22
|
+
import * as crypto from "node:crypto";
|
|
23
|
+
import * as path from "node:path";
|
|
24
|
+
const log = createLogger("enforcement:message-end");
|
|
25
|
+
export function registerMessageEndHandler(pi) {
|
|
26
|
+
onEvent(pi, MESSAGE_END, async (event, ctx) => {
|
|
27
|
+
if (!getState(ctx).enforcementActive)
|
|
28
|
+
return;
|
|
29
|
+
const isBurst = getState(ctx).consecutiveErrorTurns >= ERROR_BURST_THRESHOLD;
|
|
30
|
+
// Part 1: Conflict detection
|
|
31
|
+
if (!isBurst) {
|
|
32
|
+
const newConflicts = detectConflicts(ctx);
|
|
33
|
+
if (newConflicts.length > 0) {
|
|
34
|
+
const msg = formatConflictMessage(newConflicts[0]);
|
|
35
|
+
sendEnforcementWhisper(pi, ctx, msg);
|
|
36
|
+
emitSignal(ctx, "conflict", "detected", newConflicts[0]?.for[0]?.confidence > 0.7 ? "warn" : "info", false, { conflictId: newConflicts[0]?.id });
|
|
37
|
+
}
|
|
38
|
+
const unresolved = getUnresolvedConflicts(ctx);
|
|
39
|
+
if (unresolved.length > 0) {
|
|
40
|
+
emitSignal(ctx, "conflict", "unresolved", "info", false, { count: unresolved.length });
|
|
41
|
+
}
|
|
42
|
+
if (unresolved.length > 0 && unresolved.length % 5 === 0) {
|
|
43
|
+
sendEnforcementWhisper(pi, ctx, `[conflict] ${unresolved.length} unresolved source conflicts. ` +
|
|
44
|
+
`Consider resolving: memory_store content with conflict_verified tag.`);
|
|
45
|
+
}
|
|
46
|
+
// Non-blocking LLM re-classification: upgrade heuristic "implication"
|
|
47
|
+
// conflicts to "direct" when the triple-critic system detects a
|
|
48
|
+
// real contradiction. Runs in background -- does not await.
|
|
49
|
+
if (newConflicts.length > 0) {
|
|
50
|
+
classifyConflictsWithLLM(ctx, newConflicts).catch((e) => {
|
|
51
|
+
log.warn(`[conflict] background LLM re-classification failed: ${e instanceof Error ? e.message : String(e)}`);
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
// Non-blocking semantic conflict detection: catch evidence pairs that
|
|
55
|
+
// the 30% token-overlap heuristic pre-filter missed (same topic,
|
|
56
|
+
// different wording). Limited to 10 LLM checks per turn.
|
|
57
|
+
detectSemanticConflicts(ctx).catch((e) => {
|
|
58
|
+
log.warn(`[conflict] background semantic detection failed: ${e instanceof Error ? e.message : String(e)}`);
|
|
59
|
+
});
|
|
60
|
+
const newQAs = processConflictQAs(ctx);
|
|
61
|
+
for (const qa of newQAs) {
|
|
62
|
+
sendEnforcementWhisper(pi, ctx, formatConflictWhisper(qa));
|
|
63
|
+
// Bridge qa-xxx -> c-xxx ID space: store conflictId so resolveConflict() can find it
|
|
64
|
+
const cId = qa.conflictId || qa.id;
|
|
65
|
+
if (!getState(ctx).pendingConflictIds.includes(cId)) {
|
|
66
|
+
getState(ctx).pendingConflictIds.push(cId);
|
|
67
|
+
// ConflictDetectionTurn grows one entry per conflict id and
|
|
68
|
+
// was never pruned (pool-side conflicts ARE capped 20->10, so old
|
|
69
|
+
// ids here referenced evicted conflicts anyway). Bounded FIFO at 50
|
|
70
|
+
// — far above the ~10 live conflicts the pool keeps.
|
|
71
|
+
mapInsertBounded(getState(ctx).conflictDetectionTurn, cId, getState(ctx).currentTurn, 50);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
if (event.message?.role === "assistant") {
|
|
75
|
+
const textContent = Array.isArray(event.message.content)
|
|
76
|
+
? event.message.content
|
|
77
|
+
.filter((c) => c?.type === "text")
|
|
78
|
+
.map((c) => c?.text || "")
|
|
79
|
+
.join(" ")
|
|
80
|
+
: String(event.message.content ?? "");
|
|
81
|
+
if (textContent.length > 50 && getState(ctx).pendingConflictIds.length > 0) {
|
|
82
|
+
const verdict = await checkResponseForResolution(ctx, textContent);
|
|
83
|
+
if (verdict) {
|
|
84
|
+
for (const conflictId of getState(ctx).pendingConflictIds) {
|
|
85
|
+
resolveConflict(ctx, conflictId, verdict, "agent");
|
|
86
|
+
log.info(`[conflict] Resolved ${conflictId} (${verdict}) from agent response`);
|
|
87
|
+
}
|
|
88
|
+
getState(ctx).pendingConflictIds = [];
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
// Periodic evidence pool cleanup - prune evidence tied to resolved conflicts
|
|
92
|
+
if (getState(ctx).currentTurn % 5 === 0) {
|
|
93
|
+
const pruned = pruneResolvedEvidence(ctx);
|
|
94
|
+
if (pruned > 0) {
|
|
95
|
+
log.debug(`[evidence-pool] Pruned ${pruned} evidence entries from resolved conflicts`);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
const currentTurn = getState(ctx).currentTurn;
|
|
99
|
+
for (const id of getState(ctx).pendingConflictIds) {
|
|
100
|
+
const detectedTurn = getState(ctx).conflictDetectionTurn.get(id) ?? 0;
|
|
101
|
+
if (currentTurn - detectedTurn >= 5) {
|
|
102
|
+
sendEnforcementWhisper(pi, ctx, `[conflict] Conflict ${id} unresolved for ${currentTurn - detectedTurn} turns. ` +
|
|
103
|
+
`Consider resolving explicitly.`);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
// Part 2: Message analysis + verification judge
|
|
109
|
+
if (event.message.role !== "assistant")
|
|
110
|
+
return;
|
|
111
|
+
const textContent = event.message.content
|
|
112
|
+
.filter((c) => c.type === "text")
|
|
113
|
+
.map((c) => c.text)
|
|
114
|
+
.join("\n");
|
|
115
|
+
const thinkingContent = event.message.content
|
|
116
|
+
.filter((c) => c.type === "thinking")
|
|
117
|
+
.map((c) => c.thinking)
|
|
118
|
+
.join("\n");
|
|
119
|
+
const fullContent = thinkingContent
|
|
120
|
+
? `## REASONING\n${thinkingContent}\n\n## RESPONSE\n${textContent}`
|
|
121
|
+
: textContent;
|
|
122
|
+
if (textContent.length < 100)
|
|
123
|
+
return;
|
|
124
|
+
const analysisSignals = await analyzeMessage(textContent, thinkingContent, getState(ctx), ctx);
|
|
125
|
+
getState(ctx).lastUserMessage = "";
|
|
126
|
+
const signalEntries = analysisSignals;
|
|
127
|
+
for (const [key, signal] of Object.entries(signalEntries)) {
|
|
128
|
+
if (signal?.text) {
|
|
129
|
+
enforcementSignals[key] = signal;
|
|
130
|
+
if (key === "stability") {
|
|
131
|
+
emitSignal(ctx, "stability", "decline", "warn", false, {
|
|
132
|
+
overlap: signal.text.match(/overlap=([0-9.]+)/)?.[1] ?? 0,
|
|
133
|
+
reason: signal.text,
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
const turnState = getState(ctx).turnHistory.get(getState(ctx).currentTurn);
|
|
139
|
+
if (turnState) {
|
|
140
|
+
detectMalformedToolCalls(textContent, pi, ctx);
|
|
141
|
+
// When the agent calls verify_claim/conflict_qa and produces a structured
|
|
142
|
+
// markdown response (headings, lists, code blocks) but doesn't call
|
|
143
|
+
// finalize, suggest recording the phase.
|
|
144
|
+
const usedVerificationTools = turnState.actualTools.some((t) => ["verify_claim", "conflict_qa"].includes(t));
|
|
145
|
+
const calledFinalize = turnState.actualTools.includes("finalize");
|
|
146
|
+
const hasStructuredMarkdown = /^#{1,6}\s|^[*-]\s|^\d+\.\s|```/.test(textContent);
|
|
147
|
+
if (usedVerificationTools &&
|
|
148
|
+
!calledFinalize &&
|
|
149
|
+
hasStructuredMarkdown &&
|
|
150
|
+
textContent.length > 200) {
|
|
151
|
+
const finalizeAfterVerifyCooldown = 10;
|
|
152
|
+
if (getState(ctx).currentTurn - getState(ctx).lastFinalizeNudge >=
|
|
153
|
+
finalizeAfterVerifyCooldown) {
|
|
154
|
+
getState(ctx).lastFinalizeNudge = getState(ctx).currentTurn;
|
|
155
|
+
sendEnforcementWhisper(pi, ctx, `**Research summary detected** after verify_claim/conflict_qa analysis.\n\n` +
|
|
156
|
+
`Consider calling \`finalize(completed=true, summary="...")\` to record this phase ` +
|
|
157
|
+
`before moving on. This preserves your findings across sessions and compaction.`, false, { triggerTurn: false });
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
// Finalize enforcement: text-only response after significant work
|
|
161
|
+
// When the agent responds with text only (no tool calls) after a series
|
|
162
|
+
// of edits/writes without calling finalize, suggest recording completion.
|
|
163
|
+
// This catches the pattern where the agent wraps up with a summary but
|
|
164
|
+
// forgets to call finalize, unlike the turn-end handler's per-turn nudge
|
|
165
|
+
// (which was suppressed by D-57 as a static instruction).
|
|
166
|
+
const isTextOnly = turnState.actualTools.length === 0;
|
|
167
|
+
if (isTextOnly && textContent.length > 200) {
|
|
168
|
+
let recentWorkTurns = 0;
|
|
169
|
+
let recentHasFinalize = false;
|
|
170
|
+
const currentT = getState(ctx).currentTurn;
|
|
171
|
+
// Look back up to 5 turns for significant work
|
|
172
|
+
for (let i = 1; i <= 5; i++) {
|
|
173
|
+
const prev = getState(ctx).turnHistory.get(currentT - i);
|
|
174
|
+
if (prev) {
|
|
175
|
+
if (prev.actualTools.includes("finalize")) {
|
|
176
|
+
recentHasFinalize = true;
|
|
177
|
+
break;
|
|
178
|
+
}
|
|
179
|
+
if (prev.actualTools.some((t) => ["edit", "write"].includes(t))) {
|
|
180
|
+
recentWorkTurns++;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
if (recentWorkTurns >= 2 && !recentHasFinalize) {
|
|
185
|
+
const finalizeCooldown = 10;
|
|
186
|
+
if (currentT - getState(ctx).lastFinalizeNudge >= finalizeCooldown) {
|
|
187
|
+
getState(ctx).lastFinalizeNudge = currentT;
|
|
188
|
+
sendEnforcementWhisper(pi, ctx, `**Work completed without finalize.** You made changes across ${recentWorkTurns} turns and responded with a summary, but did not call \`finalize()\`.\n\n` +
|
|
189
|
+
`Call \`finalize(completed=true, summary="...")\` to record this work ` +
|
|
190
|
+
`across sessions. Without finalize, this progress may be lost on ` +
|
|
191
|
+
`session shutdown.`, false, { triggerTurn: false });
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
if (getState(ctx).verificationJudgeRunning)
|
|
197
|
+
return;
|
|
198
|
+
const currentTurn = getState(ctx).currentTurn;
|
|
199
|
+
const turnsSinceLastJudge = currentTurn - getState(ctx).lastVerificationJudgeTurn;
|
|
200
|
+
const timeSinceLastJudge = Date.now() - getState(ctx).lastJudgeTime;
|
|
201
|
+
// Judge triggers (first one wins):
|
|
202
|
+
// 1. Always judge on finalize - agent is declaring done
|
|
203
|
+
// 2. Judge after code changes with reasonable gap (5+ turns)
|
|
204
|
+
// 3. Periodic check every 15 turns regardless
|
|
205
|
+
const shouldJudge = getState(ctx).pendingFinalize ||
|
|
206
|
+
(getState(ctx).hasCodeChanges && turnsSinceLastJudge >= 5 && timeSinceLastJudge > 30_000) ||
|
|
207
|
+
(turnsSinceLastJudge >= 15 && timeSinceLastJudge > 60_000);
|
|
208
|
+
// Skip the judge on wake-retry redelivery turns. A turn broken by a
|
|
209
|
+
// redelivery leaves this handler auditing the redelivered TAIL turn;
|
|
210
|
+
// judging it would treat a fragment as the whole task.
|
|
211
|
+
const isRedeliveryTurn = isWakeRedeliveryInFlight();
|
|
212
|
+
if (shouldJudge && isRedeliveryTurn) {
|
|
213
|
+
log.info("[verification-judge] skipping judge: wake-retry redelivery turn (redelivery in flight)");
|
|
214
|
+
}
|
|
215
|
+
if (shouldJudge && !isRedeliveryTurn) {
|
|
216
|
+
startJudge(getState(ctx));
|
|
217
|
+
const toolLog = [];
|
|
218
|
+
for (const [, turn] of getState(ctx).turnHistory) {
|
|
219
|
+
if (turn.actualTools.length > 0) {
|
|
220
|
+
const toolLine = `Turn ${turn.turnIndex}: [${turn.actualTools.join(", ")}]`;
|
|
221
|
+
// Include truncated tool output so the verification judge can see actual results
|
|
222
|
+
const outputLines = (turn.toolOutputs || []).slice(0, 8); // limit to 8 outputs per turn
|
|
223
|
+
toolLog.push(toolLine +
|
|
224
|
+
(outputLines.length > 0 ? "\n" + outputLines.map((o) => ` -> ${o}`).join("\n") : ""));
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
// Resolve the project root ONCE and scope every git command to it —
|
|
228
|
+
// an unscoped git log falls back to the daemon's cwd, not the project.
|
|
229
|
+
const cwd = ctx.cwd ?? process.cwd();
|
|
230
|
+
let repoRoot = cwd;
|
|
231
|
+
let foundGit = false;
|
|
232
|
+
while (repoRoot !== path.dirname(repoRoot)) {
|
|
233
|
+
if (fs.existsSync(path.join(repoRoot, ".git"))) {
|
|
234
|
+
foundGit = true;
|
|
235
|
+
break;
|
|
236
|
+
}
|
|
237
|
+
repoRoot = path.dirname(repoRoot);
|
|
238
|
+
}
|
|
239
|
+
// Capture git history for the judge so it has verification evidence
|
|
240
|
+
// that survives across reloads and compactions (tool log is truncated).
|
|
241
|
+
let gitHistory;
|
|
242
|
+
try {
|
|
243
|
+
gitHistory =
|
|
244
|
+
execSync("git log --oneline -5 --no-merges", {
|
|
245
|
+
cwd: repoRoot,
|
|
246
|
+
encoding: "utf-8",
|
|
247
|
+
timeout: 3000,
|
|
248
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
249
|
+
}).trim() || undefined;
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
// Not a git repo or git unavailable — judge will work without it
|
|
253
|
+
}
|
|
254
|
+
// Disk-check deliverables so the judge has ground truth that survives
|
|
255
|
+
// tool-log truncation / compaction. Stat the current working tree (git-changed
|
|
256
|
+
// files) directly; the finalize tool also persists a project-scoped
|
|
257
|
+
// manifest under the braid home (a global shared file would pollute
|
|
258
|
+
// unrelated projects).
|
|
259
|
+
let deliverables;
|
|
260
|
+
try {
|
|
261
|
+
const checks = [];
|
|
262
|
+
// 1) current working-tree changes (most direct ground truth)
|
|
263
|
+
let changed = [];
|
|
264
|
+
try {
|
|
265
|
+
const tracked = execSync("git diff --name-only HEAD", {
|
|
266
|
+
cwd: repoRoot,
|
|
267
|
+
encoding: "utf-8",
|
|
268
|
+
timeout: 5000,
|
|
269
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
270
|
+
})
|
|
271
|
+
.split("\n")
|
|
272
|
+
.filter(Boolean);
|
|
273
|
+
const untracked = execSync("git ls-files --others --exclude-standard", {
|
|
274
|
+
cwd: repoRoot,
|
|
275
|
+
encoding: "utf-8",
|
|
276
|
+
timeout: 5000,
|
|
277
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
278
|
+
})
|
|
279
|
+
.split("\n")
|
|
280
|
+
.filter(Boolean);
|
|
281
|
+
changed = [...new Set([...tracked, ...untracked])];
|
|
282
|
+
}
|
|
283
|
+
catch {
|
|
284
|
+
/* not a git repo */
|
|
285
|
+
}
|
|
286
|
+
for (const f of changed.slice(0, 200)) {
|
|
287
|
+
const abs = path.join(repoRoot, f);
|
|
288
|
+
const exists = fs.existsSync(abs);
|
|
289
|
+
// No baseline sha256 for raw working-tree checks (nothing to compare
|
|
290
|
+
// against) — sha256Match stays undefined. This used
|
|
291
|
+
// to hardcode `sha256Match = true` inside a try that could never
|
|
292
|
+
// throw, which reported a fabricated "match" the judge trusted.
|
|
293
|
+
checks.push({ path: f, exists });
|
|
294
|
+
}
|
|
295
|
+
// 2) persisted manifest entries (intent + recorded sha256). Project-scoped
|
|
296
|
+
// read only — never the global home-dir file, so this project's checks
|
|
297
|
+
// cannot pull other projects' entries. Entries are further filtered by
|
|
298
|
+
// their recorded session (repoRoot) as defense in depth.
|
|
299
|
+
const dPath = getDeliverablesFilePath(repoRoot);
|
|
300
|
+
if (foundGit && fs.existsSync(dPath)) {
|
|
301
|
+
const lines = fs.readFileSync(dPath, "utf-8").split("\n").filter(Boolean);
|
|
302
|
+
for (const line of lines) {
|
|
303
|
+
try {
|
|
304
|
+
const rec = JSON.parse(line);
|
|
305
|
+
if (rec.session !== repoRoot)
|
|
306
|
+
continue;
|
|
307
|
+
for (const f of rec.files || []) {
|
|
308
|
+
const abs = path.join(repoRoot, f.path);
|
|
309
|
+
const exists = fs.existsSync(abs);
|
|
310
|
+
let sha256Match;
|
|
311
|
+
if (exists && f.sha256) {
|
|
312
|
+
try {
|
|
313
|
+
sha256Match =
|
|
314
|
+
crypto.createHash("sha256").update(fs.readFileSync(abs)).digest("hex") ===
|
|
315
|
+
f.sha256;
|
|
316
|
+
}
|
|
317
|
+
catch {
|
|
318
|
+
sha256Match = undefined;
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
checks.push({ path: f.path, exists, sha256Match });
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
catch {
|
|
325
|
+
/* skip malformed line */
|
|
326
|
+
}
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
if (checks.length > 0)
|
|
330
|
+
deliverables = checks;
|
|
331
|
+
}
|
|
332
|
+
catch {
|
|
333
|
+
/* best-effort */
|
|
334
|
+
}
|
|
335
|
+
const judgeCtx = {
|
|
336
|
+
userRequest: getState(ctx).originalRequest || getState(ctx).lastUserMessage || "",
|
|
337
|
+
toolsUsed: Array.from(getState(ctx).uniqueToolsUsed),
|
|
338
|
+
toolLog,
|
|
339
|
+
hasCodeChanges: getState(ctx).hasCodeChanges,
|
|
340
|
+
gitHistory,
|
|
341
|
+
deliverables,
|
|
342
|
+
lastResponse: fullContent,
|
|
343
|
+
thinking: thinkingContent,
|
|
344
|
+
};
|
|
345
|
+
// Rebuild evidence since the task's last user message from the
|
|
346
|
+
// session store. The turnHistory log above only records at
|
|
347
|
+
// turn_end and is scoped to enforcement state, so a turn broken by a
|
|
348
|
+
// wake-retry redelivery leaves it with only the tail turn. The session
|
|
349
|
+
// store survives turn breaks (task-evidence.ts); fall back silently to
|
|
350
|
+
// toolLog-only when the store is unavailable (stale ctx).
|
|
351
|
+
const taskEvidence = collectTaskEvidence(ctx, { cap: false });
|
|
352
|
+
if (taskEvidence) {
|
|
353
|
+
// Over the cap: older chunks are compacted by parallel LLM
|
|
354
|
+
// sub-summaries (the newest chunk stays raw) so the judge keeps
|
|
355
|
+
// full-log coverage at a bounded prompt cost. Any sub-call
|
|
356
|
+
// failure returns null here and the legacy drop-oldest render
|
|
357
|
+
// below takes over — the judge never blocks on chunking.
|
|
358
|
+
judgeCtx.taskEvidence =
|
|
359
|
+
(await summarizeTaskEvidence(ctx, taskEvidence, {
|
|
360
|
+
...(ctx.signal ? { signal: ctx.signal } : {}),
|
|
361
|
+
})) ?? renderTaskEvidence(taskEvidence);
|
|
362
|
+
}
|
|
363
|
+
const result = await runVerificationJudge(ctx, judgeCtx, {
|
|
364
|
+
timeoutMs: 120_000,
|
|
365
|
+
// Thread ctx.signal so ESC / session shutdown aborts the
|
|
366
|
+
// judge cleanly. The MESSAGE_END handler runs while the
|
|
367
|
+
// session is still active (subsequent assistant messages
|
|
368
|
+
// may follow, or the agent may finalize); without this the
|
|
369
|
+
// judge runs to its 30s timeout even after the user cancels.
|
|
370
|
+
// ctx.signal is undefined when the agent is idle, in which
|
|
371
|
+
// case the 30s timeout is the only abort path - which is
|
|
372
|
+
// the right behavior for a background audit.
|
|
373
|
+
...(ctx.signal ? { signal: ctx.signal } : {}),
|
|
374
|
+
});
|
|
375
|
+
getState(ctx).pendingFinalize = false;
|
|
376
|
+
completeJudge(getState(ctx), getState(ctx).currentTurn);
|
|
377
|
+
if (result) {
|
|
378
|
+
if (result.verdict === "fail" || result.verdict === "warn") {
|
|
379
|
+
sendEnforcementWhisper(pi, ctx, formatVerificationNudge(result));
|
|
380
|
+
if (result.verdict === "fail") {
|
|
381
|
+
getState(ctx).validationFailures++;
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
});
|
|
387
|
+
}
|
|
388
|
+
//# sourceMappingURL=register-message-end.js.map
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-post-cycle-hygiene - Auto-tag + inspect + whisper on yield.
|
|
3
|
+
*
|
|
4
|
+
* Fires at turn-end when the agent yields with a text-only response
|
|
5
|
+
* (no tool calls) after a cycle of work. Detects the natural cycle
|
|
6
|
+
* boundary and:
|
|
7
|
+
* 1. Auto-tags the position via sessionManager.setLabel
|
|
8
|
+
* 2. Counts messages in the session for a lightweight status
|
|
9
|
+
* 3. Whispers a brief hygiene advisory with actionable suggestions
|
|
10
|
+
*
|
|
11
|
+
* Trigger: text-only assistant response preceded by 2+ turns with
|
|
12
|
+
* edit/write/finalize tools. Minimum 10-turn cooldown between firings.
|
|
13
|
+
*
|
|
14
|
+
* Safety: never tags more than once per 10 turns, never fires during
|
|
15
|
+
* error bursts, no archiving/compaction — just tag + inspect + advise.
|
|
16
|
+
*/
|
|
17
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
18
|
+
/**
|
|
19
|
+
* Register the post-cycle hygiene turn-end handler.
|
|
20
|
+
*
|
|
21
|
+
* Priority 1 (lowest — runs after all analysis, enforcement, and hygiene
|
|
22
|
+
* handlers). Only fires on text-only yields after work cycles.
|
|
23
|
+
*/
|
|
24
|
+
export declare function registerPostCycleHygiene(pi: ExtensionAPI): void;
|
|
25
|
+
//# sourceMappingURL=register-post-cycle-hygiene.d.ts.map
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-post-cycle-hygiene - Auto-tag + inspect + whisper on yield.
|
|
3
|
+
*
|
|
4
|
+
* Fires at turn-end when the agent yields with a text-only response
|
|
5
|
+
* (no tool calls) after a cycle of work. Detects the natural cycle
|
|
6
|
+
* boundary and:
|
|
7
|
+
* 1. Auto-tags the position via sessionManager.setLabel
|
|
8
|
+
* 2. Counts messages in the session for a lightweight status
|
|
9
|
+
* 3. Whispers a brief hygiene advisory with actionable suggestions
|
|
10
|
+
*
|
|
11
|
+
* Trigger: text-only assistant response preceded by 2+ turns with
|
|
12
|
+
* edit/write/finalize tools. Minimum 10-turn cooldown between firings.
|
|
13
|
+
*
|
|
14
|
+
* Safety: never tags more than once per 10 turns, never fires during
|
|
15
|
+
* error bursts, no archiving/compaction — just tag + inspect + advise.
|
|
16
|
+
*/
|
|
17
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
18
|
+
import { registerTurnEndHandler } from "../../../lib/events/turn-end-coordinator.js";
|
|
19
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
20
|
+
import { getState } from "../state.js";
|
|
21
|
+
import { getSessionManager } from "../../../lib/state/session-manager.js";
|
|
22
|
+
const log = createLogger("enforcement:post-cycle-hygiene");
|
|
23
|
+
/** How many turns of work (tools with edits/writes) preceded a yield. */
|
|
24
|
+
const MIN_WORK_TURNS = 2;
|
|
25
|
+
/** Lookback window for detecting preceding work. */
|
|
26
|
+
const WORK_LOOKBACK = 5;
|
|
27
|
+
/** Cooldown between post-cycle hygiene firings. */
|
|
28
|
+
const HYGIENE_COOLDOWN_TURNS = 10;
|
|
29
|
+
/** Cooldown during error bursts — never fire. */
|
|
30
|
+
const ERROR_BURST_LOOKBACK = 3;
|
|
31
|
+
/**
|
|
32
|
+
* Check whether the current turn is a text-only yield after work.
|
|
33
|
+
*/
|
|
34
|
+
function isWorkYield(ctx, event) {
|
|
35
|
+
const state = getState(ctx);
|
|
36
|
+
if (!state?.enforcementActive)
|
|
37
|
+
return false;
|
|
38
|
+
const currentTurn = state.currentTurn;
|
|
39
|
+
const turnState = state.turnHistory?.get(currentTurn);
|
|
40
|
+
if (!turnState)
|
|
41
|
+
return false;
|
|
42
|
+
// Must be text-only in this turn (no tool calls)
|
|
43
|
+
const hasToolCalls = turnState.actualTools?.length > 0 ||
|
|
44
|
+
(Array.isArray(event?.toolResults) && event.toolResults.length > 0);
|
|
45
|
+
if (hasToolCalls)
|
|
46
|
+
return false;
|
|
47
|
+
// Must have preceding work turns (edit/write/finalize)
|
|
48
|
+
let workTurns = 0;
|
|
49
|
+
for (let i = 1; i <= WORK_LOOKBACK; i++) {
|
|
50
|
+
const prev = state.turnHistory?.get(currentTurn - i);
|
|
51
|
+
if (prev?.actualTools) {
|
|
52
|
+
if (prev.actualTools.includes("finalize")) {
|
|
53
|
+
workTurns++;
|
|
54
|
+
break; // finalize counts as the work anchor
|
|
55
|
+
}
|
|
56
|
+
if (prev.actualTools.some((t) => ["edit", "write"].includes(t))) {
|
|
57
|
+
workTurns++;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
if (workTurns < MIN_WORK_TURNS)
|
|
62
|
+
return false;
|
|
63
|
+
// Error burst suppression
|
|
64
|
+
if (state.consecutiveErrorTurns >= ERROR_BURST_LOOKBACK)
|
|
65
|
+
return false;
|
|
66
|
+
return true;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Perform post-cycle hygiene: auto-tag, inspect, whisper.
|
|
70
|
+
*/
|
|
71
|
+
function performPostCycleHygiene(pi, ctx, _event) {
|
|
72
|
+
const state = getState(ctx);
|
|
73
|
+
const currentTurn = state.currentTurn;
|
|
74
|
+
const tagName = `cycle-${currentTurn}`;
|
|
75
|
+
try {
|
|
76
|
+
const sm = getSessionManager(ctx);
|
|
77
|
+
const leafId = sm.getLeafId();
|
|
78
|
+
pi.setLabel(leafId, tagName);
|
|
79
|
+
log.info(`Auto-tagged position as "${tagName}" on yield (turn ${currentTurn})`);
|
|
80
|
+
}
|
|
81
|
+
catch (err) {
|
|
82
|
+
log.debug(`Auto-tag failed (non-fatal): ${err}`);
|
|
83
|
+
}
|
|
84
|
+
const branch = getSessionManager(ctx).getBranch();
|
|
85
|
+
const assistantMessages = branch.filter((e) => e.message?.role === "assistant").length;
|
|
86
|
+
const toolResultMessages = branch.filter((e) => e.message?.role === "toolResult").length;
|
|
87
|
+
const userMessages = branch.filter((e) => e.message?.role === "user").length;
|
|
88
|
+
const totalMessages = branch.length;
|
|
89
|
+
// Estimate pruning candidates: old tool results (age > 3 from leaf)
|
|
90
|
+
// and assistant messages with minimal content.
|
|
91
|
+
const branchLen = branch.length;
|
|
92
|
+
const oldToolResults = branch.filter((e, i) => {
|
|
93
|
+
if (e.message?.role !== "toolResult")
|
|
94
|
+
return false;
|
|
95
|
+
return branchLen - 1 - i > 3; // age > 3 from leaf
|
|
96
|
+
}).length;
|
|
97
|
+
const msgParts = [];
|
|
98
|
+
msgParts.push(`Cycle boundary: ${assistantMessages} assistant / ${toolResultMessages} tool / ${userMessages} user messages.`);
|
|
99
|
+
if (oldToolResults > 5) {
|
|
100
|
+
msgParts.push(`~${oldToolResults} older tool results are prune candidates — ` +
|
|
101
|
+
`consider \`context_compress(action="compact")\` to remove redundant entries.`);
|
|
102
|
+
}
|
|
103
|
+
else if (assistantMessages > 20) {
|
|
104
|
+
msgParts.push(`${assistantMessages} assistant messages suggests rising context — ` +
|
|
105
|
+
`consider \`context_inspect(detail="prune")\` to see candidates.`);
|
|
106
|
+
}
|
|
107
|
+
else {
|
|
108
|
+
msgParts.push(`Context looks clean (${totalMessages} messages, ${oldToolResults} old tool results).`);
|
|
109
|
+
}
|
|
110
|
+
const whisper = msgParts.join(" ");
|
|
111
|
+
// Informational cycle-boundary status: park (no forced continuation turn).
|
|
112
|
+
sendEnforcementWhisper(pi, ctx, whisper, false, { delivery: "park" });
|
|
113
|
+
log.info(`Post-cycle hygiene: ${whisper}`);
|
|
114
|
+
state.lastPostCycleHygieneTurn = currentTurn;
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Register the post-cycle hygiene turn-end handler.
|
|
118
|
+
*
|
|
119
|
+
* Priority 1 (lowest — runs after all analysis, enforcement, and hygiene
|
|
120
|
+
* handlers). Only fires on text-only yields after work cycles.
|
|
121
|
+
*/
|
|
122
|
+
export function registerPostCycleHygiene(pi) {
|
|
123
|
+
registerTurnEndHandler("post-cycle-hygiene", 1, async (event, ctx) => {
|
|
124
|
+
try {
|
|
125
|
+
const state = getState(ctx);
|
|
126
|
+
if (!state?.enforcementActive)
|
|
127
|
+
return;
|
|
128
|
+
// Cooldown check
|
|
129
|
+
const currentTurn = state.currentTurn;
|
|
130
|
+
if (currentTurn - state.lastPostCycleHygieneTurn < HYGIENE_COOLDOWN_TURNS)
|
|
131
|
+
return;
|
|
132
|
+
if (!isWorkYield(ctx, event))
|
|
133
|
+
return;
|
|
134
|
+
performPostCycleHygiene(pi, ctx, event);
|
|
135
|
+
}
|
|
136
|
+
catch (err) {
|
|
137
|
+
log.error("post-cycle-hygiene error:", err);
|
|
138
|
+
}
|
|
139
|
+
});
|
|
140
|
+
log.debug("post-cycle-hygiene registered (priority 1) — auto-tags on yield, " +
|
|
141
|
+
`${HYGIENE_COOLDOWN_TURNS}-turn cooldown`);
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=register-post-cycle-hygiene.js.map
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-session-compact - Hygiene reset + re-orientation whisper after compaction.
|
|
3
|
+
*
|
|
4
|
+
* The re-orientation whisper honors whether the agent had already
|
|
5
|
+
* stopped naturally (lastTurnWasNaturalStop, set at turn_end). A natural stop
|
|
6
|
+
* gets an ADVISORY whisper (triggerTurn:false) so compaction does not force a
|
|
7
|
+
* fresh turn after the agent already finished; a mid-work turn keeps
|
|
8
|
+
* triggerTurn:true so compaction hands the loop back. See the deferred
|
|
9
|
+
* re-orientation whisper block below.
|
|
10
|
+
*
|
|
11
|
+
* Re-entrancy guard + deferred side-effects (added, see
|
|
12
|
+
* post-compaction stack overflow trace):
|
|
13
|
+
* The previous design called `callScratchpadTool` + `sendEnforcementWhisper`
|
|
14
|
+
* synchronously from the session_compact handler. A nested scratchpad tool
|
|
15
|
+
* invocation would fire `tool_call` / `tool_execution_end` synchronously,
|
|
16
|
+
* and the timer extension's `tool_execution_end` handler calls
|
|
17
|
+
* `fireExpired()` -- which can synchronously invoke `pi.sendMessage` with
|
|
18
|
+
* `triggerTurn: true` for any timer that expired at that exact moment.
|
|
19
|
+
* That synchronous chain can re-enter our handler (or other handlers) and
|
|
20
|
+
* overflow the V8 stack before the existing `MAX_REENTRY_DEPTH = 1` guard
|
|
21
|
+
* in `injection-tracker.ts` gets a chance to defer the second-level call.
|
|
22
|
+
*
|
|
23
|
+
* The fix has three layers:
|
|
24
|
+
* 1. Per-session `inHandler` flag (mirrors the `inBeforeAgentStart`
|
|
25
|
+
* pattern from context-lifecycle) bails early if session_compact
|
|
26
|
+
* fires twice synchronously.
|
|
27
|
+
* 2. The scratchpad read + whisper delivery side-effects are deferred
|
|
28
|
+
* via `setTimeout(0)` so the handler returns synchronously. The
|
|
29
|
+
* pi-core event dispatch then completes, the macrotask fires on
|
|
30
|
+
* the next event loop turn (stack fully unwound), and any
|
|
31
|
+
* pi.sendMessage calls happen on a fresh stack.
|
|
32
|
+
* 3. State writes (lastCompactionTurn, etc.) stay synchronous because
|
|
33
|
+
* downstream handlers (turn_end, message_end) read them.
|
|
34
|
+
*
|
|
35
|
+
* IMPORTANT: session_compact vs compaction_end
|
|
36
|
+
* Pi-core's session_compact event IS dispatched to extension handlers
|
|
37
|
+
* (via this._extensionRunner.emit()). The compaction_end event is emitted
|
|
38
|
+
* via this._emit() which only reaches internal listeners (TUI) — NOT
|
|
39
|
+
* extension handlers. So the re-orientation whisper MUST be delivered
|
|
40
|
+
* on session_compact. It fires during compaction (after LLM summarization,
|
|
41
|
+
* before bookkeeping/TUI rebuild), which is functionally equivalent to
|
|
42
|
+
* "after compaction completes" for the agent's purposes.
|
|
43
|
+
*
|
|
44
|
+
* See agent-session.js for the emit paths:
|
|
45
|
+
* - session_compact: _extensionRunner.emit() (lines 1417, 1660)
|
|
46
|
+
* - compaction_end: this._emit() (lines 1432, 1674)
|
|
47
|
+
*/
|
|
48
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
49
|
+
export declare function registerSessionCompactHandler(pi: ExtensionAPI): void;
|
|
50
|
+
//# sourceMappingURL=register-session-compact.d.ts.map
|