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,317 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Verification Judge - LLM-based work quality audit.
|
|
3
|
+
*
|
|
4
|
+
* Structured LLM analysis at strategic checkpoints (pre-finalize,
|
|
5
|
+
* verification gap, periodic drift) audits work quality.
|
|
6
|
+
*
|
|
7
|
+
* Uses the shared judge callLlm (judge-utils.ts), which resolves the model
|
|
8
|
+
* with getJudgeModel() (the session model, or the cheapest non-reasoning model
|
|
9
|
+
* when the session model reasons) and falls back utility -> judge/session
|
|
10
|
+
* model. Evaluates whether the agent's work aligns with the user's request,
|
|
11
|
+
* whether code changes are verified, and whether shortcuts were taken.
|
|
12
|
+
*
|
|
13
|
+
* Evidence sources, in descending authority:
|
|
14
|
+
* - DELIVERABLES MANIFEST — files claimed via finalize, verified on disk.
|
|
15
|
+
* - TASK EVIDENCE — timestamped tool results since the task's last real
|
|
16
|
+
* user message, rebuilt from the pi session store (task-evidence.ts);
|
|
17
|
+
* survives turn breaks such as wake-retry redeliveries that leave the
|
|
18
|
+
* turnHistory-derived log with only the tail turn.
|
|
19
|
+
* - GIT HISTORY — recent commits, survives reloads and compactions.
|
|
20
|
+
* - TOOL EXECUTION LOG — current-window turnHistory log (capped); this is
|
|
21
|
+
* the truncated-by-design view the other sources exist to back up.
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* LLM Judge System Prompt for Work Quality Verification.
|
|
26
|
+
*/
|
|
27
|
+
const VERIFICATION_JUDGE_SYSTEM_PROMPT = `Evaluate whether the agent's work matches the user's request.
|
|
28
|
+
|
|
29
|
+
Git history (recent commits) is provided as verification evidence that survives across reloads and compactions. If the GIT HISTORY section shows commits that match the changed files, that is strong evidence the work was completed and verified -- even if the tool log has been truncated.
|
|
30
|
+
- **DELIVERABLES MANIFEST (disk-checked):** The DELIVERABLES MANIFEST section lists the agent's claimed deliverables with 'exists: true/false' verified **directly on the filesystem** (not inferred from the tool log). If it shows the claimed files exist on disk, that is ground-truth verification — do NOT emit unverified/warn/fail solely because the TOOL EXECUTION LOG was truncated by compaction. Trust the manifest over absent tool-log entries.
|
|
31
|
+
- **TASK EVIDENCE + DELIVERABLES MANIFEST are ground truth equal to GIT HISTORY:** TASK EVIDENCE lists timestamped tool results since the task's last user message across ALL turns (bash/powershell [OK]/[FAIL], sent-message receipts, poller/timer/agent lifecycle). Do NOT emit warn/fail solely because the current-turn TOOL EXECUTION LOG looks truncated or missing — weigh the TASK EVIDENCE section first.
|
|
32
|
+
- **Chunk summaries are full-log coverage:** when the task ran long, early TASK EVIDENCE entries may appear as compact chunk summaries of the full log (each preserves per-tool OK/FAIL counts and key commands, followed by the newest entries verbatim). Treat those summaries as trustworthy coverage of the early log, not as truncation.
|
|
33
|
+
|
|
34
|
+
Output a JSON object with exactly these fields:
|
|
35
|
+
- verdict: "pass" | "warn" | "fail"
|
|
36
|
+
- confidence: number 0-100
|
|
37
|
+
- summary: string (2-3 sentences)
|
|
38
|
+
- issues: array of { severity: "critical"|"high"|"medium"|"low", category: "unverified"|"incomplete"|"shortcut"|"claim"|"scope", description: string }
|
|
39
|
+
- unverifiedChanges: boolean
|
|
40
|
+
|
|
41
|
+
Rules:
|
|
42
|
+
- pass = work matches request, changes verified, no shortcuts
|
|
43
|
+
- warn = work mostly matches but has minor gaps or unverified changes
|
|
44
|
+
- fail = work doesn't match, significant shortcuts, or claims without evidence
|
|
45
|
+
- Be strict - the agent should verify changes before declaring done
|
|
46
|
+
- If user request is missing or empty, evaluate the agent's last response and tool execution log to infer the task. Check: did the agent make concrete changes? Did it verify them? Does the response have specific claims without evidence?
|
|
47
|
+
- **CRITICAL: Verification evidence is in the TOOL EXECUTION LOG, not just the text response.**
|
|
48
|
+
The agent runs tests, typechecks, and builds via bash tool calls. Look for these commands
|
|
49
|
+
in the tool log: \`npm test\`, \`npm run typecheck\`, \`npm run build\`, \`tsc\`, \`jest\`, \`vitest\`,
|
|
50
|
+
or any output containing "PASS", "FAIL", "error TS", "tests passed", "typecheck clean".
|
|
51
|
+
If the tool log shows successful verification commands, the work IS verified even if the
|
|
52
|
+
text response doesn't mention it. Tool results are prefixed with [OK] or [FAIL] to show
|
|
53
|
+
exit status without requiring output parsing.
|
|
54
|
+
|
|
55
|
+
Examples:
|
|
56
|
+
{"verdict":"fail","confidence":90,"summary":"Agent deleted auth middleware without running tests","issues":[{"severity":"critical","category":"unverified","description":"No test run after deleting src/auth/middleware.ts"}],"unverifiedChanges":true}
|
|
57
|
+
{"verdict":"pass","confidence":92,"summary":"Agent implemented the requested sort function and ran \`npm test\` (tool log shows 81/81 tests passing) — verification evidence is in the tool execution trace, not the response text","issues":[],"unverifiedChanges":false}
|
|
58
|
+
{"verdict":"warn","confidence":70,"summary":"Agent made changes and claims they work but didn't run verification","issues":[{"severity":"high","category":"unverified","description":"edit/write tool used but no test or validation command run"}],"unverifiedChanges":true}`;
|
|
59
|
+
|
|
60
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
61
|
+
import { callLlm, extractJson } from "./judge-utils.js";
|
|
62
|
+
import { findSelfStateClaims, renderSelfStateClaimsSection } from "./self-state-claims.js";
|
|
63
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
64
|
+
|
|
65
|
+
const log = createLogger("verification-judge");
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Result from the verification judge analysis
|
|
69
|
+
*/
|
|
70
|
+
export interface VerificationVerdict {
|
|
71
|
+
/** Overall pass/fail/warn */
|
|
72
|
+
verdict: "pass" | "warn" | "fail";
|
|
73
|
+
/** Confidence 0-100 */
|
|
74
|
+
confidence: number;
|
|
75
|
+
/** Human-readable summary */
|
|
76
|
+
summary: string;
|
|
77
|
+
/** Specific issues found (empty if pass) */
|
|
78
|
+
issues: VerificationIssue[];
|
|
79
|
+
/** Whether code changes exist that haven't been verified */
|
|
80
|
+
unverifiedChanges: boolean;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
export interface VerificationIssue {
|
|
84
|
+
severity: "critical" | "high" | "medium" | "low";
|
|
85
|
+
category: "unverified" | "incomplete" | "shortcut" | "claim" | "scope";
|
|
86
|
+
description: string;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Context snapshot passed to the judge for analysis
|
|
91
|
+
*/
|
|
92
|
+
export interface DeliverableCheck {
|
|
93
|
+
/** Repository-relative path of a claimed deliverable. */
|
|
94
|
+
path: string;
|
|
95
|
+
/** Whether the file currently exists on disk. */
|
|
96
|
+
exists: boolean;
|
|
97
|
+
/** Whether the on-disk sha256 matches the recorded sha256 (undefined if no record / unreadable). */
|
|
98
|
+
sha256Match?: boolean;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
export interface JudgeContext {
|
|
102
|
+
/** User's original request/task */
|
|
103
|
+
userRequest: string | undefined;
|
|
104
|
+
/** Tools used during this session (unique set) */
|
|
105
|
+
toolsUsed: string[];
|
|
106
|
+
/** Tool execution log (chronological) */
|
|
107
|
+
toolLog: string[];
|
|
108
|
+
/** Has code been modified (edit/write) */
|
|
109
|
+
hasCodeChanges: boolean;
|
|
110
|
+
/** Agent's last response text (for claim detection) */
|
|
111
|
+
lastResponse: string;
|
|
112
|
+
/** Agent's thinking/reasoning text (if available) */
|
|
113
|
+
thinking: string;
|
|
114
|
+
/** Recent git history (git log --oneline -5) for verification evidence across reloads/compactions */
|
|
115
|
+
gitHistory?: string;
|
|
116
|
+
/** Disk-checked deliverables manifest (B17): claimed shipped files verified on the filesystem */
|
|
117
|
+
deliverables?: DeliverableCheck[];
|
|
118
|
+
/**
|
|
119
|
+
* Task-wide evidence lines since the task's last real user message,
|
|
120
|
+
* rebuilt from the pi session store. Survives turn
|
|
121
|
+
* breaks (wake-retry redelivery) that leave toolLog with only the
|
|
122
|
+
* tail turn. Rendered as the TASK EVIDENCE section.
|
|
123
|
+
*/
|
|
124
|
+
taskEvidence?: string[];
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Build the verification analysis prompt. Exported for tests.
|
|
129
|
+
*/
|
|
130
|
+
export function buildVerificationPrompt(context: JudgeContext): string {
|
|
131
|
+
const sections: string[] = [];
|
|
132
|
+
|
|
133
|
+
if (context.userRequest) {
|
|
134
|
+
sections.push(`## USER REQUEST\n${context.userRequest}\n`);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
sections.push("## TOOLS USED");
|
|
138
|
+
sections.push(context.toolsUsed.length > 0 ? context.toolsUsed.join(", ") : "(none)");
|
|
139
|
+
sections.push("");
|
|
140
|
+
|
|
141
|
+
// Task-wide evidence (since last user message, session-store
|
|
142
|
+
// backed) comes BEFORE the current-window tool log — it is the surviving
|
|
143
|
+
// view when turn breaks cut toolLog down to the tail turn.
|
|
144
|
+
if (context.taskEvidence && context.taskEvidence.length > 0) {
|
|
145
|
+
sections.push("## TASK EVIDENCE (since last user message, disk/session-surviving)");
|
|
146
|
+
sections.push(context.taskEvidence.join("\n"));
|
|
147
|
+
sections.push("");
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
if (context.toolLog.length > 0) {
|
|
151
|
+
sections.push("## TOOL EXECUTION LOG");
|
|
152
|
+
sections.push(context.toolLog.slice(-50).join("\n")); // Last 50 entries (matches turnHistory cap)
|
|
153
|
+
sections.push("");
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
sections.push(`## CODE CHANGES: ${context.hasCodeChanges ? "YES" : "NO"}`);
|
|
157
|
+
// (Verification evidence comes from the TOOL EXECUTION LOG above, not a boolean)
|
|
158
|
+
sections.push("");
|
|
159
|
+
|
|
160
|
+
if (context.thinking) {
|
|
161
|
+
sections.push("## AGENT REASONING (thinking blocks)");
|
|
162
|
+
sections.push(context.thinking);
|
|
163
|
+
sections.push("");
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
if (context.gitHistory) {
|
|
167
|
+
sections.push("## GIT HISTORY (recent commits)");
|
|
168
|
+
sections.push(context.gitHistory);
|
|
169
|
+
sections.push("");
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
if (context.deliverables && context.deliverables.length > 0) {
|
|
173
|
+
sections.push("## DELIVERABLES MANIFEST (disk-checked — ground truth)");
|
|
174
|
+
const allExist = context.deliverables.every((d) => d.exists);
|
|
175
|
+
sections.push(
|
|
176
|
+
context.deliverables
|
|
177
|
+
.map(
|
|
178
|
+
(d) =>
|
|
179
|
+
`- ${d.exists ? "[OK]" : "[MISSING]"} ${d.path}${d.sha256Match === false ? " (sha256 MISMATCH)" : ""}`,
|
|
180
|
+
)
|
|
181
|
+
.join("\n"),
|
|
182
|
+
);
|
|
183
|
+
sections.push(
|
|
184
|
+
allExist
|
|
185
|
+
? "\nAll claimed deliverables exist on disk → work is verified."
|
|
186
|
+
: "\nSome deliverables missing on disk → real unverified risk.",
|
|
187
|
+
);
|
|
188
|
+
sections.push("");
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
if (context.lastResponse) {
|
|
192
|
+
sections.push("## AGENT RESPONSE (visible text)");
|
|
193
|
+
sections.push(context.lastResponse);
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
// Self-state claims: the deterministic detector scans the visible
|
|
197
|
+
// response for liveness/delivery/progress assertions and is suppressed
|
|
198
|
+
// entirely when the evidence window shows a probe call. With no candidates
|
|
199
|
+
// nothing is appended (prompt byte-unchanged); with candidates the section
|
|
200
|
+
// carries its own rule, so the judge system prompt stays untouched.
|
|
201
|
+
const selfStateClaims = findSelfStateClaims({
|
|
202
|
+
responseText: context.lastResponse,
|
|
203
|
+
toolsUsed: context.toolsUsed,
|
|
204
|
+
taskEvidence: context.taskEvidence,
|
|
205
|
+
toolLog: context.toolLog,
|
|
206
|
+
});
|
|
207
|
+
if (selfStateClaims.length > 0) {
|
|
208
|
+
sections.push(renderSelfStateClaimsSection(selfStateClaims));
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
return sections.join("\n");
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Parse judge output with robust error handling
|
|
216
|
+
*/
|
|
217
|
+
export function parseVerificationOutput(raw: string): VerificationVerdict | null {
|
|
218
|
+
try {
|
|
219
|
+
const jsonStr = extractJson(raw);
|
|
220
|
+
if (!jsonStr) return null;
|
|
221
|
+
|
|
222
|
+
const parsed = JSON.parse(jsonStr);
|
|
223
|
+
|
|
224
|
+
const issues: VerificationIssue[] = (parsed.issues ?? [])
|
|
225
|
+
.filter((i: Record<string, unknown>) => i.description && i.category)
|
|
226
|
+
.map((i: Record<string, unknown>) => ({
|
|
227
|
+
severity: (i.severity as VerificationIssue["severity"]) ?? "medium",
|
|
228
|
+
category: i.category as VerificationIssue["category"],
|
|
229
|
+
description: i.description as string,
|
|
230
|
+
}));
|
|
231
|
+
|
|
232
|
+
const verdict = ["pass", "warn", "fail"].includes(parsed.verdict)
|
|
233
|
+
? (parsed.verdict as VerificationVerdict["verdict"])
|
|
234
|
+
: "warn";
|
|
235
|
+
|
|
236
|
+
return {
|
|
237
|
+
verdict,
|
|
238
|
+
confidence: Math.min(100, Math.max(0, parsed.confidence ?? 50)),
|
|
239
|
+
summary: parsed.summary ?? "Analysis complete",
|
|
240
|
+
issues,
|
|
241
|
+
unverifiedChanges: parsed.unverifiedChanges ?? false,
|
|
242
|
+
};
|
|
243
|
+
} catch {
|
|
244
|
+
return null;
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Format judge result as enforcement nudge message
|
|
250
|
+
*/
|
|
251
|
+
export function formatVerificationNudge(result: VerificationVerdict): string {
|
|
252
|
+
const lines: string[] = [];
|
|
253
|
+
|
|
254
|
+
const icon =
|
|
255
|
+
result.verdict === "fail" ? "[FAIL]" : result.verdict === "warn" ? "[WARN]" : "[PASS]";
|
|
256
|
+
lines.push(`## ${icon} VERIFICATION JUDGE: ${result.verdict.toUpperCase()}`);
|
|
257
|
+
|
|
258
|
+
if (result.summary) {
|
|
259
|
+
lines.push(`\n**Summary:** ${result.summary}`);
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
if (result.issues.length > 0) {
|
|
263
|
+
lines.push("\n**Issues:**");
|
|
264
|
+
for (const issue of result.issues) {
|
|
265
|
+
const prefix =
|
|
266
|
+
issue.severity === "critical" ? "[high]" : issue.severity === "high" ? "[warn]" : "[med]";
|
|
267
|
+
lines.push(`- ${prefix} [${issue.category}] ${issue.description}`);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
if (result.unverifiedChanges) {
|
|
272
|
+
lines.push(
|
|
273
|
+
"\n**Unverified code changes detected.** Run tests or commands to verify before finalizing.",
|
|
274
|
+
);
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
lines.push(`\n*Confidence: ${result.confidence}%*`);
|
|
278
|
+
|
|
279
|
+
return lines.join("\n");
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Run the verification judge analysis
|
|
284
|
+
*
|
|
285
|
+
* @param ctx - Extension context for model access
|
|
286
|
+
* @param judgeContext - Context snapshot for analysis
|
|
287
|
+
* @param options - Optional timeout + cancellation signal.
|
|
288
|
+
* The signal is threaded into the underlying callLlm
|
|
289
|
+
* so ESC / session shutdown aborts the judge cleanly
|
|
290
|
+
* instead of letting it run to its 30s timeout.
|
|
291
|
+
* Pass `signal: ctx.signal` from the caller (the
|
|
292
|
+
* MESSAGE_END handler receives ctx but not an
|
|
293
|
+
* execute-style signal parameter).
|
|
294
|
+
* @returns Verification verdict or null on failure
|
|
295
|
+
*/
|
|
296
|
+
export async function runVerificationJudge(
|
|
297
|
+
ctx: ExtensionContext,
|
|
298
|
+
judgeContext: JudgeContext,
|
|
299
|
+
options: { timeoutMs?: number; signal?: AbortSignal } = {},
|
|
300
|
+
): Promise<VerificationVerdict | null> {
|
|
301
|
+
const prompt = buildVerificationPrompt(judgeContext);
|
|
302
|
+
const result = await callLlm(ctx, VERIFICATION_JUDGE_SYSTEM_PROMPT, prompt, {
|
|
303
|
+
...options,
|
|
304
|
+
// The judge-utils wrapper accepts signal through LlmCallOptions
|
|
305
|
+
// (it's part of the shared callLlm signature), so just spread
|
|
306
|
+
// options through. We re-state signal explicitly so the
|
|
307
|
+
// signal-threading contract is grep-able at this call site.
|
|
308
|
+
...(options.signal ? { signal: options.signal } : {}),
|
|
309
|
+
});
|
|
310
|
+
|
|
311
|
+
if ("error" in result) {
|
|
312
|
+
log.warn("Verification judge error:", result.error);
|
|
313
|
+
return null;
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
return parseVerificationOutput(result.text);
|
|
317
|
+
}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Whisper - direct message delivery.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
6
|
+
import { eventBus } from "../../lib/events/event-bus.js";
|
|
7
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
8
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
9
|
+
import { sendTrackedMessage } from "../../lib/utils/injection-tracker.js";
|
|
10
|
+
import { recordNudgeSent } from "../../lib/reasoning/nudge-analytics.js";
|
|
11
|
+
import { areCognitiveNudgesDisabled } from "../../lib/config/braid-settings.js";
|
|
12
|
+
|
|
13
|
+
const log = createLogger("enforcement");
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Send an enforcement whisper immediately using sendTrackedMessage().
|
|
17
|
+
*
|
|
18
|
+
* Whisper types:
|
|
19
|
+
* - followUp: advisory signals, tool misuse, memory suggestions
|
|
20
|
+
* visible in TUI, no forced turn (non-critical)
|
|
21
|
+
* - steer: critical signals (blocks, error bursts, overflow)
|
|
22
|
+
* triggerTurn: true ensures agent processes immediately
|
|
23
|
+
*
|
|
24
|
+
* Default delivery does not start an autonomous turn: non-critical whispers
|
|
25
|
+
* ride the current run (delivery class "live" - steer while the run streams,
|
|
26
|
+
* append when idle) or queue for the next user prompt, which prevents
|
|
27
|
+
* autonomous agent loops (compaction -> new turn -> more context -> more
|
|
28
|
+
* compaction). Callers whose advisory must NOT force a continuation turn pass
|
|
29
|
+
* `delivery: "park"` explicitly. Genuinely critical whispers
|
|
30
|
+
* (compaction-retry exhausted, session rotation, three-memory reliability)
|
|
31
|
+
* pass `triggerTurn: true` explicitly.
|
|
32
|
+
*
|
|
33
|
+
* Parameters:
|
|
34
|
+
* critical - If true, emits an `enforcement_violation` event
|
|
35
|
+
* so MARS/analytics/auto-recovery can react.
|
|
36
|
+
* options.triggerTurn - Explicit override. When set, controls
|
|
37
|
+
* whether pi.sendMessage starts a new turn. Only pass
|
|
38
|
+
* `true` for genuinely critical cases (compaction-retry
|
|
39
|
+
* exhausted, session rotation, three-memory reliability).
|
|
40
|
+
* options.delivery - Delivery class for a non-waking whisper: "live"
|
|
41
|
+
* (default) reaches the running loop, "park" records for the
|
|
42
|
+
* end-of-turn flush. See the delivery contract in
|
|
43
|
+
* `lib/utils/injection-tracker.ts`.
|
|
44
|
+
* options.deliverAs - Delivery mode. Defaults to `"steer"` for a
|
|
45
|
+
* non-waking whisper; left undefined when triggerTurn:true so
|
|
46
|
+
* pi-core's wake branch is not shadowed by the nextTurn queue.
|
|
47
|
+
*
|
|
48
|
+
* Nudges are suppressed when braid.suppressNudges=true in settings.json.
|
|
49
|
+
*/
|
|
50
|
+
export function sendEnforcementWhisper(
|
|
51
|
+
pi: ExtensionAPI,
|
|
52
|
+
ctx: ExtensionContext,
|
|
53
|
+
message: string,
|
|
54
|
+
critical: boolean = false,
|
|
55
|
+
options?: { triggerTurn?: boolean; deliverAs?: "steer" | "nextTurn"; delivery?: "live" | "park" },
|
|
56
|
+
): void {
|
|
57
|
+
// Cognitive nudge suppression - separate from confirm dialogs
|
|
58
|
+
if (areCognitiveNudgesDisabled()) {
|
|
59
|
+
log.debug("[whisper] Cognitive nudges suppressed via braid.suppressNudges=true");
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// Track nudge sent for A/B variant analytics.
|
|
64
|
+
try {
|
|
65
|
+
recordNudgeSent(ctx);
|
|
66
|
+
} catch (err) {
|
|
67
|
+
log.warn("Failed to record nudge sent:", err);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// Emit via event bus — only as a violation when actually critical: an
|
|
71
|
+
// advisory nudge propagating as a `tool_error` event triggers MARS
|
|
72
|
+
// error-recurrence and auto-recovery on the next turn, amplifying a benign
|
|
73
|
+
// advisory into an error burst.
|
|
74
|
+
if (critical) {
|
|
75
|
+
try {
|
|
76
|
+
eventBus.emit({
|
|
77
|
+
type: "enforcement_violation",
|
|
78
|
+
rule: "enforcement",
|
|
79
|
+
description: message,
|
|
80
|
+
severity: "high",
|
|
81
|
+
});
|
|
82
|
+
} catch (err) {
|
|
83
|
+
log.warn("Failed to emit enforcement event:", err);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// Tag all enforcement whispers with customType="enforcement" so the agent
|
|
88
|
+
// knows these are system-generated signals, not human messages.
|
|
89
|
+
// The universal "[braid-whisper - enforcement]" envelope is applied by
|
|
90
|
+
// `sendTrackedMessage` (the trunk) so this wrapper just passes the raw
|
|
91
|
+
// message through. See `lib/utils/whisper-format.ts` for the full design.
|
|
92
|
+
//
|
|
93
|
+
// Callers that need immediate agent action pass `triggerTurn: true` in
|
|
94
|
+
// options. When they do, `deliverAs` stays undefined: pi-core's
|
|
95
|
+
// `sendCustomMessage` routes an explicit `deliverAs === "nextTurn"` to
|
|
96
|
+
// `_pendingNextTurnMessages` BEFORE evaluating `triggerTurn`
|
|
97
|
+
// (agent-session.ts:1287/1295), so a `triggerTurn: true` wake with the
|
|
98
|
+
// `nextTurn` default would be silently queued for the next user prompt and
|
|
99
|
+
// never fire — defeating the gated auto-resume after agent-initiated
|
|
100
|
+
// mid-turn compaction (context_compress tool). Undefined `deliverAs` falls
|
|
101
|
+
// through to the triggerTurn branch and calls agent.prompt(), the same wake
|
|
102
|
+
// path the timer extension uses.
|
|
103
|
+
const triggerTurn = options?.triggerTurn ?? false;
|
|
104
|
+
const deliverAs = options?.deliverAs ?? (triggerTurn ? undefined : "steer");
|
|
105
|
+
// Default class for a non-waking enforcement whisper: live. An enforcement
|
|
106
|
+
// advisory's value is read during the run it fires in (see the delivery
|
|
107
|
+
// contract in lib/utils/injection-tracker.ts). Callers whose advisory must
|
|
108
|
+
// not force a continuation turn pass `delivery: "park"` explicitly.
|
|
109
|
+
const delivery = options?.delivery ?? (triggerTurn ? undefined : "live");
|
|
110
|
+
sendTrackedMessage(
|
|
111
|
+
pi,
|
|
112
|
+
{
|
|
113
|
+
customType: "enforcement",
|
|
114
|
+
content: [{ type: "text" as const, text: message }],
|
|
115
|
+
display: true,
|
|
116
|
+
},
|
|
117
|
+
{ deliverAs, triggerTurn, delivery },
|
|
118
|
+
{ type: "enforcement", source: "enforcement/whisper" },
|
|
119
|
+
);
|
|
120
|
+
}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/extensions/heartbeat/ - Background Daemons
|
|
4
|
+
|
|
5
|
+
Background services that run continuously during a session. Unlike
|
|
6
|
+
cognitive/ detectors (which fire on events), heartbeat services run on
|
|
7
|
+
their own schedule.
|
|
8
|
+
|
|
9
|
+
## Sub-extensions
|
|
10
|
+
|
|
11
|
+
| Path | Purpose |
|
|
12
|
+
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| `heartbeat-scheduler/` | The main heartbeat engine. Runs policies on a schedule. Includes modules: `behavioral-drift`, `evolver`, `recaller`, `context-hygiene`, `measurement`, `budget`, `reflection-consolidator`. |
|
|
14
|
+
| `analytics/` | Analytics engine. Tracks tool usage, success rates, and produces A/B test variants. |
|
|
15
|
+
|
|
16
|
+
## Local Contracts
|
|
17
|
+
|
|
18
|
+
- Heartbeat services are **decoupled from the turn loop** - they run on timers or on `turn_end` events.
|
|
19
|
+
- They don't emit whispers directly to the agent. They emit signals that the enforcement layer translates.
|
|
20
|
+
- See `extensions/heartbeat/heartbeat-scheduler/policies.ts` for the policy DSL.
|
|
21
|
+
- See `extensions/heartbeat/heartbeat-scheduler/modules/` for the built-in policies.
|
|
22
|
+
|
|
23
|
+
## Abort handling (ESC, session shutdown)
|
|
24
|
+
|
|
25
|
+
`agent_end` and `tick()` handlers make LLM calls (consolidation scoring,
|
|
26
|
+
SOP extraction, optional hint-quality classification). These calls
|
|
27
|
+
**MUST honor the session abort signal** so ESC and shutdown propagate.
|
|
28
|
+
|
|
29
|
+
The contract (verified by `test/runtime/lib/test-classifier-abort-handling.mjs`):
|
|
30
|
+
|
|
31
|
+
1. `tryModelCall` in `src/lib/ai/text-classifier.ts` threads `ctx.signal`
|
|
32
|
+
through to `callLlm`. When `ctx.signal` is set (agent streaming or
|
|
33
|
+
session signal active), ESC aborts parallel braid LLM calls cleanly.
|
|
34
|
+
2. `callLlm` in `src/lib/ai/llm-call.ts` checks `signal?.aborted === true`
|
|
35
|
+
before logging aborts at ERROR level. External aborts (ESC / shutdown)
|
|
36
|
+
log at debug; provider errors and timeouts still log at ERROR.
|
|
37
|
+
3. `detectPatternWithLLM` in `src/lib/utils/sop-extractor.ts` checks
|
|
38
|
+
`result.tier === "failed"` from `classify()` and falls back to the
|
|
39
|
+
heuristic `detectPattern(tools)` pattern. Previously "unknown" was
|
|
40
|
+
accepted as a valid label and embedded in the strategic SOP - a real
|
|
41
|
+
regression that surfaced under abort pressure.
|
|
42
|
+
4. `detectPatternWithLLM` timeout is 5000ms (was 3000ms). Slow utility
|
|
43
|
+
models + busy session model at session end routinely exceeded 3s.
|
|
44
|
+
|
|
45
|
+
If you add a new module that calls LLM from a heartbeat context, you
|
|
46
|
+
inherit these guarantees automatically via `classify()` / `callLlm()`.
|
|
47
|
+
Direct `pi-ai` calls or external HTTP bypass them - prefer the wrapper.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Analytics Extension
|
|
4
|
+
|
|
5
|
+
Self-contained tool usage analytics. Tracks tool call counts, durations,
|
|
6
|
+
success/failure rates, tool sequences and patterns, session-level metrics,
|
|
7
|
+
and emits alerts on degradation/anomaly.
|
|
8
|
+
|
|
9
|
+
## Architecture
|
|
10
|
+
|
|
11
|
+
| File | Purpose |
|
|
12
|
+
| --------------- | ---------------------------------------------------------------------- |
|
|
13
|
+
| `index.ts` | Extension entry point; registers event listeners and tool result hooks |
|
|
14
|
+
| `types.ts` | Type definitions for metrics, alerts, A/B variants |
|
|
15
|
+
| `core.ts` | Core metrics collection (counters, histograms) |
|
|
16
|
+
| `format.ts` | Human-readable output formatting for `get_session_metrics` |
|
|
17
|
+
| `shared.ts` | Shared utilities (alert emission, persistence helpers) |
|
|
18
|
+
| `ab-variant.ts` | A/B experiment variant tracking (BR3) |
|
|
19
|
+
|
|
20
|
+
## What it tracks
|
|
21
|
+
|
|
22
|
+
- **Per-tool metrics**: call count, success/failure rate, p50/p95 duration
|
|
23
|
+
- **Tool sequences**: which tools tend to be called together (used by SOP suggestion)
|
|
24
|
+
- **Session metrics**: turn count, total tokens, error rate
|
|
25
|
+
- **A/B variants**: which experimental branch a session is on (set via
|
|
26
|
+
`set_ab_variant` - note: that tool was removed in the 0.3.0 audit; A/B <!-- doc-ref-exempt: removed tool named as history -->
|
|
27
|
+
state is now set via `behavior` action=activate)
|
|
28
|
+
|
|
29
|
+
## Tools exposed
|
|
30
|
+
|
|
31
|
+
_(None - both `get_session_metrics` and `get_tool_reliability` removed in <!-- doc-ref-exempt: removed tool named as history -->
|
|
32
|
+
2026-06 tool-inventory audit. They were passive observability with no
|
|
33
|
+
internal consumers. Background tracking and the `analytics:all` slash
|
|
34
|
+
command remain.)_
|
|
35
|
+
|
|
36
|
+
## Event-bus contract
|
|
37
|
+
|
|
38
|
+
| Emits | Listens to |
|
|
39
|
+
| ------------------------------------------------------------- | --------------------------- |
|
|
40
|
+
| `analytics_alert` (degradation, addiction, recovery, anomaly) | `self/watchdog/index.ts:51` |
|
|
41
|
+
|
|
42
|
+
## Persistence
|
|
43
|
+
|
|
44
|
+
Metrics are written to `METRICS_FILE` (under `BRAID_DATA_DIR/`) on
|
|
45
|
+
session_shutdown. The file is JSON; safe to read with `jq` for
|
|
46
|
+
post-hoc analysis.
|
|
47
|
+
|
|
48
|
+
## Local Contracts
|
|
49
|
+
|
|
50
|
+
- **Session-scoped state** via `getExtensionState(ctx, key, factory)`.
|
|
51
|
+
No cross-session contamination.
|
|
52
|
+
- **No whisper emission**: analytics is purely passive observation.
|
|
53
|
+
When it detects degradation, it emits `analytics_alert` to the bus
|
|
54
|
+
and the watchdog decides what to do.
|
|
55
|
+
- **Reset**: `resetCriticStats()` is called on session_start to clear
|
|
56
|
+
the critic-gate counters (not analytics; analytics resets on
|
|
57
|
+
session_shutdown).
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Analytics - A/B variant measurement.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
6
|
+
import { metricsFilePath } from "../../../lib/config/braid-paths.js";
|
|
7
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
8
|
+
const log = createLogger("analytics:ab-variant");
|
|
9
|
+
|
|
10
|
+
interface VariantStats {
|
|
11
|
+
variant: string;
|
|
12
|
+
sessions: number;
|
|
13
|
+
totalToolCalls: number;
|
|
14
|
+
successCount: number;
|
|
15
|
+
partialCount: number;
|
|
16
|
+
failureCount: number;
|
|
17
|
+
avgToolsPerSession: number;
|
|
18
|
+
avgErrorRate: number;
|
|
19
|
+
nudgesSent: number;
|
|
20
|
+
nudgesSuppressed: number;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function loadAnalyticsByVariant(storagePath?: string): Map<string, VariantStats> {
|
|
24
|
+
const path = storagePath ?? metricsFilePath();
|
|
25
|
+
const variants = new Map<string, VariantStats>();
|
|
26
|
+
if (!existsSync(path)) return variants;
|
|
27
|
+
|
|
28
|
+
try {
|
|
29
|
+
for (const line of readFileSync(path, "utf-8").trim().split("\n")) {
|
|
30
|
+
try {
|
|
31
|
+
const entry = JSON.parse(line);
|
|
32
|
+
const variant = entry.abVariant || "control";
|
|
33
|
+
const sm = entry.sessionMetrics || {};
|
|
34
|
+
const tms = entry.toolMetrics || [];
|
|
35
|
+
let v = variants.get(variant);
|
|
36
|
+
if (!v) {
|
|
37
|
+
v = {
|
|
38
|
+
variant,
|
|
39
|
+
sessions: 0,
|
|
40
|
+
totalToolCalls: 0,
|
|
41
|
+
successCount: 0,
|
|
42
|
+
partialCount: 0,
|
|
43
|
+
failureCount: 0,
|
|
44
|
+
avgToolsPerSession: 0,
|
|
45
|
+
avgErrorRate: 0,
|
|
46
|
+
nudgesSent: 0,
|
|
47
|
+
nudgesSuppressed: 0,
|
|
48
|
+
};
|
|
49
|
+
variants.set(variant, v);
|
|
50
|
+
}
|
|
51
|
+
v.sessions++;
|
|
52
|
+
v.totalToolCalls += sm.totalToolCalls || 0;
|
|
53
|
+
if (entry.outcome === "success") v.successCount++;
|
|
54
|
+
else if (entry.outcome === "failure") v.failureCount++;
|
|
55
|
+
else v.partialCount++;
|
|
56
|
+
v.avgToolsPerSession =
|
|
57
|
+
(v.avgToolsPerSession * (v.sessions - 1) + (sm.totalToolCalls || 0)) / v.sessions;
|
|
58
|
+
v.nudgesSent += entry.nudgesSent || 0;
|
|
59
|
+
v.nudgesSuppressed += entry.nudgesSuppressed || 0;
|
|
60
|
+
const totalCalls = sm.totalToolCalls || 0;
|
|
61
|
+
const failedCalls = tms.reduce((sum: number, m: any) => sum + (m.failedCalls || 0), 0);
|
|
62
|
+
v.avgErrorRate =
|
|
63
|
+
(v.avgErrorRate * (v.sessions - 1) + (totalCalls > 0 ? failedCalls / totalCalls : 0)) /
|
|
64
|
+
v.sessions;
|
|
65
|
+
} catch (err) {
|
|
66
|
+
log.warn(`Could not aggregate error rate: ${err}`);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
} catch (err) {
|
|
70
|
+
log.warn(`Could not load variant data: ${err}`);
|
|
71
|
+
}
|
|
72
|
+
return variants;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function formatABResults(variants?: Map<string, VariantStats>): string {
|
|
76
|
+
const v = variants ?? loadAnalyticsByVariant();
|
|
77
|
+
if (v.size === 0)
|
|
78
|
+
return "## A/B Results\n\n*No historical data yet. Run `/analytics:setVariant` to configure variants.*\n";
|
|
79
|
+
|
|
80
|
+
const lines = [
|
|
81
|
+
"## A/B Experiment Results",
|
|
82
|
+
"",
|
|
83
|
+
"| Variant | Sessions | Success | Partial | Failure | Avg Tools | Nudges Sent | Suppressed | Avg Error Rate |",
|
|
84
|
+
"|---------|----------|---------|---------|---------|-----------|-------------|------------|----------------|",
|
|
85
|
+
];
|
|
86
|
+
for (const vs of v.values()) {
|
|
87
|
+
lines.push(
|
|
88
|
+
`| ${vs.variant} | ${vs.sessions} | ${vs.sessions > 0 ? ((vs.successCount / vs.sessions) * 100).toFixed(0) : "0"}% | ${vs.sessions > 0 ? ((vs.partialCount / vs.sessions) * 100).toFixed(0) : "0"}% | ${vs.sessions > 0 ? ((vs.failureCount / vs.sessions) * 100).toFixed(0) : "0"}% | ${vs.avgToolsPerSession.toFixed(1)} | ${vs.nudgesSent} | ${vs.nudgesSuppressed} | ${(vs.avgErrorRate * 100).toFixed(0)}% |`,
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
const control = v.get("control");
|
|
93
|
+
const noNudges = v.get("no_nudges");
|
|
94
|
+
if (control && noNudges && control.sessions >= 3 && noNudges.sessions >= 3) {
|
|
95
|
+
const delta = (
|
|
96
|
+
(noNudges.successCount / noNudges.sessions - control.successCount / control.sessions) *
|
|
97
|
+
100
|
|
98
|
+
).toFixed(1);
|
|
99
|
+
lines.push(
|
|
100
|
+
"",
|
|
101
|
+
`**Delta (no_nudges vs control): ${delta}% ${parseFloat(delta) > 0 ? "improvement" : "regression"}**`,
|
|
102
|
+
);
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
return lines.join("\n");
|
|
106
|
+
}
|