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,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session-file statistics for the `session` tool's `stats` action.
|
|
3
|
+
*
|
|
4
|
+
* Split out of index.ts so the aggregation can be exercised against a fixture
|
|
5
|
+
* tree: the sessions root is a module constant, so the tool itself can only
|
|
6
|
+
* read the live tree.
|
|
7
|
+
*/
|
|
8
|
+
export interface SessionStatEntry {
|
|
9
|
+
path: string;
|
|
10
|
+
size: number;
|
|
11
|
+
project: string;
|
|
12
|
+
date: string;
|
|
13
|
+
/** True for a compaction archive under `<session dir>/archives/`. */
|
|
14
|
+
archive: boolean;
|
|
15
|
+
}
|
|
16
|
+
export interface SessionStatsTotals {
|
|
17
|
+
entries: SessionStatEntry[];
|
|
18
|
+
totalSize: number;
|
|
19
|
+
/** Compaction archives among `entries`, and the messages they carry. */
|
|
20
|
+
archives: {
|
|
21
|
+
files: number;
|
|
22
|
+
messages: number;
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
export interface SessionStatsOptions {
|
|
26
|
+
project?: string | null;
|
|
27
|
+
/** Inclusive epoch-ms bounds on the file's date. */
|
|
28
|
+
since?: number | null;
|
|
29
|
+
until?: number | null;
|
|
30
|
+
}
|
|
31
|
+
/** Compaction archives live in `<session dir>/archives/`. */
|
|
32
|
+
export declare function isArchivePath(filePath: string): boolean;
|
|
33
|
+
export declare function collectSessionStats(files: string[], options?: SessionStatsOptions): Promise<SessionStatsTotals>;
|
|
34
|
+
//# sourceMappingURL=stats.d.ts.map
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session-file statistics for the `session` tool's `stats` action.
|
|
3
|
+
*
|
|
4
|
+
* Split out of index.ts so the aggregation can be exercised against a fixture
|
|
5
|
+
* tree: the sessions root is a module constant, so the tool itself can only
|
|
6
|
+
* read the live tree.
|
|
7
|
+
*/
|
|
8
|
+
import { readFile, stat } from "node:fs/promises";
|
|
9
|
+
import { countArchivedMessages } from "./text-utils.js";
|
|
10
|
+
import { dateFromPath, pathMatchesProject, projectFromPath } from "./search.js";
|
|
11
|
+
/** Compaction archives live in `<session dir>/archives/`. */
|
|
12
|
+
export function isArchivePath(filePath) {
|
|
13
|
+
return /[/\\]archives[/\\]/.test(filePath);
|
|
14
|
+
}
|
|
15
|
+
export async function collectSessionStats(files, options = {}) {
|
|
16
|
+
const { project = null, since = null, until = null } = options;
|
|
17
|
+
const entries = [];
|
|
18
|
+
let totalSize = 0;
|
|
19
|
+
for (const filePath of files) {
|
|
20
|
+
if (project && !pathMatchesProject(filePath, project))
|
|
21
|
+
continue;
|
|
22
|
+
// Archives carry no date stamp, so dateFromPath falls back to their mtime.
|
|
23
|
+
// A file with neither is not statable and is skipped, as before.
|
|
24
|
+
const date = dateFromPath(filePath);
|
|
25
|
+
if (date === "unknown")
|
|
26
|
+
continue;
|
|
27
|
+
const fileTs = new Date(date + "T00:00:00.000Z").getTime();
|
|
28
|
+
if (since !== null && fileTs < since)
|
|
29
|
+
continue;
|
|
30
|
+
if (until !== null && fileTs > until)
|
|
31
|
+
continue;
|
|
32
|
+
let size;
|
|
33
|
+
try {
|
|
34
|
+
size = (await stat(filePath)).size;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
continue; // unreadable file
|
|
38
|
+
}
|
|
39
|
+
totalSize += size;
|
|
40
|
+
entries.push({
|
|
41
|
+
path: filePath,
|
|
42
|
+
size,
|
|
43
|
+
project: projectFromPath(filePath),
|
|
44
|
+
date,
|
|
45
|
+
archive: isArchivePath(filePath),
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
let archiveFiles = 0;
|
|
49
|
+
let messages = 0;
|
|
50
|
+
for (const entry of entries) {
|
|
51
|
+
if (!entry.archive)
|
|
52
|
+
continue;
|
|
53
|
+
archiveFiles++;
|
|
54
|
+
try {
|
|
55
|
+
const body = await readFile(entry.path, "utf-8");
|
|
56
|
+
for (const line of body.split("\n")) {
|
|
57
|
+
if (line)
|
|
58
|
+
messages += countArchivedMessages(line);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
// Unreadable archive: counted as a file, not as messages.
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return { entries, totalSize, archives: { files: archiveFiles, messages } };
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=stats.js.map
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text extraction helpers for session-recall.
|
|
3
|
+
*
|
|
4
|
+
* Pure functions - no dependencies on session-recall's internal state.
|
|
5
|
+
*
|
|
6
|
+
* Used by the session search and query actions to:
|
|
7
|
+
* - extractMessageText: parse a single live .jsonl entry into {role, text}
|
|
8
|
+
* - extractLineMessages: parse any .jsonl line — a live entry OR a
|
|
9
|
+
* compaction-archive envelope — into every message it carries
|
|
10
|
+
* - snippetAround: extract a keyword-anchored window from a long text
|
|
11
|
+
* - estimateTokens: rough token count (1 token ~= 4 chars)
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* Cap on messages parsed from one archive line. A single compaction envelope
|
|
15
|
+
* holds the entire pre-compaction batch as one JSON string and is one physical
|
|
16
|
+
* line regardless of size; measured archives carry up to 1188 messages (139
|
|
17
|
+
* archives, p99=1005, max line 3.4 MB). The cap bounds a pathological envelope
|
|
18
|
+
* without truncating the measured corpus, and callers surface `truncated`
|
|
19
|
+
* rather than presenting a partial read as complete.
|
|
20
|
+
*/
|
|
21
|
+
export declare const MAX_ARCHIVE_MESSAGES = 2000;
|
|
22
|
+
export interface ExtractedMessage {
|
|
23
|
+
role: string;
|
|
24
|
+
text: string;
|
|
25
|
+
}
|
|
26
|
+
export interface LineMessages {
|
|
27
|
+
messages: ExtractedMessage[];
|
|
28
|
+
/** True when the line was a compaction-archive envelope, not a live entry. */
|
|
29
|
+
isArchive: boolean;
|
|
30
|
+
/** True when the envelope held more messages than MAX_ARCHIVE_MESSAGES. */
|
|
31
|
+
truncated: boolean;
|
|
32
|
+
/** Messages the line carries (envelope: originals length; live: 0 or 1). */
|
|
33
|
+
totalMessages: number;
|
|
34
|
+
/** Envelope provenance counters; present only on archive lines. */
|
|
35
|
+
compactedMessages?: number;
|
|
36
|
+
keptMessages?: number;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Parse a single .jsonl line and extract the message text.
|
|
40
|
+
*
|
|
41
|
+
* Returns null for entries that carry no message text (tool calls, metadata,
|
|
42
|
+
* durable `custom` entries), for archive envelopes (use extractLineMessages
|
|
43
|
+
* for those), or for lines without extractable text content. Ordinary
|
|
44
|
+
* `message` entries and extension-injected `custom_message` entries both
|
|
45
|
+
* yield a message; the `role` is returned so callers can distinguish them.
|
|
46
|
+
*/
|
|
47
|
+
export declare function extractMessageText(jsonLine: string): {
|
|
48
|
+
role: string;
|
|
49
|
+
text: string;
|
|
50
|
+
} | null;
|
|
51
|
+
/**
|
|
52
|
+
* Parse one .jsonl line into every message it carries.
|
|
53
|
+
*
|
|
54
|
+
* A live line is one entry (`{type:"message", message:{role,content}}` or
|
|
55
|
+
* `{type:"custom_message", content}`) → 0 or 1 message. An archives/*.jsonl line is a compaction envelope whose
|
|
56
|
+
* `originals` field is a JSON string holding the pre-compaction message array
|
|
57
|
+
* (written by context-manager's writeOriginalsArchive) → 0..N messages. The
|
|
58
|
+
* envelope is ONE physical line however many messages it holds, so callers
|
|
59
|
+
* that snippet per line must iterate the returned array; a search line that
|
|
60
|
+
* matches only inside a large archive would otherwise render nothing.
|
|
61
|
+
*/
|
|
62
|
+
export declare function extractLineMessages(jsonLine: string): LineMessages;
|
|
63
|
+
/**
|
|
64
|
+
* Messages a compaction-archive envelope carries, counting the stored payload
|
|
65
|
+
* only. `extractLineMessages` materialises every archived message's text, which
|
|
66
|
+
* a count does not need: the envelope's `originals` array length is the count.
|
|
67
|
+
* Returns 0 for live lines and for envelopes that cannot be parsed.
|
|
68
|
+
*/
|
|
69
|
+
export declare function countArchivedMessages(jsonLine: string): number;
|
|
70
|
+
/**
|
|
71
|
+
* Extract a window of `radius` characters around the first occurrence
|
|
72
|
+
* of `keyword` (case-insensitive). If the keyword isn't found,
|
|
73
|
+
* returns the first `radius * 2` characters of the text.
|
|
74
|
+
*/
|
|
75
|
+
export declare function snippetAround(text: string, keyword: string, radius?: number): string;
|
|
76
|
+
/**
|
|
77
|
+
* Rough token count. 1 token ~= 4 chars (English text average).
|
|
78
|
+
* This is intentionally crude - we use it to decide whether a
|
|
79
|
+
* session transcript is too long to include in full.
|
|
80
|
+
*/
|
|
81
|
+
export declare function estimateTokens(text: string): number;
|
|
82
|
+
//# sourceMappingURL=text-utils.d.ts.map
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text extraction helpers for session-recall.
|
|
3
|
+
*
|
|
4
|
+
* Pure functions - no dependencies on session-recall's internal state.
|
|
5
|
+
*
|
|
6
|
+
* Used by the session search and query actions to:
|
|
7
|
+
* - extractMessageText: parse a single live .jsonl entry into {role, text}
|
|
8
|
+
* - extractLineMessages: parse any .jsonl line — a live entry OR a
|
|
9
|
+
* compaction-archive envelope — into every message it carries
|
|
10
|
+
* - snippetAround: extract a keyword-anchored window from a long text
|
|
11
|
+
* - estimateTokens: rough token count (1 token ~= 4 chars)
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* Cap on messages parsed from one archive line. A single compaction envelope
|
|
15
|
+
* holds the entire pre-compaction batch as one JSON string and is one physical
|
|
16
|
+
* line regardless of size; measured archives carry up to 1188 messages (139
|
|
17
|
+
* archives, p99=1005, max line 3.4 MB). The cap bounds a pathological envelope
|
|
18
|
+
* without truncating the measured corpus, and callers surface `truncated`
|
|
19
|
+
* rather than presenting a partial read as complete.
|
|
20
|
+
*/
|
|
21
|
+
export const MAX_ARCHIVE_MESSAGES = 2000;
|
|
22
|
+
function textFromContent(content) {
|
|
23
|
+
if (!Array.isArray(content))
|
|
24
|
+
return "";
|
|
25
|
+
return content
|
|
26
|
+
.filter((c) => !!c && typeof c === "object")
|
|
27
|
+
.filter((c) => c.type === "text")
|
|
28
|
+
.map((c) => c.text ?? "")
|
|
29
|
+
.join(" ");
|
|
30
|
+
}
|
|
31
|
+
/** Extract {role, text} from a raw message object ({role, content: [...]}). */
|
|
32
|
+
function messageFromObject(msg) {
|
|
33
|
+
if (!msg || typeof msg !== "object")
|
|
34
|
+
return null;
|
|
35
|
+
const m = msg;
|
|
36
|
+
const text = textFromContent(m.content);
|
|
37
|
+
if (!text)
|
|
38
|
+
return null;
|
|
39
|
+
return { role: typeof m.role === "string" ? m.role : "unknown", text };
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* pi's role for extension-injected `custom_message` entries ("CustomMessage"
|
|
43
|
+
* in message-types.md). Their content is a string or a text/image block
|
|
44
|
+
* array, not the `message.content` array ordinary entries carry.
|
|
45
|
+
*/
|
|
46
|
+
const CUSTOM_MESSAGE_ROLE = "custom";
|
|
47
|
+
function messageFromCustomMessage(entry) {
|
|
48
|
+
const content = entry.content;
|
|
49
|
+
const text = typeof content === "string" ? content : Array.isArray(content) ? textFromContent(content) : "";
|
|
50
|
+
if (!text)
|
|
51
|
+
return null;
|
|
52
|
+
return { role: CUSTOM_MESSAGE_ROLE, text };
|
|
53
|
+
}
|
|
54
|
+
// Compaction and branch summaries are deliberately not indexed: both are
|
|
55
|
+
// model-generated condensations of entries that remain in the file (or in the
|
|
56
|
+
// archive), and neither carries a message role, so indexing them would
|
|
57
|
+
// duplicate recall and invent a role the transcript does not have.
|
|
58
|
+
function messageFromEntry(entry) {
|
|
59
|
+
if (!entry || typeof entry !== "object")
|
|
60
|
+
return null;
|
|
61
|
+
const e = entry;
|
|
62
|
+
if (e.type === "message")
|
|
63
|
+
return messageFromObject(e.message);
|
|
64
|
+
if (e.type === "custom_message")
|
|
65
|
+
return messageFromCustomMessage(e);
|
|
66
|
+
return null;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Parse a single .jsonl line and extract the message text.
|
|
70
|
+
*
|
|
71
|
+
* Returns null for entries that carry no message text (tool calls, metadata,
|
|
72
|
+
* durable `custom` entries), for archive envelopes (use extractLineMessages
|
|
73
|
+
* for those), or for lines without extractable text content. Ordinary
|
|
74
|
+
* `message` entries and extension-injected `custom_message` entries both
|
|
75
|
+
* yield a message; the `role` is returned so callers can distinguish them.
|
|
76
|
+
*/
|
|
77
|
+
export function extractMessageText(jsonLine) {
|
|
78
|
+
try {
|
|
79
|
+
return messageFromEntry(JSON.parse(jsonLine));
|
|
80
|
+
}
|
|
81
|
+
catch {
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Parse one .jsonl line into every message it carries.
|
|
87
|
+
*
|
|
88
|
+
* A live line is one entry (`{type:"message", message:{role,content}}` or
|
|
89
|
+
* `{type:"custom_message", content}`) → 0 or 1 message. An archives/*.jsonl line is a compaction envelope whose
|
|
90
|
+
* `originals` field is a JSON string holding the pre-compaction message array
|
|
91
|
+
* (written by context-manager's writeOriginalsArchive) → 0..N messages. The
|
|
92
|
+
* envelope is ONE physical line however many messages it holds, so callers
|
|
93
|
+
* that snippet per line must iterate the returned array; a search line that
|
|
94
|
+
* matches only inside a large archive would otherwise render nothing.
|
|
95
|
+
*/
|
|
96
|
+
export function extractLineMessages(jsonLine) {
|
|
97
|
+
let entry;
|
|
98
|
+
try {
|
|
99
|
+
entry = JSON.parse(jsonLine);
|
|
100
|
+
}
|
|
101
|
+
catch {
|
|
102
|
+
return { messages: [], isArchive: false, truncated: false, totalMessages: 0 };
|
|
103
|
+
}
|
|
104
|
+
if (entry &&
|
|
105
|
+
typeof entry === "object" &&
|
|
106
|
+
typeof entry.originals === "string") {
|
|
107
|
+
return extractArchiveEnvelope(entry);
|
|
108
|
+
}
|
|
109
|
+
const msg = messageFromEntry(entry);
|
|
110
|
+
return {
|
|
111
|
+
messages: msg ? [msg] : [],
|
|
112
|
+
isArchive: false,
|
|
113
|
+
truncated: false,
|
|
114
|
+
totalMessages: msg ? 1 : 0,
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
function extractArchiveEnvelope(entry) {
|
|
118
|
+
const base = {
|
|
119
|
+
isArchive: true,
|
|
120
|
+
truncated: false,
|
|
121
|
+
totalMessages: 0,
|
|
122
|
+
compactedMessages: typeof entry.compactedMessages === "number" ? entry.compactedMessages : undefined,
|
|
123
|
+
keptMessages: typeof entry.keptMessages === "number" ? entry.keptMessages : undefined,
|
|
124
|
+
};
|
|
125
|
+
let parsed;
|
|
126
|
+
try {
|
|
127
|
+
parsed = JSON.parse(entry.originals);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
return { ...base, messages: [] };
|
|
131
|
+
}
|
|
132
|
+
if (!Array.isArray(parsed))
|
|
133
|
+
return { ...base, messages: [] };
|
|
134
|
+
const total = parsed.length;
|
|
135
|
+
const truncated = total > MAX_ARCHIVE_MESSAGES;
|
|
136
|
+
const scan = truncated ? parsed.slice(0, MAX_ARCHIVE_MESSAGES) : parsed;
|
|
137
|
+
const messages = scan
|
|
138
|
+
.map((m) => messageFromObject(m))
|
|
139
|
+
.filter((m) => m !== null);
|
|
140
|
+
return { ...base, messages, truncated, totalMessages: total };
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Messages a compaction-archive envelope carries, counting the stored payload
|
|
144
|
+
* only. `extractLineMessages` materialises every archived message's text, which
|
|
145
|
+
* a count does not need: the envelope's `originals` array length is the count.
|
|
146
|
+
* Returns 0 for live lines and for envelopes that cannot be parsed.
|
|
147
|
+
*/
|
|
148
|
+
export function countArchivedMessages(jsonLine) {
|
|
149
|
+
try {
|
|
150
|
+
const entry = JSON.parse(jsonLine);
|
|
151
|
+
if (typeof entry.originals !== "string")
|
|
152
|
+
return 0;
|
|
153
|
+
const parsed = JSON.parse(entry.originals);
|
|
154
|
+
return Array.isArray(parsed) ? parsed.length : 0;
|
|
155
|
+
}
|
|
156
|
+
catch {
|
|
157
|
+
return 0;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Extract a window of `radius` characters around the first occurrence
|
|
162
|
+
* of `keyword` (case-insensitive). If the keyword isn't found,
|
|
163
|
+
* returns the first `radius * 2` characters of the text.
|
|
164
|
+
*/
|
|
165
|
+
export function snippetAround(text, keyword, radius = 100) {
|
|
166
|
+
const lower = text.toLowerCase();
|
|
167
|
+
const idx = lower.indexOf(keyword.toLowerCase());
|
|
168
|
+
if (idx === -1)
|
|
169
|
+
return text.slice(0, radius * 2);
|
|
170
|
+
const start = Math.max(0, idx - radius);
|
|
171
|
+
const end = Math.min(text.length, idx + keyword.length + radius);
|
|
172
|
+
const prefix = start > 0 ? "..." : "";
|
|
173
|
+
const suffix = end < text.length ? "..." : "";
|
|
174
|
+
return prefix + text.slice(start, end) + suffix;
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Rough token count. 1 token ~= 4 chars (English text average).
|
|
178
|
+
* This is intentionally crude - we use it to decide whether a
|
|
179
|
+
* session transcript is too long to include in full.
|
|
180
|
+
*/
|
|
181
|
+
export function estimateTokens(text) {
|
|
182
|
+
return Math.ceil(text.length / 4);
|
|
183
|
+
}
|
|
184
|
+
//# sourceMappingURL=text-utils.js.map
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Episodes disk layer: append-on-write durability + shutdown compaction.
|
|
3
|
+
*
|
|
4
|
+
* Whole-file-rewrite-at-shutdown alone loses episodes: with several live pi
|
|
5
|
+
* processes the last shutdown erases every episode the other processes wrote
|
|
6
|
+
* since their own load, and an episode written mid-session is lost when the
|
|
7
|
+
* process ends without a clean shutdown.
|
|
8
|
+
*
|
|
9
|
+
* Two writers share this file:
|
|
10
|
+
* - `queueEpisodeAppend` (called by addEpisode): appends one JSONL line per
|
|
11
|
+
* episode within milliseconds of the call, fire-and-forget from the
|
|
12
|
+
* caller's synchronous context. Appends are serialized in-process; the
|
|
13
|
+
* store lock makes them exclusive across processes, so concurrent
|
|
14
|
+
* appenders never interleave inside each other's lines.
|
|
15
|
+
* - `compactEpisodesFile` (called at session_shutdown): re-reads the file,
|
|
16
|
+
* unions it with the local snapshot by episode id (dropping torn or
|
|
17
|
+
* duplicate lines and capping at the same 500-entry bound the in-memory
|
|
18
|
+
* prune uses), and rewrites atomically. Compaction is the fallback that
|
|
19
|
+
* still lands an episode whose append failed.
|
|
20
|
+
*/
|
|
21
|
+
import type { Episode } from "./types.js";
|
|
22
|
+
/** Exclusive lock guarding reads/writes/appends on the episodes file. Resolved
|
|
23
|
+
* through episodesFilePath() so the lock and the file it guards always name
|
|
24
|
+
* the same (possibly BRAID_HOME-pinned) store. */
|
|
25
|
+
export declare function episodesLockFilePath(): string;
|
|
26
|
+
/**
|
|
27
|
+
* Append one episode line. Resolves when the line is on disk; rejects on
|
|
28
|
+
* I/O failure (callers may await it when a tool result must imply disk
|
|
29
|
+
* truth, and fire-and-forget callers let the shutdown compaction retry).
|
|
30
|
+
*/
|
|
31
|
+
export declare function queueEpisodeAppend(episode: Episode): Promise<void>;
|
|
32
|
+
/**
|
|
33
|
+
* Drain all pending appends: resolves once every queued line is on disk.
|
|
34
|
+
*/
|
|
35
|
+
export declare function flushEpisodeAppends(): Promise<void>;
|
|
36
|
+
/**
|
|
37
|
+
* Shutdown compaction: union the disk file with the local snapshot by
|
|
38
|
+
* episode id (local wins — it is the fresher in-process state), drop
|
|
39
|
+
* duplicate ids and torn lines, cap at the store bound, and rewrite the
|
|
40
|
+
* file atomically. Returns the number of episodes persisted.
|
|
41
|
+
*/
|
|
42
|
+
export declare function compactEpisodesFile(local: readonly Episode[]): Promise<number>;
|
|
43
|
+
//# sourceMappingURL=episodes-disk.d.ts.map
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Episodes disk layer: append-on-write durability + shutdown compaction.
|
|
3
|
+
*
|
|
4
|
+
* Whole-file-rewrite-at-shutdown alone loses episodes: with several live pi
|
|
5
|
+
* processes the last shutdown erases every episode the other processes wrote
|
|
6
|
+
* since their own load, and an episode written mid-session is lost when the
|
|
7
|
+
* process ends without a clean shutdown.
|
|
8
|
+
*
|
|
9
|
+
* Two writers share this file:
|
|
10
|
+
* - `queueEpisodeAppend` (called by addEpisode): appends one JSONL line per
|
|
11
|
+
* episode within milliseconds of the call, fire-and-forget from the
|
|
12
|
+
* caller's synchronous context. Appends are serialized in-process; the
|
|
13
|
+
* store lock makes them exclusive across processes, so concurrent
|
|
14
|
+
* appenders never interleave inside each other's lines.
|
|
15
|
+
* - `compactEpisodesFile` (called at session_shutdown): re-reads the file,
|
|
16
|
+
* unions it with the local snapshot by episode id (dropping torn or
|
|
17
|
+
* duplicate lines and capping at the same 500-entry bound the in-memory
|
|
18
|
+
* prune uses), and rewrites atomically. Compaction is the fallback that
|
|
19
|
+
* still lands an episode whose append failed.
|
|
20
|
+
*/
|
|
21
|
+
import * as fs from "node:fs/promises";
|
|
22
|
+
import * as path from "node:path";
|
|
23
|
+
import { episodesFilePath } from "../../../lib/config/braid-paths.js";
|
|
24
|
+
import { withStoreLock } from "../../../lib/memory/store-lock.js";
|
|
25
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
26
|
+
import { asyncExists } from "../../../lib/utils/async-fs.js";
|
|
27
|
+
const log = createLogger("three-memory-stores:episodes-disk");
|
|
28
|
+
/** Exclusive lock guarding reads/writes/appends on the episodes file. Resolved
|
|
29
|
+
* through episodesFilePath() so the lock and the file it guards always name
|
|
30
|
+
* the same (possibly BRAID_HOME-pinned) store. */
|
|
31
|
+
export function episodesLockFilePath() {
|
|
32
|
+
return `${episodesFilePath()}.lock`;
|
|
33
|
+
}
|
|
34
|
+
/** Same cap as pruneEpisodes in episodes.ts: the store stays bounded. */
|
|
35
|
+
const EPISODE_STORE_CAP = 500;
|
|
36
|
+
// In-process append serialization: appends to one file keep their order.
|
|
37
|
+
let appendQueue = Promise.resolve();
|
|
38
|
+
function enqueueAppend(line) {
|
|
39
|
+
const run = appendQueue.then(() => withStoreLock(episodesLockFilePath(), async () => {
|
|
40
|
+
const file = episodesFilePath();
|
|
41
|
+
await fs.mkdir(path.dirname(file), { recursive: true });
|
|
42
|
+
await fs.appendFile(file, line, "utf-8");
|
|
43
|
+
}));
|
|
44
|
+
// A failed append must not poison the chain for later episodes; the first
|
|
45
|
+
// refusal in a process warns (the store may be refusing because no absolute
|
|
46
|
+
// braid root resolves), later ones stay quiet.
|
|
47
|
+
appendQueue = run.catch(reportAppendFailure);
|
|
48
|
+
return run;
|
|
49
|
+
}
|
|
50
|
+
/** Warned once per process about a refused episode append. */
|
|
51
|
+
let _warnedAppendFailure = false;
|
|
52
|
+
function reportAppendFailure(err) {
|
|
53
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
54
|
+
if (_warnedAppendFailure)
|
|
55
|
+
return;
|
|
56
|
+
_warnedAppendFailure = true;
|
|
57
|
+
log.warn(`episode append failed (${message}); the shutdown compaction retries from memory`);
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Append one episode line. Resolves when the line is on disk; rejects on
|
|
61
|
+
* I/O failure (callers may await it when a tool result must imply disk
|
|
62
|
+
* truth, and fire-and-forget callers let the shutdown compaction retry).
|
|
63
|
+
*/
|
|
64
|
+
export function queueEpisodeAppend(episode) {
|
|
65
|
+
return enqueueAppend(`${JSON.stringify(episode)}\n`);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Drain all pending appends: resolves once every queued line is on disk.
|
|
69
|
+
*/
|
|
70
|
+
export async function flushEpisodeAppends() {
|
|
71
|
+
await appendQueue;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Parse every intact episode line on disk. Torn or corrupt lines (a crash
|
|
75
|
+
* mid-append) are skipped — they are the only lines a crash can lose.
|
|
76
|
+
*/
|
|
77
|
+
async function readEpisodeLines() {
|
|
78
|
+
try {
|
|
79
|
+
if (!(await asyncExists(episodesFilePath())))
|
|
80
|
+
return [];
|
|
81
|
+
const content = await fs.readFile(episodesFilePath(), "utf-8");
|
|
82
|
+
const episodes = [];
|
|
83
|
+
for (const line of content.split("\n")) {
|
|
84
|
+
if (!line.trim())
|
|
85
|
+
continue;
|
|
86
|
+
try {
|
|
87
|
+
episodes.push(JSON.parse(line));
|
|
88
|
+
}
|
|
89
|
+
catch {
|
|
90
|
+
/* torn or malformed line — skip */
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return episodes;
|
|
94
|
+
}
|
|
95
|
+
catch (err) {
|
|
96
|
+
log.warn(`episodes file read failed: ${err}`);
|
|
97
|
+
return [];
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* Shutdown compaction: union the disk file with the local snapshot by
|
|
102
|
+
* episode id (local wins — it is the fresher in-process state), drop
|
|
103
|
+
* duplicate ids and torn lines, cap at the store bound, and rewrite the
|
|
104
|
+
* file atomically. Returns the number of episodes persisted.
|
|
105
|
+
*/
|
|
106
|
+
export async function compactEpisodesFile(local) {
|
|
107
|
+
return withStoreLock(episodesLockFilePath(), async () => {
|
|
108
|
+
const diskEpisodes = await readEpisodeLines();
|
|
109
|
+
const byId = new Map();
|
|
110
|
+
for (const ep of diskEpisodes)
|
|
111
|
+
byId.set(ep.id, ep);
|
|
112
|
+
for (const ep of local)
|
|
113
|
+
byId.set(ep.id, ep);
|
|
114
|
+
const merged = [...byId.values()];
|
|
115
|
+
const dropped = Math.max(0, merged.length - EPISODE_STORE_CAP);
|
|
116
|
+
const kept = dropped > 0 ? merged.slice(-EPISODE_STORE_CAP) : merged;
|
|
117
|
+
const file = episodesFilePath();
|
|
118
|
+
await fs.mkdir(path.dirname(file), { recursive: true });
|
|
119
|
+
const tmpPath = `${file}.compacting`;
|
|
120
|
+
await fs.writeFile(tmpPath, kept.map((e) => JSON.stringify(e)).join("\n") + (kept.length > 0 ? "\n" : ""), "utf-8");
|
|
121
|
+
await fs.rename(tmpPath, file);
|
|
122
|
+
return kept.length;
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=episodes-disk.js.map
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Episode Store - case-based reasoning from past tasks.
|
|
3
|
+
*
|
|
4
|
+
* Paper: 2604.14475 Evo-MedAgent
|
|
5
|
+
* Key finding: Episode memory outperforms single memory.
|
|
6
|
+
* MCQ accuracy 0.68 -> 0.79.
|
|
7
|
+
*/
|
|
8
|
+
import type { MemoryStoresState, Episode } from "./types.js";
|
|
9
|
+
/**
|
|
10
|
+
* Sanitize a string by decoding literal `\uXXXX` escape sequences that
|
|
11
|
+
* may have been written by a previous code path that double-encoded
|
|
12
|
+
* unicode (BUG-M3). The agent-facing `recall_search` and `episodes_search`
|
|
13
|
+
* displays otherwise show literal `\u2192` instead of the real character
|
|
14
|
+
* `->`. Applied at load time AND at write time (in `addEpisode`) so both
|
|
15
|
+
* existing data files and new writes are healed.
|
|
16
|
+
*
|
|
17
|
+
* The previous implementation used `JSON.parse('"' + s + '"')` for safety
|
|
18
|
+
* (verify round-trip changes the value before accepting). That approach
|
|
19
|
+
* silently FAILED for any string containing raw newline/control characters
|
|
20
|
+
* -- which is the common case for task and solution fields that contain
|
|
21
|
+
* multi-line text. JSON.parse throws on raw \n inside string literals.
|
|
22
|
+
* The sanitizer returned the input unchanged, so the literal `\u2192`
|
|
23
|
+
* remained in agent-facing output.
|
|
24
|
+
*
|
|
25
|
+
* Current implementation: regex-replace each `\uXXXX` with the decoded
|
|
26
|
+
* code point. Detection: only run if the string contains at least one
|
|
27
|
+
* `\uXXXX` pattern. The safety trade-off: legitimate backslash-u text
|
|
28
|
+
* (rare in episode data) would also be decoded. Acceptable for this
|
|
29
|
+
* store; episode content is model output and natural language, not
|
|
30
|
+
* regex patterns.
|
|
31
|
+
*/
|
|
32
|
+
export declare function unescapeUnicodeIfDoubleEncoded(s: string): string;
|
|
33
|
+
/**
|
|
34
|
+
* Apply unescapeUnicodeIfDoubleEncoded to all string-bearing fields of
|
|
35
|
+
* an episode. Used at load time and write time to ensure no literal
|
|
36
|
+
* `\u2192` sequences leak into agent-facing output.
|
|
37
|
+
*/
|
|
38
|
+
export declare function sanitizeEpisode(ep: Episode): Episode;
|
|
39
|
+
export declare function addEpisode(state: MemoryStoresState, task: string, solution: string, outcome: Episode["outcome"], toolSequence: string[], tags?: string[], project?: string, strategicSOP?: string, functionalSOP?: string[], atomicSOP?: string[]): Episode;
|
|
40
|
+
export declare function condenseInsights(episode: Episode, maxTokens?: number): string;
|
|
41
|
+
export declare function retrieveEpisodes(state: MemoryStoresState, query: string, limit?: number, currentProject?: string): Episode[];
|
|
42
|
+
export declare function computeSimilarity(query: string, episode: Episode): number;
|
|
43
|
+
export declare function estimatePMI(queryWord: string, episode: Episode, backgroundFreq: Map<string, number>, totalDocs: number): number;
|
|
44
|
+
export declare function computeRUMS(query: string, episode: Episode, backgroundFreq: Map<string, number>, totalDocs: number): number;
|
|
45
|
+
export declare function retrieveByRUMS(state: MemoryStoresState, query: string, limit: number | undefined, currentSessionId: string, currentProject?: string, projectScope?: "current" | "all"): Episode[];
|
|
46
|
+
//# sourceMappingURL=episodes.d.ts.map
|