pi-braid 0.0.0-stage → 0.40.1
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 +266 -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 +166 -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 +502 -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,174 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Lightweight Reasoning Stability Metrics
|
|
3
|
+
*
|
|
4
|
+
* Approximates reasoning quality WITHOUT logprobs or model internals.
|
|
5
|
+
* Based on: MEASUREMENT_GAP_SOLUTION.md
|
|
6
|
+
*
|
|
7
|
+
* Three metrics:
|
|
8
|
+
* 1. Topic anchor overlap - did the response stay on topic?
|
|
9
|
+
* 2. Bigram entropy - is output repetitive (overconfident) or chaotic (uncertain)?
|
|
10
|
+
* 3. Self-contradiction - did the response contradict itself?
|
|
11
|
+
*
|
|
12
|
+
* Usage:
|
|
13
|
+
* ```ts
|
|
14
|
+
* const result = measureStability(userRequest, agentResponse);
|
|
15
|
+
* if (!result.stable) sendEnforcementWhisper(result.reason);
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
/** Check if a response is reasoning-stable relative to a request */
|
|
19
|
+
export function measureStability(request, response) {
|
|
20
|
+
const anchors = extractAnchors(request);
|
|
21
|
+
const overlap = anchors.size > 0 ? measureOverlap(response, anchors) : 1.0;
|
|
22
|
+
const entropy = measureBigramEntropy(response);
|
|
23
|
+
const contradictions = countSelfContradictions(response);
|
|
24
|
+
const metrics = { overlap, entropy, contradictions };
|
|
25
|
+
// Thresholds (conservative - warn-only, never block)
|
|
26
|
+
// Entropy check first: repetitive is stronger signal than topic drift
|
|
27
|
+
if (entropy < 0.15) {
|
|
28
|
+
return { stable: false, reason: "repetitive", metrics };
|
|
29
|
+
}
|
|
30
|
+
if (anchors.size > 0 && overlap < 0.15) {
|
|
31
|
+
return { stable: false, reason: "topic_drift", metrics };
|
|
32
|
+
}
|
|
33
|
+
if (contradictions > 2) {
|
|
34
|
+
return { stable: false, reason: "self_contradiction", metrics };
|
|
35
|
+
}
|
|
36
|
+
return { stable: true, reason: "ok", metrics };
|
|
37
|
+
}
|
|
38
|
+
/** Extract topic anchors (significant words) from text */
|
|
39
|
+
export function extractAnchors(text) {
|
|
40
|
+
const STOP = new Set([
|
|
41
|
+
"the",
|
|
42
|
+
"and",
|
|
43
|
+
"that",
|
|
44
|
+
"this",
|
|
45
|
+
"with",
|
|
46
|
+
"from",
|
|
47
|
+
"your",
|
|
48
|
+
"have",
|
|
49
|
+
"more",
|
|
50
|
+
"are",
|
|
51
|
+
"was",
|
|
52
|
+
"will",
|
|
53
|
+
"can",
|
|
54
|
+
"for",
|
|
55
|
+
"not",
|
|
56
|
+
"but",
|
|
57
|
+
"they",
|
|
58
|
+
"you",
|
|
59
|
+
"all",
|
|
60
|
+
"get",
|
|
61
|
+
"has",
|
|
62
|
+
"how",
|
|
63
|
+
"its",
|
|
64
|
+
"may",
|
|
65
|
+
"new",
|
|
66
|
+
"now",
|
|
67
|
+
"see",
|
|
68
|
+
"who",
|
|
69
|
+
"did",
|
|
70
|
+
"she",
|
|
71
|
+
"use",
|
|
72
|
+
"our",
|
|
73
|
+
"out",
|
|
74
|
+
"any",
|
|
75
|
+
"just",
|
|
76
|
+
"like",
|
|
77
|
+
"then",
|
|
78
|
+
"also",
|
|
79
|
+
"into",
|
|
80
|
+
"very",
|
|
81
|
+
"what",
|
|
82
|
+
"when",
|
|
83
|
+
"where",
|
|
84
|
+
"which",
|
|
85
|
+
"would",
|
|
86
|
+
"could",
|
|
87
|
+
"should",
|
|
88
|
+
"about",
|
|
89
|
+
"been",
|
|
90
|
+
"being",
|
|
91
|
+
"some",
|
|
92
|
+
"than",
|
|
93
|
+
"them",
|
|
94
|
+
"there",
|
|
95
|
+
"these",
|
|
96
|
+
"those",
|
|
97
|
+
"want",
|
|
98
|
+
"make",
|
|
99
|
+
"made",
|
|
100
|
+
"after",
|
|
101
|
+
"before",
|
|
102
|
+
"between",
|
|
103
|
+
"each",
|
|
104
|
+
]);
|
|
105
|
+
const tokens = text.toLowerCase().split(/\W+/);
|
|
106
|
+
return new Set(tokens.filter((t) => t.length > 3 && !STOP.has(t)));
|
|
107
|
+
}
|
|
108
|
+
/** Measure word overlap between text and anchors */
|
|
109
|
+
export function measureOverlap(text, anchors) {
|
|
110
|
+
if (anchors.size === 0)
|
|
111
|
+
return 1.0;
|
|
112
|
+
const tokens = new Set(text.toLowerCase().split(/\W+/));
|
|
113
|
+
let matches = 0;
|
|
114
|
+
for (const a of anchors) {
|
|
115
|
+
if (tokens.has(a))
|
|
116
|
+
matches++;
|
|
117
|
+
}
|
|
118
|
+
return matches / anchors.size;
|
|
119
|
+
}
|
|
120
|
+
/** Measure bigram entropy (diversity) of text */
|
|
121
|
+
export function measureBigramEntropy(text) {
|
|
122
|
+
const words = text
|
|
123
|
+
.toLowerCase()
|
|
124
|
+
.split(/\W+/)
|
|
125
|
+
.filter((w) => w.length > 0);
|
|
126
|
+
if (words.length < 2)
|
|
127
|
+
return 1.0;
|
|
128
|
+
const bigrams = [];
|
|
129
|
+
for (let i = 0; i < words.length - 1; i++) {
|
|
130
|
+
bigrams.push(`${words[i]} ${words[i + 1]}`);
|
|
131
|
+
}
|
|
132
|
+
const freq = new Map();
|
|
133
|
+
for (const bg of bigrams) {
|
|
134
|
+
freq.set(bg, (freq.get(bg) || 0) + 1);
|
|
135
|
+
}
|
|
136
|
+
return freq.size / bigrams.length; // Unique ratio: 1.0 = all unique, 0.0 = all same
|
|
137
|
+
}
|
|
138
|
+
/** Count self-contradictions in text (negation pattern detection) */
|
|
139
|
+
export function countSelfContradictions(text) {
|
|
140
|
+
const sentences = text
|
|
141
|
+
.split(/[.!?\n]+/)
|
|
142
|
+
.map((s) => s.trim())
|
|
143
|
+
.filter((s) => s.length > 10);
|
|
144
|
+
let contradictions = 0;
|
|
145
|
+
// Simple heuristic: look for "X is Y" and "X is not Y" or "X will" / "X won't"
|
|
146
|
+
const claims = new Map();
|
|
147
|
+
for (const sentence of sentences) {
|
|
148
|
+
// Extract "A is B" patterns
|
|
149
|
+
const isMatch = sentence.match(/^(\w[\w\s]{2,30}?)\s+(?:is|are|was|were|will|can|should|would)\s+(not\s+)?(.{3,40})$/i);
|
|
150
|
+
if (isMatch) {
|
|
151
|
+
const subject = isMatch[1].trim().toLowerCase();
|
|
152
|
+
const negated = isMatch[2] ? "not_" : "";
|
|
153
|
+
const claim = negated + isMatch[3].trim().toLowerCase();
|
|
154
|
+
if (!claims.has(subject))
|
|
155
|
+
claims.set(subject, []);
|
|
156
|
+
claims.get(subject)?.push(claim);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
// Check for contradictions: same subject, opposite claims
|
|
160
|
+
for (const [, claimList] of claims) {
|
|
161
|
+
for (let i = 0; i < claimList.length; i++) {
|
|
162
|
+
for (let j = i + 1; j < claimList.length; j++) {
|
|
163
|
+
const a = claimList[i];
|
|
164
|
+
const b = claimList[j];
|
|
165
|
+
// Direct negation: "not_X" vs "X"
|
|
166
|
+
if (a === "not_" + b || "not_" + a === b) {
|
|
167
|
+
contradictions++;
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
return contradictions;
|
|
173
|
+
}
|
|
174
|
+
//# sourceMappingURL=reasoning-metrics.js.map
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reasoning Chain Summarization (2604.15877) - Medium-Term Compression
|
|
3
|
+
*
|
|
4
|
+
* Two-tier detection:
|
|
5
|
+
* Tier 1 (regex, sync): Fast pre-filter to find candidate reasoning messages.
|
|
6
|
+
* Tier 2 (utility model, async): Confirm ambiguous blocks via classify().
|
|
7
|
+
* Runs on already-identified blocks, not individual messages.
|
|
8
|
+
*/
|
|
9
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
10
|
+
/** Tier 1: Regex pre-filter (sync, fast). */
|
|
11
|
+
export declare function isReasoningMessage(msg: {
|
|
12
|
+
role: string;
|
|
13
|
+
content?: string | unknown[];
|
|
14
|
+
}): boolean;
|
|
15
|
+
/** Tier 2: Confirmation via utility model (async, runs on identified blocks). */
|
|
16
|
+
export declare function confirmReasoningBlock(content: string, ctx: ExtensionContext): Promise<boolean>;
|
|
17
|
+
export declare function findReasoningBlocks(messages: Array<{
|
|
18
|
+
role: string;
|
|
19
|
+
content?: string | unknown[];
|
|
20
|
+
turn?: number;
|
|
21
|
+
}>, minBlockSize?: number): Array<{
|
|
22
|
+
startIndex: number;
|
|
23
|
+
endIndex: number;
|
|
24
|
+
messages: Array<{
|
|
25
|
+
role: string;
|
|
26
|
+
content: string;
|
|
27
|
+
turn: number;
|
|
28
|
+
}>;
|
|
29
|
+
}>;
|
|
30
|
+
export declare function extractReasoningSummary(block: any): string;
|
|
31
|
+
export declare function estimateTokensSaved(block: any): number;
|
|
32
|
+
export declare function shouldSummarizeReasoning(ctx: ExtensionContext): boolean;
|
|
33
|
+
export declare function recordSummarization(ctx: ExtensionContext, block: any, tokensSaved: number): void;
|
|
34
|
+
//# sourceMappingURL=reasoning-summary.d.ts.map
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
2
|
+
import { createLogger } from "../core/logger.js";
|
|
3
|
+
import { classify } from "../ai/text-classifier.js";
|
|
4
|
+
const log = createLogger("reasoning-summary");
|
|
5
|
+
const REASONING_PATTERNS = [
|
|
6
|
+
/\bI think\b/i,
|
|
7
|
+
/\bLet me\b/i,
|
|
8
|
+
/\bPerhaps\b/i,
|
|
9
|
+
/\bHowever\b/i,
|
|
10
|
+
/\bTherefore\b/i,
|
|
11
|
+
/\bFirst\b.*then\b/i,
|
|
12
|
+
/\bSo\b.*because\b/i,
|
|
13
|
+
/\bLet me analyze\b/i,
|
|
14
|
+
/\bThe approach\b/i,
|
|
15
|
+
/\bI need to\b/i,
|
|
16
|
+
/\bBased on\b.*I\b/i,
|
|
17
|
+
/\bLooking at\b.*we can\b/i,
|
|
18
|
+
];
|
|
19
|
+
/** Tier 1: Regex pre-filter (sync, fast). */
|
|
20
|
+
export function isReasoningMessage(msg) {
|
|
21
|
+
if (msg.role !== "assistant" || !msg.content)
|
|
22
|
+
return false;
|
|
23
|
+
const content = typeof msg.content === "string"
|
|
24
|
+
? msg.content
|
|
25
|
+
: Array.isArray(msg.content)
|
|
26
|
+
? msg.content.map((c) => c.text ?? "").join(" ")
|
|
27
|
+
: "";
|
|
28
|
+
if (content.trim().length < 20)
|
|
29
|
+
return false;
|
|
30
|
+
if (Array.isArray(msg.content) && msg.content.some((c) => c.type === "toolCall")) {
|
|
31
|
+
return REASONING_PATTERNS.filter((p) => p.test(content)).length >= 2;
|
|
32
|
+
}
|
|
33
|
+
return REASONING_PATTERNS.some((p) => p.test(content));
|
|
34
|
+
}
|
|
35
|
+
/** Tier 2: Confirmation via utility model (async, runs on identified blocks). */
|
|
36
|
+
export async function confirmReasoningBlock(content, ctx) {
|
|
37
|
+
try {
|
|
38
|
+
const result = await classify(ctx, {
|
|
39
|
+
systemPrompt: "You are a reasoning-content detector. Determine if the given text is " +
|
|
40
|
+
"part of the AI's reasoning process (thinking through a problem, " +
|
|
41
|
+
"analyzing options, justifying a decision) or just a response delivery. " +
|
|
42
|
+
"Answer only 'yes' or 'no'. Do not explain.",
|
|
43
|
+
userPrompt: "Is this reasoning?\n\n{{text}}",
|
|
44
|
+
}, { text: content.slice(0, 2000) }, { timeoutMs: 60_000 });
|
|
45
|
+
return result.label === "yes";
|
|
46
|
+
}
|
|
47
|
+
catch {
|
|
48
|
+
// If classify fails, keep the block (regex already identified it)
|
|
49
|
+
return true;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
export function findReasoningBlocks(messages, minBlockSize = 3) {
|
|
53
|
+
const blocks = [];
|
|
54
|
+
let current = null;
|
|
55
|
+
for (let i = 0; i < messages.length; i++) {
|
|
56
|
+
const msg = messages[i];
|
|
57
|
+
if (isReasoningMessage(msg)) {
|
|
58
|
+
const content = typeof msg.content === "string"
|
|
59
|
+
? msg.content
|
|
60
|
+
: Array.isArray(msg.content)
|
|
61
|
+
? msg.content.map((c) => c.text ?? "").join(" ")
|
|
62
|
+
: "";
|
|
63
|
+
if (!current)
|
|
64
|
+
current = { startIndex: i, endIndex: i, messages: [] };
|
|
65
|
+
current.endIndex = i;
|
|
66
|
+
current.messages.push({
|
|
67
|
+
role: msg.role,
|
|
68
|
+
content: content.slice(0, 500),
|
|
69
|
+
turn: msg.turn ?? i,
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
else if (current && current.messages.length >= minBlockSize) {
|
|
73
|
+
blocks.push(current);
|
|
74
|
+
current = null;
|
|
75
|
+
}
|
|
76
|
+
else {
|
|
77
|
+
current = null;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
if (current && current.messages.length >= minBlockSize)
|
|
81
|
+
blocks.push(current);
|
|
82
|
+
return blocks;
|
|
83
|
+
}
|
|
84
|
+
export function extractReasoningSummary(block) {
|
|
85
|
+
const last = block.messages[block.messages.length - 1]?.content ?? "";
|
|
86
|
+
const tools = [...new Set([...(last.match(/`([a-z]+)`\(/g) ?? [])])]
|
|
87
|
+
.map((t) => t.slice(1, -2))
|
|
88
|
+
.slice(0, 5);
|
|
89
|
+
const summary = `Reasoning chain (${block.messages.length} steps): ${last.slice(0, 500)}${tools.length ? ` [Tools: ${tools.join(", ")}]` : ""}`;
|
|
90
|
+
return summary.length > 600 ? summary.slice(0, 600) + "..." : summary;
|
|
91
|
+
}
|
|
92
|
+
export function estimateTokensSaved(block) {
|
|
93
|
+
const total = block.messages.reduce((s, m) => s + m.content.split(/\s+/).length * 1.33, 0);
|
|
94
|
+
const last = block.messages[block.messages.length - 1];
|
|
95
|
+
const summary = last ? last.content.split(/\s+/).length * 1.33 : 50;
|
|
96
|
+
return Math.max(0, total - summary);
|
|
97
|
+
}
|
|
98
|
+
export function shouldSummarizeReasoning(ctx) {
|
|
99
|
+
const state = getExtensionState(ctx, "reasoning-compression", () => ({
|
|
100
|
+
localTurnCount: 0,
|
|
101
|
+
lastSummaryTurn: 0,
|
|
102
|
+
summarizedCount: 0,
|
|
103
|
+
}));
|
|
104
|
+
state.localTurnCount++;
|
|
105
|
+
return state.localTurnCount - state.lastSummaryTurn > 20 && state.summarizedCount < 10;
|
|
106
|
+
}
|
|
107
|
+
export function recordSummarization(ctx, block, tokensSaved) {
|
|
108
|
+
const state = getExtensionState(ctx, "reasoning-compression", () => ({
|
|
109
|
+
localTurnCount: 0,
|
|
110
|
+
lastSummaryTurn: 0,
|
|
111
|
+
summarizedCount: 0,
|
|
112
|
+
totalTokensSaved: 0,
|
|
113
|
+
chainDepth: 0,
|
|
114
|
+
}));
|
|
115
|
+
state.localTurnCount++;
|
|
116
|
+
state.summarizedCount++;
|
|
117
|
+
state.totalTokensSaved += tokensSaved;
|
|
118
|
+
state.lastSummaryTurn = state.localTurnCount;
|
|
119
|
+
state.chainDepth = Math.max(state.chainDepth, block.messages.length);
|
|
120
|
+
log.debug(`Reasoning summarized: ${block.messages.length} steps -> ${Math.round(tokensSaved)} tokens saved`);
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=reasoning-summary.js.map
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool Usage Frequency Analyzer
|
|
3
|
+
*
|
|
4
|
+
* Analyzes agent tool usage patterns over a session and generates heuristic
|
|
5
|
+
* advice when a tool is used disproportionately or errors recur.
|
|
6
|
+
* Not based on any specific paper - simple statistical thresholding.
|
|
7
|
+
*
|
|
8
|
+
* Trigger: adaptive (not fixed N turns) - check on every turn_end.
|
|
9
|
+
* Only whispers if actionable advice exists.
|
|
10
|
+
*/
|
|
11
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
12
|
+
export interface SessionPattern {
|
|
13
|
+
toolDistribution: Map<string, number>;
|
|
14
|
+
errorTypes: Map<string, number>;
|
|
15
|
+
confidenceTrend: number[];
|
|
16
|
+
stabilityTrend: number[];
|
|
17
|
+
errorRate: number;
|
|
18
|
+
consecutiveErrors: number;
|
|
19
|
+
}
|
|
20
|
+
export interface MARSAdvice {
|
|
21
|
+
type: "tool_overuse" | "error_recurrence" | "confidence_decline" | "stability_decline";
|
|
22
|
+
message: string;
|
|
23
|
+
severity: "info" | "warn";
|
|
24
|
+
}
|
|
25
|
+
/** Build current session pattern from enforcement state */
|
|
26
|
+
export declare function buildPattern(ctx: ExtensionContext): SessionPattern;
|
|
27
|
+
/**
|
|
28
|
+
* Generate actionable advice based on pattern.
|
|
29
|
+
*
|
|
30
|
+
* Smart over-use detection:
|
|
31
|
+
* 1. Learning phase: first LEARNING_PHASE_CALLS of each tool = normal (not flagged)
|
|
32
|
+
* 2. Success-adjusted: only flag if tool is failing AND overused
|
|
33
|
+
* 3. Frequency-based: flag only if count > average * OVERUSE_MULTIPLIER
|
|
34
|
+
*/
|
|
35
|
+
export declare function generateAdvice(current: SessionPattern, previous: SessionPattern | null, toolSuccessRates?: Map<string, number>): MARSAdvice | null;
|
|
36
|
+
/**
|
|
37
|
+
* Check if MARS should give advice on this turn.
|
|
38
|
+
*
|
|
39
|
+
* Content-change suppression: the time cooldown alone is not enough — when
|
|
40
|
+
* an overuse pattern persists, generateAdvice re-derives the SAME message
|
|
41
|
+
* from the current pattern every cooldown window, so shouldAdvise re-emitted
|
|
42
|
+
* near-identical "bash used N/M times (46%)" whispers indefinitely. Only
|
|
43
|
+
* emit when the normalized message differs from the last one emitted; a
|
|
44
|
+
* materially changed pattern yields a different message, so it still fires
|
|
45
|
+
* when the situation actually changes.
|
|
46
|
+
*/
|
|
47
|
+
export declare function shouldAdvise(ctx: ExtensionContext): MARSAdvice | null;
|
|
48
|
+
/** Reset MARS state for a new session */
|
|
49
|
+
export declare function resetMARS(ctx: ExtensionContext): void;
|
|
50
|
+
//# sourceMappingURL=tool-usage-analyzer.d.ts.map
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool Usage Frequency Analyzer
|
|
3
|
+
*
|
|
4
|
+
* Analyzes agent tool usage patterns over a session and generates heuristic
|
|
5
|
+
* advice when a tool is used disproportionately or errors recur.
|
|
6
|
+
* Not based on any specific paper - simple statistical thresholding.
|
|
7
|
+
*
|
|
8
|
+
* Trigger: adaptive (not fixed N turns) - check on every turn_end.
|
|
9
|
+
* Only whispers if actionable advice exists.
|
|
10
|
+
*/
|
|
11
|
+
import { getExtensionState, hasExtensionState } from "../state/extension-state.js";
|
|
12
|
+
import { marsOveruseMultiplier as dynamicOveruseMultiplier } from "../reasoning/advice-tracker.js";
|
|
13
|
+
function getState(ctx) {
|
|
14
|
+
return getExtensionState(ctx, "tool-usage-analyzer", () => ({
|
|
15
|
+
patternSnapshot: null,
|
|
16
|
+
lastAdviceAt: 0,
|
|
17
|
+
adviceCooldownMs: 60_000, // 60s between advice
|
|
18
|
+
lastAdviceMessage: null,
|
|
19
|
+
}));
|
|
20
|
+
}
|
|
21
|
+
// ── Constants ────────────────────────────────────────────────────────────────//
|
|
22
|
+
/** First N calls of each tool = learning phase, not flagged as pattern */
|
|
23
|
+
const LEARNING_PHASE_CALLS = 5;
|
|
24
|
+
/**
|
|
25
|
+
* Overuse multiplier. Starts at 3, dynamically adjusted by advice tracker.
|
|
26
|
+
* Accessed via live `let` export from advice-tracker.js.
|
|
27
|
+
*/
|
|
28
|
+
const OVERUSE_MULTIPLIER = dynamicOveruseMultiplier;
|
|
29
|
+
/** Flag as overused only if success rate below this threshold */
|
|
30
|
+
const MIN_SUCCESS_RATE_FOR_OVERUSE = 0.5;
|
|
31
|
+
// ── Pattern analysis ──────────────────────────────────────────────────────────
|
|
32
|
+
/** Build current session pattern from enforcement state */
|
|
33
|
+
export function buildPattern(ctx) {
|
|
34
|
+
const eState = hasExtensionState(ctx, "enforcement")
|
|
35
|
+
? getExtensionState(ctx, "enforcement", () => ({ consecutiveErrorTurns: 0 }))
|
|
36
|
+
: null;
|
|
37
|
+
if (!eState) {
|
|
38
|
+
return {
|
|
39
|
+
toolDistribution: new Map(),
|
|
40
|
+
errorTypes: new Map(),
|
|
41
|
+
confidenceTrend: [],
|
|
42
|
+
stabilityTrend: [],
|
|
43
|
+
errorRate: 0,
|
|
44
|
+
consecutiveErrors: 0,
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
const toolDist = new Map();
|
|
48
|
+
for (const tool of eState.toolLog || []) {
|
|
49
|
+
toolDist.set(tool, (toolDist.get(tool) || 0) + 1);
|
|
50
|
+
}
|
|
51
|
+
const stabilityTrend = [];
|
|
52
|
+
const signals = eState.enforcementSignals || {};
|
|
53
|
+
for (const [, signal] of Object.entries(signals)) {
|
|
54
|
+
const s = signal;
|
|
55
|
+
if (s?.turn !== undefined && s?.text?.includes("[stability]")) {
|
|
56
|
+
const match = s.text.match(/overlap=([0-9.]+)/);
|
|
57
|
+
if (match)
|
|
58
|
+
stabilityTrend.push(parseFloat(match[1]));
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
toolDistribution: toolDist,
|
|
63
|
+
errorTypes: new Map(),
|
|
64
|
+
confidenceTrend: [],
|
|
65
|
+
stabilityTrend,
|
|
66
|
+
errorRate: 0,
|
|
67
|
+
consecutiveErrors: eState.consecutiveErrors || 0,
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Generate actionable advice based on pattern.
|
|
72
|
+
*
|
|
73
|
+
* Smart over-use detection:
|
|
74
|
+
* 1. Learning phase: first LEARNING_PHASE_CALLS of each tool = normal (not flagged)
|
|
75
|
+
* 2. Success-adjusted: only flag if tool is failing AND overused
|
|
76
|
+
* 3. Frequency-based: flag only if count > average * OVERUSE_MULTIPLIER
|
|
77
|
+
*/
|
|
78
|
+
export function generateAdvice(current, previous, toolSuccessRates) {
|
|
79
|
+
// Tool over-reliance: one tool > OVERUSE_MULTIPLIER * average AND failing
|
|
80
|
+
// AND not in learning phase (first N calls)
|
|
81
|
+
if (current.toolDistribution.size > 0) {
|
|
82
|
+
const total = [...current.toolDistribution.values()].reduce((a, b) => a + b, 0);
|
|
83
|
+
const avgPerTool = total / current.toolDistribution.size;
|
|
84
|
+
for (const [tool, count] of current.toolDistribution) {
|
|
85
|
+
// Learning phase: first N calls = normal behavior
|
|
86
|
+
if (count <= LEARNING_PHASE_CALLS)
|
|
87
|
+
continue;
|
|
88
|
+
// Frequency check: flag only if significantly above average
|
|
89
|
+
const isOverused = count > avgPerTool * OVERUSE_MULTIPLIER;
|
|
90
|
+
if (!isOverused)
|
|
91
|
+
continue;
|
|
92
|
+
// Success check: flag only if tool is failing (not just being used a lot)
|
|
93
|
+
const successRate = toolSuccessRates?.get(tool) ?? 1.0;
|
|
94
|
+
const isFailing = successRate < MIN_SUCCESS_RATE_FOR_OVERUSE;
|
|
95
|
+
// Only flag if both overused AND failing, or severely overused (>10x average)
|
|
96
|
+
const severeOveruse = count > avgPerTool * 10;
|
|
97
|
+
if (isOverused && (isFailing || severeOveruse)) {
|
|
98
|
+
const successStr = toolSuccessRates ? `${Math.round(successRate * 100)}% success` : "";
|
|
99
|
+
const suggestion = isFailing
|
|
100
|
+
? "Consider: alternative tools, grep/find vs bash, or step back to verify approach."
|
|
101
|
+
: "Verify this is intentional before continuing.";
|
|
102
|
+
return {
|
|
103
|
+
type: "tool_overuse",
|
|
104
|
+
message: `[mars] ${tool} used ${count}/${total} times (${Math.round((count / total) * 100)}%${successStr ? `, ${successStr}` : ""}). ${suggestion}`,
|
|
105
|
+
severity: "warn",
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
// Error recurrence: same error type 3+ times
|
|
111
|
+
if (current.consecutiveErrors >= 3) {
|
|
112
|
+
return {
|
|
113
|
+
type: "error_recurrence",
|
|
114
|
+
message: `[mars] ${current.consecutiveErrors} consecutive errors detected. Consider: think(type="reflection") to identify root cause before continuing.`,
|
|
115
|
+
severity: "warn",
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
// Stability decline: trend going down
|
|
119
|
+
if (previous && current.stabilityTrend.length > 2 && previous.stabilityTrend.length > 2) {
|
|
120
|
+
const prevAvg = previous.stabilityTrend.slice(-3).reduce((a, b) => a + b, 0) / 3;
|
|
121
|
+
const currAvg = current.stabilityTrend.slice(-3).reduce((a, b) => a + b, 0) / 3;
|
|
122
|
+
if (currAvg < prevAvg * 0.7) {
|
|
123
|
+
return {
|
|
124
|
+
type: "stability_decline",
|
|
125
|
+
message: `[mars] Response quality declining (avg stability ${currAvg.toFixed(2)} vs ${prevAvg.toFixed(2)} earlier). Consider refocusing on the original task.`,
|
|
126
|
+
severity: "info",
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
return null;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Normalize an advice message so near-identical repeats compare equal.
|
|
134
|
+
* Collapses whitespace AND digit runs to a placeholder: the tool-overuse
|
|
135
|
+
* message re-derives fresh counters every window ("bash used 360/823 times
|
|
136
|
+
* (44%)" -> "bash used 399/874 times (46%)"), so a whitespace-only normalize
|
|
137
|
+
* never suppresses it (observed: re-fired every cooldown window while bash
|
|
138
|
+
* stabilized around the same 40-50% share). Collapsing digits makes the
|
|
139
|
+
* persistent-pattern message stable; a different tool name, advice type, or
|
|
140
|
+
* wording still produces a different normalized string and re-fires.
|
|
141
|
+
*/
|
|
142
|
+
function normalizeAdviceMessage(message) {
|
|
143
|
+
return (message
|
|
144
|
+
.trim()
|
|
145
|
+
.replace(/\s+/g, " ")
|
|
146
|
+
// Collapse numeric runs (counts, ratios, percentages, stability values)
|
|
147
|
+
// so a persisting pattern whose counters keep ticking stays suppressed.
|
|
148
|
+
.replace(/\d+(?:\.\d+)?/g, "#"));
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Check if MARS should give advice on this turn.
|
|
152
|
+
*
|
|
153
|
+
* Content-change suppression: the time cooldown alone is not enough — when
|
|
154
|
+
* an overuse pattern persists, generateAdvice re-derives the SAME message
|
|
155
|
+
* from the current pattern every cooldown window, so shouldAdvise re-emitted
|
|
156
|
+
* near-identical "bash used N/M times (46%)" whispers indefinitely. Only
|
|
157
|
+
* emit when the normalized message differs from the last one emitted; a
|
|
158
|
+
* materially changed pattern yields a different message, so it still fires
|
|
159
|
+
* when the situation actually changes.
|
|
160
|
+
*/
|
|
161
|
+
export function shouldAdvise(ctx) {
|
|
162
|
+
const state = getState(ctx);
|
|
163
|
+
const now = Date.now();
|
|
164
|
+
// Cooldown check
|
|
165
|
+
if (now - state.lastAdviceAt < state.adviceCooldownMs)
|
|
166
|
+
return null;
|
|
167
|
+
const current = buildPattern(ctx);
|
|
168
|
+
const advice = generateAdvice(current, state.patternSnapshot);
|
|
169
|
+
if (advice) {
|
|
170
|
+
// Keep the snapshot fresh even when suppressed so stability/trend
|
|
171
|
+
// detection always sees the current state.
|
|
172
|
+
state.patternSnapshot = current;
|
|
173
|
+
if (normalizeAdviceMessage(advice.message) === state.lastAdviceMessage) {
|
|
174
|
+
return null;
|
|
175
|
+
}
|
|
176
|
+
state.lastAdviceAt = now;
|
|
177
|
+
state.lastAdviceMessage = normalizeAdviceMessage(advice.message);
|
|
178
|
+
}
|
|
179
|
+
return advice;
|
|
180
|
+
}
|
|
181
|
+
/** Reset MARS state for a new session */
|
|
182
|
+
export function resetMARS(ctx) {
|
|
183
|
+
const state = getState(ctx);
|
|
184
|
+
state.patternSnapshot = null;
|
|
185
|
+
state.lastAdviceAt = 0;
|
|
186
|
+
state.lastAdviceMessage = null;
|
|
187
|
+
}
|
|
188
|
+
//# sourceMappingURL=tool-usage-analyzer.js.map
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Async storage utility for cognitive systems.
|
|
3
|
+
*
|
|
4
|
+
* Provides debounced async file I/O to replace synchronous readFileSync/writeFileSync
|
|
5
|
+
* calls that block the Node.js event loop.
|
|
6
|
+
*
|
|
7
|
+
* Uses microtask-based batching instead of setTimeout debouncing - writes are
|
|
8
|
+
* flushed before the event loop continues, eliminating the data-loss window
|
|
9
|
+
* that existed with pending setTimeout callbacks on process exit.
|
|
10
|
+
*
|
|
11
|
+
* For safety, also registers a process.on('beforeExit') handler as a last resort.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* Load state from JSON file asynchronously.
|
|
15
|
+
*
|
|
16
|
+
* Load-side size seatbelt (the write-side MAX_STATE_JSON_CHARS guard in
|
|
17
|
+
* flushAll only bounds saves): a polluted state file on disk (the
|
|
18
|
+
* OOM: degradation.json at ~508MB) must not be read into
|
|
19
|
+
* memory and JSON.parsed — stat first, refuse oversized files.
|
|
20
|
+
*/
|
|
21
|
+
export declare function loadState<T>(path: string): Promise<T | null>;
|
|
22
|
+
/**
|
|
23
|
+
* Save state to JSON file asynchronously with microtask-based batching.
|
|
24
|
+
* Multiple rapid saves to the same path are coalesced into a single write.
|
|
25
|
+
*
|
|
26
|
+
* Unlike the previous setTimeout-based debounce, this guarantees the write
|
|
27
|
+
* completes before the event loop continues. Zero data-loss window.
|
|
28
|
+
*/
|
|
29
|
+
export declare function saveState<T>(path: string, data: T): Promise<void>;
|
|
30
|
+
/**
|
|
31
|
+
* Force immediate save (for shutdown/cleanup).
|
|
32
|
+
* Flushes all pending writes synchronously-asynchronously.
|
|
33
|
+
*/
|
|
34
|
+
export declare function saveStateImmediate<T>(path: string, data: T): Promise<void>;
|
|
35
|
+
export declare function flushAll(): Promise<void>;
|
|
36
|
+
/**
|
|
37
|
+
* Initialize shutdown safety. Registers a beforeExit handler that flushes
|
|
38
|
+
* any remaining writes before the process exits. Safe to call multiple times.
|
|
39
|
+
*
|
|
40
|
+
* Also exposed as shut down integration for pi session shutdown handlers.
|
|
41
|
+
*/
|
|
42
|
+
export declare function shutdownAsyncStorage(): Promise<void>;
|
|
43
|
+
/**
|
|
44
|
+
* Register the process-exit flush handlers exactly once per process.
|
|
45
|
+
*
|
|
46
|
+
* Idempotent across module re-execution: the first call registers all three
|
|
47
|
+
* handlers (beforeExit/SIGINT/SIGTERM) and sets the `globalThis` marker;
|
|
48
|
+
* every subsequent call (including module re-evaluation on pi /reload) is a
|
|
49
|
+
* no-op. Behavior is otherwise unchanged - all three handlers still flush.
|
|
50
|
+
*/
|
|
51
|
+
export declare function ensureShutdownHandlers(): void;
|
|
52
|
+
//# sourceMappingURL=async-storage.d.ts.map
|