pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,534 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Extension loader - flat loading with runtime toggling.
|
|
3
|
+
*
|
|
4
|
+
* Config layers (applied high -> low; runtime and settings override the
|
|
5
|
+
* layers below per-id, the env var is a complete spec over the defaults):
|
|
6
|
+
* 1. Runtime overrides - /modules-toggle, /modules-enable, /modules-disable
|
|
7
|
+
* (in-session; the toggle commands also persist them into `braid.modules`)
|
|
8
|
+
* 2. `braid.modules` settings - two sources, later wins per id: pi's
|
|
9
|
+
* agent-directory settings file (`<agent dir>/settings.json`) and braid's
|
|
10
|
+
* own module-overrides store, which is where toggles persist
|
|
11
|
+
* (getModuleOverridesFilePath). true enables an opt-in id, false disables
|
|
12
|
+
* a default-enabled one. Braid writes only its own store.
|
|
13
|
+
*
|
|
14
|
+
* A project-scoped `<cwd>/.pi/settings.json` is deliberately NOT a source.
|
|
15
|
+
* That file is pi's artifact, and pi applies it only when it trusts the
|
|
16
|
+
* project (its SettingsManager keeps `{}` for an untrusted one); the
|
|
17
|
+
* resolution below cannot ask pi which it is, because it runs while
|
|
18
|
+
* extensions load - where pi's runtime is unbound (`pi.getSettings()`
|
|
19
|
+
* throws "Extension runtime not initialized") and pi's project settings
|
|
20
|
+
* are forced empty for the pre-trust pass. The trust answer arrives with
|
|
21
|
+
* the session, after the load decision it would have to inform, and a
|
|
22
|
+
* gate braid reconstructed on its own (trust store + defaultProjectTrust
|
|
23
|
+
* + the project_trust event + an explicit override) would be a second
|
|
24
|
+
* implementation of a pi-owned policy, wrong in either direction the day
|
|
25
|
+
* the two drift. So a `braid.modules` block authored in a project file
|
|
26
|
+
* stops applying: pin module state in the agent-directory settings file,
|
|
27
|
+
* or toggle, which persists to braid's store.
|
|
28
|
+
* 3. Environment variable - BRAID_MODULES (+id to enable, -id to disable)
|
|
29
|
+
* 4. Default - all extensions enabled (except opt-in/disabledByDefault)
|
|
30
|
+
*
|
|
31
|
+
* The loader works on individual extensions from the flat manifest. The
|
|
32
|
+
* `module` field on each entry is a convenience label for the subagent API -
|
|
33
|
+
* it has no structural role in the directory tree.
|
|
34
|
+
*
|
|
35
|
+
* Config references can be:
|
|
36
|
+
* - An extension ID (e.g. "enforcement", "three-memory-stores")
|
|
37
|
+
* - A module group name (e.g. "core", "memory") - expands to all member IDs
|
|
38
|
+
*/
|
|
39
|
+
import { mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
|
|
40
|
+
import { homedir } from "node:os";
|
|
41
|
+
import { basename, dirname, join } from "node:path";
|
|
42
|
+
import { createLogger } from "../lib/core/logger.js";
|
|
43
|
+
import { initModels } from "../lib/ai/models-init.js";
|
|
44
|
+
import { recordToolRegistration } from "../lib/state/tool-provenance.js";
|
|
45
|
+
import { getModuleOverridesFilePath } from "../lib/config/braid-paths.js";
|
|
46
|
+
import { MANIFEST, getEntry, getModuleGroup, getModuleNames, getDefaultEnabledIds, getAlwaysOnIds, } from "../extensions/manifest.js";
|
|
47
|
+
const log = createLogger("modules");
|
|
48
|
+
// ──── Settings sources ──────────────────────────────────────────────────────
|
|
49
|
+
/** Pi's global settings file. Built from homedir() at module load, so a
|
|
50
|
+
* relocated agent directory (PI_CODING_AGENT_DIR) is not honored on this
|
|
51
|
+
* read path. */
|
|
52
|
+
const GLOBAL_SETTINGS = join(homedir(), ".pi", "agent", "settings.json");
|
|
53
|
+
/** Braid's own `braid.modules` store for the process cwd ("" when the cwd is
|
|
54
|
+
* unavailable). Durable write state under braidDir(), so BRAID_HOME pinning
|
|
55
|
+
* moves it; the user's project is never written. */
|
|
56
|
+
function getModuleStorePath() {
|
|
57
|
+
try {
|
|
58
|
+
return getModuleOverridesFilePath(process.cwd());
|
|
59
|
+
}
|
|
60
|
+
catch {
|
|
61
|
+
return "";
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
const BRAID_KEY = "braid";
|
|
65
|
+
const _loaderState = {
|
|
66
|
+
runtimeConfig: new Map(),
|
|
67
|
+
loaded: [],
|
|
68
|
+
loadedCount: 0,
|
|
69
|
+
skipped: [],
|
|
70
|
+
};
|
|
71
|
+
function getLoaderState() {
|
|
72
|
+
return _loaderState;
|
|
73
|
+
}
|
|
74
|
+
// ──── Tool provenance wrapping ───────────────────────────────────────────────
|
|
75
|
+
/**
|
|
76
|
+
* Returns a wrapper around `pi` where `registerTool` records the
|
|
77
|
+
* registering extension id into the tool-provenance map. Other
|
|
78
|
+
* methods pass through unchanged.
|
|
79
|
+
*
|
|
80
|
+
* The wrapper exists because calling `pi.getAllTools()` during
|
|
81
|
+
* extension loading triggers "Extension runtime not initialized" in
|
|
82
|
+
* pi-core (it's an action method that requires the runtime to be
|
|
83
|
+
* ready). The previous before/after diff approach hit this; wrapping
|
|
84
|
+
* `registerTool` is a passive observer pattern that doesn't depend
|
|
85
|
+
* on runtime state.
|
|
86
|
+
*/
|
|
87
|
+
function wrapForProvenance(pi, extId) {
|
|
88
|
+
const origRegister = pi.registerTool.bind(pi);
|
|
89
|
+
return new Proxy(pi, {
|
|
90
|
+
get(target, prop, receiver) {
|
|
91
|
+
if (prop === "registerTool") {
|
|
92
|
+
return (tool) => {
|
|
93
|
+
const name = tool?.name;
|
|
94
|
+
if (typeof name === "string" && name.length > 0) {
|
|
95
|
+
recordToolRegistration(name, extId);
|
|
96
|
+
}
|
|
97
|
+
return origRegister(tool);
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
return Reflect.get(target, prop, receiver);
|
|
101
|
+
},
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
// ──── Pi settings.json persistence ───────────────────────────────────────────
|
|
105
|
+
function readSettingsFile(path) {
|
|
106
|
+
try {
|
|
107
|
+
return JSON.parse(readFileSync(path, "utf-8"));
|
|
108
|
+
}
|
|
109
|
+
catch (e) {
|
|
110
|
+
// Missing file = fresh install, silent. Anything else (truncated write,
|
|
111
|
+
// trailing comma, EACCES) silently reverts every braid setting unless it
|
|
112
|
+
// is surfaced.
|
|
113
|
+
if (e?.code !== "ENOENT")
|
|
114
|
+
warnUnreadableSettings(path, e);
|
|
115
|
+
return {};
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
/** Warned once per process about an unreadable settings file. */
|
|
119
|
+
let _warnedUnreadableSettings = false;
|
|
120
|
+
function warnUnreadableSettings(path, e) {
|
|
121
|
+
if (_warnedUnreadableSettings)
|
|
122
|
+
return;
|
|
123
|
+
_warnedUnreadableSettings = true;
|
|
124
|
+
log.warn(`Cannot read settings file at ${path} - braid settings in it are ignored ` +
|
|
125
|
+
"until the file is fixed.", { error: e.message });
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* Read `braid.modules` from every source that may carry it. Sources apply in
|
|
129
|
+
* order, later wins per key:
|
|
130
|
+
* 1. pi's agent-directory settings file (user-owned, always trusted)
|
|
131
|
+
* 2. braid's module-overrides store - what the toggle commands persist
|
|
132
|
+
*
|
|
133
|
+
* The returned `source` names the LAST source that contributed a key, which is
|
|
134
|
+
* the layer whose values survived the merge; it feeds the user-facing
|
|
135
|
+
* `config:` line, so a store-decided state is not reported as a settings-file
|
|
136
|
+
* decision.
|
|
137
|
+
*/
|
|
138
|
+
function readBraidSettings() {
|
|
139
|
+
const global_ = readSettingsFile(GLOBAL_SETTINGS);
|
|
140
|
+
const storePath = getModuleStorePath();
|
|
141
|
+
const store_ = storePath ? readSettingsFile(storePath) : {};
|
|
142
|
+
const merged = {};
|
|
143
|
+
let source;
|
|
144
|
+
for (const [label, doc] of [
|
|
145
|
+
["settings-json", global_],
|
|
146
|
+
["store", store_],
|
|
147
|
+
]) {
|
|
148
|
+
const modules = doc[BRAID_KEY]?.modules ?? {};
|
|
149
|
+
const entries = Object.entries(modules);
|
|
150
|
+
if (entries.length === 0)
|
|
151
|
+
continue;
|
|
152
|
+
for (const [k, v] of entries)
|
|
153
|
+
merged[k] = v;
|
|
154
|
+
source = label;
|
|
155
|
+
}
|
|
156
|
+
return Object.keys(merged).length > 0 ? { modules: merged, source } : { modules: undefined };
|
|
157
|
+
}
|
|
158
|
+
function isPlainObject(v) {
|
|
159
|
+
return typeof v === "object" && v !== null && !Array.isArray(v);
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Merge `modules` into braid's module-overrides store, destroying nothing:
|
|
163
|
+
* only the `braid.modules` keys being written change; sibling keys in the
|
|
164
|
+
* store and untouched module entries survive. Installed as a same-directory
|
|
165
|
+
* temp file plus rename, so a reader never observes a torn file.
|
|
166
|
+
*
|
|
167
|
+
* An unreadable existing store is never overwritten - content we could not
|
|
168
|
+
* read must not be replaced from a partial view; the write aborts with the
|
|
169
|
+
* once-per-process unreadable-settings warning instead.
|
|
170
|
+
*/
|
|
171
|
+
function writeBraidSettings(modules) {
|
|
172
|
+
const storePath = getModuleStorePath();
|
|
173
|
+
if (!storePath) {
|
|
174
|
+
log.warn("Cannot determine the module-overrides store path");
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
let all;
|
|
178
|
+
try {
|
|
179
|
+
all = JSON.parse(readFileSync(storePath, "utf-8"));
|
|
180
|
+
}
|
|
181
|
+
catch (e) {
|
|
182
|
+
if (e?.code === "ENOENT") {
|
|
183
|
+
all = {};
|
|
184
|
+
}
|
|
185
|
+
else {
|
|
186
|
+
warnUnreadableSettings(storePath, e);
|
|
187
|
+
return;
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
const existingBraid = isPlainObject(all[BRAID_KEY]) ? all[BRAID_KEY] : {};
|
|
191
|
+
const existingModules = isPlainObject(existingBraid.modules) ? existingBraid.modules : {};
|
|
192
|
+
all[BRAID_KEY] = { ...existingBraid, modules: { ...existingModules, ...modules } };
|
|
193
|
+
const tmp = `${storePath}.tmp.${process.pid}`;
|
|
194
|
+
try {
|
|
195
|
+
mkdirSync(dirname(storePath), { recursive: true });
|
|
196
|
+
sweepStaleStoreTemps(storePath);
|
|
197
|
+
writeFileSync(tmp, JSON.stringify(all, null, 2), "utf-8");
|
|
198
|
+
renameSync(tmp, storePath);
|
|
199
|
+
}
|
|
200
|
+
catch (e) {
|
|
201
|
+
// This write's own temp must not outlive it: a failed rename would leave
|
|
202
|
+
// a file nothing collects until the age-gated sweep runs.
|
|
203
|
+
try {
|
|
204
|
+
unlinkSync(tmp);
|
|
205
|
+
}
|
|
206
|
+
catch {
|
|
207
|
+
/* never created, or already gone */
|
|
208
|
+
}
|
|
209
|
+
log.warn(`Failed to write braid module overrides: ${e.message}`);
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
/** Age after which a `<store>.tmp.<pid>` left by a crashed write is garbage. */
|
|
213
|
+
const STALE_TEMP_MS = 24 * 60 * 60 * 1000;
|
|
214
|
+
/**
|
|
215
|
+
* Collect the temp files crashed earlier writes left behind: the rename never
|
|
216
|
+
* ran, so the temp is complete and unowned, and nothing else ever removes it.
|
|
217
|
+
* Only temps older than a day go - a live writer's temp must survive a
|
|
218
|
+
* concurrent sweep, and every write here is a synchronous write-plus-rename.
|
|
219
|
+
*/
|
|
220
|
+
function sweepStaleStoreTemps(storePath) {
|
|
221
|
+
const dir = dirname(storePath);
|
|
222
|
+
const prefix = `${basename(storePath)}.tmp.`;
|
|
223
|
+
const cutoff = Date.now() - STALE_TEMP_MS;
|
|
224
|
+
let entries;
|
|
225
|
+
try {
|
|
226
|
+
entries = readdirSync(dir, { withFileTypes: true });
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
return;
|
|
230
|
+
}
|
|
231
|
+
for (const entry of entries) {
|
|
232
|
+
if (!entry.isFile() || !entry.name.startsWith(prefix))
|
|
233
|
+
continue;
|
|
234
|
+
const candidate = join(dir, entry.name);
|
|
235
|
+
try {
|
|
236
|
+
if (statSync(candidate).mtimeMs < cutoff)
|
|
237
|
+
unlinkSync(candidate);
|
|
238
|
+
}
|
|
239
|
+
catch {
|
|
240
|
+
/* gone, or a concurrent writer owns it: leave it alone */
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
function saveModuleOverridesToFile(overrides) {
|
|
245
|
+
const modules = {};
|
|
246
|
+
for (const [name, val] of overrides) {
|
|
247
|
+
modules[name] = val;
|
|
248
|
+
}
|
|
249
|
+
writeBraidSettings(modules);
|
|
250
|
+
}
|
|
251
|
+
// ──── Config expansion ──────────────────────────────────────────────────────
|
|
252
|
+
/**
|
|
253
|
+
* Expand a config reference (extension ID or module group name) into
|
|
254
|
+
* individual extension IDs.
|
|
255
|
+
*/
|
|
256
|
+
function expandRef(ref) {
|
|
257
|
+
// Direct extension ID match
|
|
258
|
+
if (getEntry(ref))
|
|
259
|
+
return [ref];
|
|
260
|
+
// Module group name
|
|
261
|
+
const group = getModuleGroup(ref);
|
|
262
|
+
if (group.length > 0)
|
|
263
|
+
return group.map((e) => e.id);
|
|
264
|
+
return [];
|
|
265
|
+
}
|
|
266
|
+
/** All valid config references (extension IDs + module group names). */
|
|
267
|
+
function allConfigRefs() {
|
|
268
|
+
const ids = MANIFEST.map((e) => e.id);
|
|
269
|
+
const groups = getModuleNames();
|
|
270
|
+
return [...new Set([...ids, ...groups])];
|
|
271
|
+
}
|
|
272
|
+
/** Resolve which extensions are enabled, tracing the config source. */
|
|
273
|
+
export function resolveEnabledExtensions(envOverride) {
|
|
274
|
+
const state = getLoaderState();
|
|
275
|
+
const env = envOverride ?? process.env.BRAID_MODULES ?? null;
|
|
276
|
+
// Priority 1: runtime overrides overlay the resolved base per-id, so an
|
|
277
|
+
// in-process toggle can never drop settings-file additions or env-var
|
|
278
|
+
// enables - and an opt-in enable is visible to the resolver.
|
|
279
|
+
if (state.runtimeConfig.size > 0) {
|
|
280
|
+
const base = resolveFromSources(env);
|
|
281
|
+
const enabled = new Set(base.enabled);
|
|
282
|
+
for (const [id, override] of state.runtimeConfig) {
|
|
283
|
+
if (override)
|
|
284
|
+
enabled.add(id);
|
|
285
|
+
else
|
|
286
|
+
enabled.delete(id);
|
|
287
|
+
}
|
|
288
|
+
return { enabled: [...enabled], source: "runtime-api" };
|
|
289
|
+
}
|
|
290
|
+
return resolveFromSources(env);
|
|
291
|
+
}
|
|
292
|
+
/**
|
|
293
|
+
* Boot-time resolution, layered high -> low; one function is the truth for
|
|
294
|
+
* boot, the runtime API overlay and getModuleStates:
|
|
295
|
+
*
|
|
296
|
+
* 1. env var (when set): a complete spec that replaces the default set
|
|
297
|
+
* 2. settings.json braid.modules: per-ref boolean overlay (true enables,
|
|
298
|
+
* false disables), so a persisted entry cannot shadow what the env var
|
|
299
|
+
* enabled elsewhere
|
|
300
|
+
* 3. defaults
|
|
301
|
+
*
|
|
302
|
+
* The reported source is the highest-priority layer that contributed.
|
|
303
|
+
*/
|
|
304
|
+
function resolveFromSources(env) {
|
|
305
|
+
const defaults = getDefaultEnabledIds();
|
|
306
|
+
const enabled = new Set(defaults);
|
|
307
|
+
let source = "defaults";
|
|
308
|
+
// Priority 3: Environment variable
|
|
309
|
+
if (env && env.trim()) {
|
|
310
|
+
const parts = env
|
|
311
|
+
.split(",")
|
|
312
|
+
.map((s) => s.trim())
|
|
313
|
+
.filter(Boolean);
|
|
314
|
+
const disabled = new Set();
|
|
315
|
+
const envEnabled = new Set();
|
|
316
|
+
for (const part of parts) {
|
|
317
|
+
if (part.startsWith("+")) {
|
|
318
|
+
for (const id of expandRef(part.slice(1)))
|
|
319
|
+
envEnabled.add(id);
|
|
320
|
+
}
|
|
321
|
+
else if (part.startsWith("-")) {
|
|
322
|
+
for (const id of expandRef(part.slice(1)))
|
|
323
|
+
disabled.add(id);
|
|
324
|
+
}
|
|
325
|
+
else {
|
|
326
|
+
for (const id of expandRef(part))
|
|
327
|
+
envEnabled.add(id);
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
if (envEnabled.size > 0) {
|
|
331
|
+
enabled.clear();
|
|
332
|
+
for (const id of envEnabled)
|
|
333
|
+
enabled.add(id);
|
|
334
|
+
}
|
|
335
|
+
for (const id of disabled)
|
|
336
|
+
enabled.delete(id);
|
|
337
|
+
source = "env-var";
|
|
338
|
+
}
|
|
339
|
+
// Priority 2: pi's agent-directory settings file, then braid's own store.
|
|
340
|
+
// Refs expand regardless of the value, so a persisted false disables a
|
|
341
|
+
// default-enabled extension; a true enables an opt-in id. The reported
|
|
342
|
+
// label comes from the read ("store" for a stored decision), so the
|
|
343
|
+
// user-facing `config:` line does not call one a settings-file decision.
|
|
344
|
+
const settings = readBraidSettings();
|
|
345
|
+
if (settings.modules && Object.keys(settings.modules).length > 0) {
|
|
346
|
+
for (const [ref, val] of Object.entries(settings.modules)) {
|
|
347
|
+
for (const id of expandRef(ref)) {
|
|
348
|
+
if (val)
|
|
349
|
+
enabled.add(id);
|
|
350
|
+
else
|
|
351
|
+
enabled.delete(id);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
source = settings.source ?? "settings-json";
|
|
355
|
+
}
|
|
356
|
+
return { enabled: [...enabled], source };
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
359
|
+
* Load all enabled extensions based on resolved config.
|
|
360
|
+
* Calls each factory with the pi API.
|
|
361
|
+
*/
|
|
362
|
+
export async function loadModules(pi, envOverride) {
|
|
363
|
+
const state = getLoaderState();
|
|
364
|
+
const { enabled, source } = resolveEnabledExtensions(envOverride);
|
|
365
|
+
// Initialize the pi-ai Models instance before loading extensions.
|
|
366
|
+
// Auxiliary LLM calls do not read it: llm-call.ts dispatches through the
|
|
367
|
+
// session's model registry. See lib/ai/models-init.ts for the current state.
|
|
368
|
+
await initModels();
|
|
369
|
+
const loaded = [];
|
|
370
|
+
const skipped = [];
|
|
371
|
+
let total = 0;
|
|
372
|
+
log.info(`Loading extensions from config: ${source}`);
|
|
373
|
+
log.info(`Enabled: ${enabled.join(", ")}`);
|
|
374
|
+
const ordered = topologicalSort(enabled);
|
|
375
|
+
for (const extId of ordered) {
|
|
376
|
+
const entry = getEntry(extId);
|
|
377
|
+
if (!entry) {
|
|
378
|
+
skipped.push({ id: extId, reason: "unknown extension" });
|
|
379
|
+
continue;
|
|
380
|
+
}
|
|
381
|
+
try {
|
|
382
|
+
// Wrap pi.registerTool so the extension's tool registrations
|
|
383
|
+
// are attributed to this extension id in the provenance map.
|
|
384
|
+
// Calling pi.getAllTools() during loading triggers
|
|
385
|
+
// "Extension runtime not initialized" in pi-core - the wrap
|
|
386
|
+
// approach avoids that entirely.
|
|
387
|
+
const extPi = wrapForProvenance(pi, extId);
|
|
388
|
+
await entry.fn(extPi);
|
|
389
|
+
total++;
|
|
390
|
+
loaded.push({ id: extId, desc: entry.desc });
|
|
391
|
+
}
|
|
392
|
+
catch (err) {
|
|
393
|
+
skipped.push({ id: extId, reason: err.message });
|
|
394
|
+
log.error(`Failed to load ${extId}: ${err.message}`);
|
|
395
|
+
}
|
|
396
|
+
}
|
|
397
|
+
state.loaded = loaded.map((l) => l.id);
|
|
398
|
+
state.loadedCount = total;
|
|
399
|
+
state.skipped = skipped;
|
|
400
|
+
log.info(`Loaded ${total} extensions` + (skipped.length > 0 ? `, ${skipped.length} skipped` : ""));
|
|
401
|
+
return { loaded, skipped, total, source };
|
|
402
|
+
}
|
|
403
|
+
// ──── Runtime toggling API ───────────────────────────────────────────────────
|
|
404
|
+
/**
|
|
405
|
+
* Resolve a config reference to individual extension IDs.
|
|
406
|
+
* Returns null if the reference is unknown.
|
|
407
|
+
*/
|
|
408
|
+
function resolveIds(ref) {
|
|
409
|
+
// Direct extension ID
|
|
410
|
+
if (getEntry(ref))
|
|
411
|
+
return [ref];
|
|
412
|
+
// Module group name
|
|
413
|
+
const group = getModuleGroup(ref);
|
|
414
|
+
if (group.length > 0)
|
|
415
|
+
return group.map((e) => e.id);
|
|
416
|
+
return null;
|
|
417
|
+
}
|
|
418
|
+
/** Enable an extension (or module group). Persists to settings.json. */
|
|
419
|
+
export function enableModule(name, _ctx) {
|
|
420
|
+
const ids = resolveIds(name);
|
|
421
|
+
if (!ids)
|
|
422
|
+
return false;
|
|
423
|
+
const state = getLoaderState();
|
|
424
|
+
const nonAlwaysOn = ids.filter((id) => !getEntry(id)?.alwaysOn);
|
|
425
|
+
if (nonAlwaysOn.length === 0)
|
|
426
|
+
return true;
|
|
427
|
+
for (const id of nonAlwaysOn)
|
|
428
|
+
state.runtimeConfig.set(id, true);
|
|
429
|
+
saveModuleOverridesToFile(state.runtimeConfig);
|
|
430
|
+
return true;
|
|
431
|
+
}
|
|
432
|
+
/** Disable an extension (or module group). Persists to settings.json. */
|
|
433
|
+
export function disableModule(name, _ctx) {
|
|
434
|
+
const ids = resolveIds(name);
|
|
435
|
+
if (!ids)
|
|
436
|
+
return false;
|
|
437
|
+
const nonAlwaysOn = ids.filter((id) => !getEntry(id)?.alwaysOn);
|
|
438
|
+
if (nonAlwaysOn.length === 0)
|
|
439
|
+
return false;
|
|
440
|
+
const state = getLoaderState();
|
|
441
|
+
for (const id of nonAlwaysOn)
|
|
442
|
+
state.runtimeConfig.set(id, false);
|
|
443
|
+
saveModuleOverridesToFile(state.runtimeConfig);
|
|
444
|
+
return true;
|
|
445
|
+
}
|
|
446
|
+
/** Toggle an extension (or module group). Returns the new state or null. */
|
|
447
|
+
export function toggleModule(name, _ctx) {
|
|
448
|
+
const ids = resolveIds(name);
|
|
449
|
+
if (!ids)
|
|
450
|
+
return null;
|
|
451
|
+
const nonAlwaysOn = ids.filter((id) => !getEntry(id)?.alwaysOn);
|
|
452
|
+
if (nonAlwaysOn.length === 0)
|
|
453
|
+
return true;
|
|
454
|
+
const state = getLoaderState();
|
|
455
|
+
// Flip the EFFECTIVE state (one resolution path), not the last runtime
|
|
456
|
+
// value: a toggle on a default-enabled extension with no prior override
|
|
457
|
+
// must turn it off, not "toggled ON" on an already-on extension.
|
|
458
|
+
const target = nonAlwaysOn[0]; // Use first non-alwaysOn as toggle indicator
|
|
459
|
+
const next = !resolveEnabledExtensions().enabled.includes(target);
|
|
460
|
+
for (const id of nonAlwaysOn)
|
|
461
|
+
state.runtimeConfig.set(id, next);
|
|
462
|
+
saveModuleOverridesToFile(state.runtimeConfig);
|
|
463
|
+
return next;
|
|
464
|
+
}
|
|
465
|
+
/** Get the current state of all extensions with loading status. */
|
|
466
|
+
export function getModuleStates(_ctx) {
|
|
467
|
+
const state = getLoaderState();
|
|
468
|
+
const { enabled, source } = resolveEnabledExtensions();
|
|
469
|
+
const result = {};
|
|
470
|
+
for (const entry of MANIFEST) {
|
|
471
|
+
// One resolution path: the resolver already applies runtime overrides,
|
|
472
|
+
// settings and env - consulting runtimeConfig here would produce a
|
|
473
|
+
// second answer in the same process.
|
|
474
|
+
const isEnabled = enabled.includes(entry.id);
|
|
475
|
+
result[entry.id] = {
|
|
476
|
+
enabled: isEnabled,
|
|
477
|
+
loaded: state.loaded.includes(entry.id),
|
|
478
|
+
source,
|
|
479
|
+
desc: entry.desc,
|
|
480
|
+
};
|
|
481
|
+
}
|
|
482
|
+
return result;
|
|
483
|
+
}
|
|
484
|
+
/**
|
|
485
|
+
* Reset all runtime overrides. Persisted braid.modules settings are data the
|
|
486
|
+
* user owns - reset clears the in-process layer only; a merge write that
|
|
487
|
+
* wiped them would destroy hand-authored entries (the same data-loss class
|
|
488
|
+
* as sibling-key destruction).
|
|
489
|
+
*/
|
|
490
|
+
export function resetModuleOverrides(_ctx) {
|
|
491
|
+
getLoaderState().runtimeConfig.clear();
|
|
492
|
+
}
|
|
493
|
+
// ──── Helpers ────────────────────────────────────────────────────────────────
|
|
494
|
+
/**
|
|
495
|
+
* Topological sort by dependency chain.
|
|
496
|
+
* Always includes alwaysOn extensions first, then sorts remaining by dep order.
|
|
497
|
+
*/
|
|
498
|
+
function topologicalSort(extIds) {
|
|
499
|
+
const alwaysOn = getAlwaysOnIds();
|
|
500
|
+
const inputSet = new Set([...alwaysOn, ...extIds]);
|
|
501
|
+
const visited = new Set();
|
|
502
|
+
const visiting = new Set();
|
|
503
|
+
const sorted = [];
|
|
504
|
+
function visit(id) {
|
|
505
|
+
if (visited.has(id))
|
|
506
|
+
return;
|
|
507
|
+
if (visiting.has(id))
|
|
508
|
+
throw new Error(`Circular extension dependency: ${id}`);
|
|
509
|
+
visiting.add(id);
|
|
510
|
+
const entry = getEntry(id);
|
|
511
|
+
if (entry?.dependencies) {
|
|
512
|
+
for (const dep of entry.dependencies) {
|
|
513
|
+
if (inputSet.has(dep))
|
|
514
|
+
visit(dep);
|
|
515
|
+
}
|
|
516
|
+
}
|
|
517
|
+
visiting.delete(id);
|
|
518
|
+
visited.add(id);
|
|
519
|
+
sorted.push(id);
|
|
520
|
+
}
|
|
521
|
+
// Visit alwaysOn first, then remaining input
|
|
522
|
+
for (const id of alwaysOn)
|
|
523
|
+
if (inputSet.has(id))
|
|
524
|
+
visit(id);
|
|
525
|
+
for (const id of extIds)
|
|
526
|
+
if (!alwaysOn.includes(id))
|
|
527
|
+
visit(id);
|
|
528
|
+
return sorted;
|
|
529
|
+
}
|
|
530
|
+
/** Get all valid config reference names for API completion/docs. */
|
|
531
|
+
export function getAllRefNames() {
|
|
532
|
+
return allConfigRefs();
|
|
533
|
+
}
|
|
534
|
+
//# sourceMappingURL=loader.js.map
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Beginner's Guide to pi-braid
|
|
4
|
+
|
|
5
|
+
This guide bridges **install → how agents use braid → writing your first
|
|
6
|
+
extension**. It assumes you have pi-coding-agent installed and know roughly
|
|
7
|
+
what an agent session is. For the complete setup reference (all install
|
|
8
|
+
paths, module toggles, troubleshooting) see [`SETUP.md`](SETUP.md).
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. What pi-braid is
|
|
13
|
+
|
|
14
|
+
pi is a coding agent with a base agent loop and a small built-in toolset.
|
|
15
|
+
**Extensions** are the way pi gets more capability: they register tools,
|
|
16
|
+
listen for session events, and shape the system prompt.
|
|
17
|
+
|
|
18
|
+
pi-braid is a collection of extensions that add a **metacognitive layer**:
|
|
19
|
+
memory that survives between sessions, reasoning tools (`think`, `verify`,
|
|
20
|
+
`finalize`), enforcement of agent-behavior policies, and self-improvement.
|
|
21
|
+
It is a monorepo of five workspaces; the one you care about first is
|
|
22
|
+
`packages/core`.
|
|
23
|
+
|
|
24
|
+
## 2. Install
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
git clone https://github.com/kifirkin/pi-braid.git ~/pi-braid
|
|
28
|
+
cd ~/pi-braid && npm install && npm run build
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Tell pi to load the core workspace (and any siblings you want):
|
|
32
|
+
|
|
33
|
+
```jsonc
|
|
34
|
+
// ~/.pi/agent/settings.json
|
|
35
|
+
{
|
|
36
|
+
"packages": [
|
|
37
|
+
"file:~/pi-braid/packages/core",
|
|
38
|
+
"file:~/pi-braid/packages/skills",
|
|
39
|
+
"file:~/pi-braid/packages/contrib",
|
|
40
|
+
],
|
|
41
|
+
}
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Then start pi. You're done when you see the braid tools in `<Available
|
|
45
|
+
tools>` (memory, timer, workspace_snapshot, …) and the braid skills in
|
|
46
|
+
`<available_skills>`.
|
|
47
|
+
|
|
48
|
+
## 3. How agents use braid
|
|
49
|
+
|
|
50
|
+
An agent session is a loop: see the system prompt → pick a tool → run it →
|
|
51
|
+
observe → repeat. braid changes what the agent _can_ do at each step:
|
|
52
|
+
|
|
53
|
+
- **Metacognitive tools** - `think` (structured reasoning before hard
|
|
54
|
+
decisions), `verify` (check work after an edit), `finalize` (close a task
|
|
55
|
+
with evidence). These are always-on.
|
|
56
|
+
- **Memory** - `memory_store` / `memory` let the agent persist and recall
|
|
57
|
+
across sessions. Three stores: episodes (what happened), semantic (facts),
|
|
58
|
+
heuristics (procedural rules). The agent uses them automatically.
|
|
59
|
+
- **Scratchpad** - per-session goal/plan/decision tracking that survives
|
|
60
|
+
context compaction.
|
|
61
|
+
- **Context lifecycle** - the agent manages its own context window
|
|
62
|
+
(`context_compress`, `context_navigate`), the same way you'd organize a
|
|
63
|
+
long to-do.
|
|
64
|
+
- **Skills** - `SKILL.md` files the agent reads on demand (a `software-engineer`
|
|
65
|
+
skill defines how it debugs; a `research` skill defines how it researches).
|
|
66
|
+
Skills cost nothing until opened.
|
|
67
|
+
|
|
68
|
+
You don't "use" most of this yourself - the agent does, guided by its system
|
|
69
|
+
prompt and the skill files. Your job is to pick which extensions to enable
|
|
70
|
+
and point the agent at the right docs.
|
|
71
|
+
|
|
72
|
+
## 4. Anatomy of a braid extension
|
|
73
|
+
|
|
74
|
+
An extension is a **factory function** that receives `pi` (the extension API)
|
|
75
|
+
and registers tools / event handlers:
|
|
76
|
+
|
|
77
|
+
```ts
|
|
78
|
+
import type { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
|
|
79
|
+
import { Type } from "typebox";
|
|
80
|
+
|
|
81
|
+
export default function myExtension(pi: ExtensionAPI): void {
|
|
82
|
+
pi.registerTool({
|
|
83
|
+
name: "hello",
|
|
84
|
+
label: "Hello",
|
|
85
|
+
promptSnippet: "Say hello",
|
|
86
|
+
description: "Say hello to the user.",
|
|
87
|
+
parameters: Type.Object({
|
|
88
|
+
who: Type.String({ description: "Who to greet" }),
|
|
89
|
+
}),
|
|
90
|
+
execute: async (_toolCallId: string, params: any) => ({
|
|
91
|
+
content: [{ type: "text" as const, text: `Hello, ${params.who}!` }],
|
|
92
|
+
}),
|
|
93
|
+
} as ToolDefinition<any, any, any>);
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Key points:
|
|
98
|
+
|
|
99
|
+
- **Tool name** must be unique across everything pi loads; `description` is
|
|
100
|
+
what the agent reads to decide whether to call the tool.
|
|
101
|
+
- **Parameters** use TypeBox schemas - pi validates the agent's arguments
|
|
102
|
+
against them.
|
|
103
|
+
- **`execute`** returns a content block. Return `{ content: [{ type: "text",
|
|
104
|
+
text: ... }] }`.
|
|
105
|
+
- The factory can also `pi.on(...)` session events (see
|
|
106
|
+
`packages/core/src/lib/core/event-names.ts`).
|
|
107
|
+
|
|
108
|
+
## 5. Your first extension
|
|
109
|
+
|
|
110
|
+
A runnable example lives at **`examples/minimal-extension/`** - copy it into
|
|
111
|
+
a scratch directory and point pi at it:
|
|
112
|
+
|
|
113
|
+
```jsonc
|
|
114
|
+
// ~/.pi/agent/settings.json — alongside your braid packages
|
|
115
|
+
{
|
|
116
|
+
"packages": ["file:~/pi-braid/packages/core"],
|
|
117
|
+
"extensions": ["file:~/my-extensions/index.ts"],
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Then start pi and ask: _"say hello to the world"_. The agent should call
|
|
122
|
+
your `hello` tool.
|
|
123
|
+
|
|
124
|
+
### Extending braid itself
|
|
125
|
+
|
|
126
|
+
Extensions that belong in braid are added under `packages/core/src/extensions/`
|
|
127
|
+
and registered in `src/extensions/manifest.ts` (the flat list the loader
|
|
128
|
+
reads). Each gets a `module` label for the toggle commands. Follow the layout
|
|
129
|
+
of an existing group (e.g. `src/extensions/cognitive/`) and the contract in
|
|
130
|
+
`packages/core/AGENTS.md`.
|
|
131
|
+
|
|
132
|
+
If your extension is standalone tooling that doesn't belong in core, put it
|
|
133
|
+
in `packages/contrib` (see [`../../contrib/README.md`](../../contrib/README.md)).
|
|
134
|
+
|
|
135
|
+
## 6. Where to go next
|
|
136
|
+
|
|
137
|
+
| Topic | Doc |
|
|
138
|
+
| ----------------------------- | ------------------------------------------------ |
|
|
139
|
+
| Full install + module toggles | [`SETUP.md`](SETUP.md) |
|
|
140
|
+
| Core contributor contract | [`../AGENTS.md`](../AGENTS.md) |
|
|
141
|
+
| Tool catalog (canonical) | [`../TOOLS.md`](../TOOLS.md) |
|
|
142
|
+
| Roadmap + shipped milestones | [`ROADMAP.md`](ROADMAP.md) |
|
|
143
|
+
| Project history | [`HISTORY.md`](HISTORY.md) |
|
|
144
|
+
| Release notes | [`../../../CHANGELOG.md`](../../../CHANGELOG.md) |
|