pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Episode Store - case-based reasoning from past tasks.
|
|
3
|
+
*
|
|
4
|
+
* Paper: 2604.14475 Evo-MedAgent
|
|
5
|
+
* Key finding: Episode memory outperforms single memory.
|
|
6
|
+
* MCQ accuracy 0.68 -> 0.79.
|
|
7
|
+
*/
|
|
8
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
9
|
+
import { eventBus } from "../../../lib/events/event-bus.js";
|
|
10
|
+
import { nextId } from "../../../lib/utils/id.js";
|
|
11
|
+
import { queueEpisodeAppend } from "./episodes-disk.js";
|
|
12
|
+
const log = createLogger("three-memory-stores:episodes");
|
|
13
|
+
/**
|
|
14
|
+
* Sanitize a string by decoding literal `\uXXXX` escape sequences that
|
|
15
|
+
* may have been written by a previous code path that double-encoded
|
|
16
|
+
* unicode (BUG-M3). The agent-facing `recall_search` and `episodes_search`
|
|
17
|
+
* displays otherwise show literal `\u2192` instead of the real character
|
|
18
|
+
* `->`. Applied at load time AND at write time (in `addEpisode`) so both
|
|
19
|
+
* existing data files and new writes are healed.
|
|
20
|
+
*
|
|
21
|
+
* The previous implementation used `JSON.parse('"' + s + '"')` for safety
|
|
22
|
+
* (verify round-trip changes the value before accepting). That approach
|
|
23
|
+
* silently FAILED for any string containing raw newline/control characters
|
|
24
|
+
* -- which is the common case for task and solution fields that contain
|
|
25
|
+
* multi-line text. JSON.parse throws on raw \n inside string literals.
|
|
26
|
+
* The sanitizer returned the input unchanged, so the literal `\u2192`
|
|
27
|
+
* remained in agent-facing output.
|
|
28
|
+
*
|
|
29
|
+
* Current implementation: regex-replace each `\uXXXX` with the decoded
|
|
30
|
+
* code point. Detection: only run if the string contains at least one
|
|
31
|
+
* `\uXXXX` pattern. The safety trade-off: legitimate backslash-u text
|
|
32
|
+
* (rare in episode data) would also be decoded. Acceptable for this
|
|
33
|
+
* store; episode content is model output and natural language, not
|
|
34
|
+
* regex patterns.
|
|
35
|
+
*/
|
|
36
|
+
export function unescapeUnicodeIfDoubleEncoded(s) {
|
|
37
|
+
if (typeof s !== "string")
|
|
38
|
+
return s;
|
|
39
|
+
if (!/\\u[0-9a-fA-F]{4}/.test(s))
|
|
40
|
+
return s;
|
|
41
|
+
return s.replace(/\\u([0-9a-fA-F]{4})/g, (_match, hex) => String.fromCodePoint(parseInt(hex, 16)));
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Apply unescapeUnicodeIfDoubleEncoded to all string-bearing fields of
|
|
45
|
+
* an episode. Used at load time and write time to ensure no literal
|
|
46
|
+
* `\u2192` sequences leak into agent-facing output.
|
|
47
|
+
*/
|
|
48
|
+
export function sanitizeEpisode(ep) {
|
|
49
|
+
return {
|
|
50
|
+
...ep,
|
|
51
|
+
task: unescapeUnicodeIfDoubleEncoded(ep.task),
|
|
52
|
+
solution: unescapeUnicodeIfDoubleEncoded(ep.solution),
|
|
53
|
+
// outcome is a small enum, not affected
|
|
54
|
+
// toolSequence, tags, etc. are arrays - recurse over string entries
|
|
55
|
+
toolSequence: ep.toolSequence?.map(unescapeUnicodeIfDoubleEncoded),
|
|
56
|
+
tags: ep.tags?.map(unescapeUnicodeIfDoubleEncoded),
|
|
57
|
+
project: unescapeUnicodeIfDoubleEncoded(ep.project),
|
|
58
|
+
strategicSOP: ep.strategicSOP ? unescapeUnicodeIfDoubleEncoded(ep.strategicSOP) : undefined,
|
|
59
|
+
functionalSOP: ep.functionalSOP?.map(unescapeUnicodeIfDoubleEncoded),
|
|
60
|
+
atomicSOP: ep.atomicSOP?.map(unescapeUnicodeIfDoubleEncoded),
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
export function addEpisode(state, task, solution, outcome, toolSequence, tags = [], project, strategicSOP, functionalSOP, atomicSOP) {
|
|
64
|
+
const outcomeScore = { success: 1.0, partial: 0.5, failure: 0.2 }[outcome];
|
|
65
|
+
const uniqueTools = new Set(toolSequence).size;
|
|
66
|
+
const toolDiversity = toolSequence.length > 0 ? uniqueTools / toolSequence.length : 0;
|
|
67
|
+
const reasoningDensity = toolSequence.length > 0 ? Math.min(1, solution.length / (toolSequence.length * 200)) : 0.5;
|
|
68
|
+
const quality = Math.round(outcomeScore * (toolDiversity * 0.4 + 0.6) * (reasoningDensity * 0.4 + 0.6) * 100) /
|
|
69
|
+
100;
|
|
70
|
+
// Sanitize string fields before storing so newly-added episodes
|
|
71
|
+
// never reintroduce literal \uXXXX sequences (BUG-M3 hardening).
|
|
72
|
+
// The load-time sanitizer in index.ts:loadPastEpisodes handles
|
|
73
|
+
// already-stored entries.
|
|
74
|
+
const episode = sanitizeEpisode({
|
|
75
|
+
id: nextId("ep"),
|
|
76
|
+
task,
|
|
77
|
+
solution,
|
|
78
|
+
outcome,
|
|
79
|
+
similarity: 0,
|
|
80
|
+
timestamp: Date.now(),
|
|
81
|
+
toolSequence,
|
|
82
|
+
tags,
|
|
83
|
+
project: project ?? "unknown",
|
|
84
|
+
sessionId: state.currentSessionId || "unknown",
|
|
85
|
+
quality,
|
|
86
|
+
strategicSOP,
|
|
87
|
+
functionalSOP,
|
|
88
|
+
atomicSOP,
|
|
89
|
+
});
|
|
90
|
+
state.episodes.push(episode);
|
|
91
|
+
// Append-on-write durability: the episode reaches episodes.jsonl within
|
|
92
|
+
// milliseconds of this call, not at session shutdown. Fire-and-forget: a
|
|
93
|
+
// failed append degrades to a logged warning, and the shutdown compaction
|
|
94
|
+
// (compactEpisodesFile) re-lands the whole in-memory snapshot as fallback.
|
|
95
|
+
queueEpisodeAppend(episode).catch((err) => log.warn(`episode ${episode.id} append failed: ${err}`));
|
|
96
|
+
if (state.episodes.length > 500) {
|
|
97
|
+
pruneEpisodes(state);
|
|
98
|
+
}
|
|
99
|
+
log.debug(`Added episode: "${task.slice(0, 50)}..." (${outcome}, quality=${quality})`);
|
|
100
|
+
return episode;
|
|
101
|
+
}
|
|
102
|
+
// Memory Condensation (Decocted Experience 2604.03213)
|
|
103
|
+
export function condenseInsights(episode, maxTokens = 150) {
|
|
104
|
+
const outcomeLabel = episode.outcome === "success"
|
|
105
|
+
? "SUCCESS"
|
|
106
|
+
: episode.outcome === "failure"
|
|
107
|
+
? "FAILURE"
|
|
108
|
+
: "PARTIAL";
|
|
109
|
+
const toolSummary = episode.toolSequence.length > 0
|
|
110
|
+
? `[${episode.toolSequence.slice(0, 5).join(" -> ")}${episode.toolSequence.length > 5 ? ` (+${episode.toolSequence.length - 5} more)` : ""}]`
|
|
111
|
+
: "";
|
|
112
|
+
const insight = episode.solution
|
|
113
|
+
.split(/[.!?]\n/)
|
|
114
|
+
.map((s) => s.trim())
|
|
115
|
+
.filter((s) => s.length > 10 && s.length < 200)
|
|
116
|
+
.slice(0, 3)
|
|
117
|
+
.join(". ");
|
|
118
|
+
const condensed = `* ${episode.task.slice(0, 80)} [${outcomeLabel}] ${toolSummary}\n Insight: ${insight.slice(0, maxTokens * 3)}`;
|
|
119
|
+
return condensed.length > maxTokens * 4 ? condensed.slice(0, maxTokens * 4) + "..." : condensed;
|
|
120
|
+
}
|
|
121
|
+
export function retrieveEpisodes(state, query, limit = 3, currentProject) {
|
|
122
|
+
const queryLower = query.toLowerCase();
|
|
123
|
+
const now = Date.now();
|
|
124
|
+
const scored = state.episodes
|
|
125
|
+
.map((ep) => {
|
|
126
|
+
const baseScore = computeSimilarity(queryLower, ep);
|
|
127
|
+
const CROSS_PROJECT_PENALTY = -0.7;
|
|
128
|
+
const crossProjectPenalty = currentProject && ep.project && ep.project !== currentProject ? CROSS_PROJECT_PENALTY : 0;
|
|
129
|
+
const projectBonus = currentProject && ep.project === currentProject ? 0.2 : 0;
|
|
130
|
+
const ageHours = (now - ep.timestamp) / 3600000;
|
|
131
|
+
const ageBonus = Math.max(0, 1 - ageHours / 168) * 0.1;
|
|
132
|
+
return {
|
|
133
|
+
ep,
|
|
134
|
+
score: baseScore + projectBonus + ageBonus + crossProjectPenalty,
|
|
135
|
+
isCrossProject: crossProjectPenalty < 0,
|
|
136
|
+
};
|
|
137
|
+
})
|
|
138
|
+
.filter((s) => s.score > 0.1)
|
|
139
|
+
.sort((a, b) => b.score - a.score)
|
|
140
|
+
.slice(0, limit);
|
|
141
|
+
return scored.map((s) => {
|
|
142
|
+
const ageHours = (Date.now() - s.ep.timestamp) / 3600000;
|
|
143
|
+
const memoryConfidence = Math.max(0.1, 1 - ageHours / 504);
|
|
144
|
+
return { ...s.ep, similarity: s.score, memoryConfidence };
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
export function computeSimilarity(query, episode) {
|
|
148
|
+
const queryWords = new Set(query.split(/\s+/).filter((w) => w.length > 2));
|
|
149
|
+
if (queryWords.size === 0)
|
|
150
|
+
return 0;
|
|
151
|
+
const taskWords = new Set(episode.task
|
|
152
|
+
.toLowerCase()
|
|
153
|
+
.split(/\s+/)
|
|
154
|
+
.filter((w) => w.length > 2));
|
|
155
|
+
const solutionWords = new Set(episode.solution
|
|
156
|
+
.toLowerCase()
|
|
157
|
+
.split(/\s+/)
|
|
158
|
+
.filter((w) => w.length > 2));
|
|
159
|
+
const tagWords = new Set(episode.tags.flatMap((t) => t.toLowerCase().split(/\s+/)).filter((w) => w.length > 2));
|
|
160
|
+
let matches = 0;
|
|
161
|
+
for (const word of queryWords) {
|
|
162
|
+
if (taskWords.has(word))
|
|
163
|
+
matches += 3;
|
|
164
|
+
if (solutionWords.has(word))
|
|
165
|
+
matches += 1;
|
|
166
|
+
if (tagWords.has(word))
|
|
167
|
+
matches += 2;
|
|
168
|
+
}
|
|
169
|
+
return matches / (queryWords.size * 3);
|
|
170
|
+
}
|
|
171
|
+
// RUMS Retrieval (paper 2604.14473)
|
|
172
|
+
export function estimatePMI(queryWord, episode, backgroundFreq, totalDocs) {
|
|
173
|
+
const pWord = backgroundFreq.get(queryWord) ?? 1;
|
|
174
|
+
let pWordGivenEpisode = 0;
|
|
175
|
+
if (queryWord.length >= 3) {
|
|
176
|
+
if (episode.task.toLowerCase().includes(queryWord))
|
|
177
|
+
pWordGivenEpisode += 0.7;
|
|
178
|
+
if (episode.solution.toLowerCase().includes(queryWord))
|
|
179
|
+
pWordGivenEpisode += 0.5;
|
|
180
|
+
if (episode.tags.some((t) => t.toLowerCase().includes(queryWord)))
|
|
181
|
+
pWordGivenEpisode += 0.3;
|
|
182
|
+
}
|
|
183
|
+
if (pWordGivenEpisode === 0)
|
|
184
|
+
return 0;
|
|
185
|
+
return Math.log((pWordGivenEpisode * totalDocs) / Math.max(pWord, 1));
|
|
186
|
+
}
|
|
187
|
+
export function computeRUMS(query, episode, backgroundFreq, totalDocs) {
|
|
188
|
+
const queryWords = query
|
|
189
|
+
.toLowerCase()
|
|
190
|
+
.split(/\W+/)
|
|
191
|
+
.filter((w) => w.length > 2);
|
|
192
|
+
if (queryWords.length === 0)
|
|
193
|
+
return 0;
|
|
194
|
+
let pmiSum = 0;
|
|
195
|
+
let validWords = 0;
|
|
196
|
+
for (const word of queryWords) {
|
|
197
|
+
const pmi = estimatePMI(word, episode, backgroundFreq, totalDocs);
|
|
198
|
+
if (pmi > 0) {
|
|
199
|
+
pmiSum += pmi;
|
|
200
|
+
validWords++;
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
const avgPMI = validWords > 0 ? pmiSum / validWords : 0;
|
|
204
|
+
const pmiScore = Math.min(avgPMI / 5, 1) * 0.6;
|
|
205
|
+
const outcomeScore = episode.outcome === "success" ? 0.2 : episode.outcome === "partial" ? 0.1 : 0.0;
|
|
206
|
+
const ageDays = (Date.now() - episode.timestamp) / (24 * 60 * 60 * 1000);
|
|
207
|
+
const recencyScore = Math.max(0, 1 - ageDays / 30) * 0.2;
|
|
208
|
+
const solutionTokens = episode.solution.split(/\W+/).filter((w) => w.length > 3).length;
|
|
209
|
+
const specificityScore = Math.min(solutionTokens / 20, 1) * 0.1;
|
|
210
|
+
return pmiScore + outcomeScore + recencyScore + specificityScore;
|
|
211
|
+
}
|
|
212
|
+
export function retrieveByRUMS(state, query, limit = 3, currentSessionId, currentProject, projectScope) {
|
|
213
|
+
if (state.episodes.length === 0)
|
|
214
|
+
return [];
|
|
215
|
+
const backgroundFreq = new Map();
|
|
216
|
+
const totalDocs = state.episodes.length;
|
|
217
|
+
for (const ep of state.episodes) {
|
|
218
|
+
const words = new Set((ep.task + " " + ep.solution + " " + ep.tags.join(" "))
|
|
219
|
+
.toLowerCase()
|
|
220
|
+
.split(/\W+/)
|
|
221
|
+
.filter((w) => w.length > 2));
|
|
222
|
+
for (const word of words) {
|
|
223
|
+
backgroundFreq.set(word, (backgroundFreq.get(word) ?? 0) + 1);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
let candidates = state.episodes.map((ep) => ({
|
|
227
|
+
ep,
|
|
228
|
+
score: computeRUMS(query, ep, backgroundFreq, totalDocs),
|
|
229
|
+
crossProject: false,
|
|
230
|
+
}));
|
|
231
|
+
// Cross-project handling when a current project is known: the tool contract
|
|
232
|
+
// says projectScope "current" is the default,
|
|
233
|
+
// so projectScope is treated as "current" unless explicitly "all".
|
|
234
|
+
//
|
|
235
|
+
// Policy ("current project wins"):
|
|
236
|
+
// - Same-project / unverifiable-project episodes keep their face score.
|
|
237
|
+
// - Cross-project episodes (project set AND != currentProject, including
|
|
238
|
+
// legacy "unknown" writes that can no longer be attributed) are PENALIZED
|
|
239
|
+
// so same-project content ranks above them, and are only RETAINED when
|
|
240
|
+
// clearly valuable (penalized score > CROSS_PROJECT_KEEP_THRESHOLD).
|
|
241
|
+
// - Any cross-project episode that survives is labeled `_crossProject: true`
|
|
242
|
+
// so callers/whisper can surface it honestly instead of as current-project.
|
|
243
|
+
if (currentProject) {
|
|
244
|
+
const CROSS_PROJECT_PENALTY = 0.35;
|
|
245
|
+
const CROSS_PROJECT_KEEP_THRESHOLD = 0.6;
|
|
246
|
+
const scoped = projectScope === "all";
|
|
247
|
+
candidates = candidates.map((c) => {
|
|
248
|
+
const crossProject = !c.ep.project || c.ep.project !== currentProject;
|
|
249
|
+
if (scoped)
|
|
250
|
+
return { ...c, crossProject };
|
|
251
|
+
return {
|
|
252
|
+
...c,
|
|
253
|
+
crossProject,
|
|
254
|
+
score: crossProject ? c.score - CROSS_PROJECT_PENALTY : c.score,
|
|
255
|
+
};
|
|
256
|
+
});
|
|
257
|
+
if (!scoped) {
|
|
258
|
+
// Drop cross-project episodes that are not clearly valuable after the
|
|
259
|
+
// penalty. Same-project episodes are never dropped by this filter.
|
|
260
|
+
candidates = candidates.filter((c) => {
|
|
261
|
+
if (!c.crossProject)
|
|
262
|
+
return true;
|
|
263
|
+
return c.score > CROSS_PROJECT_KEEP_THRESHOLD;
|
|
264
|
+
});
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
const results = candidates
|
|
268
|
+
.filter((s) => s.score > 0.05)
|
|
269
|
+
.sort((a, b) => b.score - a.score)
|
|
270
|
+
.slice(0, limit)
|
|
271
|
+
.map((s) => ({ ...s.ep, similarity: s.score }));
|
|
272
|
+
// Mark cross-session episodes (for display/auto-whisper filtering)
|
|
273
|
+
// but do NOT filter them out - user-initiated memory tool needs them.
|
|
274
|
+
// Callers that want filtering (e.g. auto-whisper) should do it at the call site.
|
|
275
|
+
// Label cross-project survivors so they are surfaced as cross-project, not
|
|
276
|
+
// as if they belonged to the current project (THREE-MEMORY-STORE RECALL FIX).
|
|
277
|
+
const crossProjectIds = new Set(candidates.filter((c) => c.crossProject).map((c) => c.ep.id));
|
|
278
|
+
for (const ep of results) {
|
|
279
|
+
ep._crossSession =
|
|
280
|
+
ep.sessionId && ep.sessionId !== currentSessionId;
|
|
281
|
+
ep._crossProject = crossProjectIds.has(ep.id);
|
|
282
|
+
}
|
|
283
|
+
log.debug(`RUMS retrieved ${results.length} episodes for "${query.slice(0, 30)}..."`);
|
|
284
|
+
return results;
|
|
285
|
+
}
|
|
286
|
+
function pruneEpisodes(state) {
|
|
287
|
+
const before = state.episodes.length;
|
|
288
|
+
const removed = before - Math.min(before, 500);
|
|
289
|
+
if (removed > 0) {
|
|
290
|
+
// Emit memory_evict event so context-lifecycle can adjust proposal thresholds
|
|
291
|
+
eventBus.emit({
|
|
292
|
+
type: "memory_evict",
|
|
293
|
+
reason: "episode_prune",
|
|
294
|
+
count: removed,
|
|
295
|
+
});
|
|
296
|
+
}
|
|
297
|
+
state.episodes = state.episodes.slice(-500);
|
|
298
|
+
}
|
|
299
|
+
//# sourceMappingURL=episodes.js.map
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Auto-recall whisper - delivers relevant past episodes as a whisper
|
|
3
|
+
* when the agent is working on something related.
|
|
4
|
+
*
|
|
5
|
+
* This is the core "memory surfaces to agent" loop.
|
|
6
|
+
*
|
|
7
|
+
* Behavior contract:
|
|
8
|
+
* - AUTO_RECALL_ENABLED: master switch (default true)
|
|
9
|
+
* - RECALL_COOLDOWN_MS: 120s
|
|
10
|
+
* - Cross-session episodes: filtered unless similarity > 0.6
|
|
11
|
+
* - Deduplication: skip if same title + episode IDs as last emission
|
|
12
|
+
* - Contamination signal: emitted to bus when cross-session episodes
|
|
13
|
+
* appear (so enforcement can surface the concern)
|
|
14
|
+
*
|
|
15
|
+
* The function is called from tool_result and turn_end handlers when
|
|
16
|
+
* they detect relevant work. It's co-located with three-memory-stores
|
|
17
|
+
* (not moved to lib) because it depends on `MemoryStoresState` shape.
|
|
18
|
+
*/
|
|
19
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
20
|
+
import type { Episode, MemoryStoresState } from "../types.js";
|
|
21
|
+
declare const AUTO_RECALL_ENABLED = true;
|
|
22
|
+
declare const RECALL_COOLDOWN_MS = 120000;
|
|
23
|
+
export { AUTO_RECALL_ENABLED, RECALL_COOLDOWN_MS };
|
|
24
|
+
export declare function whisperRecall(state: MemoryStoresState, ctx: ExtensionContext, pi: ExtensionAPI, title: string, episodes: Episode[], currentProject?: string): void;
|
|
25
|
+
//# sourceMappingURL=whisper-recall.d.ts.map
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Auto-recall whisper - delivers relevant past episodes as a whisper
|
|
3
|
+
* when the agent is working on something related.
|
|
4
|
+
*
|
|
5
|
+
* This is the core "memory surfaces to agent" loop.
|
|
6
|
+
*
|
|
7
|
+
* Behavior contract:
|
|
8
|
+
* - AUTO_RECALL_ENABLED: master switch (default true)
|
|
9
|
+
* - RECALL_COOLDOWN_MS: 120s
|
|
10
|
+
* - Cross-session episodes: filtered unless similarity > 0.6
|
|
11
|
+
* - Deduplication: skip if same title + episode IDs as last emission
|
|
12
|
+
* - Contamination signal: emitted to bus when cross-session episodes
|
|
13
|
+
* appear (so enforcement can surface the concern)
|
|
14
|
+
*
|
|
15
|
+
* The function is called from tool_result and turn_end handlers when
|
|
16
|
+
* they detect relevant work. It's co-located with three-memory-stores
|
|
17
|
+
* (not moved to lib) because it depends on `MemoryStoresState` shape.
|
|
18
|
+
*/
|
|
19
|
+
import { sendTrackedMessage } from "../../../../lib/utils/injection-tracker.js";
|
|
20
|
+
import { fenceMemoryContext } from "../../../../lib/utils/memory-fence.js";
|
|
21
|
+
import { emitSignal } from "../../../../lib/reasoning/belief-policy-engine.js";
|
|
22
|
+
const AUTO_RECALL_ENABLED = true;
|
|
23
|
+
const RECALL_COOLDOWN_MS = 120_000;
|
|
24
|
+
// Re-export for the turn_end handler which also gates on these.
|
|
25
|
+
export { AUTO_RECALL_ENABLED, RECALL_COOLDOWN_MS };
|
|
26
|
+
export function whisperRecall(state, ctx, pi, title, episodes, currentProject) {
|
|
27
|
+
if (!AUTO_RECALL_ENABLED || episodes.length === 0)
|
|
28
|
+
return;
|
|
29
|
+
// Filter out cross-session episodes from auto-whisper unless highly relevant (>0.75)
|
|
30
|
+
// Episode doesn't declare _crossSession; RichEpisode does. The cast
|
|
31
|
+
// narrows to RichEpisode for the similarity check.
|
|
32
|
+
let filtered = episodes.filter((ep) => {
|
|
33
|
+
const rich = ep;
|
|
34
|
+
if (!rich._crossSession)
|
|
35
|
+
return true;
|
|
36
|
+
return rich.similarity > 0.75;
|
|
37
|
+
});
|
|
38
|
+
// Filter out cross-project episodes from auto-whisper unless highly relevant (>0.6)
|
|
39
|
+
// This parallels the cross-session policy but uses a slightly lower threshold
|
|
40
|
+
// since project boundaries are weaker than session boundaries.
|
|
41
|
+
if (currentProject) {
|
|
42
|
+
filtered = filtered.filter((ep) => {
|
|
43
|
+
if (!ep.project || ep.project === currentProject)
|
|
44
|
+
return true;
|
|
45
|
+
return ep.similarity > 0.6;
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
// Never whisper a placeholder-task episode. Episodes written
|
|
49
|
+
// with the "session_outcome" sentinel (heartbeat fallback when _event.task
|
|
50
|
+
// is absent) carry no actionable signal — skip them at whisper time so
|
|
51
|
+
// already-persisted junk stops surfacing as "[ok] session_outcome".
|
|
52
|
+
filtered = filtered.filter((ep) => ep.task && !/^session_outcome$/i.test(ep.task.trim()));
|
|
53
|
+
if (filtered.length === 0)
|
|
54
|
+
return;
|
|
55
|
+
const now = Date.now();
|
|
56
|
+
if (now - state.lastRecallTime < RECALL_COOLDOWN_MS)
|
|
57
|
+
return;
|
|
58
|
+
state.lastRecallTime = now;
|
|
59
|
+
const signature = `${title}|${filtered
|
|
60
|
+
.slice(0, 2)
|
|
61
|
+
.map((ep) => ep.id)
|
|
62
|
+
.join("|")}`;
|
|
63
|
+
if (signature === state.lastEpisodeRecallSignature)
|
|
64
|
+
return;
|
|
65
|
+
state.lastEpisodeRecallSignature = signature;
|
|
66
|
+
const crossSession = filtered.filter((ep) => ep._crossSession);
|
|
67
|
+
// Only emit contamination signal for repeated cross-session - batch per session
|
|
68
|
+
if (crossSession.length > 0 && state.recentErrors.length < 10) {
|
|
69
|
+
emitSignal(ctx, "memory", "contamination", "warn", false, {
|
|
70
|
+
count: crossSession.length,
|
|
71
|
+
sessionIds: crossSession
|
|
72
|
+
.map((ep) => ep.sessionId)
|
|
73
|
+
.filter(Boolean)
|
|
74
|
+
.slice(0, 3),
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
const lines = [title];
|
|
78
|
+
for (const ep of filtered.slice(0, 2)) {
|
|
79
|
+
const icon = ep.outcome === "success" ? "[ok]" : ep.outcome === "failure" ? "[fail]" : "[warn]";
|
|
80
|
+
const _richEp = ep;
|
|
81
|
+
const crossMark = _richEp._crossSession ? " [CROSS-SESSION]" : "";
|
|
82
|
+
// THREE-MEMORY-STORE RECALL FIX: cross-project episodes that pass the
|
|
83
|
+
// clearly-valuable bar must be LABELED as cross-project, not presented
|
|
84
|
+
// as if they belonged to the current project.
|
|
85
|
+
const projectMark = ep._crossProject
|
|
86
|
+
? " [CROSS-PROJECT]"
|
|
87
|
+
: "";
|
|
88
|
+
const conf = _richEp.memoryConfidence != null
|
|
89
|
+
? ` (conf ${(_richEp.memoryConfidence * 100).toFixed(0)}%)`
|
|
90
|
+
: "";
|
|
91
|
+
// Whisper truncation fix: render-side caps raised
|
|
92
|
+
// (task 80→120, solution 300→600) with explicit ellipsis on the
|
|
93
|
+
// solution line, plus a retrieval handle so the receiving agent can
|
|
94
|
+
// fetch the full episode via memory recall_get. Mirrors the bounded
|
|
95
|
+
// pattern in memory-agent-bridge/memory-tool.ts. Episode text itself
|
|
96
|
+
// is stored full (write path is clean) — this is render-only.
|
|
97
|
+
const taskTruncated = ep.task.length > 120;
|
|
98
|
+
const solutionTruncated = ep.solution.length > 600;
|
|
99
|
+
lines.push(` ${icon}${crossMark}${projectMark}${conf} ${ep.task.slice(0, 120)}`);
|
|
100
|
+
lines.push(` Solution: ${ep.solution.slice(0, 600)}${solutionTruncated ? "…" : ""}`);
|
|
101
|
+
if (taskTruncated || solutionTruncated) {
|
|
102
|
+
lines.push(` (id: ${ep.id} — memory recall_get for full text)`);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
sendTrackedMessage(pi, {
|
|
106
|
+
customType: "memory",
|
|
107
|
+
display: true,
|
|
108
|
+
// Recalled episode text is fenced non-user context.
|
|
109
|
+
content: [{ type: "text", text: fenceMemoryContext(lines.join("\n")) }],
|
|
110
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "memory", source: "three-memory-stores/recall" });
|
|
111
|
+
}
|
|
112
|
+
//# sourceMappingURL=whisper-recall.js.map
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Heuristics Store - adaptive procedural rules that evolve from experience.
|
|
3
|
+
*
|
|
4
|
+
* Paper: 2604.14475 Evo-MedAgent
|
|
5
|
+
* Heuristics are priority-tagged rules learned from success/failure feedback.
|
|
6
|
+
*/
|
|
7
|
+
import type { MemoryStoresState, HeuristicRule } from "./types.js";
|
|
8
|
+
export declare function addHeuristicRule(state: MemoryStoresState, condition: string, action: string, initialPriority?: number): HeuristicRule;
|
|
9
|
+
export declare function addPrinciple(state: MemoryStoresState, principle: string, context: string): HeuristicRule;
|
|
10
|
+
export declare function evolveHeuristic(state: MemoryStoresState, ruleId: string, success: boolean): void;
|
|
11
|
+
export declare function calculateHeuristicPriority(rule: HeuristicRule): number;
|
|
12
|
+
export declare function getPrioritizedHeuristics(state: MemoryStoresState): HeuristicRule[];
|
|
13
|
+
export declare function getApplicableHeuristics(state: MemoryStoresState, context: string): HeuristicRule[];
|
|
14
|
+
export declare const BUILTIN_HEURISTICS: {
|
|
15
|
+
condition: string;
|
|
16
|
+
action: string;
|
|
17
|
+
priority: number;
|
|
18
|
+
}[];
|
|
19
|
+
//# sourceMappingURL=heuristics.d.ts.map
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Heuristics Store - adaptive procedural rules that evolve from experience.
|
|
3
|
+
*
|
|
4
|
+
* Paper: 2604.14475 Evo-MedAgent
|
|
5
|
+
* Heuristics are priority-tagged rules learned from success/failure feedback.
|
|
6
|
+
*/
|
|
7
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
8
|
+
import { nextId } from "../../../lib/utils/id.js";
|
|
9
|
+
import { pushBounded } from "../../../lib/utils/bounded.js";
|
|
10
|
+
const log = createLogger("three-memory-stores:heuristics");
|
|
11
|
+
export function addHeuristicRule(state, condition, action, initialPriority = 0.5) {
|
|
12
|
+
const rule = {
|
|
13
|
+
id: nextId("hr"),
|
|
14
|
+
condition,
|
|
15
|
+
action,
|
|
16
|
+
priority: initialPriority,
|
|
17
|
+
successRate: 0.5,
|
|
18
|
+
uses: 0,
|
|
19
|
+
successes: 0,
|
|
20
|
+
lastUsed: 0,
|
|
21
|
+
created: Date.now(),
|
|
22
|
+
};
|
|
23
|
+
// Safety cap 500 — agent-added rules accumulate for the session.
|
|
24
|
+
pushBounded(state.heuristics, rule, 500);
|
|
25
|
+
log.debug(`Added heuristic: "${condition.slice(0, 50)}..."`);
|
|
26
|
+
return rule;
|
|
27
|
+
}
|
|
28
|
+
export function addPrinciple(state, principle, context) {
|
|
29
|
+
const rule = {
|
|
30
|
+
id: nextId("pr"),
|
|
31
|
+
condition: context,
|
|
32
|
+
action: principle,
|
|
33
|
+
priority: 0.2,
|
|
34
|
+
successRate: 0.1,
|
|
35
|
+
uses: 0,
|
|
36
|
+
successes: 0,
|
|
37
|
+
lastUsed: Date.now(),
|
|
38
|
+
created: Date.now(),
|
|
39
|
+
ruleType: "principle",
|
|
40
|
+
};
|
|
41
|
+
// Same safety cap as addHeuristicRule.
|
|
42
|
+
pushBounded(state.heuristics, rule, 500);
|
|
43
|
+
log.info(`Added principle: "${principle.slice(0, 50)}..."`);
|
|
44
|
+
return rule;
|
|
45
|
+
}
|
|
46
|
+
export function evolveHeuristic(state, ruleId, success) {
|
|
47
|
+
const rule = state.heuristics.find((r) => r.id === ruleId);
|
|
48
|
+
if (!rule)
|
|
49
|
+
return;
|
|
50
|
+
rule.uses++;
|
|
51
|
+
if (success)
|
|
52
|
+
rule.successes++;
|
|
53
|
+
rule.successRate = rule.successes / rule.uses;
|
|
54
|
+
rule.priority = calculateHeuristicPriority(rule);
|
|
55
|
+
rule.lastUsed = Date.now();
|
|
56
|
+
}
|
|
57
|
+
export function calculateHeuristicPriority(rule) {
|
|
58
|
+
const successComponent = rule.successRate * 0.6;
|
|
59
|
+
const recencyComponent = Math.max(0, 1 - (Date.now() - rule.lastUsed) / (7 * 24 * 60 * 60 * 1000)) * 0.2;
|
|
60
|
+
const usageComponent = Math.min(rule.uses / 10, 1) * 0.2;
|
|
61
|
+
return successComponent + recencyComponent + usageComponent;
|
|
62
|
+
}
|
|
63
|
+
export function getPrioritizedHeuristics(state) {
|
|
64
|
+
return [...state.heuristics].sort((a, b) => b.priority - a.priority);
|
|
65
|
+
}
|
|
66
|
+
export function getApplicableHeuristics(state, context) {
|
|
67
|
+
return state.heuristics
|
|
68
|
+
.filter((r) => context.toLowerCase().includes(r.condition.toLowerCase()))
|
|
69
|
+
.sort((a, b) => b.priority - a.priority);
|
|
70
|
+
}
|
|
71
|
+
export const BUILTIN_HEURISTICS = [
|
|
72
|
+
{
|
|
73
|
+
condition: "think before write",
|
|
74
|
+
action: "Always use think tool before write tool for complex changes",
|
|
75
|
+
priority: 0.8,
|
|
76
|
+
},
|
|
77
|
+
{ condition: "test after edit", action: "Run tests after modifying code files", priority: 0.7 },
|
|
78
|
+
{
|
|
79
|
+
condition: "read before edit",
|
|
80
|
+
action: "Read file contents before editing to understand context",
|
|
81
|
+
priority: 0.9,
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
condition: "small changes first",
|
|
85
|
+
action: "Make incremental changes and verify each step",
|
|
86
|
+
priority: 0.6,
|
|
87
|
+
},
|
|
88
|
+
];
|
|
89
|
+
//# sourceMappingURL=heuristics.js.map
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Three Memory Stores Extension
|
|
3
|
+
*
|
|
4
|
+
* Paper: 2604.14475 Evo-MedAgent
|
|
5
|
+
* Key finding: Three complementary stores (Episodes + Heuristics + ToolReliability)
|
|
6
|
+
* outperform single memory. MCQ accuracy 0.68 -> 0.79.
|
|
7
|
+
*
|
|
8
|
+
* Architecture:
|
|
9
|
+
* 1. Retrospective Episodes - case-based reasoning from past tasks (episodes.ts)
|
|
10
|
+
* 2. Adaptive Procedural Heuristics - priority-tagged rules that evolve (heuristics.ts)
|
|
11
|
+
* 3. Tool Reliability Controller - per-tool trustworthiness tracking (tool-reliability.ts)
|
|
12
|
+
*
|
|
13
|
+
* Two surfaces:
|
|
14
|
+
* - **Internal API** (episodes.ts / heuristics.ts / tool-reliability.ts):
|
|
15
|
+
* data-layer functions like `addEpisode`, `addPrinciple`, `recordToolCall`.
|
|
16
|
+
* Many extensions import these directly (e.g. finalize.ts adds episodes
|
|
17
|
+
* on task completion, recaller.ts retrieves them for cross-task context).
|
|
18
|
+
* Treat as infrastructure - do not move.
|
|
19
|
+
* - **Agent-facing tools** live in `memory-agent-bridge/` as the unified
|
|
20
|
+
* `memory` tool (actions: recall_search|recall_list|recall_get,
|
|
21
|
+
* episodes_search|episodes_list|episodes_add,
|
|
22
|
+
* heuristics_list|heuristics_add|heuristics_evolve).
|
|
23
|
+
* The separate `memory_store` tool covers the unified semantic-memory write side.
|
|
24
|
+
*/
|
|
25
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
26
|
+
export type { Episode, HeuristicRule, ToolStat, MemoryStoresState } from "./types.js";
|
|
27
|
+
import type { MemoryStoresState } from "./types.js";
|
|
28
|
+
export declare function createMemoryStoresState(): MemoryStoresState;
|
|
29
|
+
export declare function getState(ctx: ExtensionContext): MemoryStoresState;
|
|
30
|
+
export default function threeMemoryStoresExtension(pi: ExtensionAPI): void;
|
|
31
|
+
export { addEpisode, condenseInsights, retrieveEpisodes, retrieveByRUMS, sanitizeEpisode, } from "./episodes.js";
|
|
32
|
+
export { addHeuristicRule, addPrinciple, evolveHeuristic, getPrioritizedHeuristics, getApplicableHeuristics, } from "./heuristics.js";
|
|
33
|
+
export { recordToolCall, getToolReliability, selectBestTool } from "./tool-reliability.js";
|
|
34
|
+
//# sourceMappingURL=index.d.ts.map
|