pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated hints pipeline.
|
|
3
|
+
*
|
|
4
|
+
* Loads hints from the consolidated-hints.jsonl file, filters by
|
|
5
|
+
* utility-model relevance, and delivers the relevant ones as
|
|
6
|
+
* per-hint whispers. All work is best-effort: any failure is swallowed
|
|
7
|
+
* because hints are supplemental and should never block the main prompt.
|
|
8
|
+
*
|
|
9
|
+
* Delivery model: WHISPER. Each relevant hint is sent as a separate
|
|
10
|
+
* `hint` custom message (steer, no trigger). The agent sees them in
|
|
11
|
+
* the next turn but they do NOT live in the system prompt.
|
|
12
|
+
*
|
|
13
|
+
* Cross-project deprioritization (matches episodic memory policy in
|
|
14
|
+
* `three-memory-stores`): same-project hints are kept; cross-project
|
|
15
|
+
* hints must score >= 80 to be considered.
|
|
16
|
+
*
|
|
17
|
+
* Heuristic fallback: if the LLM tier is unavailable, a small regex-based
|
|
18
|
+
* filter rejects obviously-generic patterns. Semantic matching is left
|
|
19
|
+
* to the LLM tier - keyword-overlap scoring (Jaccard) produces too many
|
|
20
|
+
* false positives and false negatives, so it is not used.
|
|
21
|
+
*/
|
|
22
|
+
import { stat, readFile } from "node:fs/promises";
|
|
23
|
+
import { consolidatedHintsFilePath } from "../config/braid-paths.js";
|
|
24
|
+
import { sendTrackedMessage } from "../utils/injection-tracker.js";
|
|
25
|
+
import { fenceMemoryContext } from "../utils/memory-fence.js";
|
|
26
|
+
import { classify } from "../ai/text-classifier.js";
|
|
27
|
+
import { CRITICS } from "../ai/critic-registry.js";
|
|
28
|
+
import { deriveProjectIdFromCwd } from "../memory/past-insights.js";
|
|
29
|
+
import { HINT_MAX_AGE_MS } from "../constants/session-thresholds.js";
|
|
30
|
+
/** Async helper: check if a path exists. */
|
|
31
|
+
async function asyncExists(p) {
|
|
32
|
+
return stat(p)
|
|
33
|
+
.then(() => true)
|
|
34
|
+
.catch(() => false);
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Load and dedup hints from the consolidated-hints file. Same-project
|
|
38
|
+
* hints are preferred; cross-project hints must score >= 80.
|
|
39
|
+
*/
|
|
40
|
+
async function loadConsolidatedHints(currentProject) {
|
|
41
|
+
try {
|
|
42
|
+
if (!(await asyncExists(consolidatedHintsFilePath())))
|
|
43
|
+
return [];
|
|
44
|
+
const content = await readFile(consolidatedHintsFilePath(), "utf-8");
|
|
45
|
+
const lines = content.split("\n").filter((l) => l.trim());
|
|
46
|
+
if (lines.length === 0)
|
|
47
|
+
return [];
|
|
48
|
+
const now = Date.now();
|
|
49
|
+
const parsed = lines
|
|
50
|
+
.map((l) => {
|
|
51
|
+
try {
|
|
52
|
+
return JSON.parse(l);
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
return null;
|
|
56
|
+
}
|
|
57
|
+
})
|
|
58
|
+
.filter((h) => h !== null)
|
|
59
|
+
.filter((h) => h.steps && h.steps.length > 0)
|
|
60
|
+
.filter((h) => now - (h.createdAt ?? 0) < HINT_MAX_AGE_MS);
|
|
61
|
+
if (parsed.length === 0)
|
|
62
|
+
return [];
|
|
63
|
+
const sameProject = currentProject
|
|
64
|
+
? parsed.filter((h) => !h.project ||
|
|
65
|
+
h.project === currentProject ||
|
|
66
|
+
// Unknown-project hints must score >= 80 to avoid generic noise
|
|
67
|
+
// (e.g. "session_outcome" with generic steps). Same-project hints
|
|
68
|
+
// have no score threshold — they're contextually relevant.
|
|
69
|
+
(h.project === "unknown" && (h.score ?? 0) >= 80))
|
|
70
|
+
: parsed;
|
|
71
|
+
const crossProject = currentProject
|
|
72
|
+
? parsed.filter((h) => h.project &&
|
|
73
|
+
h.project !== currentProject &&
|
|
74
|
+
h.project !== "unknown" &&
|
|
75
|
+
(h.score ?? 0) >= 80)
|
|
76
|
+
: [];
|
|
77
|
+
const candidates = [...sameProject, ...crossProject];
|
|
78
|
+
const byTask = new Map();
|
|
79
|
+
for (const h of candidates) {
|
|
80
|
+
const key = h.task ?? "";
|
|
81
|
+
const existing = byTask.get(key);
|
|
82
|
+
if (!existing || (h.createdAt ?? 0) > (existing.createdAt ?? 0)) {
|
|
83
|
+
byTask.set(key, h);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
const deduped = Array.from(byTask.values())
|
|
87
|
+
.filter((h) => h.createdAt != null)
|
|
88
|
+
.sort((a, b) => (a.createdAt ?? 0) - (b.createdAt ?? 0));
|
|
89
|
+
// Render the strategy/task description rather than the raw steps (often
|
|
90
|
+
// generic tool names): the task field carries the high-level summary
|
|
91
|
+
// from consolidation.
|
|
92
|
+
return deduped.slice(-3).map((h) => {
|
|
93
|
+
const task = (h.task ?? "").slice(0, 120);
|
|
94
|
+
const strategy = (h.strategy ?? "").slice(0, 200);
|
|
95
|
+
// Prefer the strategy field (richer prose) over the raw steps list
|
|
96
|
+
if (strategy && strategy.length > task.length) {
|
|
97
|
+
return `When working on "${task}": ${strategy}`;
|
|
98
|
+
}
|
|
99
|
+
const steps = h.steps.slice(0, 3).join(" -> ");
|
|
100
|
+
return `When working on "${task}": ${steps}`;
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
catch {
|
|
104
|
+
return [];
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Extract the current task from the session - the most recent user message.
|
|
109
|
+
* Returns a short summary, max 500 chars.
|
|
110
|
+
*/
|
|
111
|
+
function getCurrentTask(ctx) {
|
|
112
|
+
try {
|
|
113
|
+
const sm = ctx.sessionManager;
|
|
114
|
+
if (!sm || typeof sm.getBranch !== "function")
|
|
115
|
+
return "";
|
|
116
|
+
const branch = sm.getBranch();
|
|
117
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
118
|
+
const entry = branch[i];
|
|
119
|
+
if (entry?.type === "message" && entry.message?.role === "user") {
|
|
120
|
+
const content = entry.message.content;
|
|
121
|
+
let text = "";
|
|
122
|
+
if (typeof content === "string")
|
|
123
|
+
text = content;
|
|
124
|
+
else if (Array.isArray(content)) {
|
|
125
|
+
text = content
|
|
126
|
+
.filter((c) => {
|
|
127
|
+
if (typeof c !== "object" || c === null)
|
|
128
|
+
return false;
|
|
129
|
+
return c.type === "text";
|
|
130
|
+
})
|
|
131
|
+
.map((c) => {
|
|
132
|
+
if (typeof c !== "object" || c === null)
|
|
133
|
+
return "";
|
|
134
|
+
return c.text || "";
|
|
135
|
+
})
|
|
136
|
+
.join(" ");
|
|
137
|
+
}
|
|
138
|
+
return text.trim().slice(0, 500);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
catch {
|
|
143
|
+
// Non-fatal: empty current task means the relevance check rejects all hints,
|
|
144
|
+
// which is the safe default.
|
|
145
|
+
}
|
|
146
|
+
return "";
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Heuristic fallback (Tier 1 graceful degradation).
|
|
150
|
+
* Only the obviously-generic patterns are rejected here. The semantic
|
|
151
|
+
* matching is left to the LLM tier.
|
|
152
|
+
*/
|
|
153
|
+
function hintRelevanceFallback(hint, _currentTask) {
|
|
154
|
+
if (hint.length < 30)
|
|
155
|
+
return "no";
|
|
156
|
+
if (/Fix \w+ error:/.test(hint))
|
|
157
|
+
return "no";
|
|
158
|
+
if (/Debug.*isolate/.test(hint))
|
|
159
|
+
return "no";
|
|
160
|
+
if (/Reproduce.*Locate.*Apply/.test(hint))
|
|
161
|
+
return "no";
|
|
162
|
+
return "yes";
|
|
163
|
+
}
|
|
164
|
+
/**
|
|
165
|
+
* Filter hints by relevance using the utility model.
|
|
166
|
+
* Returns only hints classified as relevant to the current session.
|
|
167
|
+
*/
|
|
168
|
+
async function filterRelevantHints(hints, ctx) {
|
|
169
|
+
const currentTask = getCurrentTask(ctx);
|
|
170
|
+
// Empty current task -> reject all hints. Better to surface nothing
|
|
171
|
+
// than to inject a hint that has no task to be relevant to.
|
|
172
|
+
if (!currentTask)
|
|
173
|
+
return [];
|
|
174
|
+
const results = await Promise.allSettled(hints.map((hint) => classify(ctx, CRITICS.hintRelevance.criteria, { hint, currentTask }, {
|
|
175
|
+
timeoutMs: 60_000,
|
|
176
|
+
// B-class: prefer-heuristic runs the regex fallback first
|
|
177
|
+
// (fast path for obvious rejections), but if it returns "yes",
|
|
178
|
+
// the utility model verifies — rejecting generic hints that the
|
|
179
|
+
// permissive regex would otherwise let through.
|
|
180
|
+
fallback: () => hintRelevanceFallback(hint, currentTask),
|
|
181
|
+
tierPolicy: "prefer-heuristic",
|
|
182
|
+
})));
|
|
183
|
+
return hints.filter((_, i) => {
|
|
184
|
+
const r = results[i];
|
|
185
|
+
return r.status === "fulfilled" && r.value.label === "yes";
|
|
186
|
+
});
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Deliver relevant hints as whispers (one whisper per relevant hint).
|
|
190
|
+
* Best-effort: any failure (missing file, LLM timeout, send error) is swallowed.
|
|
191
|
+
*
|
|
192
|
+
* Pass `pi`, `ctx` and the current working directory. The function:
|
|
193
|
+
* 1. Loads hints from the consolidated-hints file.
|
|
194
|
+
* 2. Filters by utility-model relevance against the current task.
|
|
195
|
+
* 3. Sends each relevant hint as a separate `hint` custom message.
|
|
196
|
+
*/
|
|
197
|
+
export async function deliverRelevantHints(cwd, pi, ctx) {
|
|
198
|
+
const projectId = deriveProjectIdFromCwd(cwd);
|
|
199
|
+
const allHints = await loadConsolidatedHints(projectId);
|
|
200
|
+
if (allHints.length === 0)
|
|
201
|
+
return;
|
|
202
|
+
let relevantHints;
|
|
203
|
+
try {
|
|
204
|
+
relevantHints = await filterRelevantHints(allHints, ctx);
|
|
205
|
+
}
|
|
206
|
+
catch {
|
|
207
|
+
return;
|
|
208
|
+
}
|
|
209
|
+
for (const hint of relevantHints) {
|
|
210
|
+
try {
|
|
211
|
+
sendTrackedMessage(pi, {
|
|
212
|
+
customType: "hint",
|
|
213
|
+
display: true,
|
|
214
|
+
// Recalled consolidated hints are fenced non-user context.
|
|
215
|
+
content: [{ type: "text", text: fenceMemoryContext(`[hint] ${hint}`) }],
|
|
216
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "memory", source: "prompt-builder/hint" });
|
|
217
|
+
}
|
|
218
|
+
catch {
|
|
219
|
+
// Non-fatal: hint delivery is best-effort
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
//# sourceMappingURL=hints.js.map
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OpenSpec spec context - inject SHALL/MUST/SHOULD requirements from active
|
|
3
|
+
* specs into the agent's context.
|
|
4
|
+
*
|
|
5
|
+
* Delivery model: WHISPER. The active spec requirements are sent once per
|
|
6
|
+
* session as an `openspec` custom message (steer, no trigger). The agent
|
|
7
|
+
* sees them in the next turn but they do NOT live in the system prompt.
|
|
8
|
+
*
|
|
9
|
+
* Rationale: spec context is supplemental. It can be 100+ lines for projects
|
|
10
|
+
* with many domains. Keeping it out of the system prompt keeps every turn's
|
|
11
|
+
* baseline cost low; the agent still has the spec content in its next turn
|
|
12
|
+
* via the whisper and can `read` the full spec.md if it needs more detail.
|
|
13
|
+
*
|
|
14
|
+
* Behavior:
|
|
15
|
+
* - Walks `cwd/openspec/specs/<domain>/spec.md` for up to 3 domains.
|
|
16
|
+
* - Extracts the `### Requirement:` headings and any line containing
|
|
17
|
+
* SHALL/MUST/SHOULD.
|
|
18
|
+
* - Sends as a `## Active Specs` block with per-domain requirement lists,
|
|
19
|
+
* plus a footer reminder to update delta specs.
|
|
20
|
+
*
|
|
21
|
+
* If the spec dir is missing or unreadable, the whisper is skipped.
|
|
22
|
+
*/
|
|
23
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
24
|
+
/**
|
|
25
|
+
* Deliver active OpenSpec spec context as a whisper (once per session).
|
|
26
|
+
* Best-effort: any failure (missing dirs, unreadable files) is swallowed.
|
|
27
|
+
*/
|
|
28
|
+
export declare function deliverActiveSpecs(cwd: string, pi: ExtensionAPI, _ctx: ExtensionContext): Promise<void>;
|
|
29
|
+
//# sourceMappingURL=openspec.d.ts.map
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OpenSpec spec context - inject SHALL/MUST/SHOULD requirements from active
|
|
3
|
+
* specs into the agent's context.
|
|
4
|
+
*
|
|
5
|
+
* Delivery model: WHISPER. The active spec requirements are sent once per
|
|
6
|
+
* session as an `openspec` custom message (steer, no trigger). The agent
|
|
7
|
+
* sees them in the next turn but they do NOT live in the system prompt.
|
|
8
|
+
*
|
|
9
|
+
* Rationale: spec context is supplemental. It can be 100+ lines for projects
|
|
10
|
+
* with many domains. Keeping it out of the system prompt keeps every turn's
|
|
11
|
+
* baseline cost low; the agent still has the spec content in its next turn
|
|
12
|
+
* via the whisper and can `read` the full spec.md if it needs more detail.
|
|
13
|
+
*
|
|
14
|
+
* Behavior:
|
|
15
|
+
* - Walks `cwd/openspec/specs/<domain>/spec.md` for up to 3 domains.
|
|
16
|
+
* - Extracts the `### Requirement:` headings and any line containing
|
|
17
|
+
* SHALL/MUST/SHOULD.
|
|
18
|
+
* - Sends as a `## Active Specs` block with per-domain requirement lists,
|
|
19
|
+
* plus a footer reminder to update delta specs.
|
|
20
|
+
*
|
|
21
|
+
* If the spec dir is missing or unreadable, the whisper is skipped.
|
|
22
|
+
*/
|
|
23
|
+
import { readFile, readdir } from "node:fs/promises";
|
|
24
|
+
import { join } from "node:path";
|
|
25
|
+
import { sendTrackedMessage } from "../utils/injection-tracker.js";
|
|
26
|
+
import { asyncExists } from "../utils/async-fs.js";
|
|
27
|
+
const MAX_DOMAINS = 3;
|
|
28
|
+
const SPECS_DIRNAME = "openspec";
|
|
29
|
+
const SPECS_SUBDIR = "specs";
|
|
30
|
+
const SPEC_FILENAME = "spec.md";
|
|
31
|
+
/** Extract requirement lines from a spec.md file. */
|
|
32
|
+
function extractRequirements(content) {
|
|
33
|
+
const reqs = [];
|
|
34
|
+
for (const line of content.split("\n")) {
|
|
35
|
+
const trimmed = line.trim();
|
|
36
|
+
if (trimmed.startsWith("### Requirement:") || /\b(SHALL|MUST|SHOULD)\b/.test(trimmed)) {
|
|
37
|
+
reqs.push(trimmed.replace(/^[#\s]+/, ""));
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return reqs;
|
|
41
|
+
}
|
|
42
|
+
/** Walk up to MAX_DOMAINS spec domains, return their extracted requirements. */
|
|
43
|
+
async function readActiveSpecs(cwd) {
|
|
44
|
+
const specDir = join(cwd, SPECS_DIRNAME, SPECS_SUBDIR);
|
|
45
|
+
if (!(await asyncExists(specDir)))
|
|
46
|
+
return [];
|
|
47
|
+
const domains = await readdir(specDir, { withFileTypes: true }).catch(() => []);
|
|
48
|
+
const out = [];
|
|
49
|
+
for (const domain of domains) {
|
|
50
|
+
if (out.length >= MAX_DOMAINS)
|
|
51
|
+
break;
|
|
52
|
+
if (!domain.isDirectory())
|
|
53
|
+
continue;
|
|
54
|
+
const specPath = join(specDir, domain.name, SPEC_FILENAME);
|
|
55
|
+
if (!(await asyncExists(specPath)))
|
|
56
|
+
continue;
|
|
57
|
+
try {
|
|
58
|
+
const content = await readFile(specPath, "utf-8");
|
|
59
|
+
const requirements = extractRequirements(content);
|
|
60
|
+
if (requirements.length > 0) {
|
|
61
|
+
out.push({ domain: domain.name, requirements });
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
// An unreadable spec file is skipped, not fatal.
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
return out;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Build the whisper text for the `## Active Specs` block.
|
|
72
|
+
* Returns "" if no spec domains were found or no requirements could be extracted.
|
|
73
|
+
*/
|
|
74
|
+
function renderSpecsText(specs) {
|
|
75
|
+
if (specs.length === 0)
|
|
76
|
+
return "";
|
|
77
|
+
const body = specs
|
|
78
|
+
.map((s) => `${s.domain}:\n${s.requirements.map((r) => ` ${r}`).join("\n")}`)
|
|
79
|
+
.join("\n\n");
|
|
80
|
+
return `## Active Specs\n\n${body}\n\nWhen editing, check openspec/specs/ for relevant requirements and update delta specs if behavior changes.`;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Deliver active OpenSpec spec context as a whisper (once per session).
|
|
84
|
+
* Best-effort: any failure (missing dirs, unreadable files) is swallowed.
|
|
85
|
+
*/
|
|
86
|
+
export async function deliverActiveSpecs(cwd, pi, _ctx) {
|
|
87
|
+
let specs;
|
|
88
|
+
try {
|
|
89
|
+
specs = await readActiveSpecs(cwd);
|
|
90
|
+
}
|
|
91
|
+
catch {
|
|
92
|
+
return;
|
|
93
|
+
}
|
|
94
|
+
const text = renderSpecsText(specs);
|
|
95
|
+
if (!text)
|
|
96
|
+
return;
|
|
97
|
+
try {
|
|
98
|
+
sendTrackedMessage(pi, {
|
|
99
|
+
customType: "openspec",
|
|
100
|
+
display: true,
|
|
101
|
+
content: [{ type: "text", text }],
|
|
102
|
+
}, { delivery: "park", deliverAs: "steer" }, { type: "memory", source: "prompt-builder/openspec" });
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
// Non-fatal: steer message send is best-effort
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
//# sourceMappingURL=openspec.js.map
|
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Braid Paths - centralized storage paths for braid's persistent data.
|
|
3
|
+
*
|
|
4
|
+
* All braid-specific persistent storage is consolidated here.
|
|
5
|
+
* This makes it easy to find, audit, and migrate braid data.
|
|
6
|
+
*
|
|
7
|
+
* Canonical local registry for packages/core (and, through the `pi-braid/lib`
|
|
8
|
+
* public entry, for packages/contrib). Restored from its own local content
|
|
9
|
+
* when the temporary `export * from "pi-braid-lib"` wholesale re-export was
|
|
10
|
+
* retired (see packages/core/docs/archive/monorepo-architecture-review.md).
|
|
11
|
+
*/
|
|
12
|
+
declare const AGENT: string;
|
|
13
|
+
declare const BRAID: string;
|
|
14
|
+
/**
|
|
15
|
+
* Root for braid's persistent state, overridable per process via BRAID_HOME
|
|
16
|
+
* (read on every call). Callers that WRITE durable state must resolve through
|
|
17
|
+
* this accessor instead of a precomputed const, so test harnesses can pin
|
|
18
|
+
* the whole braid tree into a tmpdir and prove the live tree was untouched.
|
|
19
|
+
*
|
|
20
|
+
* The no-override leg is derived here, on every call, and must be absolute:
|
|
21
|
+
* with `HOME=.` or `HOME=""` the old module-load fallback produced a RELATIVE
|
|
22
|
+
* root, so a module toggle (or any other default-leg writer) created
|
|
23
|
+
* `.pi/agent/braid/...` inside the user's project. The override leg carries
|
|
24
|
+
* the same rule for the same reason: a relative BRAID_HOME resolves against
|
|
25
|
+
* whatever cwd the process has, so a pinned run started from a project wrote
|
|
26
|
+
* braid's whole state tree into that project. A root that is not absolute
|
|
27
|
+
* names no directory braid owns, so this throws instead of returning one;
|
|
28
|
+
* callers that can skip (a writer) or degrade (a reader) decide what to do
|
|
29
|
+
* with the refusal. BRAID_HOME wins whenever it is set to an absolute path.
|
|
30
|
+
*/
|
|
31
|
+
export declare function braidDir(): string;
|
|
32
|
+
export declare const BRAID_DIR: string;
|
|
33
|
+
export { BRAID };
|
|
34
|
+
export { AGENT };
|
|
35
|
+
export declare const MEMORY_DIR: string;
|
|
36
|
+
export declare const CHECKPOINT_DIR: string;
|
|
37
|
+
export declare const ERROR_DIR: string;
|
|
38
|
+
export declare const SCRATCHPAD_DIR: string;
|
|
39
|
+
export declare const METRICS_DIR: string;
|
|
40
|
+
export declare const TELEMETRY_DIR: string;
|
|
41
|
+
export declare const HEALTHCHECK_DIR: string;
|
|
42
|
+
/** Lossless flush target for offloaded stale tool results. Precomputed from
|
|
43
|
+
* the default root: a caller that WRITES here must resolve through
|
|
44
|
+
* `offloadDir()` so BRAID_HOME pinning applies (see braidDir()). */
|
|
45
|
+
export declare const OFFLOAD_DIR: string;
|
|
46
|
+
/** Offload root, resolved on every call (BRAID_HOME pinning honored). Also
|
|
47
|
+
* the containment root `offload_recover` accepts stub paths under, so writer
|
|
48
|
+
* and reader can never disagree about where a flush landed. */
|
|
49
|
+
export declare function offloadDir(): string;
|
|
50
|
+
/** Memory root (semantic + episodic stores), resolved on every call. */
|
|
51
|
+
export declare function memoryDir(): string;
|
|
52
|
+
/** Session checkpoints root, resolved on every call. */
|
|
53
|
+
export declare function checkpointDir(): string;
|
|
54
|
+
/** Error-capture root, resolved on every call. */
|
|
55
|
+
export declare function errorDir(): string;
|
|
56
|
+
/** Scratchpad root (one dir per project slug), resolved on every call. */
|
|
57
|
+
export declare function scratchpadDir(): string;
|
|
58
|
+
/** Healthcheck scratch and report root, resolved on every call. Durable-write
|
|
59
|
+
* state: the probes and the saved report must follow a pinned BRAID_HOME. */
|
|
60
|
+
export declare function healthcheckDir(): string;
|
|
61
|
+
/** Analytics metrics root, resolved on every call. */
|
|
62
|
+
export declare function metricsDir(): string;
|
|
63
|
+
/** Telemetry sink root (context-heartbeat JSONL), resolved on every call. */
|
|
64
|
+
export declare function telemetryDir(): string;
|
|
65
|
+
/** Workspace snapshot root, resolved on every call. */
|
|
66
|
+
export declare function snapshotDir(): string;
|
|
67
|
+
/** Per-project store root (locks, workers, timers, module overrides,
|
|
68
|
+
* deliverables), resolved on every call. */
|
|
69
|
+
export declare function projectsDir(): string;
|
|
70
|
+
/** lib/memory semantic + episodic store */
|
|
71
|
+
export declare const SEMANTIC_MEMORY_FILE: string;
|
|
72
|
+
/** Semantic store, resolved on every call (durable-write base). */
|
|
73
|
+
export declare function semanticMemoryFilePath(): string;
|
|
74
|
+
/** Evidence pool: cross-session evidence + conflict persistence */
|
|
75
|
+
export declare const EVIDENCE_POOL_FILE: string;
|
|
76
|
+
/** Evidence pool store, resolved on every call (durable-write base). */
|
|
77
|
+
export declare function evidencePoolFilePath(): string;
|
|
78
|
+
/** Legacy path for lib/memory (kept for graceful migration) */
|
|
79
|
+
export declare const LEGACY_MEMORY_FILE: string;
|
|
80
|
+
/** Legacy pre-braid memory store, resolved on every call. The one path here
|
|
81
|
+
* that is not a child of the live root: the old layout kept the store at
|
|
82
|
+
* `<old root>/memory/memory.json`, with the braid home two levels below the
|
|
83
|
+
* old root (`<old root>/agent/braid`), so this derives the source from the
|
|
84
|
+
* live root the same way the precomputed default names it. Under a pinned
|
|
85
|
+
* root that is the pin's own (normally absent) predecessor, never the store
|
|
86
|
+
* under the developer's default tree: a read that imports prior state has to
|
|
87
|
+
* follow the pin with everything else. Readers degrade when the root refuses
|
|
88
|
+
* (see braidDir()): no source, no import. */
|
|
89
|
+
export declare function legacyMemoryFilePath(): string;
|
|
90
|
+
/** Three-memory-stores retrospective episodes */
|
|
91
|
+
export declare const EPISODES_FILE: string;
|
|
92
|
+
/** Episodic store, resolved on every call (durable-write base). */
|
|
93
|
+
export declare function episodesFilePath(): string;
|
|
94
|
+
/** Memory write gate: append-only per-decision log (measurement hook). */
|
|
95
|
+
export declare const WRITE_LOG_FILE: string;
|
|
96
|
+
/** Write-decision log, resolved on every call (durable-write base). */
|
|
97
|
+
export declare function writeLogFilePath(): string;
|
|
98
|
+
/** Error-capture: classified error log */
|
|
99
|
+
export declare const ERROR_LOG_FILE: string;
|
|
100
|
+
export declare const ERROR_FILE: string;
|
|
101
|
+
/** Classified error log, resolved on every call (durable-write base). */
|
|
102
|
+
export declare function errorsFilePath(): string;
|
|
103
|
+
/** Consolidation: behavioral hints from successful patterns */
|
|
104
|
+
export declare const CONSOLIDATED_HINTS_FILE: string;
|
|
105
|
+
/** Consolidated hints log, resolved on every call (durable-write base). */
|
|
106
|
+
export declare function consolidatedHintsFilePath(): string;
|
|
107
|
+
/** Analytics: tool call metrics + A/B variant tracking */
|
|
108
|
+
export declare const METRICS_FILE: string;
|
|
109
|
+
/** Analytics metrics log, resolved on every call (durable-write base). */
|
|
110
|
+
export declare function metricsFilePath(): string;
|
|
111
|
+
/** Degradation detector: health metrics state */
|
|
112
|
+
export declare const DEGRADATION_FILE: string;
|
|
113
|
+
/** Degradation state, resolved on every call (durable-write base). */
|
|
114
|
+
export declare function degradationFilePath(): string;
|
|
115
|
+
/** Shown-signals persistence: survive process restart for session resume dedup */
|
|
116
|
+
export declare const SHOWN_SIGNALS_FILE: string;
|
|
117
|
+
/** Shown-signals index, resolved on every call (write-through cache base). */
|
|
118
|
+
export declare function shownSignalsFilePath(): string;
|
|
119
|
+
/** Persistent one-shot timers (JSONL): survive process restart.
|
|
120
|
+
* Legacy precomputed path — kept for compatibility. Durable-write callers
|
|
121
|
+
* must resolve their actual path through getTimerFilePath, which routes
|
|
122
|
+
* through braidDir() so BRAID_HOME pinning is honored. */
|
|
123
|
+
export declare const PENDING_TIMERS_FILE: string;
|
|
124
|
+
/** Orchestrator file-lock registry: track which files are locked by which worker. */
|
|
125
|
+
export declare const LOCK_FILE: string;
|
|
126
|
+
/** Orchestrator worker registry: track worker lifecycle and result locations. */
|
|
127
|
+
export declare const WORKERS_FILE: string;
|
|
128
|
+
/** Skills adoption: cross-session per-skill usage counters. */
|
|
129
|
+
export declare const SKILLS_USAGE_FILE: string;
|
|
130
|
+
/** Skills adoption: durable per-session adoption records (append-only JSONL). */
|
|
131
|
+
export declare const SKILLS_SESSIONS_FILE: string;
|
|
132
|
+
/** Braid config home (session profiles and future braid-owned settings). */
|
|
133
|
+
export declare const BRAID_CONFIG_FILE: string;
|
|
134
|
+
/** File name (sans `.json`) of the cross-session tag file for one project.
|
|
135
|
+
* One rule for the three sites that touch that file: the tag writer
|
|
136
|
+
* (register-tool-call), the context-lifecycle proposal merge and the
|
|
137
|
+
* session-start discoverability signal. It lived inline at those sites, so a
|
|
138
|
+
* second spelling split the file in two: the writer's, which the proposal
|
|
139
|
+
* merge matched, and the discoverability reader's `--wrapped--` form (the
|
|
140
|
+
* scratchpad/sessions convention), which matched nothing the writer ever
|
|
141
|
+
* wrote and silently muted the `tags_prior` signal. */
|
|
142
|
+
export declare function tagsSlugFromCwd(cwd?: string): string;
|
|
143
|
+
/**
|
|
144
|
+
* Get the lossless flush file path for one offloaded tool result.
|
|
145
|
+
* Layout: <offload dir>/<sessionId>/<toolName>-<toolCallId>.txt.
|
|
146
|
+
* The stub embedded in the LLM context carries this path; recovery = read it.
|
|
147
|
+
*/
|
|
148
|
+
export declare function getOffloadFilePath(sessionId: string, toolCallId: string, toolName: string): string;
|
|
149
|
+
/** Get the per-CWD pending timers file path.
|
|
150
|
+
* Resolves through braidDir() — this file is DURABLE WRITE state, and the
|
|
151
|
+
* braidDir() contract requires write paths to honor BRAID_HOME so test
|
|
152
|
+
* harnesses can pin the whole braid tree into a tmpdir. A precomputed
|
|
153
|
+
* const here would silently write test fixtures into the live store. */
|
|
154
|
+
export declare function getTimerFilePath(cwd?: string): string;
|
|
155
|
+
/** Get the per-CWD module overrides store path.
|
|
156
|
+
* Braid's own record of the runtime module toggles (`braid.modules` values a
|
|
157
|
+
* toggle persisted), kept out of the user's project: writing it into
|
|
158
|
+
* `<cwd>/.pi/settings.json` made braid create files in a stranger's repo.
|
|
159
|
+
* Resolves through braidDir() — durable write state, so BRAID_HOME pinning
|
|
160
|
+
* must move it. A `braid.modules` block in pi's agent-directory settings file
|
|
161
|
+
* stays an INPUT (see the loader's read order); it is never written. The cwd
|
|
162
|
+
* is required: a store at the braid root names no project and has no writer
|
|
163
|
+
* in production, so it would only be a second, silently divergent location. */
|
|
164
|
+
export declare function getModuleOverridesFilePath(cwd: string): string;
|
|
165
|
+
/** Get the per-CWD lock file path.
|
|
166
|
+
* Resolves through braidDir() (and projectsDir() for the project leg): the
|
|
167
|
+
* registry is DURABLE WRITE state, so BRAID_HOME pinning must move it; the
|
|
168
|
+
* precomputed LOCK_FILE leg is the read-side default beside the braid root. */
|
|
169
|
+
export declare function getLockFilePath(cwd?: string): string;
|
|
170
|
+
/** Get the per-CWD worker registry path (beside locks.json). Durable write
|
|
171
|
+
* state: same braidDir() leg as getLockFilePath. */
|
|
172
|
+
export declare function getWorkersFilePath(cwd?: string): string;
|
|
173
|
+
/** Get the per-CWD deliverables manifest path (session-touched files the
|
|
174
|
+
* verification judge reads as ground truth). Durable write state: resolves
|
|
175
|
+
* through braidDir() so BRAID_HOME pinning is honored, and lives under the
|
|
176
|
+
* braid home — never under <repo>/.braid, which polluted every project a
|
|
177
|
+
* session ran in. */
|
|
178
|
+
export declare function getDeliverablesFilePath(cwd?: string): string;
|
|
179
|
+
/** Get the skills adoption usage file path. Durable write state: resolves
|
|
180
|
+
* through braidDir() so BRAID_HOME pinning is honored. */
|
|
181
|
+
export declare function getSkillsUsageFilePath(): string;
|
|
182
|
+
/** Get the per-session skills adoption records path (append-only JSONL).
|
|
183
|
+
* Durable write state: same braidDir() leg as getSkillsUsageFilePath. */
|
|
184
|
+
export declare function getSkillsSessionsFilePath(): string;
|
|
185
|
+
/** Get the braid config home path (BRAID_CONFIG_FILE). Resolved through
|
|
186
|
+
* braidDir() so a pinned braid tree reads its own config, not the default one. */
|
|
187
|
+
export declare function getBraidConfigFilePath(): string;
|
|
188
|
+
//# sourceMappingURL=braid-paths.d.ts.map
|