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,977 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Lifecycle Extension - S-MMU Active Context Management
|
|
3
|
+
*
|
|
4
|
+
* AUTOMATION layer that works WITH context-manager.
|
|
5
|
+
* NO new tools - uses existing context_navigate, context_compress, etc.
|
|
6
|
+
*
|
|
7
|
+
* R-CCAM-inspired loop:
|
|
8
|
+
* - Retrieval: Signal detection from session content
|
|
9
|
+
* - Cognition: Policy evaluation with governance
|
|
10
|
+
* - Control: Action selection with constraint checking
|
|
11
|
+
* - Action: Proposal injection or immediate execution
|
|
12
|
+
* - Memory: CustomEntry persistence with outcome tracking
|
|
13
|
+
*/
|
|
14
|
+
import { StringEnum } from "@earendil-works/pi-ai";
|
|
15
|
+
import { Type } from "typebox";
|
|
16
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
17
|
+
import { applyWhisperEnvelope } from "../../../lib/utils/whisper-format.js";
|
|
18
|
+
import { formatTokensK } from "../../../lib/detection/context-usage.js";
|
|
19
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
20
|
+
import * as path from "node:path";
|
|
21
|
+
import { braidDir, tagsSlugFromCwd } from "../../../lib/config/braid-paths.js";
|
|
22
|
+
import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
|
|
23
|
+
import { getExtensionState, getCachedSessionManager } from "../../../lib/state/extension-state.js";
|
|
24
|
+
import { getSessionManager } from "../../../lib/state/session-manager.js";
|
|
25
|
+
import { loadScratchpadFromDisk, projectSlugFromCwd } from "../../memory/scratchpad/persistence.js";
|
|
26
|
+
import { handleUpdateSession } from "../../memory/scratchpad/handlers.js";
|
|
27
|
+
import { eventBus } from "../../../lib/events/event-bus.js";
|
|
28
|
+
import { createProposal, createSnapshot, isProposalEntry, PROPOSAL_CUSTOM_TYPE, SNAPSHOT_CUSTOM_TYPE, } from "./types.js";
|
|
29
|
+
import { evaluatePolicies, generateDensitySignals } from "./policy-engine.js";
|
|
30
|
+
import { detectSignals, queueSignal, detectCompletionPattern } from "./signal-detector.js";
|
|
31
|
+
// Module State
|
|
32
|
+
const log = createLogger("context-lifecycle");
|
|
33
|
+
// Proposal rate limiting
|
|
34
|
+
const MAX_PROPOSALS_PER_TURN = 2;
|
|
35
|
+
const MAX_PROPOSALS_SESSION = 10;
|
|
36
|
+
// proposal real-need GATE + same-suggestion DEDUPE
|
|
37
|
+
// The benchmark measured context-lifecycle:proposal as the #1
|
|
38
|
+
// de-bloat target: 2,546 deliveries / 69,558 tokens at 4% acted-on, with
|
|
39
|
+
// 33% of deliveries being exact-repeat same-session bodies re-injected turn
|
|
40
|
+
// after turn. Two independent levers suppress that class at the single
|
|
41
|
+
// proposal-send chokepoint (queueProposal):
|
|
42
|
+
//
|
|
43
|
+
// GATE (fire only on real need): proposals triggered by PERSISTENT
|
|
44
|
+
// conditions (usage %, token counts, density) only fire when context
|
|
45
|
+
// state actually warrants them - usage above an actionable floor or a
|
|
46
|
+
// concrete compression signal present, the agent has NOT just acted on
|
|
47
|
+
// context, and the same suggestion class was not just declined.
|
|
48
|
+
// DEDUPE (never re-send a still-actionable suggestion): the same body ->
|
|
49
|
+
// same suggested tool is not re-sent within a session while the previous
|
|
50
|
+
// one is still actionable (pending, or delivered and not yet acted on).
|
|
51
|
+
//
|
|
52
|
+
// Each knob is a named constant so volume reduction and usefulness are
|
|
53
|
+
// independently adjustable, and urgency is preserved: a proposal whose usage
|
|
54
|
+
// crosses PROPOSAL_URGENT_USAGE (or is high-priority) bypasses both levers.
|
|
55
|
+
const PROPOSAL_ACTIONABLE_USAGE = 55; // [gate] below this %, advisory proposals = no real need (unless a density signal backs them)
|
|
56
|
+
// Token arm: the % floor is unreachable at
|
|
57
|
+
// a 1M window (20% ≈ 200k tokens) and a measured session fired ZERO
|
|
58
|
+
// high-context advisories across 154 turns at 150-238k tokens — persistent
|
|
59
|
+
// policies triggered on tokens but this gate suppressed them all. The gate
|
|
60
|
+
// now opens on EITHER arm: usage >= PROPOSAL_ACTIONABLE_USAGE OR tokens >=
|
|
61
|
+
// PROPOSAL_ACTIONABLE_TOKENS (min(percent, token) semantics).
|
|
62
|
+
const PROPOSAL_ACTIONABLE_TOKENS = USAGE_TOKENS_CRITICAL(); // [gate, tokens] either arm opens the gate (act arm, min(0.60W, 130k))
|
|
63
|
+
const PROPOSAL_ACTED_SUPPRESS_TURNS = 3; // [gate] quiet window after the agent acts on context (opportunity already taken)
|
|
64
|
+
const PROPOSAL_URGENT_USAGE = 75; // [gate] = USAGE_WHISPER_CRITICAL - genuinely urgent nudge bypasses gate + dedupe (keep urgency)
|
|
65
|
+
const PROPOSAL_URGENT_TOKENS = HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(); // [gate, tokens] hard-backstop band is urgent at any window
|
|
66
|
+
const PROPOSAL_DEDUPE_COOLDOWN_MS = 20 * 60 * 1000; // [dedupe] a delivered suggestion stays "in effect" this long (mirrors reprime)
|
|
67
|
+
const PROPOSAL_IGNORED_BACKOFF_TURNS = 8; // [dedupe/compliance, independent] after a same-class proposal was ignored, back off N turns
|
|
68
|
+
// Compaction Escalation Thresholds
|
|
69
|
+
// When the agent ignores 3+ compaction nudges at >=85% usage, auto-compact with timer.
|
|
70
|
+
const COMPACT_ESCALATION_THRESHOLD = 3;
|
|
71
|
+
const COMPACT_ESCALATION_USAGE = 85;
|
|
72
|
+
// Token constants for the ADVISORY path:
|
|
73
|
+
// single owner is lib/detection/context-thresholds.ts — import, never restate.
|
|
74
|
+
import { USAGE_TOKENS_CRITICAL, HYGIENE_AUTO_COMPACT_HARD_BACKSTOP, USAGE_TOKENS_ESCALATE, } from "../../../lib/detection/context-thresholds.js";
|
|
75
|
+
// Context management tools that count as "agent acted on compaction nudge"
|
|
76
|
+
const CONTEXT_MGMT_TOOLS = new Set([
|
|
77
|
+
"context_compress",
|
|
78
|
+
"context_inspect",
|
|
79
|
+
"context_navigate",
|
|
80
|
+
"context_proposals",
|
|
81
|
+
]);
|
|
82
|
+
// Policy engine + signal-detector state are per-session fields of
|
|
83
|
+
// ContextLifecycleState (see ./state.ts): each session starts with a fresh
|
|
84
|
+
// engine + detector. Access via `state(ctx).policyEngine` / `.detector`.
|
|
85
|
+
// Outcome tracking (closed-loop feedback) with TTL eviction, session-scoped
|
|
86
|
+
const MAX_OUTCOMES = 100;
|
|
87
|
+
const OUTCOME_TTL_MS = 30 * 60 * 1000;
|
|
88
|
+
// Outcome interface now lives in ./state.ts (extracted to break the state<->helpers cycle)
|
|
89
|
+
function evictOldOutcomes(s) {
|
|
90
|
+
const now = Date.now();
|
|
91
|
+
const before = s.outcomes.length;
|
|
92
|
+
while (s.outcomes.length > 0 && now - s.outcomes[0].timestamp > OUTCOME_TTL_MS) {
|
|
93
|
+
s.outcomes.shift();
|
|
94
|
+
}
|
|
95
|
+
while (s.outcomes.length > MAX_OUTCOMES) {
|
|
96
|
+
s.outcomes.shift();
|
|
97
|
+
}
|
|
98
|
+
if (s.outcomes.length < before) {
|
|
99
|
+
log.info(`Evicted ${before - s.outcomes.length} old outcomes`);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
// Note: turn_end handlers in this module use the session-scoped getState(ctx)
|
|
103
|
+
// pattern to read the latest state. Module-level `state()` is the fallback
|
|
104
|
+
// when ctx is not available.
|
|
105
|
+
import { state, resetState } from "./state.js";
|
|
106
|
+
// Note: state.ts types and functions are intentionally NOT re-exported.
|
|
107
|
+
// All consumers (this file, helpers.ts) access them via the import above.
|
|
108
|
+
// External callers should depend on `./state.js` directly if they need
|
|
109
|
+
// access to state types or functions. This removes the public-API surface
|
|
110
|
+
// area (it has zero external callers, so nothing depends on it).
|
|
111
|
+
// Schema
|
|
112
|
+
const contextProposalsSchema = Type.Object({
|
|
113
|
+
action: StringEnum(["list", "approve", "reject", "snapshots", "stats"]),
|
|
114
|
+
id: Type.Optional(Type.String({ description: "Proposal ID to approve/reject" })),
|
|
115
|
+
});
|
|
116
|
+
import { getContextUsage, getContextTokens, getAllEntries, getBranchEntries, readProposalsFromSession, readSnapshotsFromSession, formatDuration, interpolateMessage, proposalKeyFor, } from "./helpers.js";
|
|
117
|
+
// Re-export for backward compat
|
|
118
|
+
export { getContextUsage, getContextTokens, getAllEntries, getBranchEntries, readProposalsFromSession, readSnapshotsFromSession, formatDuration, interpolateMessage, proposalKeyFor, } from "./helpers.js";
|
|
119
|
+
// Action Execution
|
|
120
|
+
/**
|
|
121
|
+
* Send a compact nudge to the agent via tracked message. Shared by
|
|
122
|
+
* executeAction and the before_agent_start handler.
|
|
123
|
+
*/
|
|
124
|
+
function sendCompactNudge(pi, evaluated, usage, tokens) {
|
|
125
|
+
// Tag/branch is preferred over compaction - preserves session history
|
|
126
|
+
// while freeing working context.
|
|
127
|
+
// Advisory ladder (token arms; single owner context-thresholds.ts):
|
|
128
|
+
// >= USAGE_TOKENS_ESCALATE (0.85W) escalated wording (archive-or-handoff)
|
|
129
|
+
// >= HARD_BACKSTOP (0.90W) or usage >= 80 full pipeline message
|
|
130
|
+
// else light tag/checkout message
|
|
131
|
+
// Percent stays as the secondary trigger (sub-1M windows).
|
|
132
|
+
const tokensK = formatTokensK(tokens);
|
|
133
|
+
const pipelineMsg = tokens >= USAGE_TOKENS_ESCALATE()
|
|
134
|
+
? `Context at ${Math.round(usage)}% (~${tokensK} tokens). Escalated: archive the current phase with context_compress(action="archive"), or hand off to a fresh session (write a handoff note first).`
|
|
135
|
+
: usage >= 80 || tokens >= HYGIENE_AUTO_COMPACT_HARD_BACKSTOP()
|
|
136
|
+
? `Context at ${Math.round(usage)}% (~${tokensK} tokens). Pipeline: context_navigate(action="tag") -> context_navigate(action="checkout") -> context_compress(action="archive") -> context_compress(action="slide").`
|
|
137
|
+
: `Context at ${Math.round(usage)}% (~${tokensK} tokens). Tag with context_navigate(action="tag"), then context_navigate(action="checkout") to branch with a summary.`;
|
|
138
|
+
sendTrackedMessage(pi, {
|
|
139
|
+
customType: "context-lifecycle",
|
|
140
|
+
content: [
|
|
141
|
+
{
|
|
142
|
+
type: "text",
|
|
143
|
+
text: `${evaluated.policy.name} - ${pipelineMsg}`,
|
|
144
|
+
},
|
|
145
|
+
],
|
|
146
|
+
display: true,
|
|
147
|
+
details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "context-lifecycle/compact-suggestion" },
|
|
148
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/compact-suggestion" });
|
|
149
|
+
log.info(`Suggested compact: ${evaluated.policy.name} (context ${Math.round(usage)}%, ` +
|
|
150
|
+
`priority ${evaluated.policy.priority})`);
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* Execute auto-compaction.
|
|
154
|
+
* This is the escalation path: when the agent ignores compaction nudges,
|
|
155
|
+
* we auto-trigger compaction. The agent loop automatically continues after
|
|
156
|
+
* compaction completes (pi-core's _runAutoCompaction() returns `true` →
|
|
157
|
+
* agent.continue()). No resume timer is needed.
|
|
158
|
+
*/
|
|
159
|
+
async function executeAutoCompact(pi, ctx) {
|
|
160
|
+
try {
|
|
161
|
+
// 1. Cancel stale resume timers from previous compaction cycles
|
|
162
|
+
try {
|
|
163
|
+
// Cancel any stale resume timer from a previous compaction cycle
|
|
164
|
+
// (manual or auto). Without this, an old timer can fire later during
|
|
165
|
+
// an unrelated TURN_END and produce a stray [timer] whisper.
|
|
166
|
+
//
|
|
167
|
+
// CRITICAL: scope to current session - see the timer module for why:
|
|
168
|
+
// an unscoped timer map leaks across pi sessions.
|
|
169
|
+
const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "anonymous";
|
|
170
|
+
timerMod.cancelTimersByTag(sessionId, "compaction-resume");
|
|
171
|
+
timerMod.cancelTimersByTag(sessionId, "auto-compaction-resume");
|
|
172
|
+
// NOTE: no scheduleTimer() here — pi-core's agent loop automatically
|
|
173
|
+
// continues after compaction (_runAutoCompaction() returns `true` →
|
|
174
|
+
// agent.continue()); a fallback resume timer fires as spurious noise
|
|
175
|
+
// the agent ignores.
|
|
176
|
+
}
|
|
177
|
+
catch {
|
|
178
|
+
log.warn("Timer unavailable for auto-compaction - agent must type to resume");
|
|
179
|
+
}
|
|
180
|
+
// 2. Send visible notification
|
|
181
|
+
sendTrackedMessage(pi, {
|
|
182
|
+
customType: "context-lifecycle",
|
|
183
|
+
content: [
|
|
184
|
+
{
|
|
185
|
+
type: "text",
|
|
186
|
+
text: [
|
|
187
|
+
"## ⚡ Auto-compacting context",
|
|
188
|
+
"Compaction nudges were ignored. Auto-tagging then compacting to prevent overflow.",
|
|
189
|
+
'Use context_navigate(action="tag") proactively next time to avoid losing the completion summary.',
|
|
190
|
+
].join("\n"),
|
|
191
|
+
},
|
|
192
|
+
],
|
|
193
|
+
display: true,
|
|
194
|
+
details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "context-lifecycle/auto-compact" },
|
|
195
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/auto-compact" });
|
|
196
|
+
// 3. Trigger compaction (this aborts the agent loop, timer resumes later)
|
|
197
|
+
ctx.compact();
|
|
198
|
+
log.warn("Auto-compaction triggered (escalation path)");
|
|
199
|
+
}
|
|
200
|
+
catch (err) {
|
|
201
|
+
log.error("Auto-compaction failed:", err);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
function executeAction(evaluated, pi, ctx, usage, branchLength) {
|
|
205
|
+
const action = evaluated.action;
|
|
206
|
+
switch (action.type) {
|
|
207
|
+
case "compact":
|
|
208
|
+
if (evaluated.canExecute) {
|
|
209
|
+
// Advisory wording ladder also token-gated (see sendCompactNudge).
|
|
210
|
+
sendCompactNudge(pi, evaluated, usage, getContextTokens(ctx));
|
|
211
|
+
}
|
|
212
|
+
break;
|
|
213
|
+
case "snapshot":
|
|
214
|
+
if (evaluated.canExecute) {
|
|
215
|
+
const snapshot = createSnapshot(action.reason, branchLength, Math.round(usage * 2));
|
|
216
|
+
pi.appendEntry(SNAPSHOT_CUSTOM_TYPE, snapshot);
|
|
217
|
+
log.debug(`Created snapshot: ${snapshot.id}`);
|
|
218
|
+
}
|
|
219
|
+
break;
|
|
220
|
+
case "nudge":
|
|
221
|
+
if (evaluated.canExecute) {
|
|
222
|
+
const msg = interpolateMessage(action.message, ctx, evaluated.signal?.data);
|
|
223
|
+
// Non-critical context awareness - use hint, visible in TUI but no hidden turn
|
|
224
|
+
sendTrackedMessage(pi, {
|
|
225
|
+
customType: "context-lifecycle",
|
|
226
|
+
content: [{ type: "text", text: msg }],
|
|
227
|
+
display: true,
|
|
228
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/nudge" });
|
|
229
|
+
}
|
|
230
|
+
break;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
// proposal gate + dedupe helpers
|
|
234
|
+
/**
|
|
235
|
+
* True when an evaluated propose-action carries a concrete compression
|
|
236
|
+
* signal (density low / high / duplicates / redundancy). Presence of such a
|
|
237
|
+
* signal means there IS a real need even when usage % looks low.
|
|
238
|
+
*/
|
|
239
|
+
function hasConcreteCompressionSignal(evaluated) {
|
|
240
|
+
const t = evaluated.signal?.type;
|
|
241
|
+
return (t === "context_density_low" ||
|
|
242
|
+
t === "context_density_high" ||
|
|
243
|
+
t === "context_duplicates" ||
|
|
244
|
+
t === "redundancy_detected");
|
|
245
|
+
}
|
|
246
|
+
/**
|
|
247
|
+
* Proposals triggered by PERSISTENT conditions - usage %, token counts,
|
|
248
|
+
* density - stay true across turns, so the policy re-fires every cooldown
|
|
249
|
+
* with a fresh copy of the SAME advice ("Context at 55%. Consider archive").
|
|
250
|
+
* This is the measured 33% exact-repeat class. Event-triggered proposals
|
|
251
|
+
* (topic_shift, task_boundary, task_complexity, decision_density,
|
|
252
|
+
* task_completion_candidate) fire on discrete moments and are NOT this class
|
|
253
|
+
* - they skip the real-need gate but still pass through the dedupe.
|
|
254
|
+
*/
|
|
255
|
+
function isPersistentConditionProposal(evaluated) {
|
|
256
|
+
const trigger = evaluated.policy.trigger;
|
|
257
|
+
if (trigger.type === "context_usage" || trigger.type === "context_usage_tokens")
|
|
258
|
+
return true;
|
|
259
|
+
if (trigger.type === "signal") {
|
|
260
|
+
switch (trigger.signal) {
|
|
261
|
+
case "context_pressure":
|
|
262
|
+
case "context_density_low":
|
|
263
|
+
case "context_density_high":
|
|
264
|
+
case "context_duplicates":
|
|
265
|
+
case "redundancy_detected":
|
|
266
|
+
case "compaction_opportunity":
|
|
267
|
+
case "checkpoint_opportunity":
|
|
268
|
+
return true;
|
|
269
|
+
default:
|
|
270
|
+
return false;
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
return false;
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* Genuinely urgent nudge - bypasses the gate + dedupe so a critical
|
|
277
|
+
* compact/archive suggestion still lands with its current delivery behavior.
|
|
278
|
+
*/
|
|
279
|
+
function isUrgentProposal(evaluated, usage, tokens) {
|
|
280
|
+
if (evaluated.action.type === "propose" && evaluated.action.priority === "high")
|
|
281
|
+
return true;
|
|
282
|
+
// Urgent on EITHER arm — percent band (sub-1M windows) or the
|
|
283
|
+
// hard-backstop token band (any window).
|
|
284
|
+
if (usage >= PROPOSAL_URGENT_USAGE)
|
|
285
|
+
return true;
|
|
286
|
+
if (tokens >= PROPOSAL_URGENT_TOKENS)
|
|
287
|
+
return true;
|
|
288
|
+
const percent = evaluated.signal?.data?.percent ?? 0;
|
|
289
|
+
return evaluated.signal?.type === "context_pressure" && percent >= PROPOSAL_URGENT_USAGE;
|
|
290
|
+
}
|
|
291
|
+
/**
|
|
292
|
+
* Seed the per-session dedupe map from persisted proposals so a resumed /
|
|
293
|
+
* compacted session does not re-inject a suggestion that was already delivered
|
|
294
|
+
* (persisted custom_message entries are replayed into context). Runs once per
|
|
295
|
+
* session (lazy) - state is fresh on session_start.
|
|
296
|
+
*/
|
|
297
|
+
function ensureProposalKeysSeeded(ctx, existingProposals) {
|
|
298
|
+
const s = state(ctx);
|
|
299
|
+
if (s.proposalKeysSeeded)
|
|
300
|
+
return;
|
|
301
|
+
s.proposalKeysSeeded = true;
|
|
302
|
+
for (const p of existingProposals) {
|
|
303
|
+
const key = proposalKeyFor(p.message, p.suggested_action);
|
|
304
|
+
if (!s.proposalKeys.has(key)) {
|
|
305
|
+
s.proposalKeys.set(key, p.created_at);
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* Decide whether a candidate propose-action should be suppressed before it
|
|
311
|
+
* reaches the agent. Returns a human-readable reason string, or null to allow
|
|
312
|
+
* delivery. This is the SINGLE decision point for the proposal-noise class -
|
|
313
|
+
* both the real-need gate and the same-suggestion dedupe live here.
|
|
314
|
+
*/
|
|
315
|
+
function proposeSuppressionCause(ctx, evaluated, existingProposals, usage, tokens) {
|
|
316
|
+
if (evaluated.action.type !== "propose")
|
|
317
|
+
return null;
|
|
318
|
+
const s = state(ctx);
|
|
319
|
+
const now = Date.now();
|
|
320
|
+
const isUrgent = isUrgentProposal(evaluated, usage, tokens);
|
|
321
|
+
const key = proposalKeyFor(interpolateMessage(evaluated.action.message, ctx, evaluated.signal?.data), evaluated.policy.suggested_action);
|
|
322
|
+
// GATE: persistent-condition proposals need a real need
|
|
323
|
+
if (isPersistentConditionProposal(evaluated) && !isUrgent) {
|
|
324
|
+
// (a) No actionable need: usage below the floor AND no concrete
|
|
325
|
+
// compression signal backs this advisory re-fire.
|
|
326
|
+
// Token arm: either arm satisfies the floor (min(percent, token)).
|
|
327
|
+
if (usage < PROPOSAL_ACTIONABLE_USAGE &&
|
|
328
|
+
tokens < PROPOSAL_ACTIONABLE_TOKENS &&
|
|
329
|
+
!hasConcreteCompressionSignal(evaluated)) {
|
|
330
|
+
return "no-actionable-need";
|
|
331
|
+
}
|
|
332
|
+
// (b) Agent just acted on context - the opportunity was taken / is being
|
|
333
|
+
// handled; a fresh advisory would fight the action it just took.
|
|
334
|
+
if (s.lastContextActionTurn > 0 &&
|
|
335
|
+
s.turnCount - s.lastContextActionTurn <= PROPOSAL_ACTED_SUPPRESS_TURNS) {
|
|
336
|
+
return "agent-just-acted";
|
|
337
|
+
}
|
|
338
|
+
// (c) Compliance feedback: the agent declined this exact suggestion class
|
|
339
|
+
// via context_proposals reject - back off re-proposing it.
|
|
340
|
+
if (s.declinedKeys.has(key)) {
|
|
341
|
+
return "declined-same-class";
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
// DEDUPE: same suggestion must not re-send while still actionable
|
|
345
|
+
if (!isUrgent) {
|
|
346
|
+
// Persisted pending proposal of the same class = already delivered and
|
|
347
|
+
// unresolved (still actionable), and persisted entries are replayed into
|
|
348
|
+
// context on resume - re-sending would double-inject.
|
|
349
|
+
if (existingProposals.some((p) => !p.resolution && proposalKeyFor(p.message, p.suggested_action) === key)) {
|
|
350
|
+
return "proposal-pending";
|
|
351
|
+
}
|
|
352
|
+
// Session-hot: we delivered this class and the agent has not acted since
|
|
353
|
+
// (proposalKeys is cleared on action) - keep it suppressed for the window.
|
|
354
|
+
const lastSentAt = s.proposalKeys.get(key);
|
|
355
|
+
if (lastSentAt !== undefined && now - lastSentAt < PROPOSAL_DEDUPE_COOLDOWN_MS) {
|
|
356
|
+
return "repeat-session";
|
|
357
|
+
}
|
|
358
|
+
// Compliance feedback: a same-class suggestion was ignored recently
|
|
359
|
+
// (implicitly approved = agent never acted) - back off for an independent,
|
|
360
|
+
// session-scoped window so usefulness and volume are separately tunable.
|
|
361
|
+
const ignoredTurn = s.proposalIgnoredTurns.get(key);
|
|
362
|
+
if (ignoredTurn !== undefined && s.turnCount - ignoredTurn <= PROPOSAL_IGNORED_BACKOFF_TURNS) {
|
|
363
|
+
return "ignored-backoff";
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
return null;
|
|
367
|
+
}
|
|
368
|
+
async function queueProposal(evaluated, pi, ctx, branchLength) {
|
|
369
|
+
if (evaluated.action.type !== "propose")
|
|
370
|
+
return;
|
|
371
|
+
const action = evaluated.action;
|
|
372
|
+
const existingEntries = getAllEntries(ctx);
|
|
373
|
+
const existingProposals = readProposalsFromSession(existingEntries);
|
|
374
|
+
const usage = getContextUsage(ctx);
|
|
375
|
+
const tokens = getContextTokens(ctx);
|
|
376
|
+
// real-need GATE + same-suggestion DEDUPE
|
|
377
|
+
// Seed the per-session dedupe map from persisted proposals (resume /
|
|
378
|
+
// compaction replay must not re-inject), then decide in ONE place whether
|
|
379
|
+
// this candidate may reach the agent. Possible reasons:
|
|
380
|
+
// no-actionable-need / agent-just-acted / declined-same-class /
|
|
381
|
+
// proposal-pending / repeat-session / ignored-backoff
|
|
382
|
+
ensureProposalKeysSeeded(ctx, existingProposals);
|
|
383
|
+
const suppressReason = proposeSuppressionCause(ctx, evaluated, existingProposals, usage, tokens);
|
|
384
|
+
if (!suppressReason) {
|
|
385
|
+
// Rate limiting: only delivered proposals consume the caps
|
|
386
|
+
state(ctx).proposalsThisTurn++;
|
|
387
|
+
state(ctx).proposalsTotal++;
|
|
388
|
+
if (state(ctx).proposalsThisTurn > MAX_PROPOSALS_PER_TURN) {
|
|
389
|
+
log.debug(`Rate limited: ${state(ctx).proposalsThisTurn} proposals this turn (max ${MAX_PROPOSALS_PER_TURN})`);
|
|
390
|
+
}
|
|
391
|
+
else if (state(ctx).proposalsTotal > MAX_PROPOSALS_SESSION) {
|
|
392
|
+
log.debug(`Session limit reached: ${state(ctx).proposalsTotal} proposals (max ${MAX_PROPOSALS_SESSION})`);
|
|
393
|
+
}
|
|
394
|
+
else {
|
|
395
|
+
const proposal = createProposal("compact", interpolateMessage(action.message, ctx, evaluated.signal?.data), evaluated.policy.id, branchLength, action.priority, 0.7, evaluated.policy.suggested_action);
|
|
396
|
+
const sm = getCachedSessionManager(ctx);
|
|
397
|
+
// Apply the universal whisper envelope + [braid-whisper-end] marker to
|
|
398
|
+
// the proposal content array. appendCustomMessageEntry bypasses the
|
|
399
|
+
// sendTrackedMessage trunk, so the envelope must be applied here -- this
|
|
400
|
+
// is the sole call site for that channel. The end-marker is essential
|
|
401
|
+
// because the proposal is persisted as a custom_message entry and replayed
|
|
402
|
+
// into agent context on session resume/compaction: without it the agent
|
|
403
|
+
// has no unambiguous boundary for the suggestion body.
|
|
404
|
+
const proposalContent = [
|
|
405
|
+
{ type: "text", text: `Context Suggestion: ${proposal.message}` },
|
|
406
|
+
];
|
|
407
|
+
// The envelope source was "memory/context-lifecycle",
|
|
408
|
+
// whose first segment maps to `[braid-whisper - memory]` — misattributing
|
|
409
|
+
// these context-lifecycle proposal bodies to the memory family (114
|
|
410
|
+
// measured deliveries). The source must be the TRUE family, so the
|
|
411
|
+
// envelope says context-lifecycle.
|
|
412
|
+
applyWhisperEnvelope(proposalContent, "context-lifecycle/proposal");
|
|
413
|
+
sm?.appendCustomMessageEntry?.(PROPOSAL_CUSTOM_TYPE, proposalContent, true, proposal);
|
|
414
|
+
// Record the suggestion class so a repeat re-fire is suppressed while
|
|
415
|
+
// this one is still actionable (gate + dedupe rely on this map).
|
|
416
|
+
state(ctx).proposalKeys.set(proposalKeyFor(proposal.message, proposal.suggested_action), Date.now());
|
|
417
|
+
log.debug(`Created proposal: ${proposal.id}`);
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
else {
|
|
421
|
+
log.info(`Proposal suppressed (${suppressReason}) policy=${evaluated.policy.id} "${action.message.slice(0, 48)}"`);
|
|
422
|
+
}
|
|
423
|
+
// Phase boundary enforcement: upgrade topic_shift and task_boundary
|
|
424
|
+
// proposals to enforcement whispers with auto-tagging. This ensures the
|
|
425
|
+
// agent preserves context before switching between investigation,
|
|
426
|
+
// implementation, and verification phases.
|
|
427
|
+
if (evaluated.signal?.type === "topic_shift" || evaluated.signal?.type === "task_boundary") {
|
|
428
|
+
const signalType = evaluated.signal.type;
|
|
429
|
+
const signalData = evaluated.signal.data || {};
|
|
430
|
+
// Auto-tag current position
|
|
431
|
+
let tagName;
|
|
432
|
+
if (signalType === "topic_shift") {
|
|
433
|
+
const to = signalData.to || "next-phase";
|
|
434
|
+
tagName = `before-${to}`;
|
|
435
|
+
}
|
|
436
|
+
else {
|
|
437
|
+
tagName = `before-task-boundary`;
|
|
438
|
+
}
|
|
439
|
+
try {
|
|
440
|
+
const sessionManager = getSessionManager(ctx);
|
|
441
|
+
const leafId = sessionManager.getLeafId();
|
|
442
|
+
pi.setLabel(leafId, tagName);
|
|
443
|
+
log.info(`Auto-tagged position as "${tagName}" on ${signalType} signal`);
|
|
444
|
+
}
|
|
445
|
+
catch (err) {
|
|
446
|
+
log.debug(`Auto-tag failed (non-fatal): ${err}`);
|
|
447
|
+
}
|
|
448
|
+
// Auto-set SessionPhase in scratchpad when topic_shift is detected
|
|
449
|
+
if (signalType === "topic_shift") {
|
|
450
|
+
const to = signalData.to || "";
|
|
451
|
+
const phaseMap = {
|
|
452
|
+
exploration: "exploring",
|
|
453
|
+
implementation: "implementing",
|
|
454
|
+
verification: "verifying",
|
|
455
|
+
debugging: "debugging",
|
|
456
|
+
documentation: "documenting",
|
|
457
|
+
planning: "planning",
|
|
458
|
+
testing: "verifying",
|
|
459
|
+
refactoring: "implementing",
|
|
460
|
+
};
|
|
461
|
+
const newPhase = phaseMap[to];
|
|
462
|
+
if (newPhase) {
|
|
463
|
+
try {
|
|
464
|
+
const cwd = ctx.cwd ?? "";
|
|
465
|
+
const slug = projectSlugFromCwd(cwd);
|
|
466
|
+
const pad = await loadScratchpadFromDisk(slug);
|
|
467
|
+
if (pad) {
|
|
468
|
+
await handleUpdateSession(pad, { phase: newPhase, turn: state(ctx).turnCount });
|
|
469
|
+
log.info(`Auto-set scratchpad phase to "${newPhase}"`);
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
catch (err) {
|
|
473
|
+
log.debug(`Auto-set SessionPhase failed (non-fatal): ${err}`);
|
|
474
|
+
}
|
|
475
|
+
}
|
|
476
|
+
}
|
|
477
|
+
// Send enforcement whisper with triggerTurn to wake the agent
|
|
478
|
+
const msg = signalType === "topic_shift"
|
|
479
|
+
? `**Phase transition detected:** from "${signalData.from || "previous"}" to "${signalData.to || "next"}".\n\n` +
|
|
480
|
+
`Auto-tagged position as \`${tagName}\`. Use \`context_navigate(action="checkout", target="${tagName}")\` to return to this point.\n\n` +
|
|
481
|
+
`Update your scratchpad phase: \`scratchpad(action="update_session", phase="${signalData.to || "implementing"}")\`.\n\n` +
|
|
482
|
+
`Consider archiving the previous phase with \`context_compress(action="archive", topic="${signalData.from || "previous"}")\` to free context.`
|
|
483
|
+
: `**Task boundary detected** (explore → implement → verify pattern).\n\n` +
|
|
484
|
+
`Auto-tagged position as \`${tagName}\`. Consider archiving the current phase with \`context_compress(action="archive")\` before proceeding.`;
|
|
485
|
+
sendTrackedMessage(pi, {
|
|
486
|
+
customType: "context-lifecycle",
|
|
487
|
+
content: [{ type: "text", text: msg }],
|
|
488
|
+
display: true,
|
|
489
|
+
}, { deliverAs: "steer", triggerTurn: true }, { type: "context", source: "context-lifecycle/phase-boundary-enforcement" });
|
|
490
|
+
// Track navigation whisper for escalation monitoring
|
|
491
|
+
state(ctx).lastNavigationWhisperTurn = state(ctx).turnCount;
|
|
492
|
+
}
|
|
493
|
+
}
|
|
494
|
+
// Extension Factory
|
|
495
|
+
import { clearInjections, sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
496
|
+
import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
|
|
497
|
+
import { TOOL_CALL } from "../../../lib/core/event-names.js";
|
|
498
|
+
import * as timerMod from "../../scheduling/timer/index.js";
|
|
499
|
+
export default function contextLifecycleExtension(pi) {
|
|
500
|
+
// session_start
|
|
501
|
+
registerSessionStartHandler(pi, SessionPhase.MemoryState, async (_event, ctx) => {
|
|
502
|
+
resetState(ctx);
|
|
503
|
+
// state(ctx) is fresh per session; the policy
|
|
504
|
+
// engine and signal detector live inside the per-session state, so
|
|
505
|
+
// no manual reset is needed for them. clearInjections() is a
|
|
506
|
+
// process-global tracker (see lib/utils/injection-tracker.ts) and
|
|
507
|
+
// must be cleared explicitly on session boundaries.
|
|
508
|
+
state(ctx).outcomes.length = 0;
|
|
509
|
+
clearInjections();
|
|
510
|
+
});
|
|
511
|
+
// Subscribe to memory_evict events to adjust compact nudge escalation
|
|
512
|
+
eventBus.on("memory_evict", (event) => {
|
|
513
|
+
log.debug(`[context-lifecycle] Memory eviction: ${event.reason} (${event.count} entries)`);
|
|
514
|
+
// Large evictions increase compact urgency for the next proposal check
|
|
515
|
+
if (event.count > 5) {
|
|
516
|
+
const s = state();
|
|
517
|
+
s.ignoredCompactNudges = Math.min(5, s.ignoredCompactNudges + 1);
|
|
518
|
+
}
|
|
519
|
+
});
|
|
520
|
+
// before_agent_start
|
|
521
|
+
// R-CCAM loop: Retrieval -> Cognition -> Control -> Action
|
|
522
|
+
pi.on("before_agent_start", async (_event, ctx) => {
|
|
523
|
+
// RE-ENTRANCY GUARD
|
|
524
|
+
// If sendTrackedMessage -> pi.sendMessage(steer) fires before_agent_start
|
|
525
|
+
// synchronously, prevent unbounded recursion. Without this guard, a
|
|
526
|
+
// nudge that triggers a steer can create a loop:
|
|
527
|
+
// before_agent_start -> sendCompactNudge -> sendTrackedMessage ->
|
|
528
|
+
// pi.sendMessage(steer) -> before_agent_start -> ... (stack overflow)
|
|
529
|
+
const reentrancy = getExtensionState(ctx, "context-lifecycle/reentrancy", () => ({
|
|
530
|
+
inBeforeAgentStart: false,
|
|
531
|
+
}));
|
|
532
|
+
if (reentrancy.inBeforeAgentStart) {
|
|
533
|
+
log.warn("Re-entrant before_agent_start detected - skipping to prevent stack overflow");
|
|
534
|
+
return;
|
|
535
|
+
}
|
|
536
|
+
reentrancy.inBeforeAgentStart = true;
|
|
537
|
+
try {
|
|
538
|
+
state(ctx).turnCount++;
|
|
539
|
+
state(ctx).proposalsThisTurn = 0; // Reset per-turn counter
|
|
540
|
+
// Evict old outcomes on each turn (sliding window TTL)
|
|
541
|
+
evictOldOutcomes(state(ctx));
|
|
542
|
+
const usage = getContextUsage(ctx);
|
|
543
|
+
const entries = getAllEntries(ctx);
|
|
544
|
+
const branch = getBranchEntries(ctx);
|
|
545
|
+
// COMPACTION ESCALATION CHECK
|
|
546
|
+
// If we sent a compact nudge last turn and the agent didn't use any
|
|
547
|
+
// context management tool, increment the ignored counter.
|
|
548
|
+
// If they DID use a tool, reset the counter.
|
|
549
|
+
if (state(ctx).compactNudgeActive) {
|
|
550
|
+
if (state(ctx).agentActedOnContext) {
|
|
551
|
+
state(ctx).ignoredCompactNudges = 0;
|
|
552
|
+
state(ctx).compactNudgeActive = false;
|
|
553
|
+
log.debug("Compact nudge acknowledged - agent used a context management tool");
|
|
554
|
+
}
|
|
555
|
+
else if (state(ctx).turnCount - state(ctx).lastCompactNudgeTurn > 0) {
|
|
556
|
+
// Agent had a turn to respond but didn't act
|
|
557
|
+
state(ctx).ignoredCompactNudges++;
|
|
558
|
+
log.info(`Compact nudge ignored (${state(ctx).ignoredCompactNudges}/${COMPACT_ESCALATION_THRESHOLD}) ` +
|
|
559
|
+
`usage=${usage.toFixed(0)}%`);
|
|
560
|
+
}
|
|
561
|
+
}
|
|
562
|
+
// NAVIGATION PROPOSAL ESCALATION
|
|
563
|
+
// Mirror the compaction escalation pattern: if the agent ignores
|
|
564
|
+
// navigation enforcement whispers, increment the count and escalate.
|
|
565
|
+
// The enforcement whisper is sent from queueProposal() with triggerTurn.
|
|
566
|
+
// If the agent ignores 3+ whispers, auto-tag and send a stronger message.
|
|
567
|
+
if (state(ctx).lastNavigationWhisperTurn > 0) {
|
|
568
|
+
if (state(ctx).agentActedOnContext) {
|
|
569
|
+
state(ctx).ignoredNavigationProposals = 0;
|
|
570
|
+
log.debug("Navigation proposal acknowledged - agent used a context management tool");
|
|
571
|
+
}
|
|
572
|
+
else if (state(ctx).turnCount - state(ctx).lastNavigationWhisperTurn > 0) {
|
|
573
|
+
state(ctx).ignoredNavigationProposals++;
|
|
574
|
+
log.info(`Navigation proposal ignored (${state(ctx).ignoredNavigationProposals}/3)`);
|
|
575
|
+
// Escalate: after 3 ignored proposals, auto-tag and send stronger whisper
|
|
576
|
+
if (state(ctx).ignoredNavigationProposals >= 3) {
|
|
577
|
+
state(ctx).ignoredNavigationProposals = 0;
|
|
578
|
+
state(ctx).lastNavigationWhisperTurn = 0;
|
|
579
|
+
// Auto-tag position
|
|
580
|
+
try {
|
|
581
|
+
const sm = getSessionManager(ctx);
|
|
582
|
+
const leafId = sm.getLeafId();
|
|
583
|
+
pi.setLabel(leafId, `auto-tag-${state(ctx).turnCount}`);
|
|
584
|
+
log.info(`Auto-tagged position on escalation (turn ${state(ctx).turnCount})`);
|
|
585
|
+
}
|
|
586
|
+
catch {
|
|
587
|
+
// Session manager may be detached mid-escalation; the tag is
|
|
588
|
+
// cosmetic — navigation still works untagged.
|
|
589
|
+
}
|
|
590
|
+
sendTrackedMessage(pi, {
|
|
591
|
+
customType: "context-lifecycle",
|
|
592
|
+
content: [
|
|
593
|
+
{
|
|
594
|
+
type: "text",
|
|
595
|
+
text: `## ⚡ Navigation enforcement escalated\n\n` +
|
|
596
|
+
`Navigation proposals were ignored ${COMPACT_ESCALATION_THRESHOLD} times. ` +
|
|
597
|
+
`Auto-tagged current position.\n\n` +
|
|
598
|
+
`Use \`context_compress(action="archive")\` to free context before continuing.\n` +
|
|
599
|
+
`Use \`context_navigate(action="checkout", target="auto-tag-${state(ctx).turnCount}")\` to return to this point.`,
|
|
600
|
+
},
|
|
601
|
+
],
|
|
602
|
+
display: true,
|
|
603
|
+
}, { deliverAs: "steer", triggerTurn: true }, { type: "context", source: "context-lifecycle/navigation-escalation" });
|
|
604
|
+
}
|
|
605
|
+
}
|
|
606
|
+
}
|
|
607
|
+
state(ctx).agentActedOnContext = false;
|
|
608
|
+
// RETRIEVAL: Detect signals from session content
|
|
609
|
+
const s = state(ctx);
|
|
610
|
+
const signals = await detectSignals(s.detector, entries, ctx, usage);
|
|
611
|
+
// DENSITY: Generate context density signals (SimpleMem 2601.02553)
|
|
612
|
+
// These feed into density-aware policies (prune, compress, dedup)
|
|
613
|
+
const densitySignals = generateDensitySignals(ctx);
|
|
614
|
+
if (densitySignals.length > 0) {
|
|
615
|
+
signals.push(...densitySignals);
|
|
616
|
+
}
|
|
617
|
+
// COGNITION: Evaluate policies against signals
|
|
618
|
+
const redundancyCount = signals.filter((s) => s.type === "redundancy_detected").length;
|
|
619
|
+
// TASK COMPLETION DETECTION
|
|
620
|
+
if (detectCompletionPattern(s.detector)) {
|
|
621
|
+
queueSignal(s.detector, "task_completion_candidate", {
|
|
622
|
+
topicHistory: s.detector.topicHistory.slice(-3),
|
|
623
|
+
uniqueTools: new Set(s.detector.toolSequence.slice(-10)).size,
|
|
624
|
+
});
|
|
625
|
+
}
|
|
626
|
+
const completionSignals = [...s.detector.pendingSignals];
|
|
627
|
+
s.detector.pendingSignals = [];
|
|
628
|
+
if (completionSignals.length > 0) {
|
|
629
|
+
signals.push(...completionSignals);
|
|
630
|
+
}
|
|
631
|
+
const evaluated = evaluatePolicies(s.policyEngine, {
|
|
632
|
+
signals,
|
|
633
|
+
contextUsage: usage,
|
|
634
|
+
contextTokens: getContextTokens(ctx),
|
|
635
|
+
turnCount: branch.length,
|
|
636
|
+
redundancyCount,
|
|
637
|
+
});
|
|
638
|
+
// CONTROL: Validate and select actions
|
|
639
|
+
for (const ev of evaluated) {
|
|
640
|
+
if (!ev.validation.valid) {
|
|
641
|
+
log.warn(`Governance blocked: ${ev.validation.messages.join(", ")}`);
|
|
642
|
+
}
|
|
643
|
+
else if (ev.validation.severity === "warn") {
|
|
644
|
+
log.warn(`Governance warning: ${ev.validation.messages.join(", ")}`);
|
|
645
|
+
}
|
|
646
|
+
// ACTION: Execute or queue
|
|
647
|
+
if (ev.action.type === "propose") {
|
|
648
|
+
await queueProposal(ev, pi, ctx, branch.length);
|
|
649
|
+
}
|
|
650
|
+
else if (ev.action.type === "compact" && ev.canExecute) {
|
|
651
|
+
// ESCALATION GATE
|
|
652
|
+
// If the agent has ignored 3+ compaction nudges and context is
|
|
653
|
+
// still above 85%, auto-compact with a pre-scheduled resume timer.
|
|
654
|
+
// This avoids the mid-task overflow death spiral (scenario 2.2).
|
|
655
|
+
if (state(ctx).ignoredCompactNudges >= COMPACT_ESCALATION_THRESHOLD &&
|
|
656
|
+
usage >= COMPACT_ESCALATION_USAGE) {
|
|
657
|
+
log.warn(`Escalating: auto-compacting (${state(ctx).ignoredCompactNudges} ignored nudges, ` +
|
|
658
|
+
`usage=${usage.toFixed(0)}%)`);
|
|
659
|
+
await executeAutoCompact(pi, ctx);
|
|
660
|
+
state(ctx).ignoredCompactNudges = 0;
|
|
661
|
+
state(ctx).compactNudgeActive = false;
|
|
662
|
+
}
|
|
663
|
+
else {
|
|
664
|
+
// Normal: send compact nudge
|
|
665
|
+
sendCompactNudge(pi, ev, usage, getContextTokens(ctx));
|
|
666
|
+
state(ctx).compactNudgeActive = true;
|
|
667
|
+
state(ctx).lastCompactNudgeTurn = state(ctx).turnCount;
|
|
668
|
+
state(ctx).lastCompactNudgeUsage = usage;
|
|
669
|
+
}
|
|
670
|
+
}
|
|
671
|
+
else {
|
|
672
|
+
executeAction(ev, pi, ctx, usage, branch.length);
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
// MEMORY: Track implicit approvals
|
|
676
|
+
const proposalEntries = entries.filter(isProposalEntry);
|
|
677
|
+
for (const entry of proposalEntries) {
|
|
678
|
+
const proposal = entry.details;
|
|
679
|
+
if (proposal?.resolution)
|
|
680
|
+
continue;
|
|
681
|
+
if (Date.now() - proposal.created_at > 120_000) {
|
|
682
|
+
proposal.resolution = "implicit_approved";
|
|
683
|
+
proposal.resolved_at = Date.now();
|
|
684
|
+
state(ctx).proposalsByEntryId.set(entry.id, proposal);
|
|
685
|
+
// Track outcome for closed-loop feedback
|
|
686
|
+
state(ctx).outcomes.push({
|
|
687
|
+
proposalId: proposal.id,
|
|
688
|
+
resolution: "implicit_approved",
|
|
689
|
+
turnsToResolve: state(ctx).turnCount - proposal.turn,
|
|
690
|
+
timestamp: Date.now(),
|
|
691
|
+
});
|
|
692
|
+
// A same-class suggestion the agent never acted on
|
|
693
|
+
// was implicitly approved = ignored. Record the class so the
|
|
694
|
+
// compliance-feedback backoff suppresses re-proposing it for
|
|
695
|
+
// PROPOSAL_IGNORED_BACKOFF_TURNS.
|
|
696
|
+
state(ctx).proposalIgnoredTurns.set(proposalKeyFor(proposal.message, proposal.suggested_action), state(ctx).turnCount);
|
|
697
|
+
}
|
|
698
|
+
}
|
|
699
|
+
}
|
|
700
|
+
finally {
|
|
701
|
+
reentrancy.inBeforeAgentStart = false;
|
|
702
|
+
}
|
|
703
|
+
});
|
|
704
|
+
// tool_call: Capture agent signals + compaction escalation reset
|
|
705
|
+
pi.on(TOOL_CALL, async (event, ctx) => {
|
|
706
|
+
const toolName = event.toolName;
|
|
707
|
+
// Task boundary signals
|
|
708
|
+
const detectorState = state(ctx).detector;
|
|
709
|
+
if (toolName === "context_navigate") {
|
|
710
|
+
const action = event.input?.action;
|
|
711
|
+
if (action === "tag") {
|
|
712
|
+
queueSignal(detectorState, "task_boundary", { action: "tag", target: toolName });
|
|
713
|
+
}
|
|
714
|
+
else if (action === "checkout") {
|
|
715
|
+
queueSignal(detectorState, "task_boundary", { action: "checkout" });
|
|
716
|
+
}
|
|
717
|
+
}
|
|
718
|
+
else if (toolName === "context_compress") {
|
|
719
|
+
const action = event.input?.action;
|
|
720
|
+
if (action === "archive" || action === "compact") {
|
|
721
|
+
queueSignal(detectorState, "task_boundary", { action: "compress" });
|
|
722
|
+
}
|
|
723
|
+
}
|
|
724
|
+
// Compaction escalation reset
|
|
725
|
+
// If the agent calls any context management tool, the compaction nudge
|
|
726
|
+
// is considered "acted upon" and we reset the escalation counter.
|
|
727
|
+
if (CONTEXT_MGMT_TOOLS.has(toolName)) {
|
|
728
|
+
state(ctx).agentActedOnContext = true;
|
|
729
|
+
state(ctx).ignoredCompactNudges = 0;
|
|
730
|
+
state(ctx).compactNudgeActive = false;
|
|
731
|
+
state(ctx).ignoredNavigationProposals = 0;
|
|
732
|
+
// The agent acted on a context suggestion — re-arm
|
|
733
|
+
// the proposal dedupe (the actionable suggestions are no longer
|
|
734
|
+
// pending) and remember the turn so recently-acting suppresses fresh
|
|
735
|
+
// advisory proposals instead of fighting the action just taken.
|
|
736
|
+
state(ctx).proposalKeys.clear();
|
|
737
|
+
state(ctx).lastContextActionTurn = state(ctx).turnCount;
|
|
738
|
+
log.debug(`Context management tool "${toolName}" called - reset compaction and navigation escalation`);
|
|
739
|
+
}
|
|
740
|
+
// Auto-navigate back to investigation checkpoint
|
|
741
|
+
// When the agent finalizes a task, check if there are tagged checkpoints
|
|
742
|
+
// from the investigation phase and suggest navigating back.
|
|
743
|
+
if (toolName === "finalize") {
|
|
744
|
+
try {
|
|
745
|
+
const sm = getSessionManager(ctx);
|
|
746
|
+
const branch = sm.getBranch();
|
|
747
|
+
const tags = [];
|
|
748
|
+
for (const entry of branch) {
|
|
749
|
+
try {
|
|
750
|
+
const label = sm.getLabel(entry.id);
|
|
751
|
+
if (label && label.startsWith("before-")) {
|
|
752
|
+
tags.push(label);
|
|
753
|
+
}
|
|
754
|
+
}
|
|
755
|
+
catch {
|
|
756
|
+
// entry may not have a label
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
const cwd = ctx.cwd ?? "";
|
|
760
|
+
const slug = tagsSlugFromCwd(cwd);
|
|
761
|
+
const tagsFile = path.join(braidDir(), "tags", `${slug}.json`);
|
|
762
|
+
let fileTags = [];
|
|
763
|
+
try {
|
|
764
|
+
if (existsSync(tagsFile)) {
|
|
765
|
+
const content = readFileSync(tagsFile, "utf-8");
|
|
766
|
+
fileTags = Object.keys(JSON.parse(content)).filter((t) => t.startsWith("before-"));
|
|
767
|
+
}
|
|
768
|
+
}
|
|
769
|
+
catch {
|
|
770
|
+
// Corrupt/absent tags file — proposal merge proceeds with session
|
|
771
|
+
// tags only; nothing durable is at risk.
|
|
772
|
+
}
|
|
773
|
+
const allTags = [...new Set([...tags, ...fileTags])];
|
|
774
|
+
if (allTags.length > 0) {
|
|
775
|
+
const tagList = allTags
|
|
776
|
+
.slice(0, 3)
|
|
777
|
+
.map((t) => `\`${t}\``)
|
|
778
|
+
.join(", ");
|
|
779
|
+
sendTrackedMessage(pi, {
|
|
780
|
+
customType: "context-lifecycle",
|
|
781
|
+
content: [
|
|
782
|
+
{
|
|
783
|
+
type: "text",
|
|
784
|
+
text: `Task finalized. Previous investigation checkpoints found: ${tagList}.\n\n` +
|
|
785
|
+
`Navigate back to review: \`context_navigate(action="checkout", target="${allTags[0]}")\`\n` +
|
|
786
|
+
`Use \`context_compress(action="archive")\` to free context before starting the next phase.`,
|
|
787
|
+
},
|
|
788
|
+
],
|
|
789
|
+
display: true,
|
|
790
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/navigate-back-suggestion" });
|
|
791
|
+
log.info(`Suggested navigating back to checkpoint: ${allTags[0]}`);
|
|
792
|
+
}
|
|
793
|
+
}
|
|
794
|
+
catch {
|
|
795
|
+
// Suggestion path is advisory steering; a missing checkpoint target
|
|
796
|
+
// must not fail the escalation flow that produced it.
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
});
|
|
800
|
+
// Proposals Tool
|
|
801
|
+
pi.registerTool({
|
|
802
|
+
name: "context_proposals",
|
|
803
|
+
exposure: "deferred",
|
|
804
|
+
label: "Context Proposals",
|
|
805
|
+
promptSnippet: "View and manage auto-generated context proposals",
|
|
806
|
+
description: "List, approve, or reject auto-generated context proposals (pending compaction/archive suggestions).",
|
|
807
|
+
parameters: contextProposalsSchema,
|
|
808
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
|
|
809
|
+
const entries = getAllEntries(ctx);
|
|
810
|
+
const proposals = readProposalsFromSession(entries);
|
|
811
|
+
const pending = proposals.filter((p) => !p.resolution);
|
|
812
|
+
const snapshots = readSnapshotsFromSession(entries);
|
|
813
|
+
switch (params.action) {
|
|
814
|
+
case "list": {
|
|
815
|
+
if (pending.length === 0) {
|
|
816
|
+
return {
|
|
817
|
+
content: [{ type: "text", text: "[v] No pending proposals." }],
|
|
818
|
+
details: { pending: 0 },
|
|
819
|
+
};
|
|
820
|
+
}
|
|
821
|
+
const lines = pending.map((p) => {
|
|
822
|
+
const age = Date.now() - p.created_at;
|
|
823
|
+
const icon = p.priority === "high" ? "[high]" : p.priority === "medium" ? "[med]" : "[low]";
|
|
824
|
+
return `${icon} **${p.id}** (${p.priority}) ${p.message}\n └─ ${formatDuration(age)} ago`;
|
|
825
|
+
});
|
|
826
|
+
return {
|
|
827
|
+
content: [
|
|
828
|
+
{
|
|
829
|
+
type: "text",
|
|
830
|
+
text: `## Pending Proposals (${pending.length})\n\n${lines.join("\n\n")}\n\nUse context_proposals(action="approve", id="<id>") or the suggested tool.`,
|
|
831
|
+
},
|
|
832
|
+
],
|
|
833
|
+
details: { pending: pending.length, proposals },
|
|
834
|
+
};
|
|
835
|
+
}
|
|
836
|
+
case "approve": {
|
|
837
|
+
const id = params.id;
|
|
838
|
+
if (!id) {
|
|
839
|
+
return {
|
|
840
|
+
content: [{ type: "text", text: "Proposal ID required." }],
|
|
841
|
+
details: { error: "missing_id" },
|
|
842
|
+
};
|
|
843
|
+
}
|
|
844
|
+
const proposal = pending.find((p) => p.id === id);
|
|
845
|
+
if (!proposal) {
|
|
846
|
+
return {
|
|
847
|
+
content: [{ type: "text", text: `Proposal ${id} not found.` }],
|
|
848
|
+
details: { error: "not_found" },
|
|
849
|
+
};
|
|
850
|
+
}
|
|
851
|
+
proposal.resolution = "approved";
|
|
852
|
+
proposal.resolved_at = Date.now();
|
|
853
|
+
state(ctx).proposalsByEntryId.set(id, proposal);
|
|
854
|
+
state(ctx).outcomes.push({
|
|
855
|
+
proposalId: id,
|
|
856
|
+
resolution: "approved",
|
|
857
|
+
turnsToResolve: state(ctx).turnCount - proposal.turn,
|
|
858
|
+
timestamp: Date.now(),
|
|
859
|
+
});
|
|
860
|
+
return {
|
|
861
|
+
content: [
|
|
862
|
+
{ type: "text", text: `[v] Approved **${id}**: ${proposal.message}` },
|
|
863
|
+
],
|
|
864
|
+
details: {
|
|
865
|
+
approved: id,
|
|
866
|
+
proposal,
|
|
867
|
+
nextStep: { tool: "context_inspect", detail: "quick" },
|
|
868
|
+
},
|
|
869
|
+
};
|
|
870
|
+
}
|
|
871
|
+
case "reject": {
|
|
872
|
+
const id = params.id;
|
|
873
|
+
if (!id) {
|
|
874
|
+
return {
|
|
875
|
+
content: [{ type: "text", text: "Proposal ID required." }],
|
|
876
|
+
details: { error: "missing_id" },
|
|
877
|
+
};
|
|
878
|
+
}
|
|
879
|
+
const proposal = pending.find((p) => p.id === id);
|
|
880
|
+
if (!proposal) {
|
|
881
|
+
return {
|
|
882
|
+
content: [{ type: "text", text: `Proposal ${id} not found.` }],
|
|
883
|
+
details: { error: "not_found" },
|
|
884
|
+
};
|
|
885
|
+
}
|
|
886
|
+
proposal.resolution = "rejected";
|
|
887
|
+
proposal.resolved_at = Date.now();
|
|
888
|
+
state(ctx).proposalsByEntryId.set(id, proposal);
|
|
889
|
+
state(ctx).outcomes.push({
|
|
890
|
+
proposalId: id,
|
|
891
|
+
resolution: "rejected",
|
|
892
|
+
turnsToResolve: state(ctx).turnCount - proposal.turn,
|
|
893
|
+
timestamp: Date.now(),
|
|
894
|
+
});
|
|
895
|
+
// Remember that this suggestion class was declined
|
|
896
|
+
// so the real-need gate backs off re-proposing it (compliance
|
|
897
|
+
// feedback) for the rest of the session.
|
|
898
|
+
state(ctx).declinedKeys.add(proposalKeyFor(proposal.message, proposal.suggested_action));
|
|
899
|
+
return {
|
|
900
|
+
content: [{ type: "text", text: `[x] Rejected **${id}**.` }],
|
|
901
|
+
details: { rejected: id },
|
|
902
|
+
};
|
|
903
|
+
}
|
|
904
|
+
case "snapshots": {
|
|
905
|
+
if (snapshots.length === 0) {
|
|
906
|
+
return {
|
|
907
|
+
content: [{ type: "text", text: "No snapshots available." }],
|
|
908
|
+
details: { count: 0 },
|
|
909
|
+
};
|
|
910
|
+
}
|
|
911
|
+
const lines = snapshots.slice(0, 10).map((s) => {
|
|
912
|
+
const expiresIn = s.expires_at - Date.now();
|
|
913
|
+
return `- **${s.id}** (turn ${s.turn}) ${s.reason} | expires in ${formatDuration(expiresIn)}`;
|
|
914
|
+
});
|
|
915
|
+
return {
|
|
916
|
+
content: [
|
|
917
|
+
{
|
|
918
|
+
type: "text",
|
|
919
|
+
text: `## Snapshots (${snapshots.length})\n\n${lines.join("\n\n")}`,
|
|
920
|
+
},
|
|
921
|
+
],
|
|
922
|
+
details: { count: snapshots.length, snapshots },
|
|
923
|
+
};
|
|
924
|
+
}
|
|
925
|
+
case "stats": {
|
|
926
|
+
// Policies, governance, topicHistory come
|
|
927
|
+
// from the per-session state via state(ctx).policyEngine /
|
|
928
|
+
// state(ctx).detector. Each session sees its own engine.
|
|
929
|
+
const ctxState = state(ctx);
|
|
930
|
+
const policies = ctxState.policyEngine.policies;
|
|
931
|
+
const governance = ctxState.policyEngine.governance;
|
|
932
|
+
const total = ctxState.outcomes.length;
|
|
933
|
+
const approved = ctxState.outcomes.filter((o) => o.resolution === "approved" || o.resolution === "implicit_approved").length;
|
|
934
|
+
const avgTurns = total > 0 ? ctxState.outcomes.reduce((sum, o) => sum + o.turnsToResolve, 0) / total : 0;
|
|
935
|
+
return {
|
|
936
|
+
content: [
|
|
937
|
+
{
|
|
938
|
+
type: "text",
|
|
939
|
+
text: [
|
|
940
|
+
"## S-MMU Statistics",
|
|
941
|
+
`**Session:** ${ctxState.turnCount} turns | ${formatDuration(Date.now() - ctxState.sessionStartMs)}`,
|
|
942
|
+
`**Proposals:** ${pending.length} pending, ${proposals.filter((p) => p.resolution).length} resolved`,
|
|
943
|
+
`**Outcomes:** ${approved}/${total} approved (${avgTurns.toFixed(1)} turns avg)`,
|
|
944
|
+
`**Policies:** ${policies.length} active`,
|
|
945
|
+
`**Governance:** ${governance.length} constraints`,
|
|
946
|
+
"",
|
|
947
|
+
"### Topic History",
|
|
948
|
+
...ctxState.detector.topicHistory
|
|
949
|
+
.slice(-5)
|
|
950
|
+
.map((h) => `- Turn ${h.turn}: ${h.topic}`),
|
|
951
|
+
].join("\n"),
|
|
952
|
+
},
|
|
953
|
+
],
|
|
954
|
+
details: {
|
|
955
|
+
turns: ctxState.turnCount,
|
|
956
|
+
proposals,
|
|
957
|
+
outcomes: ctxState.outcomes,
|
|
958
|
+
policies,
|
|
959
|
+
governance,
|
|
960
|
+
topicHistory: ctxState.detector.topicHistory,
|
|
961
|
+
},
|
|
962
|
+
};
|
|
963
|
+
}
|
|
964
|
+
default:
|
|
965
|
+
return {
|
|
966
|
+
content: [{ type: "text", text: `Unknown action: ${params.action}` }],
|
|
967
|
+
details: { error: "unknown_action" },
|
|
968
|
+
};
|
|
969
|
+
}
|
|
970
|
+
},
|
|
971
|
+
});
|
|
972
|
+
// No context_signal tool (internal API, not agent-facing). queueSignal()
|
|
973
|
+
// remains exported from signal-detector.ts for direct extension use:
|
|
974
|
+
// import { queueSignal, createDetectorState } from "./signal-detector.js";
|
|
975
|
+
// queueSignal(detectorState, "task_boundary", { action: "tag" });
|
|
976
|
+
}
|
|
977
|
+
//# sourceMappingURL=index.js.map
|