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,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Memory lifecycle functions.
|
|
3
|
+
*
|
|
4
|
+
* These functions decide what to do with
|
|
5
|
+
* memories: whether to store a new one, what utility to assign, and
|
|
6
|
+
* how to prune/merge existing memories.
|
|
7
|
+
*
|
|
8
|
+
* Pure functions - all dependencies are passed in or imported. No
|
|
9
|
+
* coupling to the CognitiveMemory class or to module-level state.
|
|
10
|
+
*
|
|
11
|
+
* The `consolidate` function is the only one that mutates: it merges
|
|
12
|
+
* duplicate memories and decays utility over time. Callers receive
|
|
13
|
+
* a new CognitiveMemoryStore with the consolidated state.
|
|
14
|
+
*/
|
|
15
|
+
import { jaccardSimilarity } from "./utils.js";
|
|
16
|
+
// ── Constants ────────────────────────────────────────────────────────────────
|
|
17
|
+
const GENERIC_CONTENT_PATTERNS = [/auto-captured memory from enforcement/i, /auto-captured/i];
|
|
18
|
+
// Re-exported for the CognitiveMemory class which also gates on these.
|
|
19
|
+
export { MAX_ENTRIES, MIN_UTILITY_THRESHOLD, CATEGORY_BASE_UTILITY } from "./constants.js";
|
|
20
|
+
import { MAX_ENTRIES, MIN_UTILITY_THRESHOLD, CATEGORY_BASE_UTILITY } from "./constants.js";
|
|
21
|
+
/**
|
|
22
|
+
* Decide whether a new memory should be stored, given existing memories.
|
|
23
|
+
*
|
|
24
|
+
* Rules:
|
|
25
|
+
* - error/goal memories are always stored (high-signal types)
|
|
26
|
+
* - auto-captured enforcement memories are rejected (generic noise)
|
|
27
|
+
* - memories shorter than 20 chars are rejected
|
|
28
|
+
* - duplicate detection via jaccard similarity (60% for same type,
|
|
29
|
+
* 80% for different type)
|
|
30
|
+
*/
|
|
31
|
+
export function shouldStore(content, type, existingMemories) {
|
|
32
|
+
if (type === "error" || type === "goal")
|
|
33
|
+
return true;
|
|
34
|
+
if (GENERIC_CONTENT_PATTERNS.some((p) => p.test(content)))
|
|
35
|
+
return false;
|
|
36
|
+
if (content.trim().length < 20)
|
|
37
|
+
return false;
|
|
38
|
+
const SIMILARITY_THRESHOLD = 0.6;
|
|
39
|
+
const duplicate = existingMemories.find((m) => {
|
|
40
|
+
if (m.type === type)
|
|
41
|
+
return jaccardSimilarity(m.content, content) > SIMILARITY_THRESHOLD;
|
|
42
|
+
return jaccardSimilarity(m.content, content) > 0.8;
|
|
43
|
+
});
|
|
44
|
+
return !duplicate;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Calculate utility score for a memory (0-1).
|
|
48
|
+
*
|
|
49
|
+
* Combines the type's base utility with content-based boosts (fix,
|
|
50
|
+
* solution, pattern, important, critical, remember, key) and the
|
|
51
|
+
* caller's importance rating. Final = base * 0.7 + importance * 0.3.
|
|
52
|
+
*/
|
|
53
|
+
export function calculateUtility(type, content, importance) {
|
|
54
|
+
let base = CATEGORY_BASE_UTILITY[type] ?? 0.5;
|
|
55
|
+
const boostKeywords = ["fix", "solution", "pattern", "important", "critical", "remember", "key"];
|
|
56
|
+
if (boostKeywords.some((k) => content.toLowerCase().includes(k))) {
|
|
57
|
+
base = Math.min(1.0, base + 0.2);
|
|
58
|
+
}
|
|
59
|
+
return base * 0.7 + importance * 0.3;
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Prune memories down to MAX_ENTRIES, keeping recent-access and
|
|
63
|
+
* high-utility entries. Recent (last 5 min) entries are always kept.
|
|
64
|
+
* Other entries are sorted by utility, then timestamp, and trimmed.
|
|
65
|
+
*/
|
|
66
|
+
export function pruneMemories(memories) {
|
|
67
|
+
const now = Date.now();
|
|
68
|
+
const RECENT_ACCESS_MS = 5 * 60 * 1000;
|
|
69
|
+
const recent = memories.filter((m) => now - m.lastAccessed < RECENT_ACCESS_MS);
|
|
70
|
+
const others = memories.filter((m) => now - m.lastAccessed >= RECENT_ACCESS_MS);
|
|
71
|
+
const sorted = [...others].sort((a, b) => {
|
|
72
|
+
if (Math.abs(a.utility - b.utility) > 0.1)
|
|
73
|
+
return b.utility - a.utility;
|
|
74
|
+
return b.timestamp - a.timestamp;
|
|
75
|
+
});
|
|
76
|
+
const remainingSlots = Math.max(0, MAX_ENTRIES - recent.length);
|
|
77
|
+
const pruned = sorted
|
|
78
|
+
.filter((m, i) => i < remainingSlots || m.utility >= MIN_UTILITY_THRESHOLD)
|
|
79
|
+
.slice(0, remainingSlots);
|
|
80
|
+
const combined = [...recent, ...pruned];
|
|
81
|
+
return combined
|
|
82
|
+
.sort((a, b) => {
|
|
83
|
+
if (Math.abs(a.utility - b.utility) > 0.1)
|
|
84
|
+
return b.utility - a.utility;
|
|
85
|
+
return b.timestamp - a.timestamp;
|
|
86
|
+
})
|
|
87
|
+
.slice(0, MAX_ENTRIES);
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Consolidate a memory store: merge near-duplicates, decay old utility.
|
|
91
|
+
*
|
|
92
|
+
* Returns a NEW store (does not mutate the input). Decay: utility
|
|
93
|
+
* scales linearly from 1.0 at access to 0.1 at 168 hours (1 week)
|
|
94
|
+
* since last access or creation.
|
|
95
|
+
*/
|
|
96
|
+
export function consolidate(store) {
|
|
97
|
+
const now = Date.now();
|
|
98
|
+
const DEAD_UTILITY_THRESHOLD = 0.05;
|
|
99
|
+
const alive = store.memories.filter((m) => m.utility >= DEAD_UTILITY_THRESHOLD || m.type === "goal" || m.type === "error");
|
|
100
|
+
const MERGE_THRESHOLD = 0.7;
|
|
101
|
+
const merged = [];
|
|
102
|
+
const mergedIds = new Set();
|
|
103
|
+
for (const memory of alive) {
|
|
104
|
+
if (mergedIds.has(memory.id))
|
|
105
|
+
continue;
|
|
106
|
+
const duplicates = [memory];
|
|
107
|
+
for (const other of alive) {
|
|
108
|
+
if (other.id === memory.id || mergedIds.has(other.id))
|
|
109
|
+
continue;
|
|
110
|
+
if (other.type !== memory.type)
|
|
111
|
+
continue;
|
|
112
|
+
if (jaccardSimilarity(memory.content, other.content) > MERGE_THRESHOLD) {
|
|
113
|
+
duplicates.push(other);
|
|
114
|
+
mergedIds.add(other.id);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
if (duplicates.length > 1) {
|
|
118
|
+
duplicates.sort((a, b) => b.utility - a.utility);
|
|
119
|
+
const best = { ...duplicates[0] };
|
|
120
|
+
best.utility = Math.min(1.0, best.utility + 0.1 * (duplicates.length - 1));
|
|
121
|
+
best.tags = [...new Set(duplicates.flatMap((d) => d.tags))];
|
|
122
|
+
best.accessCount = duplicates.reduce((sum, d) => sum + d.accessCount, 0);
|
|
123
|
+
merged.push(best);
|
|
124
|
+
mergedIds.add(memory.id);
|
|
125
|
+
}
|
|
126
|
+
else if (!mergedIds.has(memory.id)) {
|
|
127
|
+
merged.push(memory);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
const decayed = merged.map((m) => {
|
|
131
|
+
const effectiveTime = Math.max(m.timestamp, m.lastAccessed || m.timestamp);
|
|
132
|
+
const ageHours = (now - effectiveTime) / (1000 * 60 * 60);
|
|
133
|
+
const decayFactor = Math.max(0.1, 1 - ageHours / 168);
|
|
134
|
+
return { ...m, utility: m.utility * decayFactor };
|
|
135
|
+
});
|
|
136
|
+
const pruned = pruneMemories(decayed);
|
|
137
|
+
return { ...store, memories: pruned, lastConsolidation: store.turnCount };
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=lifecycle.js.map
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Proactive Past Insights.
|
|
3
|
+
*
|
|
4
|
+
* Surfaces relevant experience from previous sessions to the agent.
|
|
5
|
+
* Uses three-memory-stores (episodes) + session-recall (sessions).
|
|
6
|
+
* Memory confidence threshold: only inject if relevance >= 0.7.
|
|
7
|
+
*
|
|
8
|
+
* Delivery model: WHISPER. The insights are sent once per session as a
|
|
9
|
+
* `context` custom message (steer, no trigger). The agent sees them in
|
|
10
|
+
* the next turn but they do NOT live in the system prompt - this keeps
|
|
11
|
+
* the prompt lean and the insights transient.
|
|
12
|
+
*/
|
|
13
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
14
|
+
export interface PastInsight {
|
|
15
|
+
type: "episode" | "session";
|
|
16
|
+
relevance: number;
|
|
17
|
+
content: string;
|
|
18
|
+
source: string;
|
|
19
|
+
project?: string;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Derive a project identifier from a cwd path.
|
|
23
|
+
* Returns the last 2 path components.
|
|
24
|
+
*/
|
|
25
|
+
export declare function deriveProjectIdFromCwd(cwd: string): string;
|
|
26
|
+
/**
|
|
27
|
+
* Search past sessions and episodes for relevant insights.
|
|
28
|
+
*/
|
|
29
|
+
export declare function searchPastInsights(cwd: string): Promise<PastInsight[]>;
|
|
30
|
+
/**
|
|
31
|
+
* Deliver past insights as a whisper (once per session).
|
|
32
|
+
* Best-effort: any failure (missing dirs, malformed JSON) is swallowed.
|
|
33
|
+
*/
|
|
34
|
+
export declare function deliverPastInsights(cwd: string, pi: ExtensionAPI, _ctx: ExtensionContext): Promise<void>;
|
|
35
|
+
//# sourceMappingURL=past-insights.d.ts.map
|
|
@@ -0,0 +1,189 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Proactive Past Insights.
|
|
3
|
+
*
|
|
4
|
+
* Surfaces relevant experience from previous sessions to the agent.
|
|
5
|
+
* Uses three-memory-stores (episodes) + session-recall (sessions).
|
|
6
|
+
* Memory confidence threshold: only inject if relevance >= 0.7.
|
|
7
|
+
*
|
|
8
|
+
* Delivery model: WHISPER. The insights are sent once per session as a
|
|
9
|
+
* `context` custom message (steer, no trigger). The agent sees them in
|
|
10
|
+
* the next turn but they do NOT live in the system prompt - this keeps
|
|
11
|
+
* the prompt lean and the insights transient.
|
|
12
|
+
*/
|
|
13
|
+
import { homedir } from "node:os";
|
|
14
|
+
import { join } from "node:path";
|
|
15
|
+
import { readdir, readFile } from "node:fs/promises";
|
|
16
|
+
import { sendTrackedMessage } from "../utils/injection-tracker.js";
|
|
17
|
+
import { fenceMemoryContext } from "../utils/memory-fence.js";
|
|
18
|
+
import { asyncExists } from "../utils/async-fs.js";
|
|
19
|
+
import { memoryDir } from "../config/braid-paths.js";
|
|
20
|
+
import { hasSignal } from "./write-quality.js";
|
|
21
|
+
/**
|
|
22
|
+
* Derive a project identifier from a cwd path.
|
|
23
|
+
* Returns the last 2 path components.
|
|
24
|
+
*/
|
|
25
|
+
export function deriveProjectIdFromCwd(cwd) {
|
|
26
|
+
const parts = cwd.replace(/\\/g, "/").split("/").filter(Boolean);
|
|
27
|
+
if (parts.length < 2)
|
|
28
|
+
return cwd || "unknown";
|
|
29
|
+
return parts.slice(-2).join("/");
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Check if an episode is eligible for cross-project injection.
|
|
33
|
+
* HaluMem (2511.03506): Only allow cross-project if recent (< 1h) and high-quality (success).
|
|
34
|
+
*/
|
|
35
|
+
function isCrossProjectInjectionAllowed(epProject, currentProject, timestamp, outcome) {
|
|
36
|
+
if (!epProject || epProject === currentProject || epProject === "unknown")
|
|
37
|
+
return true;
|
|
38
|
+
const ageMs = Date.now() - timestamp;
|
|
39
|
+
return ageMs < 3600000 && outcome === "success";
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Search past sessions and episodes for relevant insights.
|
|
43
|
+
*/
|
|
44
|
+
export async function searchPastInsights(cwd) {
|
|
45
|
+
const projectId = deriveProjectIdFromCwd(cwd);
|
|
46
|
+
const insights = [];
|
|
47
|
+
// Search three-memory-stores episodes. The store root is resolved through
|
|
48
|
+
// the accessor, never the module-load constant: a pinned run must read the
|
|
49
|
+
// tree the writers wrote to, and a refused root (no absolute braid home)
|
|
50
|
+
// degrades to "nothing to search" instead of throwing into the caller.
|
|
51
|
+
let memoryRoot;
|
|
52
|
+
try {
|
|
53
|
+
memoryRoot = memoryDir();
|
|
54
|
+
}
|
|
55
|
+
catch {
|
|
56
|
+
memoryRoot = null;
|
|
57
|
+
}
|
|
58
|
+
if (memoryRoot !== null && (await asyncExists(memoryRoot))) {
|
|
59
|
+
try {
|
|
60
|
+
const episodeFiles = (await readdir(memoryRoot)).filter((f) => f.startsWith("episodes"));
|
|
61
|
+
for (const file of episodeFiles.slice(0, 3)) {
|
|
62
|
+
const content = await readFile(join(memoryRoot, file), "utf-8");
|
|
63
|
+
const lines = content.split("\n").filter((l) => l.trim());
|
|
64
|
+
for (const line of lines.slice(-5)) {
|
|
65
|
+
try {
|
|
66
|
+
const ep = JSON.parse(line);
|
|
67
|
+
if (!ep.task || !ep.outcome)
|
|
68
|
+
continue;
|
|
69
|
+
if (!isCrossProjectInjectionAllowed(ep.project, projectId, ep.timestamp ?? Date.now(), ep.outcome)) {
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
insights.push({
|
|
73
|
+
type: "episode",
|
|
74
|
+
project: ep.project || "unknown",
|
|
75
|
+
relevance: 0.75,
|
|
76
|
+
content: `[${ep.outcome}] ${ep.task}: ${ep.solution || "(see logs)"}`,
|
|
77
|
+
source: `episodes:${ep.id}`,
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
/* skip malformed */
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
/* skip unavailable */
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
// Search recent session summaries
|
|
91
|
+
const sessionDir = join(homedir(), ".pi/agent/sessions");
|
|
92
|
+
if (await asyncExists(sessionDir)) {
|
|
93
|
+
try {
|
|
94
|
+
const sessions = (await readdir(sessionDir))
|
|
95
|
+
.filter((f) => f.endsWith(".jsonl"))
|
|
96
|
+
.sort()
|
|
97
|
+
.reverse()
|
|
98
|
+
.slice(0, 3);
|
|
99
|
+
for (const session of sessions) {
|
|
100
|
+
const content = await readFile(join(sessionDir, session), "utf-8");
|
|
101
|
+
const lines = content.split("\n").filter((l) => l.trim());
|
|
102
|
+
for (const line of lines.slice(-3)) {
|
|
103
|
+
try {
|
|
104
|
+
const entry = JSON.parse(line);
|
|
105
|
+
if (entry.message &&
|
|
106
|
+
(String(entry.message).includes("finalize") ||
|
|
107
|
+
String(entry.message).includes("completed"))) {
|
|
108
|
+
const task = extractTaskFromEntry(entry);
|
|
109
|
+
if (task) {
|
|
110
|
+
insights.push({
|
|
111
|
+
type: "session",
|
|
112
|
+
project: "unknown",
|
|
113
|
+
relevance: 0.7,
|
|
114
|
+
content: `Session: ${task}`,
|
|
115
|
+
source: `session:${session}`,
|
|
116
|
+
});
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
catch {
|
|
121
|
+
/* skip malformed */
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
catch {
|
|
127
|
+
/* skip unavailable */
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
return insights.filter((i) => i.relevance >= 0.7).slice(0, 5);
|
|
131
|
+
}
|
|
132
|
+
function extractTaskFromEntry(entry) {
|
|
133
|
+
const msg = String(entry.message || "");
|
|
134
|
+
const patterns = [/told to ([^.]{10,80})/i, /task: ([^.]{10,80})/i, /completed: ([^.]{10,80})/i];
|
|
135
|
+
for (const pattern of patterns) {
|
|
136
|
+
const match = msg.match(pattern);
|
|
137
|
+
if (match)
|
|
138
|
+
return match[1].trim();
|
|
139
|
+
}
|
|
140
|
+
return null;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Filter out insights whose content is just metrics (no actionable signal).
|
|
144
|
+
* Returns "" if no insights have signal, or the rendered section if any do.
|
|
145
|
+
*/
|
|
146
|
+
function renderInsightsAsSection(insights) {
|
|
147
|
+
if (insights.length === 0)
|
|
148
|
+
return "";
|
|
149
|
+
const filtered = insights.filter((i) => hasSignal(i.content));
|
|
150
|
+
if (filtered.length === 0)
|
|
151
|
+
return "";
|
|
152
|
+
// Preserve the leading blank line from the original lines-based impl
|
|
153
|
+
// so the whisper text matches the section format the agent used to see.
|
|
154
|
+
const lines = [
|
|
155
|
+
"",
|
|
156
|
+
"## Past Insights",
|
|
157
|
+
"*(Relevant experience from previous sessions)*",
|
|
158
|
+
...filtered.map((insight) => `- ${insight.content}`),
|
|
159
|
+
];
|
|
160
|
+
return lines.join("\n");
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* Deliver past insights as a whisper (once per session).
|
|
164
|
+
* Best-effort: any failure (missing dirs, malformed JSON) is swallowed.
|
|
165
|
+
*/
|
|
166
|
+
export async function deliverPastInsights(cwd, pi, _ctx) {
|
|
167
|
+
let insights;
|
|
168
|
+
try {
|
|
169
|
+
insights = await searchPastInsights(cwd);
|
|
170
|
+
}
|
|
171
|
+
catch {
|
|
172
|
+
return;
|
|
173
|
+
}
|
|
174
|
+
const text = renderInsightsAsSection(insights);
|
|
175
|
+
if (!text)
|
|
176
|
+
return;
|
|
177
|
+
try {
|
|
178
|
+
sendTrackedMessage(pi, {
|
|
179
|
+
customType: "context",
|
|
180
|
+
display: true,
|
|
181
|
+
// Recalled episodes and session summaries are fenced non-user context.
|
|
182
|
+
content: [{ type: "text", text: fenceMemoryContext(text) }],
|
|
183
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "memory", source: "prompt-builder/insights" });
|
|
184
|
+
}
|
|
185
|
+
catch {
|
|
186
|
+
// Non-fatal: steer message send is best-effort
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
//# sourceMappingURL=past-insights.js.map
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cognitive Memory - file I/O for persistent storage.
|
|
3
|
+
*
|
|
4
|
+
* The disk store is the shared baseline for every live pi process: writers
|
|
5
|
+
* never rewrite it from their own snapshot. `saveMemory` re-reads the file
|
|
6
|
+
* under a cross-process lock, merges the caller's records by entry id
|
|
7
|
+
* (store-merge.ts), and persists the merged result atomically
|
|
8
|
+
* (temp file + rename, via the file mutation queue). A caller that removed
|
|
9
|
+
* ids from its snapshot passes them so deletions are expressed instead of
|
|
10
|
+
* accidentally resurrecting the removed entries.
|
|
11
|
+
*/
|
|
12
|
+
import { type MergeStoresOptions } from "./store-merge.js";
|
|
13
|
+
import type { CognitiveMemoryStore } from "./types.js";
|
|
14
|
+
/** Exclusive lock guarding the read-merge-write cycle on the semantic store.
|
|
15
|
+
* Resolved through the live store path so the lock and the file it guards
|
|
16
|
+
* always name the same (possibly BRAID_HOME-pinned) store. */
|
|
17
|
+
export declare function semanticStoreLockFilePath(): string;
|
|
18
|
+
/**
|
|
19
|
+
* Raw read of the current disk store. No migration side effects (those live
|
|
20
|
+
* in loadMemory, which may legitimately write) — this reader must be safe to
|
|
21
|
+
* call from inside the persistence lock.
|
|
22
|
+
* Returns null when the file is absent or unreadable.
|
|
23
|
+
*/
|
|
24
|
+
export declare function readStoreFile(): Promise<CognitiveMemoryStore | null>;
|
|
25
|
+
export declare function loadMemory(): Promise<CognitiveMemoryStore>;
|
|
26
|
+
/**
|
|
27
|
+
* Merge-on-write persistence: re-read the disk store under the lock, union
|
|
28
|
+
* the caller's records by entry id, and write the merged result atomically.
|
|
29
|
+
* Returns the merged store; persistent callers (the CognitiveMemory class)
|
|
30
|
+
* adopt it as their new in-memory snapshot so the next read sees what other
|
|
31
|
+
* processes wrote.
|
|
32
|
+
*
|
|
33
|
+
* `opts.replaceAll` is for explicit wipes only. `opts.removeIds` carries the
|
|
34
|
+
* caller's deletion intent (ids it removed from its snapshot since loading);
|
|
35
|
+
* without it, a removed id would look like "never seen" and be resurrected.
|
|
36
|
+
*/
|
|
37
|
+
export declare function saveMemory(local: CognitiveMemoryStore, opts?: MergeStoresOptions): Promise<CognitiveMemoryStore>;
|
|
38
|
+
//# sourceMappingURL=storage.d.ts.map
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cognitive Memory - file I/O for persistent storage.
|
|
3
|
+
*
|
|
4
|
+
* The disk store is the shared baseline for every live pi process: writers
|
|
5
|
+
* never rewrite it from their own snapshot. `saveMemory` re-reads the file
|
|
6
|
+
* under a cross-process lock, merges the caller's records by entry id
|
|
7
|
+
* (store-merge.ts), and persists the merged result atomically
|
|
8
|
+
* (temp file + rename, via the file mutation queue). A caller that removed
|
|
9
|
+
* ids from its snapshot passes them so deletions are expressed instead of
|
|
10
|
+
* accidentally resurrecting the removed entries.
|
|
11
|
+
*/
|
|
12
|
+
import * as fs from "node:fs/promises";
|
|
13
|
+
import { fileMutationQueue } from "../utils/file-mutation-queue.js";
|
|
14
|
+
import { createLogger } from "../core/logger.js";
|
|
15
|
+
import { memoryDir, semanticMemoryFilePath, legacyMemoryFilePath } from "../config/braid-paths.js";
|
|
16
|
+
import { withStoreLock } from "./store-lock.js";
|
|
17
|
+
import { mergeStores } from "./store-merge.js";
|
|
18
|
+
const _log = createLogger("semantic-memory:storage");
|
|
19
|
+
/** Exclusive lock guarding the read-merge-write cycle on the semantic store.
|
|
20
|
+
* Resolved through the live store path so the lock and the file it guards
|
|
21
|
+
* always name the same (possibly BRAID_HOME-pinned) store. */
|
|
22
|
+
export function semanticStoreLockFilePath() {
|
|
23
|
+
return `${semanticMemoryFilePath()}.lock`;
|
|
24
|
+
}
|
|
25
|
+
async function ensureMemoryDir() {
|
|
26
|
+
await fs.mkdir(memoryDir(), { recursive: true });
|
|
27
|
+
}
|
|
28
|
+
/** Map the legacy `{entries: [...]}` format onto the current memories shape. Pure. */
|
|
29
|
+
function migrateEntriesShape(parsed) {
|
|
30
|
+
return {
|
|
31
|
+
version: 1,
|
|
32
|
+
memories: parsed.entries.map((e) => ({
|
|
33
|
+
id: e.id,
|
|
34
|
+
content: e.content,
|
|
35
|
+
type: e.category,
|
|
36
|
+
tags: e.tags || [],
|
|
37
|
+
timestamp: e.timestamp,
|
|
38
|
+
accessCount: 0,
|
|
39
|
+
lastAccessed: e.timestamp,
|
|
40
|
+
source: e.source,
|
|
41
|
+
importance: e.utility,
|
|
42
|
+
utility: e.utility,
|
|
43
|
+
})),
|
|
44
|
+
lastConsolidation: parsed.lastConsolidation || 0,
|
|
45
|
+
turnCount: parsed.turnCount || 0,
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Raw read of the current disk store. No migration side effects (those live
|
|
50
|
+
* in loadMemory, which may legitimately write) — this reader must be safe to
|
|
51
|
+
* call from inside the persistence lock.
|
|
52
|
+
* Returns null when the file is absent or unreadable.
|
|
53
|
+
*/
|
|
54
|
+
export async function readStoreFile() {
|
|
55
|
+
try {
|
|
56
|
+
const data = await fs.readFile(semanticMemoryFilePath(), "utf-8");
|
|
57
|
+
const parsed = JSON.parse(data);
|
|
58
|
+
if (parsed?.memories)
|
|
59
|
+
return parsed;
|
|
60
|
+
if (parsed?.entries)
|
|
61
|
+
return migrateEntriesShape(parsed);
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
catch (e) {
|
|
65
|
+
if (e.code !== "ENOENT") {
|
|
66
|
+
_log.error("Read error:", e);
|
|
67
|
+
}
|
|
68
|
+
return null;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
export async function loadMemory() {
|
|
72
|
+
try {
|
|
73
|
+
await ensureMemoryDir();
|
|
74
|
+
}
|
|
75
|
+
catch (err) {
|
|
76
|
+
// A reader degrades: a refused root (no absolute braid root resolves) is
|
|
77
|
+
// read as an absent store, and the writer side is the loud one.
|
|
78
|
+
_log.warn(`Semantic store root unavailable, starting empty: ${err}`);
|
|
79
|
+
}
|
|
80
|
+
// Prefer the current format; legacy sources are handled below.
|
|
81
|
+
try {
|
|
82
|
+
const data = await fs.readFile(semanticMemoryFilePath(), "utf-8");
|
|
83
|
+
const parsed = JSON.parse(data);
|
|
84
|
+
// Handle migration from old format (entries) to new format (memories)
|
|
85
|
+
if (parsed.entries && !parsed.memories) {
|
|
86
|
+
const migrated = migrateEntriesShape(parsed);
|
|
87
|
+
await saveMemory(migrated);
|
|
88
|
+
return migrated;
|
|
89
|
+
}
|
|
90
|
+
// After loading from new path, check if legacy memories need importing
|
|
91
|
+
// This handles the case where semantic.json exists but legacy memories
|
|
92
|
+
// were never migrated (e.g., migration condition missed the file format)
|
|
93
|
+
const store = parsed;
|
|
94
|
+
if (!store.migratedAt) {
|
|
95
|
+
try {
|
|
96
|
+
const legacyData = await fs.readFile(legacyMemoryFilePath(), "utf-8");
|
|
97
|
+
const legacyParsed = JSON.parse(legacyData);
|
|
98
|
+
if (legacyParsed.memories?.length > 0) {
|
|
99
|
+
const existingIds = new Set(store.memories.map((m) => m.id));
|
|
100
|
+
const newMemories = legacyParsed.memories.filter((m) => !existingIds.has(m.id));
|
|
101
|
+
if (newMemories.length > 0) {
|
|
102
|
+
_log.info(`Importing ${newMemories.length} legacy memories into semantic store`);
|
|
103
|
+
store.memories.push(...newMemories);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
catch (e) {
|
|
108
|
+
if (e.code !== "ENOENT") {
|
|
109
|
+
_log.warn("Legacy memory check failed:", e);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
store.migratedAt = Date.now();
|
|
113
|
+
await saveMemory(store);
|
|
114
|
+
}
|
|
115
|
+
return store;
|
|
116
|
+
}
|
|
117
|
+
catch (e) {
|
|
118
|
+
if (e.code !== "ENOENT") {
|
|
119
|
+
_log.error("Load error (new path):", e);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
// Fallback: try the legacy pre-braid path (resolved off the live root, so a
|
|
123
|
+
// pinned braid home migrates only its own predecessor).
|
|
124
|
+
try {
|
|
125
|
+
const legacyData = await fs.readFile(legacyMemoryFilePath(), "utf-8");
|
|
126
|
+
const legacyParsed = JSON.parse(legacyData);
|
|
127
|
+
if (legacyParsed.memories && legacyParsed.memories.length > 0) {
|
|
128
|
+
_log.info(`Migrating ${legacyParsed.memories.length} memories from legacy path`);
|
|
129
|
+
if (legacyParsed.entries && !legacyParsed.memories) {
|
|
130
|
+
const migrated = migrateEntriesShape(legacyParsed);
|
|
131
|
+
await saveMemory(migrated);
|
|
132
|
+
return migrated;
|
|
133
|
+
}
|
|
134
|
+
// Migrate to new path for next load
|
|
135
|
+
await saveMemory(legacyParsed);
|
|
136
|
+
return legacyParsed;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
catch (e) {
|
|
140
|
+
// ENOENT on legacy path is expected (fresh install or already migrated)
|
|
141
|
+
if (e.code !== "ENOENT") {
|
|
142
|
+
_log.error("Load error (legacy path):", e);
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
return { version: 1, memories: [], lastConsolidation: 0, turnCount: 0 };
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* Merge-on-write persistence: re-read the disk store under the lock, union
|
|
149
|
+
* the caller's records by entry id, and write the merged result atomically.
|
|
150
|
+
* Returns the merged store; persistent callers (the CognitiveMemory class)
|
|
151
|
+
* adopt it as their new in-memory snapshot so the next read sees what other
|
|
152
|
+
* processes wrote.
|
|
153
|
+
*
|
|
154
|
+
* `opts.replaceAll` is for explicit wipes only. `opts.removeIds` carries the
|
|
155
|
+
* caller's deletion intent (ids it removed from its snapshot since loading);
|
|
156
|
+
* without it, a removed id would look like "never seen" and be resurrected.
|
|
157
|
+
*/
|
|
158
|
+
export async function saveMemory(local, opts = {}) {
|
|
159
|
+
await ensureMemoryDir();
|
|
160
|
+
return withStoreLock(semanticStoreLockFilePath(), async () => {
|
|
161
|
+
const disk = await readStoreFile();
|
|
162
|
+
const merged = mergeStores(disk, local, opts);
|
|
163
|
+
await fileMutationQueue.write(semanticMemoryFilePath(), merged);
|
|
164
|
+
return merged;
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
//# sourceMappingURL=storage.js.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cross-process store lock for the memory disk layers.
|
|
3
|
+
*
|
|
4
|
+
* The memory stores are written by several live pi processes (workers,
|
|
5
|
+
* subagents, heartbeat). A read-merge-write cycle is only as safe as the
|
|
6
|
+
* window between reading the file and renaming the new one: without mutual
|
|
7
|
+
* exclusion, two concurrent merge-writers can still lose each other's update
|
|
8
|
+
* (both read the same baseline, both rename, the last rename wins). The lock
|
|
9
|
+
* closes that window.
|
|
10
|
+
*
|
|
11
|
+
* Mechanism: an exclusive-create lock file (`open(path, "wx")`). It works
|
|
12
|
+
* across processes AND across interleaved async calls within one process.
|
|
13
|
+
* Contenders poll; a lock older than LOCK_STALE_MS is stolen (its holder may
|
|
14
|
+
* have crashed between create and release). Timeout raises so a wedged lock
|
|
15
|
+
* never hangs a memory write forever; callers degrade to their existing
|
|
16
|
+
* error paths.
|
|
17
|
+
*/
|
|
18
|
+
/**
|
|
19
|
+
* Run `fn` while holding the exclusive lock at `lockPath`.
|
|
20
|
+
* Throws on timeout; the caller decides how to degrade.
|
|
21
|
+
*/
|
|
22
|
+
export declare function withStoreLock<T>(lockPath: string, fn: () => Promise<T>): Promise<T>;
|
|
23
|
+
//# sourceMappingURL=store-lock.d.ts.map
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cross-process store lock for the memory disk layers.
|
|
3
|
+
*
|
|
4
|
+
* The memory stores are written by several live pi processes (workers,
|
|
5
|
+
* subagents, heartbeat). A read-merge-write cycle is only as safe as the
|
|
6
|
+
* window between reading the file and renaming the new one: without mutual
|
|
7
|
+
* exclusion, two concurrent merge-writers can still lose each other's update
|
|
8
|
+
* (both read the same baseline, both rename, the last rename wins). The lock
|
|
9
|
+
* closes that window.
|
|
10
|
+
*
|
|
11
|
+
* Mechanism: an exclusive-create lock file (`open(path, "wx")`). It works
|
|
12
|
+
* across processes AND across interleaved async calls within one process.
|
|
13
|
+
* Contenders poll; a lock older than LOCK_STALE_MS is stolen (its holder may
|
|
14
|
+
* have crashed between create and release). Timeout raises so a wedged lock
|
|
15
|
+
* never hangs a memory write forever; callers degrade to their existing
|
|
16
|
+
* error paths.
|
|
17
|
+
*/
|
|
18
|
+
import { open, stat, unlink, mkdir } from "node:fs/promises";
|
|
19
|
+
import { dirname } from "node:path";
|
|
20
|
+
const LOCK_RETRY_MS = 25;
|
|
21
|
+
const LOCK_TIMEOUT_MS = 5_000;
|
|
22
|
+
const LOCK_STALE_MS = 10_000;
|
|
23
|
+
function sleep(ms) {
|
|
24
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
25
|
+
}
|
|
26
|
+
async function lockIsStale(lockPath) {
|
|
27
|
+
try {
|
|
28
|
+
const st = await stat(lockPath);
|
|
29
|
+
return Date.now() - st.mtimeMs > LOCK_STALE_MS;
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Run `fn` while holding the exclusive lock at `lockPath`.
|
|
37
|
+
* Throws on timeout; the caller decides how to degrade.
|
|
38
|
+
*/
|
|
39
|
+
export async function withStoreLock(lockPath, fn) {
|
|
40
|
+
await mkdir(dirname(lockPath), { recursive: true });
|
|
41
|
+
const deadline = Date.now() + LOCK_TIMEOUT_MS;
|
|
42
|
+
let handle;
|
|
43
|
+
for (;;) {
|
|
44
|
+
try {
|
|
45
|
+
handle = await open(lockPath, "wx");
|
|
46
|
+
break;
|
|
47
|
+
}
|
|
48
|
+
catch (err) {
|
|
49
|
+
if (err.code !== "EEXIST")
|
|
50
|
+
throw err;
|
|
51
|
+
if (await lockIsStale(lockPath)) {
|
|
52
|
+
await unlink(lockPath).catch(() => { });
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
if (Date.now() > deadline) {
|
|
56
|
+
throw new Error(`memory store lock timeout: ${lockPath}`, { cause: err });
|
|
57
|
+
}
|
|
58
|
+
await sleep(LOCK_RETRY_MS);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
try {
|
|
62
|
+
return await fn();
|
|
63
|
+
}
|
|
64
|
+
finally {
|
|
65
|
+
await handle.close().catch(() => { });
|
|
66
|
+
await unlink(lockPath).catch(() => { });
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=store-lock.js.map
|