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,240 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-session-start-discoverability - Surface disk-backed state on SESSION_START.
|
|
3
|
+
*
|
|
4
|
+
* The key insight: discoverability must fire BEFORE the first turn, not after.
|
|
5
|
+
* When the agent reloads (fresh pi instance), turn-end handlers fire only
|
|
6
|
+
* after the first turn completes -- by then the agent has already responded
|
|
7
|
+
* without knowing about scratchpad, memory, or episodes.
|
|
8
|
+
*
|
|
9
|
+
* This handler runs in SessionPhase.Background (fire-and-forget, non-blocking)
|
|
10
|
+
* so it doesn't delay agent startup. It checks for:
|
|
11
|
+
* 1. Scratchpad latest.json for this project
|
|
12
|
+
* 2. Episodes file with content
|
|
13
|
+
* 3. Semantic memory file with content
|
|
14
|
+
* 4. Prior session .jsonl files (session-recall)
|
|
15
|
+
* 5. Resume file from prior session shutdown
|
|
16
|
+
* 6. (Always when prior state exists) Context hygiene & preservation tip
|
|
17
|
+
*
|
|
18
|
+
* For each that exists, it emits a whisper so the agent knows to use
|
|
19
|
+
* `scratchpad action=continue`, `memory action=recall_search`, or
|
|
20
|
+
* `session action=search` before starting new work, plus context management
|
|
21
|
+
* and state preservation tools for ongoing session hygiene.
|
|
22
|
+
*
|
|
23
|
+
* This is environmental discoverability: the agent's environment makes
|
|
24
|
+
* its own state visible, rather than hiding it behind tool calls the
|
|
25
|
+
* agent doesn't know to make.
|
|
26
|
+
*/
|
|
27
|
+
import { existsSync, statSync, readFileSync, readdirSync } from "node:fs";
|
|
28
|
+
import * as path from "node:path";
|
|
29
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
30
|
+
import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
|
|
31
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
32
|
+
import { getState } from "../state.js";
|
|
33
|
+
import { enforcementSignals } from "../signals.js";
|
|
34
|
+
import { isProjectSignalShown, markProjectSignalShown, reconstructShownSignalsFromBranch, } from "../../../lib/state/global-state.js";
|
|
35
|
+
import { scratchpadDir, episodesFilePath, semanticMemoryFilePath, AGENT, braidDir, tagsSlugFromCwd, } from "../../../lib/config/braid-paths.js";
|
|
36
|
+
import { projectSlugFromCwd } from "../../memory/scratchpad/persistence.js";
|
|
37
|
+
const log = createLogger("enforcement:session-start-discoverability");
|
|
38
|
+
/**
|
|
39
|
+
* Register the SESSION_START discoverability handler.
|
|
40
|
+
*
|
|
41
|
+
* Runs in Background phase (fire-and-forget) so it doesn't block startup.
|
|
42
|
+
*/
|
|
43
|
+
export function registerSessionStartDiscoverability(pi) {
|
|
44
|
+
registerSessionStartHandler(pi, SessionPhase.Background, async (_event, ctx) => {
|
|
45
|
+
if (!getState(ctx).enforcementActive)
|
|
46
|
+
return;
|
|
47
|
+
// 0. Rebuild shown-signal state from the active branch
|
|
48
|
+
// The branch decides what THIS session has already shown; the project
|
|
49
|
+
// disk index is a derived cache only. Must run before the filter at the
|
|
50
|
+
// bottom of this handler.
|
|
51
|
+
try {
|
|
52
|
+
reconstructShownSignalsFromBranch(ctx.sessionManager.getBranch());
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
// Stale ctx (or an older pi without getBranch): keep the last map.
|
|
56
|
+
}
|
|
57
|
+
const cwd = ctx.cwd ?? "";
|
|
58
|
+
// Signal TYPE is the dedup key (stable across content changes); TEXT
|
|
59
|
+
// carries the user-facing content (may change on every emission via
|
|
60
|
+
// dynamic fields like openPlans count or goal slice).
|
|
61
|
+
const signals = [];
|
|
62
|
+
// Clear module-level enforcementSignals from the previous session.
|
|
63
|
+
// This prevents stale signal data (e.g. unpersisted_learnings flag,
|
|
64
|
+
// old contrast mode indicators) from leaking into the new session.
|
|
65
|
+
// The signals map is module-level, not session-scoped, so it persists
|
|
66
|
+
// across /reload unless explicitly cleared.
|
|
67
|
+
for (const key of Object.keys(enforcementSignals)) {
|
|
68
|
+
delete enforcementSignals[key];
|
|
69
|
+
}
|
|
70
|
+
// 1. Scratchpad. The store root is resolved on every call, never a
|
|
71
|
+
// module-load constant: a pinned run must read the tree the writers
|
|
72
|
+
// wrote to, and a refused root (no absolute braid home) degrades.
|
|
73
|
+
try {
|
|
74
|
+
const slug = projectSlugFromCwd(cwd);
|
|
75
|
+
const scratchpadFile = path.join(scratchpadDir(), slug, "latest.json");
|
|
76
|
+
if (existsSync(scratchpadFile)) {
|
|
77
|
+
const stat = statSync(scratchpadFile);
|
|
78
|
+
if (stat.size > 10) {
|
|
79
|
+
const content = readFileSync(scratchpadFile, "utf-8");
|
|
80
|
+
const parsed = JSON.parse(content);
|
|
81
|
+
const hasGoal = parsed.goal && parsed.goal.length > 0;
|
|
82
|
+
const openPlans = Array.isArray(parsed.plans)
|
|
83
|
+
? parsed.plans.filter((p) => !p.done).length
|
|
84
|
+
: 0;
|
|
85
|
+
if (hasGoal || openPlans > 0) {
|
|
86
|
+
signals.push({
|
|
87
|
+
type: "scratchpad_prior",
|
|
88
|
+
text: `Prior scratchpad data exists for this project (${openPlans} open plan items). ` +
|
|
89
|
+
`Use \`scratchpad action=continue\` to resume -- it returns goal + open plan + recent context in one call.`,
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
catch (err) {
|
|
96
|
+
log.debug(`scratchpad discoverability check failed: ${err}`);
|
|
97
|
+
}
|
|
98
|
+
// 2. Episodes
|
|
99
|
+
let hasEpisodes = false;
|
|
100
|
+
try {
|
|
101
|
+
if (existsSync(episodesFilePath())) {
|
|
102
|
+
const stat = statSync(episodesFilePath());
|
|
103
|
+
if (stat.size > 10)
|
|
104
|
+
hasEpisodes = true;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
// ignore
|
|
109
|
+
}
|
|
110
|
+
// 3. Semantic memory
|
|
111
|
+
let hasSemantic = false;
|
|
112
|
+
try {
|
|
113
|
+
if (existsSync(semanticMemoryFilePath())) {
|
|
114
|
+
const content = readFileSync(semanticMemoryFilePath(), "utf-8");
|
|
115
|
+
const parsed = JSON.parse(content);
|
|
116
|
+
const count = Array.isArray(parsed) ? parsed.length : Object.keys(parsed).length;
|
|
117
|
+
if (count > 0)
|
|
118
|
+
hasSemantic = true;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
catch {
|
|
122
|
+
// ignore
|
|
123
|
+
}
|
|
124
|
+
if (hasEpisodes || hasSemantic) {
|
|
125
|
+
const sources = [];
|
|
126
|
+
if (hasEpisodes)
|
|
127
|
+
sources.push("episodes");
|
|
128
|
+
if (hasSemantic)
|
|
129
|
+
sources.push("semantic memory");
|
|
130
|
+
signals.push({
|
|
131
|
+
type: "memory_prior",
|
|
132
|
+
text: `Prior ${sources.join(" and ")} available. Use \`memory action=recall_search\` with a relevant query ` +
|
|
133
|
+
`to surface insights from past sessions before starting new work.`,
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
// 4. Prior session files
|
|
137
|
+
try {
|
|
138
|
+
const sessionsDir = path.join(AGENT, "sessions");
|
|
139
|
+
if (existsSync(sessionsDir)) {
|
|
140
|
+
const entries = readdirSync(sessionsDir, { withFileTypes: true });
|
|
141
|
+
const jsonlCount = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).length;
|
|
142
|
+
if (jsonlCount > 0) {
|
|
143
|
+
signals.push({
|
|
144
|
+
type: "sessions_prior",
|
|
145
|
+
text: `${jsonlCount} prior session${jsonlCount > 1 ? "s" : ""} on record. ` +
|
|
146
|
+
`Use \`session action=search\` with keywords to find relevant past work.`,
|
|
147
|
+
});
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
catch {
|
|
152
|
+
// ignore
|
|
153
|
+
}
|
|
154
|
+
// 5. Resume file from prior session
|
|
155
|
+
try {
|
|
156
|
+
const slug = projectSlugFromCwd(cwd);
|
|
157
|
+
const resumeFile = path.join(braidDir(), "sessions", slug, "resume.json");
|
|
158
|
+
if (existsSync(resumeFile)) {
|
|
159
|
+
const content = readFileSync(resumeFile, "utf-8");
|
|
160
|
+
const parsed = JSON.parse(content);
|
|
161
|
+
const openCount = Array.isArray(parsed.openPlans) ? parsed.openPlans.length : 0;
|
|
162
|
+
const uncommitted = Array.isArray(parsed.uncommittedFiles)
|
|
163
|
+
? parsed.uncommittedFiles.length
|
|
164
|
+
: 0;
|
|
165
|
+
if (openCount > 0 || parsed.goal || uncommitted > 0) {
|
|
166
|
+
const parts = [];
|
|
167
|
+
if (parsed.goal)
|
|
168
|
+
parts.push(`goal: "${String(parsed.goal).slice(0, 80)}"`);
|
|
169
|
+
if (openCount > 0)
|
|
170
|
+
parts.push(`${openCount} open plan items`);
|
|
171
|
+
if (uncommitted > 0)
|
|
172
|
+
parts.push(`${uncommitted} uncommitted file${uncommitted > 1 ? "s" : ""}`);
|
|
173
|
+
signals.push({
|
|
174
|
+
type: "resume",
|
|
175
|
+
text: `Prior session left ${parts.join(", ")}. ` +
|
|
176
|
+
`Use \`scratchpad action=continue\` to resume the full context.`,
|
|
177
|
+
});
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
catch {
|
|
182
|
+
// ignore
|
|
183
|
+
}
|
|
184
|
+
// 6. Cross-session tags from prior sessions. The same slug rule the tag
|
|
185
|
+
// writer uses (tagsSlugFromCwd), never the scratchpad/sessions form: a
|
|
186
|
+
// reader on a second spelling reads a file that was never written.
|
|
187
|
+
try {
|
|
188
|
+
const slug = tagsSlugFromCwd(cwd);
|
|
189
|
+
const tagsFile = path.join(braidDir(), "tags", `${slug}.json`);
|
|
190
|
+
if (existsSync(tagsFile)) {
|
|
191
|
+
const content = readFileSync(tagsFile, "utf-8");
|
|
192
|
+
const tags = JSON.parse(content);
|
|
193
|
+
const tagNames = Object.keys(tags);
|
|
194
|
+
if (tagNames.length > 0) {
|
|
195
|
+
signals.push({
|
|
196
|
+
type: "tags_prior",
|
|
197
|
+
text: `Cross-session tags available: ${tagNames.slice(0, 5).join(", ")}${tagNames.length > 5 ? ` +${tagNames.length - 5} more` : ""}. ` +
|
|
198
|
+
`Use \`context_navigate(action="checkout", target="<tag-name>")\` to navigate to a tagged position.`,
|
|
199
|
+
});
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
catch {
|
|
204
|
+
// ignore
|
|
205
|
+
}
|
|
206
|
+
// 7. Context hygiene & state preservation tip: forward-looking
|
|
207
|
+
// guidance — when prior state exists, remind the agent how to manage
|
|
208
|
+
// context and preserve state against crashes.
|
|
209
|
+
// Shown only when there's prior state to manage (other signals exist).
|
|
210
|
+
if (signals.length > 0) {
|
|
211
|
+
signals.push({
|
|
212
|
+
type: "context_hygiene_tip",
|
|
213
|
+
text: `Session state auto-preserves: scratchpad saves to disk, shutdown writes a resume file. ` +
|
|
214
|
+
`Monitor context with \`context_inspect\`, archive with \`context_compress\` when near capacity, ` +
|
|
215
|
+
`and capture workspace files with \`workspace_snapshot(action='capture')\`. ` +
|
|
216
|
+
`These surfaces survive crashes.`,
|
|
217
|
+
});
|
|
218
|
+
}
|
|
219
|
+
// Per-signal dedup, keyed by stable signal TYPE: per-project
|
|
220
|
+
// persistence (via `projectSlugFromCwd`) lets `pi --session <id>` (a new
|
|
221
|
+
// process) read previously shown signals from disk and skip them, so the
|
|
222
|
+
// discoverability bundle doesn't re-fire on session resume.
|
|
223
|
+
const slug = signals.length > 0 && (cwd ? projectSlugFromCwd(cwd) : "");
|
|
224
|
+
const unseenSignals = slug
|
|
225
|
+
? signals.filter((s) => !isProjectSignalShown(slug, s.type))
|
|
226
|
+
: signals.filter((s) => !isProjectSignalShown("default", s.type));
|
|
227
|
+
if (unseenSignals.length > 0) {
|
|
228
|
+
const bundled = unseenSignals.map((s) => s.text).join("\n");
|
|
229
|
+
for (const s of unseenSignals) {
|
|
230
|
+
markProjectSignalShown(slug || "default", s.type, pi);
|
|
231
|
+
}
|
|
232
|
+
// Informational pointers to prior state: park (no forced turn).
|
|
233
|
+
sendEnforcementWhisper(pi, ctx, bundled, false, { delivery: "park" });
|
|
234
|
+
log.debug(`[discoverability] ${unseenSignals.length}/${signals.length} new signal(s) emitted for ${cwd} ` +
|
|
235
|
+
`(${signals.length - unseenSignals.length} already shown)`);
|
|
236
|
+
}
|
|
237
|
+
}, "session-start-discoverability");
|
|
238
|
+
log.debug("session-start-discoverability registered (Background phase)");
|
|
239
|
+
}
|
|
240
|
+
//# sourceMappingURL=register-session-start-discoverability.js.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-session-start - Session initialization: event bus wiring, drift init.
|
|
3
|
+
*
|
|
4
|
+
* RELOAD SAFETY:
|
|
5
|
+
* eventBus listeners are registered with a dedup guard. Each listener is stored
|
|
6
|
+
* in a module-level variable (old handler reference). On session_start, the old
|
|
7
|
+
* handler is removed via eventBus.off() before the new one is added. This prevents
|
|
8
|
+
* listener accumulation across /reload calls, which would cause N whispers per
|
|
9
|
+
* event after N reloads.
|
|
10
|
+
*
|
|
11
|
+
* See also: enforcementSignals cleared in register-session-start-discoverability.ts
|
|
12
|
+
* (module-level state needs explicit reset on each session_start).
|
|
13
|
+
*/
|
|
14
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
15
|
+
export declare function registerSessionStart(pi: ExtensionAPI): void;
|
|
16
|
+
//# sourceMappingURL=register-session-start.d.ts.map
|
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-session-start - Session initialization: event bus wiring, drift init.
|
|
3
|
+
*
|
|
4
|
+
* RELOAD SAFETY:
|
|
5
|
+
* eventBus listeners are registered with a dedup guard. Each listener is stored
|
|
6
|
+
* in a module-level variable (old handler reference). On session_start, the old
|
|
7
|
+
* handler is removed via eventBus.off() before the new one is added. This prevents
|
|
8
|
+
* listener accumulation across /reload calls, which would cause N whispers per
|
|
9
|
+
* event after N reloads.
|
|
10
|
+
*
|
|
11
|
+
* See also: enforcementSignals cleared in register-session-start-discoverability.ts
|
|
12
|
+
* (module-level state needs explicit reset on each session_start).
|
|
13
|
+
*/
|
|
14
|
+
import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
|
|
15
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
16
|
+
import { eventBus } from "../../../lib/events/event-bus.js";
|
|
17
|
+
import { cacheSessionManager } from "../../../lib/state/extension-state.js";
|
|
18
|
+
import { getState } from "../state.js";
|
|
19
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
20
|
+
import { classify } from "../../../lib/ai/text-classifier.js";
|
|
21
|
+
import { CRITICS } from "../../../lib/ai/critic-registry.js";
|
|
22
|
+
import { setLlmCallListeners } from "../../../lib/ai/llm-call.js";
|
|
23
|
+
import { clearTerminalBreaker, isTurnStartBlocked, recordLlmError, recordLlmSuccess, resetSessionHealth, tickSessionHealth, } from "../session-health.js";
|
|
24
|
+
import { classifyLlmError } from "../../../lib/errors/llm-error.js";
|
|
25
|
+
import { setExtensionCtxProvider, setTurnStartGate, } from "../../../lib/state/global-state.js";
|
|
26
|
+
// Module-level eventBus listener references.
|
|
27
|
+
// Stored in globalThis (process-global) to survive module re-evaluation on /reload.
|
|
28
|
+
// Each session_start replaces the old listener after removing it from the eventBus.
|
|
29
|
+
// The eventBus uses a Set<Handler>, so different function references are NOT deduped
|
|
30
|
+
// automatically. Without this guard, N reloads produce N listeners per event.
|
|
31
|
+
//
|
|
32
|
+
// Key: process-global, not module-global. Module-level `const` or `let` is re-created
|
|
33
|
+
// on /reload (extension module tree is re-evaluated), so all old handler refs are lost.
|
|
34
|
+
function getEventBusHandlers() {
|
|
35
|
+
const KEY = "__braid_eventbus_handlers";
|
|
36
|
+
if (!globalThis[KEY]) {
|
|
37
|
+
globalThis[KEY] = {
|
|
38
|
+
context_full: null,
|
|
39
|
+
enforcement_violation: null,
|
|
40
|
+
heartbeat_tick: null,
|
|
41
|
+
turn_complete: null,
|
|
42
|
+
sop_suggestion: null,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
return globalThis[KEY];
|
|
46
|
+
}
|
|
47
|
+
const log = createLogger("enforcement:session-start");
|
|
48
|
+
export function registerSessionStart(pi) {
|
|
49
|
+
// Publish the turn-start gate: the enforcement layer owns the health state
|
|
50
|
+
// (it classifies the LLM errors); the scheduler's wake path consumes it
|
|
51
|
+
// through this lib-level slot because it may not import an extension
|
|
52
|
+
// sibling. Registered once at setup — the two methods are pure functions of
|
|
53
|
+
// the per-session ctx, so nothing leaks between sessions.
|
|
54
|
+
const turnStartGate = {
|
|
55
|
+
isBlocked: (ctx, threshold) => isTurnStartBlocked(ctx, threshold),
|
|
56
|
+
noteCleanTurn: (ctx) => clearTerminalBreaker(ctx),
|
|
57
|
+
};
|
|
58
|
+
setTurnStartGate(turnStartGate);
|
|
59
|
+
// A route change is the one signal that the wake breaker's premise ("this
|
|
60
|
+
// route is terminal") is false: close the latch so wakes resume against the
|
|
61
|
+
// new route. In-memory state only; no owner surface.
|
|
62
|
+
pi.on("model_select", (_event, ctx) => {
|
|
63
|
+
try {
|
|
64
|
+
clearTerminalBreaker(ctx);
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
// non-fatal
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
registerSessionStartHandler(pi, SessionPhase.CoreInit, async (event, ctx) => {
|
|
71
|
+
if (!getState(ctx).enforcementActive)
|
|
72
|
+
return;
|
|
73
|
+
// Cache fresh sessionManager reference for stale-safe access in turn_end handlers
|
|
74
|
+
cacheSessionManager(ctx);
|
|
75
|
+
// Layer 2 wiring: register LLM call listeners that
|
|
76
|
+
// route every call outcome into SessionHealthState. The listener
|
|
77
|
+
// uses a closure over `ctx` so it always updates the right session.
|
|
78
|
+
// Single-listener design: Braid typically runs one session per
|
|
79
|
+
// process; multi-session support is a future concern (Layer 3).
|
|
80
|
+
setLlmCallListeners({
|
|
81
|
+
onError: (err) => {
|
|
82
|
+
try {
|
|
83
|
+
const classified = classifyLlmError(err);
|
|
84
|
+
recordLlmError(ctx, classified);
|
|
85
|
+
tickSessionHealth(ctx);
|
|
86
|
+
}
|
|
87
|
+
catch (e) {
|
|
88
|
+
log.warn(`session-health listener error (non-fatal): ${e.message}`);
|
|
89
|
+
}
|
|
90
|
+
},
|
|
91
|
+
onSuccess: () => {
|
|
92
|
+
try {
|
|
93
|
+
recordLlmSuccess(ctx);
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
// non-fatal
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
});
|
|
100
|
+
// Reset health on session start (preserves history for diagnostics).
|
|
101
|
+
resetSessionHealth(ctx, { preserveHistory: true });
|
|
102
|
+
// Publish the CURRENT session's ctx so out-of-extension consumers
|
|
103
|
+
// (lib/ai: the emergency offloader and the auxiliary LLM path's
|
|
104
|
+
// registry/headers/session-id lookup) act on the live session. The
|
|
105
|
+
// provider closure always hands back the latest ctx this session-start
|
|
106
|
+
// saw.
|
|
107
|
+
setExtensionCtxProvider(() => ctx);
|
|
108
|
+
const task = getState(ctx).originalRequest || "";
|
|
109
|
+
if (task) {
|
|
110
|
+
getState(ctx).driftDetector?.setTaskContext(task);
|
|
111
|
+
}
|
|
112
|
+
getState(ctx).currentTurn++;
|
|
113
|
+
// Classify initial request complexity (fire-and-forget)
|
|
114
|
+
// Determines whether phase-boundary enforcement should be active.
|
|
115
|
+
// Complex tasks get full enforcement; simple tasks skip it to avoid noise.
|
|
116
|
+
if (task) {
|
|
117
|
+
classify(ctx, CRITICS.initialRequestComplexity.criteria, { request: task.slice(0, 1500) }, {
|
|
118
|
+
timeoutMs: 30_000,
|
|
119
|
+
fallback: () => "moderate",
|
|
120
|
+
tierPolicy: "fallback-only",
|
|
121
|
+
})
|
|
122
|
+
.then((result) => {
|
|
123
|
+
const label = result.label.trim().toLowerCase();
|
|
124
|
+
if (["simple", "moderate", "complex"].includes(label)) {
|
|
125
|
+
getState(ctx).taskComplexity = label;
|
|
126
|
+
log.info(`[complexity] Initial request classified as "${label}"` +
|
|
127
|
+
(label === "simple"
|
|
128
|
+
? " — phase-boundary enforcement will be minimal"
|
|
129
|
+
: " — phase-boundary enforcement active"));
|
|
130
|
+
}
|
|
131
|
+
})
|
|
132
|
+
.catch(() => {
|
|
133
|
+
// Non-fatal: default to moderate if classifier fails
|
|
134
|
+
getState(ctx).taskComplexity = "moderate";
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
const h = getEventBusHandlers();
|
|
138
|
+
// Reload-safe: remove old first, then add new
|
|
139
|
+
if (h.context_full)
|
|
140
|
+
eventBus.off("context_full", h.context_full);
|
|
141
|
+
h.context_full = (event) => {
|
|
142
|
+
if (event.usagePercent > 80) {
|
|
143
|
+
sendTrackedMessage(pi, {
|
|
144
|
+
customType: "context",
|
|
145
|
+
display: true,
|
|
146
|
+
content: [
|
|
147
|
+
{
|
|
148
|
+
type: "text",
|
|
149
|
+
text: `Context at ${Math.round(event.usagePercent)}%. Consider context_navigate(action="tag") -> context_compress(action="archive").`,
|
|
150
|
+
},
|
|
151
|
+
],
|
|
152
|
+
}, { deliverAs: "steer", triggerTurn: true }, { type: "enforcement", source: "enforcement/event-bus" });
|
|
153
|
+
}
|
|
154
|
+
};
|
|
155
|
+
eventBus.on("context_full", h.context_full);
|
|
156
|
+
// Reload-safe enforcement_violation → tool_error routing
|
|
157
|
+
if (h.enforcement_violation)
|
|
158
|
+
eventBus.off("enforcement_violation", h.enforcement_violation);
|
|
159
|
+
h.enforcement_violation = (event) => {
|
|
160
|
+
eventBus.emit({
|
|
161
|
+
type: "tool_error",
|
|
162
|
+
toolName: event.rule,
|
|
163
|
+
error: event.description.slice(0, 500),
|
|
164
|
+
turn: getState(ctx).currentTurn,
|
|
165
|
+
timestamp: Date.now(),
|
|
166
|
+
});
|
|
167
|
+
};
|
|
168
|
+
eventBus.on("enforcement_violation", h.enforcement_violation);
|
|
169
|
+
// Reload-safe heartbeat_tick tracking
|
|
170
|
+
if (h.heartbeat_tick)
|
|
171
|
+
eventBus.off("heartbeat_tick", h.heartbeat_tick);
|
|
172
|
+
h.heartbeat_tick = (event) => {
|
|
173
|
+
getState(ctx)._lastHeartbeatTick = event.tickCount;
|
|
174
|
+
if (event.tickCount % 10 === 0) {
|
|
175
|
+
log.debug(`[enforcement] ${event.tickCount} heartbeat ticks registered`);
|
|
176
|
+
}
|
|
177
|
+
};
|
|
178
|
+
eventBus.on("heartbeat_tick", h.heartbeat_tick);
|
|
179
|
+
// Reload-safe turn_complete tracking
|
|
180
|
+
if (h.turn_complete)
|
|
181
|
+
eventBus.off("turn_complete", h.turn_complete);
|
|
182
|
+
h.turn_complete = (event) => {
|
|
183
|
+
const state = getState(ctx);
|
|
184
|
+
state.lastTurnDuration = event.duration;
|
|
185
|
+
log.info(`turn_complete: turn ${event.turn} (${event.duration}ms)`);
|
|
186
|
+
};
|
|
187
|
+
eventBus.on("turn_complete", h.turn_complete);
|
|
188
|
+
// Reload-safe sop_suggestion tracking
|
|
189
|
+
if (h.sop_suggestion)
|
|
190
|
+
eventBus.off("sop_suggestion", h.sop_suggestion);
|
|
191
|
+
h.sop_suggestion = (event) => {
|
|
192
|
+
log.debug(`SOP suggestion: "${event.episodeId}" ` +
|
|
193
|
+
`(similarity: ${(event.similarity * 100).toFixed(0)}%)`);
|
|
194
|
+
};
|
|
195
|
+
eventBus.on("sop_suggestion", h.sop_suggestion);
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
//# sourceMappingURL=register-session-start.js.map
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-call - Tool usage tracking + blocking enforcement.
|
|
3
|
+
*/
|
|
4
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
5
|
+
export declare function registerToolCallHandler(pi: ExtensionAPI): void;
|
|
6
|
+
//# sourceMappingURL=register-tool-call.d.ts.map
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-call - Tool usage tracking + blocking enforcement.
|
|
3
|
+
*/
|
|
4
|
+
import { onEvent } from "../../../lib/events/event-types.js";
|
|
5
|
+
import { checkBlocking } from "./blocking.js";
|
|
6
|
+
import { checkOverCorrectionGate } from "./over-correction-gate.js";
|
|
7
|
+
import { recordToolCall, recordToolInput, recordBashDetails } from "./tool-tracker.js";
|
|
8
|
+
import { checkLocalizationRisk, recordFileTouch, } from "../../../lib/store/bidirectional-verifier.js";
|
|
9
|
+
import { checkCoordination, recordCoordinationEdit, } from "../../../lib/verification/coordination-checker.js";
|
|
10
|
+
import { knownFiles } from "../similarity.js";
|
|
11
|
+
import { getState, recordThink, incrementToolsSinceReflection } from "../state.js";
|
|
12
|
+
import { TOOL_CALL } from "../../../lib/core/event-names.js";
|
|
13
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
14
|
+
import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
|
|
15
|
+
import * as path from "node:path";
|
|
16
|
+
import { braidDir, tagsSlugFromCwd } from "../../../lib/config/braid-paths.js";
|
|
17
|
+
import { recordToolCall as recordLoopToolCall, getToolLoopState, } from "../../../lib/detection/tool-loop-detector.js";
|
|
18
|
+
import { pushBounded } from "../../../lib/utils/bounded.js";
|
|
19
|
+
const log = createLogger("enforcement:tool-call");
|
|
20
|
+
/** ToolLog ring cap. 20x the widest lookback (verify-judge -50). */
|
|
21
|
+
const TOOL_LOG_CAP = 1000;
|
|
22
|
+
export function registerToolCallHandler(pi) {
|
|
23
|
+
onEvent(pi, TOOL_CALL, async (event, ctx) => {
|
|
24
|
+
if (!getState(ctx).enforcementActive) {
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
const toolName = event.toolName;
|
|
28
|
+
const input = event?.input;
|
|
29
|
+
if (!toolName || !toolName.trim())
|
|
30
|
+
return undefined;
|
|
31
|
+
recordToolCall(toolName, ctx);
|
|
32
|
+
// Record tool call for tool-loop-detector (per-turn tool sets)
|
|
33
|
+
const loopState = getToolLoopState(ctx);
|
|
34
|
+
recordLoopToolCall(loopState, toolName);
|
|
35
|
+
recordToolInput(toolName, input, getState(ctx));
|
|
36
|
+
if (toolName === "bash") {
|
|
37
|
+
const cmd = input?.command || "";
|
|
38
|
+
recordBashDetails(cmd, getState(ctx));
|
|
39
|
+
}
|
|
40
|
+
if (toolName === "edit" || toolName === "write") {
|
|
41
|
+
getState(ctx).hasCodeChanges = true;
|
|
42
|
+
const fp = input?.path ?? input?.target ?? "";
|
|
43
|
+
if (fp) {
|
|
44
|
+
recordFileTouch(ctx, fp, getState(ctx).currentTurn, true);
|
|
45
|
+
recordCoordinationEdit(ctx, fp, getState(ctx).currentTurn);
|
|
46
|
+
// Localization risk check
|
|
47
|
+
const risk = checkLocalizationRisk(ctx, fp, getState(ctx).currentTurn);
|
|
48
|
+
if (risk) {
|
|
49
|
+
getState(ctx).localizationRisk = risk;
|
|
50
|
+
}
|
|
51
|
+
// Coordination check: cannot warn today: no relationship is registered
|
|
52
|
+
// (nothing calls registerDerived). See lib/verification/coordination-checker.ts.
|
|
53
|
+
const coordWarnings = checkCoordination(ctx, fp, getState(ctx).currentTurn);
|
|
54
|
+
if (coordWarnings.length > 0) {
|
|
55
|
+
getState(ctx).localizationRisk = coordWarnings[0].message;
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
if (toolName === "read" || toolName === "grep" || toolName === "find") {
|
|
60
|
+
const fp = input?.path ?? input?.target ?? input?.pattern ?? "";
|
|
61
|
+
if (fp) {
|
|
62
|
+
recordFileTouch(ctx, fp, getState(ctx).currentTurn, false);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
if (toolName === "edit" || toolName === "write") {
|
|
66
|
+
const filePath = input?.path;
|
|
67
|
+
if (filePath) {
|
|
68
|
+
knownFiles.set(filePath, { content: "", turn: getState(ctx).currentTurn });
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
// ToolLog grows one string per tool call for the session's
|
|
72
|
+
// lifetime. Capped ring (drop-oldest) at 1000 — 20x the widest consumer
|
|
73
|
+
// lookback (verification-judge slice(-50)); the MARS/advice full-log
|
|
74
|
+
// counters degrade to a last-1000 window (advisory analytics, rates
|
|
75
|
+
// preserved). See lib/utils/bounded.ts for the pattern.
|
|
76
|
+
pushBounded(getState(ctx).toolLog, `${toolName}`, TOOL_LOG_CAP);
|
|
77
|
+
if (toolName === "finalize") {
|
|
78
|
+
getState(ctx).pendingFinalize = true;
|
|
79
|
+
}
|
|
80
|
+
// When context_navigate(action="tag") creates a tag, also persist it to
|
|
81
|
+
// ~/.pi/agent/braid/tags/<project-slug>.json so tags survive across sessions.
|
|
82
|
+
if (toolName === "context_navigate" && input?.action === "tag" && input?.name) {
|
|
83
|
+
try {
|
|
84
|
+
const cwd = ctx.cwd ?? "";
|
|
85
|
+
const slug = tagsSlugFromCwd(cwd);
|
|
86
|
+
const tagsDir = path.join(braidDir(), "tags");
|
|
87
|
+
if (!existsSync(tagsDir))
|
|
88
|
+
mkdirSync(tagsDir, { recursive: true });
|
|
89
|
+
const tagsFile = path.join(tagsDir, `${slug}.json`);
|
|
90
|
+
let tags = {};
|
|
91
|
+
if (existsSync(tagsFile)) {
|
|
92
|
+
try {
|
|
93
|
+
tags = JSON.parse(readFileSync(tagsFile, "utf-8"));
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
tags = {};
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
tags[input.name] = {
|
|
100
|
+
turn: getState(ctx).currentTurn,
|
|
101
|
+
timestamp: Date.now(),
|
|
102
|
+
};
|
|
103
|
+
writeFileSync(tagsFile, JSON.stringify(tags, null, 2), "utf-8");
|
|
104
|
+
log.debug(`Persisted tag "${input.name}" to ${tagsFile}`);
|
|
105
|
+
}
|
|
106
|
+
catch (err) {
|
|
107
|
+
// Failure here means the tag is silently lost on restart — say so at
|
|
108
|
+
// warn, the level a refusal has to be visible at by default.
|
|
109
|
+
log.warn(`Tag persist failed for "${input.name}" (non-fatal, tag lost on reload): ${err}`);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
if (toolName === "think") {
|
|
113
|
+
const thinkType = input?.type || "unknown";
|
|
114
|
+
const parentId = input?.parent_id || null;
|
|
115
|
+
const confidence = input?.confidence;
|
|
116
|
+
recordThink(getState(ctx), thinkType, parentId, confidence);
|
|
117
|
+
}
|
|
118
|
+
else {
|
|
119
|
+
incrementToolsSinceReflection(getState(ctx));
|
|
120
|
+
}
|
|
121
|
+
const blockResult = checkBlocking(pi, toolName, input, getState(ctx));
|
|
122
|
+
if (blockResult.blocked) {
|
|
123
|
+
return { block: true, reason: blockResult.reason };
|
|
124
|
+
}
|
|
125
|
+
const gateResult = checkOverCorrectionGate(pi, ctx, toolName, input);
|
|
126
|
+
if (gateResult.blocked) {
|
|
127
|
+
return { block: true, reason: gateResult.reason };
|
|
128
|
+
}
|
|
129
|
+
return undefined;
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
//# sourceMappingURL=register-tool-call.js.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-result-formatting — Structured Output Catalyst (MI-3)
|
|
3
|
+
*
|
|
4
|
+
* Wraps tool outputs for read/grep/find/ls in a consistent structured format
|
|
5
|
+
* to improve transformer processing. Uses the tool_result event's middleware
|
|
6
|
+
* chaining to modify content before delivery to the agent.
|
|
7
|
+
*
|
|
8
|
+
* Research backing: MDA (2601.21996) — repetitive structural data catalyzes
|
|
9
|
+
* induction head formation in transformer models.
|
|
10
|
+
*
|
|
11
|
+
* Opt-in: Set structuredToolOutput=true in pi settings.json to enable
|
|
12
|
+
* (read through pi.getSettings(); the key is braid-owned and not part of
|
|
13
|
+
* pi's typed settings schema). Disabled by default to preserve existing
|
|
14
|
+
* behavior.
|
|
15
|
+
*/
|
|
16
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
17
|
+
export declare function registerToolResultFormatting(pi: ExtensionAPI): void;
|
|
18
|
+
//# sourceMappingURL=register-tool-result-formatting.d.ts.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* register-tool-result-formatting — Structured Output Catalyst (MI-3)
|
|
3
|
+
*
|
|
4
|
+
* Wraps tool outputs for read/grep/find/ls in a consistent structured format
|
|
5
|
+
* to improve transformer processing. Uses the tool_result event's middleware
|
|
6
|
+
* chaining to modify content before delivery to the agent.
|
|
7
|
+
*
|
|
8
|
+
* Research backing: MDA (2601.21996) — repetitive structural data catalyzes
|
|
9
|
+
* induction head formation in transformer models.
|
|
10
|
+
*
|
|
11
|
+
* Opt-in: Set structuredToolOutput=true in pi settings.json to enable
|
|
12
|
+
* (read through pi.getSettings(); the key is braid-owned and not part of
|
|
13
|
+
* pi's typed settings schema). Disabled by default to preserve existing
|
|
14
|
+
* behavior.
|
|
15
|
+
*/
|
|
16
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
17
|
+
import { formatToolResult, TOOLS_TO_FORMAT } from "../../../lib/utils/format-tool-result.js";
|
|
18
|
+
const log = createLogger("enforcement:tool-result-formatting");
|
|
19
|
+
/**
|
|
20
|
+
* Check if structured output formatting is enabled for this session.
|
|
21
|
+
* Reads the effective settings through the extension API accessor.
|
|
22
|
+
*/
|
|
23
|
+
function isFormattingEnabled(pi) {
|
|
24
|
+
try {
|
|
25
|
+
const settings = pi.getSettings();
|
|
26
|
+
return settings?.structuredToolOutput === true;
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return false;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
export function registerToolResultFormatting(pi) {
|
|
33
|
+
pi.on("tool_result", async (event) => {
|
|
34
|
+
// Only format the tools we care about
|
|
35
|
+
const toolName = event?.toolName || "";
|
|
36
|
+
if (!TOOLS_TO_FORMAT.has(toolName))
|
|
37
|
+
return;
|
|
38
|
+
// Opt-in gate
|
|
39
|
+
if (!isFormattingEnabled(pi))
|
|
40
|
+
return;
|
|
41
|
+
if (!event.content || !Array.isArray(event.content) || event.content.length === 0) {
|
|
42
|
+
return;
|
|
43
|
+
}
|
|
44
|
+
try {
|
|
45
|
+
const formatted = formatToolResult(toolName, event.content, !!event.isError);
|
|
46
|
+
log.debug(`Formatted ${toolName} output (${event.content.length} blocks → ${formatted.length} blocks)`);
|
|
47
|
+
return { content: formatted };
|
|
48
|
+
}
|
|
49
|
+
catch (err) {
|
|
50
|
+
log.error(`Failed to format tool result for ${toolName}: ${err}`);
|
|
51
|
+
// Don't block the tool result — return undefined to passthrough
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=register-tool-result-formatting.js.map
|