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,327 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MARS (Memory-Augmented Reflection) — principle + procedure reflection.
|
|
3
|
+
*
|
|
4
|
+
* Based on MARS (2601.11974) which introduces two reflection types:
|
|
5
|
+
* 1. Principle reflection: After task completion, extract general rules
|
|
6
|
+
* ("what should I follow to avoid errors?") → store as heuristics.
|
|
7
|
+
* 2. Procedure reflection: After successful task, extract steps that
|
|
8
|
+
* led to success → store as episodic memory.
|
|
9
|
+
*
|
|
10
|
+
* Triggers: on task completion (finalize called with completed=true, or
|
|
11
|
+
* significant work done without finalize). Not every turn — the MARS
|
|
12
|
+
* paper fires reflection only at episode boundaries. The statistical
|
|
13
|
+
* tool-usage analyzer lives in `tool-usage-analyzer.ts`.
|
|
14
|
+
*/
|
|
15
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
16
|
+
import { getMemoryState } from "../../heartbeat/heartbeat-scheduler/state.js";
|
|
17
|
+
import { addPrinciple, addEpisode } from "../../memory/three-memory-stores/index.js";
|
|
18
|
+
import { deriveProjectIdFromCwd } from "../../../lib/memory/past-insights.js";
|
|
19
|
+
import { describeWriteDecision, selectRecentEpisodes } from "../../../lib/memory/write-quality.js";
|
|
20
|
+
import { applyWriteGateLogged } from "../../../lib/memory/write-log.js";
|
|
21
|
+
import { getMemoryWriteGateConfig } from "../../../lib/config/braid-settings.js";
|
|
22
|
+
/** Derive a short project id from the current working directory. */
|
|
23
|
+
function deriveProject(ctx) {
|
|
24
|
+
return typeof ctx.cwd === "string" ? deriveProjectIdFromCwd(ctx.cwd) : "unknown";
|
|
25
|
+
}
|
|
26
|
+
const log = createLogger("mars");
|
|
27
|
+
/** Minimum tool calls before reflection is meaningful. */
|
|
28
|
+
const MIN_TOOL_CALLS_FOR_REFLECTION = 5;
|
|
29
|
+
/** Minimum session turns before reflection fires. */
|
|
30
|
+
const MIN_TURNS_FOR_REFLECTION = 3;
|
|
31
|
+
/** Confidence boost for a strong pattern (multiple data points). */
|
|
32
|
+
const STRONG_PATTERN_CONFIDENCE = 0.85;
|
|
33
|
+
/** Moderate pattern confidence. */
|
|
34
|
+
const MODERATE_PATTERN_CONFIDENCE = 0.6;
|
|
35
|
+
/** Weak pattern confidence. */
|
|
36
|
+
const WEAK_PATTERN_CONFIDENCE = 0.4;
|
|
37
|
+
/**
|
|
38
|
+
* Analyze the session snapshot and produce principle reflections.
|
|
39
|
+
* Principle reflections are general rules extracted from failure/success
|
|
40
|
+
* patterns: "After editing, always verify" or "Use think before edits."
|
|
41
|
+
*
|
|
42
|
+
* @param ctx - Extension context
|
|
43
|
+
* @param session - Session snapshot at task completion
|
|
44
|
+
* @returns Array of principle reflections
|
|
45
|
+
*/
|
|
46
|
+
export function reflectPrinciples(ctx, session) {
|
|
47
|
+
const principles = [];
|
|
48
|
+
const taskContext = buildTaskContext(session);
|
|
49
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION)
|
|
50
|
+
return principles;
|
|
51
|
+
// Pattern: edits without prior think
|
|
52
|
+
if (session.editCalls > 0 && session.thinkCalls === 0) {
|
|
53
|
+
principles.push({
|
|
54
|
+
type: "principle",
|
|
55
|
+
content: "Before editing files, call think(observation, decision, reason) to validate your reasoning first. Editing without thinking is the most common source of wasted turns.",
|
|
56
|
+
confidence: session.editCalls > 3 ? STRONG_PATTERN_CONFIDENCE : MODERATE_PATTERN_CONFIDENCE,
|
|
57
|
+
taskContext,
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
// Pattern: edits without verification
|
|
61
|
+
if (session.editCalls + session.writeCalls > 0 && session.verifyCalls === 0) {
|
|
62
|
+
principles.push({
|
|
63
|
+
type: "principle",
|
|
64
|
+
content: 'After changing code, run verify(target="code", criteria=["...", "..."]) before moving on. Verification catches errors that rereading would miss.',
|
|
65
|
+
confidence: session.editCalls + session.writeCalls > 3
|
|
66
|
+
? STRONG_PATTERN_CONFIDENCE
|
|
67
|
+
: MODERATE_PATTERN_CONFIDENCE,
|
|
68
|
+
taskContext,
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
// Pattern: work without scratchpad
|
|
72
|
+
if (session.totalToolCalls > 5 && session.scratchpadCalls === 0) {
|
|
73
|
+
principles.push({
|
|
74
|
+
type: "principle",
|
|
75
|
+
content: 'Before starting work, set a goal with scratchpad(action="set_goal", text="...") and break it into steps with scratchpad(action="add_plan", text="..."). A clear plan prevents drift and enables session resumption.',
|
|
76
|
+
confidence: session.totalToolCalls > 10 ? STRONG_PATTERN_CONFIDENCE : WEAK_PATTERN_CONFIDENCE,
|
|
77
|
+
taskContext,
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
// Pattern: high error rate
|
|
81
|
+
if (session.errorCount > 0 && session.totalToolCalls > 0) {
|
|
82
|
+
const errorRate = session.errorCount / session.totalToolCalls;
|
|
83
|
+
if (errorRate > 0.3) {
|
|
84
|
+
principles.push({
|
|
85
|
+
type: "principle",
|
|
86
|
+
content: 'When tool errors recur, step back and think(type="reflection") to identify the root cause. The tools work reliably — the failure is almost always an agent mistake: wrong arguments, stale content, or incorrect indentation.',
|
|
87
|
+
confidence: errorRate > 0.5 ? STRONG_PATTERN_CONFIDENCE : MODERATE_PATTERN_CONFIDENCE,
|
|
88
|
+
taskContext,
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
// Pattern: narrow tool diversity (over-reliance on a single tool category)
|
|
93
|
+
if (session.uniqueToolCount <= 3 && session.totalToolCalls >= 8) {
|
|
94
|
+
principles.push({
|
|
95
|
+
type: "principle",
|
|
96
|
+
content: `Used only ${session.uniqueToolCount} unique tools across ${session.totalToolCalls} calls. Consider a broader approach: grep/find for code search, read for context, think for reasoning — each tool serves a different purpose.`,
|
|
97
|
+
confidence: MODERATE_PATTERN_CONFIDENCE,
|
|
98
|
+
taskContext,
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
return principles;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Analyze the session snapshot and produce procedure reflections.
|
|
105
|
+
* Procedure reflections capture the concrete steps that led to success,
|
|
106
|
+
* stored as episodic memory for cross-session retrieval.
|
|
107
|
+
*
|
|
108
|
+
* @param ctx - Extension context
|
|
109
|
+
* @param session - Session snapshot at task completion
|
|
110
|
+
* @returns Array of procedure reflections
|
|
111
|
+
*/
|
|
112
|
+
export function reflectProcedures(ctx, session) {
|
|
113
|
+
const procedures = [];
|
|
114
|
+
const taskContext = buildTaskContext(session);
|
|
115
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION)
|
|
116
|
+
return procedures;
|
|
117
|
+
// Classify task type based on tool distribution
|
|
118
|
+
const taskType = classifyTaskType(session);
|
|
119
|
+
const procedureSteps = buildProcedureDescription(session, taskType);
|
|
120
|
+
if (procedureSteps) {
|
|
121
|
+
procedures.push({
|
|
122
|
+
type: "procedure",
|
|
123
|
+
content: procedureSteps,
|
|
124
|
+
confidence: session.finalizeCalled ? MODERATE_PATTERN_CONFIDENCE : WEAK_PATTERN_CONFIDENCE,
|
|
125
|
+
taskContext,
|
|
126
|
+
});
|
|
127
|
+
}
|
|
128
|
+
return procedures;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Full reflection pass — runs both principle and procedure reflection
|
|
132
|
+
* and stores the results to heuristics/episodic memory. This is the
|
|
133
|
+
* main entry point for the mars-handler.
|
|
134
|
+
*
|
|
135
|
+
* @param ctx - Extension context
|
|
136
|
+
* @param session - Session snapshot at task completion
|
|
137
|
+
* @returns Array of all reflections produced
|
|
138
|
+
*/
|
|
139
|
+
export function reflectOnTaskCompletion(ctx, session) {
|
|
140
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION)
|
|
141
|
+
return [];
|
|
142
|
+
if (session.turnCount < MIN_TURNS_FOR_REFLECTION)
|
|
143
|
+
return [];
|
|
144
|
+
const reflections = [];
|
|
145
|
+
// Principle reflections
|
|
146
|
+
const principles = reflectPrinciples(ctx, session);
|
|
147
|
+
for (const p of principles) {
|
|
148
|
+
log.info(`Principle reflection: "${p.content.slice(0, 80)}..." (confidence=${p.confidence})`);
|
|
149
|
+
storePrinciple(ctx, p);
|
|
150
|
+
}
|
|
151
|
+
reflections.push(...principles);
|
|
152
|
+
// Procedure reflections — only on actual completion
|
|
153
|
+
if (session.finalizeCalled) {
|
|
154
|
+
const procedures = reflectProcedures(ctx, session);
|
|
155
|
+
for (const p of procedures) {
|
|
156
|
+
log.info(`Procedure reflection: "${p.content.slice(0, 80)}..." (confidence=${p.confidence})`);
|
|
157
|
+
storeProcedure(ctx, p);
|
|
158
|
+
}
|
|
159
|
+
reflections.push(...procedures);
|
|
160
|
+
}
|
|
161
|
+
return reflections;
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* Store a principle reflection as a heuristic rule via the three-memory-stores.
|
|
165
|
+
* Principles with sufficient confidence are added as heuristics; evolver.ts
|
|
166
|
+
* will boost/discount them over time based on actual usage.
|
|
167
|
+
*/
|
|
168
|
+
function storePrinciple(ctx, reflection) {
|
|
169
|
+
if (reflection.confidence < WEAK_PATTERN_CONFIDENCE)
|
|
170
|
+
return;
|
|
171
|
+
const memState = getMemoryState(ctx);
|
|
172
|
+
if (!memState) {
|
|
173
|
+
log.debug("Cannot store principle: no memory state available");
|
|
174
|
+
return;
|
|
175
|
+
}
|
|
176
|
+
const condition = extractCondition(reflection.content);
|
|
177
|
+
addPrinciple(memState, reflection.content, condition);
|
|
178
|
+
log.info(`Stored principle "${reflection.content.slice(0, 60)}..." as heuristic [condition=${condition}]`);
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Store a procedure reflection as an episodic memory entry.
|
|
182
|
+
* Procedures are stored with tags for cross-session retrieval.
|
|
183
|
+
*/
|
|
184
|
+
function storeProcedure(ctx, reflection) {
|
|
185
|
+
// Parity with storePrinciple: reflections below weak confidence are noise.
|
|
186
|
+
if (reflection.confidence < WEAK_PATTERN_CONFIDENCE)
|
|
187
|
+
return;
|
|
188
|
+
const memState = getMemoryState(ctx);
|
|
189
|
+
if (!memState) {
|
|
190
|
+
log.debug("Cannot store procedure: no memory state available");
|
|
191
|
+
return;
|
|
192
|
+
}
|
|
193
|
+
const tags = extractProcedureTags(reflection.taskContext);
|
|
194
|
+
const project = deriveProject(ctx);
|
|
195
|
+
const gate = applyWriteGateLogged(getMemoryWriteGateConfig(), {
|
|
196
|
+
site: "mars",
|
|
197
|
+
task: reflection.taskContext,
|
|
198
|
+
solution: reflection.content,
|
|
199
|
+
recent: selectRecentEpisodes(memState.episodes, project),
|
|
200
|
+
});
|
|
201
|
+
if (!gate.write) {
|
|
202
|
+
log.info(`Procedure reflection ${describeWriteDecision(gate.decision)}: ` +
|
|
203
|
+
`"${reflection.taskContext.slice(0, 60)}..."`);
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
addEpisode(memState, reflection.taskContext, gate.solution, "success", [], [...tags, "mars-reflection", "procedure"], project);
|
|
207
|
+
log.info(`Stored procedure for "${reflection.taskContext.slice(0, 60)}..." as episode`);
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Build a human-readable task context string from the session snapshot.
|
|
211
|
+
*/
|
|
212
|
+
function buildTaskContext(session) {
|
|
213
|
+
if (session.toolsUsed.length === 0)
|
|
214
|
+
return "empty session";
|
|
215
|
+
const uniqueTools = [...new Set(session.toolsUsed.slice(-10))].slice(0, 5);
|
|
216
|
+
const toolStr = uniqueTools.join(", ");
|
|
217
|
+
return `${session.totalToolCalls} tool calls, ${session.uniqueToolCount} unique tools (${toolStr}), ${session.turnCount} turns, ${session.errorCount} errors`;
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Classify the task type based on tool distribution.
|
|
221
|
+
*/
|
|
222
|
+
function classifyTaskType(session) {
|
|
223
|
+
const hasCodeTools = session.editCalls > 0 || session.writeCalls > 0;
|
|
224
|
+
const hasVerifyTools = session.verifyCalls > 0;
|
|
225
|
+
const hasSearchTools = session.toolsUsed.some((t) => ["grep", "find", "read"].includes(t));
|
|
226
|
+
const hasBrowserTools = session.toolsUsed.some((t) => ["browser_navigate", "browser_snapshot"].includes(t));
|
|
227
|
+
if (hasCodeTools && hasVerifyTools)
|
|
228
|
+
return "code-change-with-verification";
|
|
229
|
+
if (hasCodeTools)
|
|
230
|
+
return "code-change";
|
|
231
|
+
if (hasBrowserTools)
|
|
232
|
+
return "web-research";
|
|
233
|
+
if (hasSearchTools && !hasCodeTools)
|
|
234
|
+
return "code-exploration";
|
|
235
|
+
if (hasSearchTools)
|
|
236
|
+
return "research";
|
|
237
|
+
return "general";
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Build a procedure description from the session tool usage pattern.
|
|
241
|
+
*/
|
|
242
|
+
function buildProcedureDescription(session, taskType) {
|
|
243
|
+
const steps = [];
|
|
244
|
+
switch (taskType) {
|
|
245
|
+
case "code-change-with-verification":
|
|
246
|
+
steps.push("1. Understand the problem (read error, grep for symptom)");
|
|
247
|
+
steps.push("2. Plan the fix (think about root cause, consider alternatives)");
|
|
248
|
+
steps.push("3. Edit the fix (use edit/write for targeted changes)");
|
|
249
|
+
steps.push("4. Verify correctness (use verify tool to check)");
|
|
250
|
+
steps.push("5. Confirm completion (run tests, call finalize)");
|
|
251
|
+
break;
|
|
252
|
+
case "code-change":
|
|
253
|
+
steps.push("1. Read the relevant files to understand current state");
|
|
254
|
+
steps.push("2. Think about the approach and alternatives");
|
|
255
|
+
steps.push("3. Make the code change (edit/write)");
|
|
256
|
+
steps.push("4. Verify the change before moving on");
|
|
257
|
+
break;
|
|
258
|
+
case "web-research":
|
|
259
|
+
steps.push("1. Navigate to the source (browser_navigate)");
|
|
260
|
+
steps.push("2. Extract relevant content (browser_*)");
|
|
261
|
+
steps.push("3. Synthesize findings into structured notes");
|
|
262
|
+
break;
|
|
263
|
+
case "code-exploration":
|
|
264
|
+
steps.push("1. Search for relevant symbols/types (grep/find)");
|
|
265
|
+
steps.push("2. Read the files to understand structure (read)");
|
|
266
|
+
steps.push("3. Map dependencies and interfaces");
|
|
267
|
+
break;
|
|
268
|
+
case "research":
|
|
269
|
+
steps.push("1. Fetch the source material (fetch_content/read)");
|
|
270
|
+
steps.push("2. Extract key claims and evidence");
|
|
271
|
+
steps.push("3. Verify claims against multiple sources");
|
|
272
|
+
break;
|
|
273
|
+
default:
|
|
274
|
+
return null;
|
|
275
|
+
}
|
|
276
|
+
return `Procedure for ${taskType}:\n${steps.join("\n")}`;
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* Extract a heuristic condition from a principle's content.
|
|
280
|
+
* The condition is used by the recaller to match against current context.
|
|
281
|
+
*/
|
|
282
|
+
function extractCondition(principleContent) {
|
|
283
|
+
const patterns = [
|
|
284
|
+
/(before\s+\w+)/i,
|
|
285
|
+
/(after\s+\w+)/i,
|
|
286
|
+
/(when\s+\w+)/i,
|
|
287
|
+
/(\w+\s+is\s+the most common)/i,
|
|
288
|
+
];
|
|
289
|
+
for (const pattern of patterns) {
|
|
290
|
+
const match = principleContent.match(pattern);
|
|
291
|
+
if (match)
|
|
292
|
+
return match[1].toLowerCase();
|
|
293
|
+
}
|
|
294
|
+
// Fallback: use first meaningful verb phrase
|
|
295
|
+
const firstSentence = principleContent.split(/[.!]/)[0];
|
|
296
|
+
return firstSentence.slice(0, 60).toLowerCase();
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* Extract tags from the task context for episodic storage.
|
|
300
|
+
*/
|
|
301
|
+
function extractProcedureTags(taskContext) {
|
|
302
|
+
const tags = [];
|
|
303
|
+
if (taskContext.includes("error"))
|
|
304
|
+
tags.push("error-recovery");
|
|
305
|
+
if (taskContext.includes("code"))
|
|
306
|
+
tags.push("code");
|
|
307
|
+
if (taskContext.includes("research"))
|
|
308
|
+
tags.push("research");
|
|
309
|
+
if (/unique|diverse/.test(taskContext))
|
|
310
|
+
tags.push("tool-usage");
|
|
311
|
+
return tags;
|
|
312
|
+
}
|
|
313
|
+
/**
|
|
314
|
+
* MARS Reflector extension factory.
|
|
315
|
+
*
|
|
316
|
+
* This extension provides reflection utilities consumed by the enforcement
|
|
317
|
+
* mars-handler. It does not register any tools or event handlers of its own;
|
|
318
|
+
* the factory is a no-op required for manifest registration.
|
|
319
|
+
*
|
|
320
|
+
* Reflection dispatch happens in enforcement/mars-handler (turn_end handler)
|
|
321
|
+
* which imports reflectOnTaskCompletion from this module.
|
|
322
|
+
*/
|
|
323
|
+
export default function marsReflectorExtension() {
|
|
324
|
+
// No-op: utility-only extension.
|
|
325
|
+
// Reflection is triggered by enforcement/mars-handler on turn_end.
|
|
326
|
+
}
|
|
327
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Claim Verification Tool - verify_claim (action=claim|decomposition).
|
|
3
|
+
*
|
|
4
|
+
* Cross-checks agent claims against retrieved context and verifies task
|
|
5
|
+
* decomposition coverage. Uses the triple-critic LLM classification system
|
|
6
|
+
* with three-tier fallback (heuristic -> utility model -> session model).
|
|
7
|
+
*
|
|
8
|
+
* PRIMARY PATH: consolidated single-LLM-call (3 dimensions in one JSON
|
|
9
|
+
* response). FALLBACK PATH: 3 individual classify() calls. The consolidated
|
|
10
|
+
* path replaces ~3 separate LLM calls with 1, reducing latency by ~66%.
|
|
11
|
+
*
|
|
12
|
+
* These tools are co-located with `verify` in this directory because they
|
|
13
|
+
* share the "verification" concept; they are registered from
|
|
14
|
+
* `metacognition/index.ts` alongside `think`/`hypothesize`/`verify`/`finalize`.
|
|
15
|
+
*/
|
|
16
|
+
import type { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
|
|
17
|
+
/**
|
|
18
|
+
* Register the verify_claim tool (action=claim|decomposition).
|
|
19
|
+
* Called by metacognition/index.ts during extension setup.
|
|
20
|
+
*/
|
|
21
|
+
export declare function createVerifyClaimTool(): ToolDefinition<any, any, any>;
|
|
22
|
+
export declare function registerClaimVerificationTools(pi: ExtensionAPI): void;
|
|
23
|
+
//# sourceMappingURL=claim-verification.d.ts.map
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Claim Verification Tool - verify_claim (action=claim|decomposition).
|
|
3
|
+
*
|
|
4
|
+
* Cross-checks agent claims against retrieved context and verifies task
|
|
5
|
+
* decomposition coverage. Uses the triple-critic LLM classification system
|
|
6
|
+
* with three-tier fallback (heuristic -> utility model -> session model).
|
|
7
|
+
*
|
|
8
|
+
* PRIMARY PATH: consolidated single-LLM-call (3 dimensions in one JSON
|
|
9
|
+
* response). FALLBACK PATH: 3 individual classify() calls. The consolidated
|
|
10
|
+
* path replaces ~3 separate LLM calls with 1, reducing latency by ~66%.
|
|
11
|
+
*
|
|
12
|
+
* These tools are co-located with `verify` in this directory because they
|
|
13
|
+
* share the "verification" concept; they are registered from
|
|
14
|
+
* `metacognition/index.ts` alongside `think`/`hypothesize`/`verify`/`finalize`.
|
|
15
|
+
*/
|
|
16
|
+
import { Type } from "typebox";
|
|
17
|
+
import { createLogger } from "../../../../lib/core/logger.js";
|
|
18
|
+
import { classify } from "../../../../lib/ai/text-classifier.js";
|
|
19
|
+
import { CRITICS } from "../../../../lib/ai/critic-registry.js";
|
|
20
|
+
import { consolidatedClaimCritique } from "../../../../lib/ai/consolidated-claim-critic.js";
|
|
21
|
+
const log = createLogger("metacognition:claim-verification");
|
|
22
|
+
function truncate(text, maxLen) {
|
|
23
|
+
return text.length > maxLen ? text.slice(0, maxLen) + "..." : text;
|
|
24
|
+
}
|
|
25
|
+
// verify_claim schema: one tool, one schema — action=claim verifies a single
|
|
26
|
+
// claim against retrieved context; action=decomposition verifies that a task
|
|
27
|
+
// decomposition covers the parent task.
|
|
28
|
+
const verifyClaimSchema = Type.Object({
|
|
29
|
+
action: Type.Union([Type.Literal("claim"), Type.Literal("decomposition")], {
|
|
30
|
+
description: "Action: claim | decomposition",
|
|
31
|
+
}),
|
|
32
|
+
claim: Type.String({ description: "The claim or statement to verify" }),
|
|
33
|
+
context: Type.Array(Type.String(), {
|
|
34
|
+
description: "Retrieved context strings to verify against",
|
|
35
|
+
}),
|
|
36
|
+
claimId: Type.Optional(Type.String({ description: "Optional ID for tracking this claim" })),
|
|
37
|
+
threshold: Type.Optional(Type.Number({
|
|
38
|
+
description: "Confidence threshold for support check (0-1). Default: 0.5",
|
|
39
|
+
minimum: 0,
|
|
40
|
+
maximum: 1,
|
|
41
|
+
})),
|
|
42
|
+
});
|
|
43
|
+
// Individual critics (FALLBACK PATH)
|
|
44
|
+
async function checkContradiction(claim, context, ctx) {
|
|
45
|
+
try {
|
|
46
|
+
const result = await classify(ctx, CRITICS.claimContradiction.criteria, { claim, context }, {
|
|
47
|
+
tierPolicy: "always-llm",
|
|
48
|
+
});
|
|
49
|
+
if (result.label === "yes") {
|
|
50
|
+
return {
|
|
51
|
+
type: "contradiction",
|
|
52
|
+
severity: "high",
|
|
53
|
+
description: `Claim contradicts context: ${truncate(claim, 100)}`,
|
|
54
|
+
quote: claim,
|
|
55
|
+
classifierDown: result.tier === "failed",
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
return null;
|
|
59
|
+
}
|
|
60
|
+
catch (err) {
|
|
61
|
+
log.debug(`checkContradiction failed: ${err}`);
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
async function checkSupport(claim, context, ctx) {
|
|
66
|
+
const contextText = context.join("\n\n---\n\n");
|
|
67
|
+
try {
|
|
68
|
+
const result = await classify(ctx, CRITICS.claimSupported.criteria, { claim, context: contextText }, {
|
|
69
|
+
tierPolicy: "always-llm",
|
|
70
|
+
});
|
|
71
|
+
return {
|
|
72
|
+
supported: result.label === "yes",
|
|
73
|
+
classifierDown: result.tier === "failed",
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
catch (err) {
|
|
77
|
+
log.debug(`checkSupport failed: ${err}`);
|
|
78
|
+
return { supported: false, classifierDown: true };
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
async function checkOverconfidence(claim, ctx) {
|
|
82
|
+
const issues = [];
|
|
83
|
+
try {
|
|
84
|
+
const result = await classify(ctx, CRITICS.claimOverconfidence.criteria, { claim }, {
|
|
85
|
+
tierPolicy: "always-llm",
|
|
86
|
+
});
|
|
87
|
+
if (result.label === "yes") {
|
|
88
|
+
issues.push({
|
|
89
|
+
type: "hedge_warning",
|
|
90
|
+
severity: "low",
|
|
91
|
+
description: "Claim uses overconfident language without sufficient evidence",
|
|
92
|
+
quote: claim,
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
return { issues, classifierDown: result.tier === "failed" };
|
|
96
|
+
}
|
|
97
|
+
catch (err) {
|
|
98
|
+
log.debug(`checkOverconfidence failed: ${err}`);
|
|
99
|
+
return { issues: [], classifierDown: true };
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Register the verify_claim tool (action=claim|decomposition).
|
|
104
|
+
* Called by metacognition/index.ts during extension setup.
|
|
105
|
+
*/
|
|
106
|
+
export function createVerifyClaimTool() {
|
|
107
|
+
return {
|
|
108
|
+
name: "verify_claim",
|
|
109
|
+
label: "Verify Claim",
|
|
110
|
+
promptSnippet: "Verify agent claims against retrieved context",
|
|
111
|
+
description: "Verify claims against retrieved context: contradictions, unsupported assertions, hedge wording. action=decomposition for task coverage.",
|
|
112
|
+
parameters: verifyClaimSchema,
|
|
113
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
|
|
114
|
+
try {
|
|
115
|
+
const p = params;
|
|
116
|
+
if (!p.claim || !Array.isArray(p.context)) {
|
|
117
|
+
throw new Error("verify_claim requires 'claim' (string) and 'context' (string array)");
|
|
118
|
+
}
|
|
119
|
+
const claimId = p.claimId ?? `claim-${Date.now()}`;
|
|
120
|
+
const issues = [];
|
|
121
|
+
// PRIMARY PATH: consolidated single-LLM-call
|
|
122
|
+
let consolidatedUsed = false;
|
|
123
|
+
try {
|
|
124
|
+
const contextJoined = p.context.join("\n\n---\n\n");
|
|
125
|
+
const consolidated = await consolidatedClaimCritique(p.claim, contextJoined, ctx);
|
|
126
|
+
if (consolidated && !consolidated.classifierDown) {
|
|
127
|
+
consolidatedUsed = true;
|
|
128
|
+
if (consolidated.contradiction) {
|
|
129
|
+
issues.push({
|
|
130
|
+
type: "contradiction",
|
|
131
|
+
severity: "high",
|
|
132
|
+
description: `Claim contradicts context: ${truncate(p.claim, 100)}`,
|
|
133
|
+
quote: p.claim,
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
if (!consolidated.supported && p.context.length > 0) {
|
|
137
|
+
issues.push({
|
|
138
|
+
type: "unsupported",
|
|
139
|
+
severity: "medium",
|
|
140
|
+
description: "Claim not sufficiently supported by any retrieved context.",
|
|
141
|
+
quote: p.claim,
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
if (consolidated.overconfidence) {
|
|
145
|
+
issues.push({
|
|
146
|
+
type: "hedge_warning",
|
|
147
|
+
severity: "low",
|
|
148
|
+
description: "Claim uses overconfident language without sufficient evidence",
|
|
149
|
+
quote: p.claim,
|
|
150
|
+
});
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
catch {
|
|
155
|
+
// Fall through to individual checks
|
|
156
|
+
}
|
|
157
|
+
// FALLBACK PATH: individual classify calls
|
|
158
|
+
let fallbackClassifierDown = false;
|
|
159
|
+
if (!consolidatedUsed) {
|
|
160
|
+
const contradictionChecks = p.context.map((ctxStr) => checkContradiction(p.claim, ctxStr, ctx));
|
|
161
|
+
const contradictionResults = await Promise.allSettled(contradictionChecks);
|
|
162
|
+
for (const r of contradictionResults) {
|
|
163
|
+
if (r.status === "fulfilled" && r.value)
|
|
164
|
+
issues.push(r.value);
|
|
165
|
+
}
|
|
166
|
+
const [supportedSettled, overconfidenceIssuesSettled] = await Promise.allSettled([
|
|
167
|
+
checkSupport(p.claim, p.context, ctx),
|
|
168
|
+
checkOverconfidence(p.claim, ctx),
|
|
169
|
+
]);
|
|
170
|
+
const supportedResult = supportedSettled.status === "fulfilled"
|
|
171
|
+
? supportedSettled.value
|
|
172
|
+
: { supported: false, classifierDown: true };
|
|
173
|
+
const overconfidenceResult = overconfidenceIssuesSettled.status === "fulfilled"
|
|
174
|
+
? overconfidenceIssuesSettled.value
|
|
175
|
+
: { issues: [], classifierDown: true };
|
|
176
|
+
const supported = supportedResult.supported;
|
|
177
|
+
const overconfidenceIssues = overconfidenceResult.issues;
|
|
178
|
+
fallbackClassifierDown =
|
|
179
|
+
supportedResult.classifierDown || overconfidenceResult.classifierDown;
|
|
180
|
+
if (!supported && p.context.length > 0) {
|
|
181
|
+
issues.push({
|
|
182
|
+
type: "unsupported",
|
|
183
|
+
severity: "medium",
|
|
184
|
+
description: "Claim not sufficiently supported by any retrieved context.",
|
|
185
|
+
quote: p.claim,
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
issues.push(...overconfidenceIssues);
|
|
189
|
+
}
|
|
190
|
+
const anyClassifierDown = consolidatedUsed ? false : fallbackClassifierDown;
|
|
191
|
+
const severityOrder = { high: 0, medium: 1, low: 2 };
|
|
192
|
+
issues.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
|
|
193
|
+
const highIssues = issues.filter((i) => i.severity === "high");
|
|
194
|
+
const summary = anyClassifierDown
|
|
195
|
+
? `Claim verification DEGRADED: classifier unavailable this turn. No issues were positively detected, but the check could not run normally. Treat this result as "not verified, not contradicted" rather than "verified." Run /logs level info for the underlying error.`
|
|
196
|
+
: highIssues.length > 0
|
|
197
|
+
? `${highIssues.length} high-severity issue(s): ${highIssues.map((i) => i.description).join("; ")}`
|
|
198
|
+
: issues.length > 0
|
|
199
|
+
? `${issues.length} issue(s): ${issues.map((i) => `${i.type}(${i.severity})`).join(", ")}`
|
|
200
|
+
: "Claim verified: no contradictions, supported by context.";
|
|
201
|
+
return {
|
|
202
|
+
content: [{ type: "text", text: summary }],
|
|
203
|
+
details: {
|
|
204
|
+
claimId,
|
|
205
|
+
verified: highIssues.length === 0 && !anyClassifierDown,
|
|
206
|
+
issues,
|
|
207
|
+
summary,
|
|
208
|
+
classifierDown: anyClassifierDown,
|
|
209
|
+
checks: {
|
|
210
|
+
contradictions: issues.filter((i) => i.type === "contradiction").length,
|
|
211
|
+
unsupported: issues.filter((i) => i.type === "unsupported").length,
|
|
212
|
+
hedgeWarnings: issues.filter((i) => i.type === "hedge_warning").length,
|
|
213
|
+
gaps: 0,
|
|
214
|
+
},
|
|
215
|
+
},
|
|
216
|
+
};
|
|
217
|
+
}
|
|
218
|
+
catch (err) {
|
|
219
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
220
|
+
log.error(`verify_claim failed: ${msg}`);
|
|
221
|
+
return {
|
|
222
|
+
content: [{ type: "text", text: `Error: ${msg}` }],
|
|
223
|
+
details: { verified: false, issues: [], summary: `Error: ${msg}`, error: msg },
|
|
224
|
+
};
|
|
225
|
+
}
|
|
226
|
+
},
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
export function registerClaimVerificationTools(pi) {
|
|
230
|
+
pi.registerTool(createVerifyClaimTool());
|
|
231
|
+
log.info("Registered claim verification tool: verify_claim (claim + decomposition actions)");
|
|
232
|
+
}
|
|
233
|
+
//# sourceMappingURL=claim-verification.js.map
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { ExtensionContext, ToolDefinition } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
/**
|
|
3
|
+
* Record shipped deliverables to a disk manifest so the verification judge
|
|
4
|
+
* has ground truth that survives tool-log truncation / context compaction.
|
|
5
|
+
*
|
|
6
|
+
* The original manifest was written to a GLOBAL home-dir path
|
|
7
|
+
* (~/.pi/agent/braid/deliverables/deliverables.jsonl) shared across every
|
|
8
|
+
* project, and it listed EVERY git-dirty file in the repo, including
|
|
9
|
+
* pre-existing strays the task never touched (e.g. an untouched scratch file). Fixed:
|
|
10
|
+
* - manifest is project-scoped under the braid home at
|
|
11
|
+
* <braidDir>/projects/<sanitized repo>/deliverables.jsonl (resolved via
|
|
12
|
+
* getDeliverablesFilePath), so no cross-project leakage and no
|
|
13
|
+
* <repo>/.braid artifacts in the working tree.
|
|
14
|
+
* - only files this session actually touched via edit/write (bidirectional-
|
|
15
|
+
* verifier editedFiles) that are dirty in git AND inside the project are
|
|
16
|
+
* recorded. Files the task didn't touch are never installed.
|
|
17
|
+
* Fire-and-forget from finalize.
|
|
18
|
+
*/
|
|
19
|
+
export declare function recordDeliverables(ctx: ExtensionContext, summary: string, completed: boolean): Promise<void>;
|
|
20
|
+
export interface FinalizeCallbacks {
|
|
21
|
+
onFinalize?: (summary: string, completed: boolean) => void;
|
|
22
|
+
recordCalibration?: (ctx: ExtensionContext, confidence: number, outcome: "success" | "failure") => void;
|
|
23
|
+
/** Write a label through the extension API (`pi.setLabel`). */
|
|
24
|
+
setLabel?: (entryId: string, label: string) => void;
|
|
25
|
+
}
|
|
26
|
+
export declare function createFinalizeTool(callbacks?: FinalizeCallbacks): ToolDefinition<any, any, any>;
|
|
27
|
+
//# sourceMappingURL=finalize.d.ts.map
|