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,110 @@
|
|
|
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
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
24
|
+
/**
|
|
25
|
+
* Result from the verification judge analysis
|
|
26
|
+
*/
|
|
27
|
+
export interface VerificationVerdict {
|
|
28
|
+
/** Overall pass/fail/warn */
|
|
29
|
+
verdict: "pass" | "warn" | "fail";
|
|
30
|
+
/** Confidence 0-100 */
|
|
31
|
+
confidence: number;
|
|
32
|
+
/** Human-readable summary */
|
|
33
|
+
summary: string;
|
|
34
|
+
/** Specific issues found (empty if pass) */
|
|
35
|
+
issues: VerificationIssue[];
|
|
36
|
+
/** Whether code changes exist that haven't been verified */
|
|
37
|
+
unverifiedChanges: boolean;
|
|
38
|
+
}
|
|
39
|
+
export interface VerificationIssue {
|
|
40
|
+
severity: "critical" | "high" | "medium" | "low";
|
|
41
|
+
category: "unverified" | "incomplete" | "shortcut" | "claim" | "scope";
|
|
42
|
+
description: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Context snapshot passed to the judge for analysis
|
|
46
|
+
*/
|
|
47
|
+
export interface DeliverableCheck {
|
|
48
|
+
/** Repository-relative path of a claimed deliverable. */
|
|
49
|
+
path: string;
|
|
50
|
+
/** Whether the file currently exists on disk. */
|
|
51
|
+
exists: boolean;
|
|
52
|
+
/** Whether the on-disk sha256 matches the recorded sha256 (undefined if no record / unreadable). */
|
|
53
|
+
sha256Match?: boolean;
|
|
54
|
+
}
|
|
55
|
+
export interface JudgeContext {
|
|
56
|
+
/** User's original request/task */
|
|
57
|
+
userRequest: string | undefined;
|
|
58
|
+
/** Tools used during this session (unique set) */
|
|
59
|
+
toolsUsed: string[];
|
|
60
|
+
/** Tool execution log (chronological) */
|
|
61
|
+
toolLog: string[];
|
|
62
|
+
/** Has code been modified (edit/write) */
|
|
63
|
+
hasCodeChanges: boolean;
|
|
64
|
+
/** Agent's last response text (for claim detection) */
|
|
65
|
+
lastResponse: string;
|
|
66
|
+
/** Agent's thinking/reasoning text (if available) */
|
|
67
|
+
thinking: string;
|
|
68
|
+
/** Recent git history (git log --oneline -5) for verification evidence across reloads/compactions */
|
|
69
|
+
gitHistory?: string;
|
|
70
|
+
/** Disk-checked deliverables manifest (B17): claimed shipped files verified on the filesystem */
|
|
71
|
+
deliverables?: DeliverableCheck[];
|
|
72
|
+
/**
|
|
73
|
+
* Task-wide evidence lines since the task's last real user message,
|
|
74
|
+
* rebuilt from the pi session store. Survives turn
|
|
75
|
+
* breaks (wake-retry redelivery) that leave toolLog with only the
|
|
76
|
+
* tail turn. Rendered as the TASK EVIDENCE section.
|
|
77
|
+
*/
|
|
78
|
+
taskEvidence?: string[];
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Build the verification analysis prompt. Exported for tests.
|
|
82
|
+
*/
|
|
83
|
+
export declare function buildVerificationPrompt(context: JudgeContext): string;
|
|
84
|
+
/**
|
|
85
|
+
* Parse judge output with robust error handling
|
|
86
|
+
*/
|
|
87
|
+
export declare function parseVerificationOutput(raw: string): VerificationVerdict | null;
|
|
88
|
+
/**
|
|
89
|
+
* Format judge result as enforcement nudge message
|
|
90
|
+
*/
|
|
91
|
+
export declare function formatVerificationNudge(result: VerificationVerdict): string;
|
|
92
|
+
/**
|
|
93
|
+
* Run the verification judge analysis
|
|
94
|
+
*
|
|
95
|
+
* @param ctx - Extension context for model access
|
|
96
|
+
* @param judgeContext - Context snapshot for analysis
|
|
97
|
+
* @param options - Optional timeout + cancellation signal.
|
|
98
|
+
* The signal is threaded into the underlying callLlm
|
|
99
|
+
* so ESC / session shutdown aborts the judge cleanly
|
|
100
|
+
* instead of letting it run to its 30s timeout.
|
|
101
|
+
* Pass `signal: ctx.signal` from the caller (the
|
|
102
|
+
* MESSAGE_END handler receives ctx but not an
|
|
103
|
+
* execute-style signal parameter).
|
|
104
|
+
* @returns Verification verdict or null on failure
|
|
105
|
+
*/
|
|
106
|
+
export declare function runVerificationJudge(ctx: ExtensionContext, judgeContext: JudgeContext, options?: {
|
|
107
|
+
timeoutMs?: number;
|
|
108
|
+
signal?: AbortSignal;
|
|
109
|
+
}): Promise<VerificationVerdict | null>;
|
|
110
|
+
//# sourceMappingURL=verification-judge.d.ts.map
|
|
@@ -0,0 +1,214 @@
|
|
|
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
|
+
* LLM Judge System Prompt for Work Quality Verification.
|
|
25
|
+
*/
|
|
26
|
+
const VERIFICATION_JUDGE_SYSTEM_PROMPT = `Evaluate whether the agent's work matches the user's request.
|
|
27
|
+
|
|
28
|
+
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.
|
|
29
|
+
- **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.
|
|
30
|
+
- **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.
|
|
31
|
+
- **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.
|
|
32
|
+
|
|
33
|
+
Output a JSON object with exactly these fields:
|
|
34
|
+
- verdict: "pass" | "warn" | "fail"
|
|
35
|
+
- confidence: number 0-100
|
|
36
|
+
- summary: string (2-3 sentences)
|
|
37
|
+
- issues: array of { severity: "critical"|"high"|"medium"|"low", category: "unverified"|"incomplete"|"shortcut"|"claim"|"scope", description: string }
|
|
38
|
+
- unverifiedChanges: boolean
|
|
39
|
+
|
|
40
|
+
Rules:
|
|
41
|
+
- pass = work matches request, changes verified, no shortcuts
|
|
42
|
+
- warn = work mostly matches but has minor gaps or unverified changes
|
|
43
|
+
- fail = work doesn't match, significant shortcuts, or claims without evidence
|
|
44
|
+
- Be strict - the agent should verify changes before declaring done
|
|
45
|
+
- 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?
|
|
46
|
+
- **CRITICAL: Verification evidence is in the TOOL EXECUTION LOG, not just the text response.**
|
|
47
|
+
The agent runs tests, typechecks, and builds via bash tool calls. Look for these commands
|
|
48
|
+
in the tool log: \`npm test\`, \`npm run typecheck\`, \`npm run build\`, \`tsc\`, \`jest\`, \`vitest\`,
|
|
49
|
+
or any output containing "PASS", "FAIL", "error TS", "tests passed", "typecheck clean".
|
|
50
|
+
If the tool log shows successful verification commands, the work IS verified even if the
|
|
51
|
+
text response doesn't mention it. Tool results are prefixed with [OK] or [FAIL] to show
|
|
52
|
+
exit status without requiring output parsing.
|
|
53
|
+
|
|
54
|
+
Examples:
|
|
55
|
+
{"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}
|
|
56
|
+
{"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}
|
|
57
|
+
{"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}`;
|
|
58
|
+
import { callLlm, extractJson } from "./judge-utils.js";
|
|
59
|
+
import { findSelfStateClaims, renderSelfStateClaimsSection } from "./self-state-claims.js";
|
|
60
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
61
|
+
const log = createLogger("verification-judge");
|
|
62
|
+
/**
|
|
63
|
+
* Build the verification analysis prompt. Exported for tests.
|
|
64
|
+
*/
|
|
65
|
+
export function buildVerificationPrompt(context) {
|
|
66
|
+
const sections = [];
|
|
67
|
+
if (context.userRequest) {
|
|
68
|
+
sections.push(`## USER REQUEST\n${context.userRequest}\n`);
|
|
69
|
+
}
|
|
70
|
+
sections.push("## TOOLS USED");
|
|
71
|
+
sections.push(context.toolsUsed.length > 0 ? context.toolsUsed.join(", ") : "(none)");
|
|
72
|
+
sections.push("");
|
|
73
|
+
// Task-wide evidence (since last user message, session-store
|
|
74
|
+
// backed) comes BEFORE the current-window tool log — it is the surviving
|
|
75
|
+
// view when turn breaks cut toolLog down to the tail turn.
|
|
76
|
+
if (context.taskEvidence && context.taskEvidence.length > 0) {
|
|
77
|
+
sections.push("## TASK EVIDENCE (since last user message, disk/session-surviving)");
|
|
78
|
+
sections.push(context.taskEvidence.join("\n"));
|
|
79
|
+
sections.push("");
|
|
80
|
+
}
|
|
81
|
+
if (context.toolLog.length > 0) {
|
|
82
|
+
sections.push("## TOOL EXECUTION LOG");
|
|
83
|
+
sections.push(context.toolLog.slice(-50).join("\n")); // Last 50 entries (matches turnHistory cap)
|
|
84
|
+
sections.push("");
|
|
85
|
+
}
|
|
86
|
+
sections.push(`## CODE CHANGES: ${context.hasCodeChanges ? "YES" : "NO"}`);
|
|
87
|
+
// (Verification evidence comes from the TOOL EXECUTION LOG above, not a boolean)
|
|
88
|
+
sections.push("");
|
|
89
|
+
if (context.thinking) {
|
|
90
|
+
sections.push("## AGENT REASONING (thinking blocks)");
|
|
91
|
+
sections.push(context.thinking);
|
|
92
|
+
sections.push("");
|
|
93
|
+
}
|
|
94
|
+
if (context.gitHistory) {
|
|
95
|
+
sections.push("## GIT HISTORY (recent commits)");
|
|
96
|
+
sections.push(context.gitHistory);
|
|
97
|
+
sections.push("");
|
|
98
|
+
}
|
|
99
|
+
if (context.deliverables && context.deliverables.length > 0) {
|
|
100
|
+
sections.push("## DELIVERABLES MANIFEST (disk-checked — ground truth)");
|
|
101
|
+
const allExist = context.deliverables.every((d) => d.exists);
|
|
102
|
+
sections.push(context.deliverables
|
|
103
|
+
.map((d) => `- ${d.exists ? "[OK]" : "[MISSING]"} ${d.path}${d.sha256Match === false ? " (sha256 MISMATCH)" : ""}`)
|
|
104
|
+
.join("\n"));
|
|
105
|
+
sections.push(allExist
|
|
106
|
+
? "\nAll claimed deliverables exist on disk → work is verified."
|
|
107
|
+
: "\nSome deliverables missing on disk → real unverified risk.");
|
|
108
|
+
sections.push("");
|
|
109
|
+
}
|
|
110
|
+
if (context.lastResponse) {
|
|
111
|
+
sections.push("## AGENT RESPONSE (visible text)");
|
|
112
|
+
sections.push(context.lastResponse);
|
|
113
|
+
}
|
|
114
|
+
// Self-state claims: the deterministic detector scans the visible
|
|
115
|
+
// response for liveness/delivery/progress assertions and is suppressed
|
|
116
|
+
// entirely when the evidence window shows a probe call. With no candidates
|
|
117
|
+
// nothing is appended (prompt byte-unchanged); with candidates the section
|
|
118
|
+
// carries its own rule, so the judge system prompt stays untouched.
|
|
119
|
+
const selfStateClaims = findSelfStateClaims({
|
|
120
|
+
responseText: context.lastResponse,
|
|
121
|
+
toolsUsed: context.toolsUsed,
|
|
122
|
+
taskEvidence: context.taskEvidence,
|
|
123
|
+
toolLog: context.toolLog,
|
|
124
|
+
});
|
|
125
|
+
if (selfStateClaims.length > 0) {
|
|
126
|
+
sections.push(renderSelfStateClaimsSection(selfStateClaims));
|
|
127
|
+
}
|
|
128
|
+
return sections.join("\n");
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Parse judge output with robust error handling
|
|
132
|
+
*/
|
|
133
|
+
export function parseVerificationOutput(raw) {
|
|
134
|
+
try {
|
|
135
|
+
const jsonStr = extractJson(raw);
|
|
136
|
+
if (!jsonStr)
|
|
137
|
+
return null;
|
|
138
|
+
const parsed = JSON.parse(jsonStr);
|
|
139
|
+
const issues = (parsed.issues ?? [])
|
|
140
|
+
.filter((i) => i.description && i.category)
|
|
141
|
+
.map((i) => ({
|
|
142
|
+
severity: i.severity ?? "medium",
|
|
143
|
+
category: i.category,
|
|
144
|
+
description: i.description,
|
|
145
|
+
}));
|
|
146
|
+
const verdict = ["pass", "warn", "fail"].includes(parsed.verdict)
|
|
147
|
+
? parsed.verdict
|
|
148
|
+
: "warn";
|
|
149
|
+
return {
|
|
150
|
+
verdict,
|
|
151
|
+
confidence: Math.min(100, Math.max(0, parsed.confidence ?? 50)),
|
|
152
|
+
summary: parsed.summary ?? "Analysis complete",
|
|
153
|
+
issues,
|
|
154
|
+
unverifiedChanges: parsed.unverifiedChanges ?? false,
|
|
155
|
+
};
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return null;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Format judge result as enforcement nudge message
|
|
163
|
+
*/
|
|
164
|
+
export function formatVerificationNudge(result) {
|
|
165
|
+
const lines = [];
|
|
166
|
+
const icon = result.verdict === "fail" ? "[FAIL]" : result.verdict === "warn" ? "[WARN]" : "[PASS]";
|
|
167
|
+
lines.push(`## ${icon} VERIFICATION JUDGE: ${result.verdict.toUpperCase()}`);
|
|
168
|
+
if (result.summary) {
|
|
169
|
+
lines.push(`\n**Summary:** ${result.summary}`);
|
|
170
|
+
}
|
|
171
|
+
if (result.issues.length > 0) {
|
|
172
|
+
lines.push("\n**Issues:**");
|
|
173
|
+
for (const issue of result.issues) {
|
|
174
|
+
const prefix = issue.severity === "critical" ? "[high]" : issue.severity === "high" ? "[warn]" : "[med]";
|
|
175
|
+
lines.push(`- ${prefix} [${issue.category}] ${issue.description}`);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
if (result.unverifiedChanges) {
|
|
179
|
+
lines.push("\n**Unverified code changes detected.** Run tests or commands to verify before finalizing.");
|
|
180
|
+
}
|
|
181
|
+
lines.push(`\n*Confidence: ${result.confidence}%*`);
|
|
182
|
+
return lines.join("\n");
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Run the verification judge analysis
|
|
186
|
+
*
|
|
187
|
+
* @param ctx - Extension context for model access
|
|
188
|
+
* @param judgeContext - Context snapshot for analysis
|
|
189
|
+
* @param options - Optional timeout + cancellation signal.
|
|
190
|
+
* The signal is threaded into the underlying callLlm
|
|
191
|
+
* so ESC / session shutdown aborts the judge cleanly
|
|
192
|
+
* instead of letting it run to its 30s timeout.
|
|
193
|
+
* Pass `signal: ctx.signal` from the caller (the
|
|
194
|
+
* MESSAGE_END handler receives ctx but not an
|
|
195
|
+
* execute-style signal parameter).
|
|
196
|
+
* @returns Verification verdict or null on failure
|
|
197
|
+
*/
|
|
198
|
+
export async function runVerificationJudge(ctx, judgeContext, options = {}) {
|
|
199
|
+
const prompt = buildVerificationPrompt(judgeContext);
|
|
200
|
+
const result = await callLlm(ctx, VERIFICATION_JUDGE_SYSTEM_PROMPT, prompt, {
|
|
201
|
+
...options,
|
|
202
|
+
// The judge-utils wrapper accepts signal through LlmCallOptions
|
|
203
|
+
// (it's part of the shared callLlm signature), so just spread
|
|
204
|
+
// options through. We re-state signal explicitly so the
|
|
205
|
+
// signal-threading contract is grep-able at this call site.
|
|
206
|
+
...(options.signal ? { signal: options.signal } : {}),
|
|
207
|
+
});
|
|
208
|
+
if ("error" in result) {
|
|
209
|
+
log.warn("Verification judge error:", result.error);
|
|
210
|
+
return null;
|
|
211
|
+
}
|
|
212
|
+
return parseVerificationOutput(result.text);
|
|
213
|
+
}
|
|
214
|
+
//# sourceMappingURL=verification-judge.js.map
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Whisper - direct message delivery.
|
|
3
|
+
*/
|
|
4
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
5
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
6
|
+
/**
|
|
7
|
+
* Send an enforcement whisper immediately using sendTrackedMessage().
|
|
8
|
+
*
|
|
9
|
+
* Whisper types:
|
|
10
|
+
* - followUp: advisory signals, tool misuse, memory suggestions
|
|
11
|
+
* visible in TUI, no forced turn (non-critical)
|
|
12
|
+
* - steer: critical signals (blocks, error bursts, overflow)
|
|
13
|
+
* triggerTurn: true ensures agent processes immediately
|
|
14
|
+
*
|
|
15
|
+
* Default delivery does not start an autonomous turn: non-critical whispers
|
|
16
|
+
* ride the current run (delivery class "live" - steer while the run streams,
|
|
17
|
+
* append when idle) or queue for the next user prompt, which prevents
|
|
18
|
+
* autonomous agent loops (compaction -> new turn -> more context -> more
|
|
19
|
+
* compaction). Callers whose advisory must NOT force a continuation turn pass
|
|
20
|
+
* `delivery: "park"` explicitly. Genuinely critical whispers
|
|
21
|
+
* (compaction-retry exhausted, session rotation, three-memory reliability)
|
|
22
|
+
* pass `triggerTurn: true` explicitly.
|
|
23
|
+
*
|
|
24
|
+
* Parameters:
|
|
25
|
+
* critical - If true, emits an `enforcement_violation` event
|
|
26
|
+
* so MARS/analytics/auto-recovery can react.
|
|
27
|
+
* options.triggerTurn - Explicit override. When set, controls
|
|
28
|
+
* whether pi.sendMessage starts a new turn. Only pass
|
|
29
|
+
* `true` for genuinely critical cases (compaction-retry
|
|
30
|
+
* exhausted, session rotation, three-memory reliability).
|
|
31
|
+
* options.delivery - Delivery class for a non-waking whisper: "live"
|
|
32
|
+
* (default) reaches the running loop, "park" records for the
|
|
33
|
+
* end-of-turn flush. See the delivery contract in
|
|
34
|
+
* `lib/utils/injection-tracker.ts`.
|
|
35
|
+
* options.deliverAs - Delivery mode. Defaults to `"steer"` for a
|
|
36
|
+
* non-waking whisper; left undefined when triggerTurn:true so
|
|
37
|
+
* pi-core's wake branch is not shadowed by the nextTurn queue.
|
|
38
|
+
*
|
|
39
|
+
* Nudges are suppressed when braid.suppressNudges=true in settings.json.
|
|
40
|
+
*/
|
|
41
|
+
export declare function sendEnforcementWhisper(pi: ExtensionAPI, ctx: ExtensionContext, message: string, critical?: boolean, options?: {
|
|
42
|
+
triggerTurn?: boolean;
|
|
43
|
+
deliverAs?: "steer" | "nextTurn";
|
|
44
|
+
delivery?: "live" | "park";
|
|
45
|
+
}): void;
|
|
46
|
+
//# sourceMappingURL=whisper.d.ts.map
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Whisper - direct message delivery.
|
|
3
|
+
*/
|
|
4
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
5
|
+
import { eventBus } from "../../lib/events/event-bus.js";
|
|
6
|
+
import { sendTrackedMessage } from "../../lib/utils/injection-tracker.js";
|
|
7
|
+
import { recordNudgeSent } from "../../lib/reasoning/nudge-analytics.js";
|
|
8
|
+
import { areCognitiveNudgesDisabled } from "../../lib/config/braid-settings.js";
|
|
9
|
+
const log = createLogger("enforcement");
|
|
10
|
+
/**
|
|
11
|
+
* Send an enforcement whisper immediately using sendTrackedMessage().
|
|
12
|
+
*
|
|
13
|
+
* Whisper types:
|
|
14
|
+
* - followUp: advisory signals, tool misuse, memory suggestions
|
|
15
|
+
* visible in TUI, no forced turn (non-critical)
|
|
16
|
+
* - steer: critical signals (blocks, error bursts, overflow)
|
|
17
|
+
* triggerTurn: true ensures agent processes immediately
|
|
18
|
+
*
|
|
19
|
+
* Default delivery does not start an autonomous turn: non-critical whispers
|
|
20
|
+
* ride the current run (delivery class "live" - steer while the run streams,
|
|
21
|
+
* append when idle) or queue for the next user prompt, which prevents
|
|
22
|
+
* autonomous agent loops (compaction -> new turn -> more context -> more
|
|
23
|
+
* compaction). Callers whose advisory must NOT force a continuation turn pass
|
|
24
|
+
* `delivery: "park"` explicitly. Genuinely critical whispers
|
|
25
|
+
* (compaction-retry exhausted, session rotation, three-memory reliability)
|
|
26
|
+
* pass `triggerTurn: true` explicitly.
|
|
27
|
+
*
|
|
28
|
+
* Parameters:
|
|
29
|
+
* critical - If true, emits an `enforcement_violation` event
|
|
30
|
+
* so MARS/analytics/auto-recovery can react.
|
|
31
|
+
* options.triggerTurn - Explicit override. When set, controls
|
|
32
|
+
* whether pi.sendMessage starts a new turn. Only pass
|
|
33
|
+
* `true` for genuinely critical cases (compaction-retry
|
|
34
|
+
* exhausted, session rotation, three-memory reliability).
|
|
35
|
+
* options.delivery - Delivery class for a non-waking whisper: "live"
|
|
36
|
+
* (default) reaches the running loop, "park" records for the
|
|
37
|
+
* end-of-turn flush. See the delivery contract in
|
|
38
|
+
* `lib/utils/injection-tracker.ts`.
|
|
39
|
+
* options.deliverAs - Delivery mode. Defaults to `"steer"` for a
|
|
40
|
+
* non-waking whisper; left undefined when triggerTurn:true so
|
|
41
|
+
* pi-core's wake branch is not shadowed by the nextTurn queue.
|
|
42
|
+
*
|
|
43
|
+
* Nudges are suppressed when braid.suppressNudges=true in settings.json.
|
|
44
|
+
*/
|
|
45
|
+
export function sendEnforcementWhisper(pi, ctx, message, critical = false, options) {
|
|
46
|
+
// Cognitive nudge suppression - separate from confirm dialogs
|
|
47
|
+
if (areCognitiveNudgesDisabled()) {
|
|
48
|
+
log.debug("[whisper] Cognitive nudges suppressed via braid.suppressNudges=true");
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
// Track nudge sent for A/B variant analytics.
|
|
52
|
+
try {
|
|
53
|
+
recordNudgeSent(ctx);
|
|
54
|
+
}
|
|
55
|
+
catch (err) {
|
|
56
|
+
log.warn("Failed to record nudge sent:", err);
|
|
57
|
+
}
|
|
58
|
+
// Emit via event bus — only as a violation when actually critical: an
|
|
59
|
+
// advisory nudge propagating as a `tool_error` event triggers MARS
|
|
60
|
+
// error-recurrence and auto-recovery on the next turn, amplifying a benign
|
|
61
|
+
// advisory into an error burst.
|
|
62
|
+
if (critical) {
|
|
63
|
+
try {
|
|
64
|
+
eventBus.emit({
|
|
65
|
+
type: "enforcement_violation",
|
|
66
|
+
rule: "enforcement",
|
|
67
|
+
description: message,
|
|
68
|
+
severity: "high",
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
catch (err) {
|
|
72
|
+
log.warn("Failed to emit enforcement event:", err);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
// Tag all enforcement whispers with customType="enforcement" so the agent
|
|
76
|
+
// knows these are system-generated signals, not human messages.
|
|
77
|
+
// The universal "[braid-whisper - enforcement]" envelope is applied by
|
|
78
|
+
// `sendTrackedMessage` (the trunk) so this wrapper just passes the raw
|
|
79
|
+
// message through. See `lib/utils/whisper-format.ts` for the full design.
|
|
80
|
+
//
|
|
81
|
+
// Callers that need immediate agent action pass `triggerTurn: true` in
|
|
82
|
+
// options. When they do, `deliverAs` stays undefined: pi-core's
|
|
83
|
+
// `sendCustomMessage` routes an explicit `deliverAs === "nextTurn"` to
|
|
84
|
+
// `_pendingNextTurnMessages` BEFORE evaluating `triggerTurn`
|
|
85
|
+
// (agent-session.ts:1287/1295), so a `triggerTurn: true` wake with the
|
|
86
|
+
// `nextTurn` default would be silently queued for the next user prompt and
|
|
87
|
+
// never fire — defeating the gated auto-resume after agent-initiated
|
|
88
|
+
// mid-turn compaction (context_compress tool). Undefined `deliverAs` falls
|
|
89
|
+
// through to the triggerTurn branch and calls agent.prompt(), the same wake
|
|
90
|
+
// path the timer extension uses.
|
|
91
|
+
const triggerTurn = options?.triggerTurn ?? false;
|
|
92
|
+
const deliverAs = options?.deliverAs ?? (triggerTurn ? undefined : "steer");
|
|
93
|
+
// Default class for a non-waking enforcement whisper: live. An enforcement
|
|
94
|
+
// advisory's value is read during the run it fires in (see the delivery
|
|
95
|
+
// contract in lib/utils/injection-tracker.ts). Callers whose advisory must
|
|
96
|
+
// not force a continuation turn pass `delivery: "park"` explicitly.
|
|
97
|
+
const delivery = options?.delivery ?? (triggerTurn ? undefined : "live");
|
|
98
|
+
sendTrackedMessage(pi, {
|
|
99
|
+
customType: "enforcement",
|
|
100
|
+
content: [{ type: "text", text: message }],
|
|
101
|
+
display: true,
|
|
102
|
+
}, { deliverAs, triggerTurn, delivery }, { type: "enforcement", source: "enforcement/whisper" });
|
|
103
|
+
}
|
|
104
|
+
//# sourceMappingURL=whisper.js.map
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Analytics - A/B variant measurement.
|
|
3
|
+
*/
|
|
4
|
+
interface VariantStats {
|
|
5
|
+
variant: string;
|
|
6
|
+
sessions: number;
|
|
7
|
+
totalToolCalls: number;
|
|
8
|
+
successCount: number;
|
|
9
|
+
partialCount: number;
|
|
10
|
+
failureCount: number;
|
|
11
|
+
avgToolsPerSession: number;
|
|
12
|
+
avgErrorRate: number;
|
|
13
|
+
nudgesSent: number;
|
|
14
|
+
nudgesSuppressed: number;
|
|
15
|
+
}
|
|
16
|
+
export declare function loadAnalyticsByVariant(storagePath?: string): Map<string, VariantStats>;
|
|
17
|
+
export declare function formatABResults(variants?: Map<string, VariantStats>): string;
|
|
18
|
+
export {};
|
|
19
|
+
//# sourceMappingURL=ab-variant.d.ts.map
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Analytics - A/B variant measurement.
|
|
3
|
+
*/
|
|
4
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
5
|
+
import { metricsFilePath } from "../../../lib/config/braid-paths.js";
|
|
6
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
7
|
+
const log = createLogger("analytics:ab-variant");
|
|
8
|
+
export function loadAnalyticsByVariant(storagePath) {
|
|
9
|
+
const path = storagePath ?? metricsFilePath();
|
|
10
|
+
const variants = new Map();
|
|
11
|
+
if (!existsSync(path))
|
|
12
|
+
return variants;
|
|
13
|
+
try {
|
|
14
|
+
for (const line of readFileSync(path, "utf-8").trim().split("\n")) {
|
|
15
|
+
try {
|
|
16
|
+
const entry = JSON.parse(line);
|
|
17
|
+
const variant = entry.abVariant || "control";
|
|
18
|
+
const sm = entry.sessionMetrics || {};
|
|
19
|
+
const tms = entry.toolMetrics || [];
|
|
20
|
+
let v = variants.get(variant);
|
|
21
|
+
if (!v) {
|
|
22
|
+
v = {
|
|
23
|
+
variant,
|
|
24
|
+
sessions: 0,
|
|
25
|
+
totalToolCalls: 0,
|
|
26
|
+
successCount: 0,
|
|
27
|
+
partialCount: 0,
|
|
28
|
+
failureCount: 0,
|
|
29
|
+
avgToolsPerSession: 0,
|
|
30
|
+
avgErrorRate: 0,
|
|
31
|
+
nudgesSent: 0,
|
|
32
|
+
nudgesSuppressed: 0,
|
|
33
|
+
};
|
|
34
|
+
variants.set(variant, v);
|
|
35
|
+
}
|
|
36
|
+
v.sessions++;
|
|
37
|
+
v.totalToolCalls += sm.totalToolCalls || 0;
|
|
38
|
+
if (entry.outcome === "success")
|
|
39
|
+
v.successCount++;
|
|
40
|
+
else if (entry.outcome === "failure")
|
|
41
|
+
v.failureCount++;
|
|
42
|
+
else
|
|
43
|
+
v.partialCount++;
|
|
44
|
+
v.avgToolsPerSession =
|
|
45
|
+
(v.avgToolsPerSession * (v.sessions - 1) + (sm.totalToolCalls || 0)) / v.sessions;
|
|
46
|
+
v.nudgesSent += entry.nudgesSent || 0;
|
|
47
|
+
v.nudgesSuppressed += entry.nudgesSuppressed || 0;
|
|
48
|
+
const totalCalls = sm.totalToolCalls || 0;
|
|
49
|
+
const failedCalls = tms.reduce((sum, m) => sum + (m.failedCalls || 0), 0);
|
|
50
|
+
v.avgErrorRate =
|
|
51
|
+
(v.avgErrorRate * (v.sessions - 1) + (totalCalls > 0 ? failedCalls / totalCalls : 0)) /
|
|
52
|
+
v.sessions;
|
|
53
|
+
}
|
|
54
|
+
catch (err) {
|
|
55
|
+
log.warn(`Could not aggregate error rate: ${err}`);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
catch (err) {
|
|
60
|
+
log.warn(`Could not load variant data: ${err}`);
|
|
61
|
+
}
|
|
62
|
+
return variants;
|
|
63
|
+
}
|
|
64
|
+
export function formatABResults(variants) {
|
|
65
|
+
const v = variants ?? loadAnalyticsByVariant();
|
|
66
|
+
if (v.size === 0)
|
|
67
|
+
return "## A/B Results\n\n*No historical data yet. Run `/analytics:setVariant` to configure variants.*\n";
|
|
68
|
+
const lines = [
|
|
69
|
+
"## A/B Experiment Results",
|
|
70
|
+
"",
|
|
71
|
+
"| Variant | Sessions | Success | Partial | Failure | Avg Tools | Nudges Sent | Suppressed | Avg Error Rate |",
|
|
72
|
+
"|---------|----------|---------|---------|---------|-----------|-------------|------------|----------------|",
|
|
73
|
+
];
|
|
74
|
+
for (const vs of v.values()) {
|
|
75
|
+
lines.push(`| ${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)}% |`);
|
|
76
|
+
}
|
|
77
|
+
const control = v.get("control");
|
|
78
|
+
const noNudges = v.get("no_nudges");
|
|
79
|
+
if (control && noNudges && control.sessions >= 3 && noNudges.sessions >= 3) {
|
|
80
|
+
const delta = ((noNudges.successCount / noNudges.sessions - control.successCount / control.sessions) *
|
|
81
|
+
100).toFixed(1);
|
|
82
|
+
lines.push("", `**Delta (no_nudges vs control): ${delta}% ${parseFloat(delta) > 0 ? "improvement" : "regression"}**`);
|
|
83
|
+
}
|
|
84
|
+
return lines.join("\n");
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=ab-variant.js.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Analytics - core functions: metrics, sequences, persistence.
|
|
3
|
+
*/
|
|
4
|
+
import type { AnalyticsState, AnalyticsSummary, ToolMetrics, ToolSequence, SessionMetrics } from "./shared.js";
|
|
5
|
+
export declare function getOrCreateMetrics(s: AnalyticsState, toolName: string): ToolMetrics;
|
|
6
|
+
export declare function recordToolCall(s: AnalyticsState, toolName: string, durationMs: number, success: boolean): void;
|
|
7
|
+
export declare function getToolSequences(s: AnalyticsState, minLength?: number, minSupport?: number): ToolSequence[];
|
|
8
|
+
export declare function getSessionMetrics(s: AnalyticsState): SessionMetrics;
|
|
9
|
+
export declare function computeSessionOutcome(s: AnalyticsState): "success" | "partial" | "failure";
|
|
10
|
+
export declare function flushAnalytics(s: AnalyticsState, taskCompleted?: boolean): void;
|
|
11
|
+
export declare function loadAnalytics(storagePath?: string): AnalyticsSummary;
|
|
12
|
+
//# sourceMappingURL=core.d.ts.map
|