pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,1004 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Skills Auto-Injection — relevant skill suggestion via steer whisper.
|
|
3
|
+
*
|
|
4
|
+
* Agenda:
|
|
5
|
+
* Instead of requiring the agent to discover skills via `list_skills` tool,
|
|
6
|
+
* proactively detect when a skill is relevant to the current task and inject
|
|
7
|
+
* a suggestion via the steer whisper pattern.
|
|
8
|
+
*
|
|
9
|
+
* Design:
|
|
10
|
+
* 1. Relevance detection: keyword match of skill name/description plus
|
|
11
|
+
* frontmatter trigger phrases against the user's current prompt.
|
|
12
|
+
* Qualification bar: a skill whose match never touches its NAME (name
|
|
13
|
+
* token or trigger phrase) must reach a score of at least
|
|
14
|
+
* MIN_NON_NAME_SCORE — a lone description/path keyword hit is too weak
|
|
15
|
+
* a signal: it fires broad skills on almost any prompt.
|
|
16
|
+
* Keywords are stemmed with one suffix rule (trailing s/es) so plural
|
|
17
|
+
* prompts hit singular name tokens ("skills" → "skill").
|
|
18
|
+
* 2. Session-scoped state: track which skills were injected on which turn.
|
|
19
|
+
* Cooldown is per-skill on top of the global floor: an injected skill
|
|
20
|
+
* cools down at least COOLDOWN_TURNS, and once it was actually loaded
|
|
21
|
+
* (detected read) it cools down LOADED_COOLDOWN_TURNS — re-suggesting
|
|
22
|
+
* a skill that is already in context is noise.
|
|
23
|
+
* 3. Slot management: at most MAX_INJECTED skills hold a slot. A loaded
|
|
24
|
+
* skill releases its slot — it is in the agent's context now. A slot
|
|
25
|
+
* whose skill was never loaded stays held until its entry ages out of
|
|
26
|
+
* the cooldown history: measured over the recorded suggestion corpus,
|
|
27
|
+
* every recycling variant (score-margin eviction, windowed slots, a
|
|
28
|
+
* third slot) admits fills that convert far below the incumbent rate,
|
|
29
|
+
* so the cap deliberately throttles. Injection history is pruned once
|
|
30
|
+
* every cooldown window it can influence has expired.
|
|
31
|
+
* 4. Injection: sendTrackedMessage with deliverAs: "steer", triggerTurn: false,
|
|
32
|
+
* bypassing the per-turn whisper cap. The steer whisper is non-blocking
|
|
33
|
+
* (the agent reads it but does not pause its turn loop). The bypass is
|
|
34
|
+
* the module's delivery guarantee: this whisper is the only channel that
|
|
35
|
+
* can surface a matching skill, it is bounded by the module's own budget
|
|
36
|
+
* (COOLDOWN_TURNS, MAX_INJECTED, one send per turn), and the
|
|
37
|
+
* once-per-session hygiene whisper is delivered earlier in the same
|
|
38
|
+
* before_agent_start at the same priority, so without the bypass the
|
|
39
|
+
* cap would drop the suggestion exactly in the turn where a skill is
|
|
40
|
+
* most likely to match.
|
|
41
|
+
* `sendTrackedMessage` reports whether the message was accepted; a
|
|
42
|
+
* suppressed suggestion is neither sent nor counted.
|
|
43
|
+
* 5. Content delivery: the whisper carries a BOUNDED
|
|
44
|
+
* excerpt of the matching skill's SKILL.md body (frontmatter stripped,
|
|
45
|
+
* ≤ MAX_EXCERPT_CHARS) plus an explicit read pointer to the full file —
|
|
46
|
+
* so skill content actually reaches the agent's view at the moment a
|
|
47
|
+
* domain matches, not just a truncated description. Best-effort: an
|
|
48
|
+
* unreadable file falls back to the description.
|
|
49
|
+
* 6. No reply ritual: the whisper points at the SKILL.md read and stops
|
|
50
|
+
* there — a read is the conversion signal, and the solicited one-line
|
|
51
|
+
* reply is honored 2% of the time (channel noise, not information).
|
|
52
|
+
* 7. Adoption counter: per-skill `suggested`/`loaded` counters,
|
|
53
|
+
* incremented on delivery and on load, surfaced by the `skill_stats`
|
|
54
|
+
* tool. `suggested` counts DELIVERED suggestions: the counter increments
|
|
55
|
+
* only after `sendTrackedMessage` reports the whisper was accepted, so
|
|
56
|
+
* the number measures the suggestion channel rather than the intent to
|
|
57
|
+
* use it. A load has two evidence grades — a verbal claim (the LOADED
|
|
58
|
+
* probe reply, an honor-system grade the whisper does not solicit; the
|
|
59
|
+
* counter stays monotone for the store's series) and a detected actual
|
|
60
|
+
* load (SKILL.md read seen by the tool_result read-detector; failed
|
|
61
|
+
* reads are skipped — an error result is not a load). Both increment
|
|
62
|
+
* `loaded`, so the all-time series stays continuous;
|
|
63
|
+
* `claimed`/`actual` record which trigger fired, and the detected read
|
|
64
|
+
* is the primary signal — sessionHasSkillLoad gates on actual loads
|
|
65
|
+
* only. Durable store rows carry an `epoch` marking which counting
|
|
66
|
+
* regime their `suggested` number mixes (rows written before the
|
|
67
|
+
* delivered-only regime normalize to "mixed": inflated, not comparable
|
|
68
|
+
* to delivered-regime counts), and rows written before the
|
|
69
|
+
* claimed/actual split normalize with actual = loaded, claimed = 0.
|
|
70
|
+
* 8. Discovery record: after a compaction, pi's section rebuild can put
|
|
71
|
+
* the stock skill catalog back into the persisted transcript (braid
|
|
72
|
+
* suppresses it per-turn, but the post-compaction diff runs against
|
|
73
|
+
* pi's own options). The module records whether the catalog is present
|
|
74
|
+
* and surfaces the state through skill_stats instead of mutating the
|
|
75
|
+
* transcript.
|
|
76
|
+
* 9. Best-effort: failures are non-fatal, logged at debug level.
|
|
77
|
+
*
|
|
78
|
+
* Structure matches the existing steer whisper pattern used by topic-drift,
|
|
79
|
+
* turn-outcome, compaction-retry, context-lifecycle, and others.
|
|
80
|
+
*
|
|
81
|
+
* Integration:
|
|
82
|
+
* Registered in skills-tool/index.ts extension factory.
|
|
83
|
+
* Consumes the module-level skill cache populated by prompt-builder's
|
|
84
|
+
* before_agent_start handler.
|
|
85
|
+
*/
|
|
86
|
+
|
|
87
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
88
|
+
import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
|
|
89
|
+
import { dirname } from "node:path";
|
|
90
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
91
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
92
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
93
|
+
import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
|
|
94
|
+
import { getSkillsUsageFilePath } from "../../../lib/config/braid-paths.js";
|
|
95
|
+
import { SESSION_COMPACT, AGENT_SETTLED } from "../../../lib/core/event-names.js";
|
|
96
|
+
import {
|
|
97
|
+
getSessionProfile,
|
|
98
|
+
recordSessionSkillLoad,
|
|
99
|
+
recordSessionStart,
|
|
100
|
+
} from "./session-records.js";
|
|
101
|
+
import { triggerMatches } from "./skill-triggers.js";
|
|
102
|
+
|
|
103
|
+
const log = createLogger("skills-auto-inject");
|
|
104
|
+
|
|
105
|
+
// Constants
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Max skill suggestions holding a slot at any time.
|
|
109
|
+
*
|
|
110
|
+
* The cap is the channel's throttle, and measurement says it must stay 2: a
|
|
111
|
+
* third slot's fills convert far below the incumbent rate, and every
|
|
112
|
+
* eviction/recycling variant that frees slots admits fills no better — the
|
|
113
|
+
* loads a bigger cap would "recover" were outranked by other live matches,
|
|
114
|
+
* not starved of slots.
|
|
115
|
+
*/
|
|
116
|
+
export const MAX_INJECTED = 2;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Global cooldown floor: minimum turns before ANY skill can be re-injected.
|
|
120
|
+
* Every injected skill cools down at least this long, whatever its own history.
|
|
121
|
+
*/
|
|
122
|
+
export const COOLDOWN_TURNS = 10;
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* Per-skill cooldown extension: a suggested skill that was actually loaded
|
|
126
|
+
* sits in the agent's context, so after its load it cools down for
|
|
127
|
+
* LOADED_COOLDOWN_TURNS (3× the floor) and releases its suggestion slot for
|
|
128
|
+
* the next match — re-suggesting an in-context skill is noise.
|
|
129
|
+
*/
|
|
130
|
+
export const LOADED_COOLDOWN_TURNS = 30;
|
|
131
|
+
|
|
132
|
+
/** Minimum keyword length to consider significant. */
|
|
133
|
+
const MIN_KEYWORD_LENGTH = 4;
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Max characters of SKILL.md body content carried in a suggestion whisper,
|
|
137
|
+
* per skill. Bounded so the steer stays a whisper (~2 skills × 300 chars +
|
|
138
|
+
* boilerplate). The whisper always points at the full file for the rest.
|
|
139
|
+
*/
|
|
140
|
+
export const MAX_EXCERPT_CHARS = 300;
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* Minimum score for a skill whose match never touches its NAME (description
|
|
144
|
+
* and/or filePath keyword hits only). Name matches qualify at any score.
|
|
145
|
+
*/
|
|
146
|
+
export const MIN_NON_NAME_SCORE = 2;
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* Common English words to exclude from keyword matching.
|
|
150
|
+
* Kept small — only the most frequent noise words that would
|
|
151
|
+
* produce false positives across many skills.
|
|
152
|
+
*
|
|
153
|
+
* NOT the same set as lib/ai/critic-helpers.ts STOP_WORDS:
|
|
154
|
+
* that list is a grammatical/text-normalization stop list for similarity
|
|
155
|
+
* scoring; this one additionally filters domain noise words (work, tool,
|
|
156
|
+
* code, file, task) for skill keyword extraction and deliberately omits
|
|
157
|
+
* most function words (keyword matching needs them rare-but-meaningful).
|
|
158
|
+
* Different sets with different jobs — deliberately not merged.
|
|
159
|
+
*/
|
|
160
|
+
const KEYWORD_STOP_WORDS = new Set([
|
|
161
|
+
"this",
|
|
162
|
+
"that",
|
|
163
|
+
"with",
|
|
164
|
+
"from",
|
|
165
|
+
"have",
|
|
166
|
+
"been",
|
|
167
|
+
"were",
|
|
168
|
+
"they",
|
|
169
|
+
"what",
|
|
170
|
+
"when",
|
|
171
|
+
"where",
|
|
172
|
+
"which",
|
|
173
|
+
"about",
|
|
174
|
+
"into",
|
|
175
|
+
"than",
|
|
176
|
+
"then",
|
|
177
|
+
"also",
|
|
178
|
+
"just",
|
|
179
|
+
"some",
|
|
180
|
+
"more",
|
|
181
|
+
"make",
|
|
182
|
+
"like",
|
|
183
|
+
"know",
|
|
184
|
+
"will",
|
|
185
|
+
"would",
|
|
186
|
+
"could",
|
|
187
|
+
"should",
|
|
188
|
+
"their",
|
|
189
|
+
"them",
|
|
190
|
+
"very",
|
|
191
|
+
"your",
|
|
192
|
+
"over",
|
|
193
|
+
"such",
|
|
194
|
+
"each",
|
|
195
|
+
"only",
|
|
196
|
+
"other",
|
|
197
|
+
"after",
|
|
198
|
+
"before",
|
|
199
|
+
"work",
|
|
200
|
+
"tool",
|
|
201
|
+
"code",
|
|
202
|
+
"file",
|
|
203
|
+
"task",
|
|
204
|
+
"need",
|
|
205
|
+
"look",
|
|
206
|
+
]);
|
|
207
|
+
|
|
208
|
+
// State
|
|
209
|
+
|
|
210
|
+
export interface InjectedSkill {
|
|
211
|
+
name: string;
|
|
212
|
+
turnNumber: number;
|
|
213
|
+
filePath: string;
|
|
214
|
+
/** Turn the skill was detected loaded after injection; releases the slot, extends the cooldown. */
|
|
215
|
+
loadedTurn?: number;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
interface AutoInjectState {
|
|
219
|
+
/** Skills injected this session, ordered by injection time (oldest first). */
|
|
220
|
+
injected: InjectedSkill[];
|
|
221
|
+
/** Turn counter, incremented every before_agent_start. */
|
|
222
|
+
currentTurn: number;
|
|
223
|
+
/** True once the once-per-session profile hint whisper fired. */
|
|
224
|
+
hintSent: boolean;
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
const STATE_KEY = "skills-auto-inject";
|
|
228
|
+
|
|
229
|
+
function getState(ctx: ExtensionContext): AutoInjectState {
|
|
230
|
+
return getExtensionState(ctx, STATE_KEY, () => ({
|
|
231
|
+
injected: [],
|
|
232
|
+
currentTurn: 0,
|
|
233
|
+
hintSent: false,
|
|
234
|
+
}));
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
// Cached skills access
|
|
238
|
+
// Populated by prompt-builder's before_agent_start via setCachedSkills().
|
|
239
|
+
// We import the module-level cache from index.ts (the setter is already
|
|
240
|
+
// exported; we add an export for the getter).
|
|
241
|
+
|
|
242
|
+
export interface CachedSkill {
|
|
243
|
+
name: string;
|
|
244
|
+
filePath: string;
|
|
245
|
+
description: string;
|
|
246
|
+
baseDir: string;
|
|
247
|
+
sourceInfo?: { source?: string; package?: string };
|
|
248
|
+
/** pi frontmatter flag: excluded from model selection (explicit invocation only). */
|
|
249
|
+
disableModelInvocation?: boolean;
|
|
250
|
+
/** Frontmatter trigger phrases (setCachedSkills resolves them from SKILL.md). */
|
|
251
|
+
triggers?: string[];
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
// Shared module-level variable rather than a per-module copy: the import
|
|
255
|
+
// cycle is safe — index.ts calls setCachedSkills, auto-inject reads
|
|
256
|
+
// getCachedSkills.
|
|
257
|
+
let _skillsCache: CachedSkill[] = [];
|
|
258
|
+
|
|
259
|
+
/** Called by index.ts's setCachedSkills to keep the auto-inject cache in sync. */
|
|
260
|
+
export function updateSkillCache(skills: CachedSkill[]): void {
|
|
261
|
+
_skillsCache = skills;
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
// Keyword Extraction
|
|
265
|
+
|
|
266
|
+
/**
|
|
267
|
+
* One-rule stemmer: strip a trailing plural s/es so "skills" matches the
|
|
268
|
+
* "skill" name token. Kept deliberately crude — one suffix rule, no
|
|
269
|
+
* dictionary — because the matcher needs recall on plurals, not linguistics:
|
|
270
|
+
* "sses"/"xes"/"zes"/"ches"/"shes" → strip es (classes→class, boxes→box)
|
|
271
|
+
* other trailing s (not ss) → strip s (skills→skill, memes→meme)
|
|
272
|
+
* Everything else passes through unchanged.
|
|
273
|
+
*/
|
|
274
|
+
export function stemKeyword(word: string): string {
|
|
275
|
+
if (/sses$/.test(word) || /(?:x|z|ch|sh)es$/.test(word)) return word.slice(0, -2);
|
|
276
|
+
if (word.endsWith("s") && !word.endsWith("ss")) return word.slice(0, -1);
|
|
277
|
+
return word;
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* Extract significant keywords from a text string.
|
|
282
|
+
* Filters out stop words, short words, and non-alphabetic tokens, then stems
|
|
283
|
+
* trailing plurals; the stem result must still pass the length and stop-word
|
|
284
|
+
* bar (stemming "tasks" lands on the noise word "task", which stays out).
|
|
285
|
+
*/
|
|
286
|
+
export function extractKeywords(text: string): string[] {
|
|
287
|
+
const words = text
|
|
288
|
+
.toLowerCase()
|
|
289
|
+
.split(/[^a-z0-9]+/)
|
|
290
|
+
.filter((w) => w.length >= MIN_KEYWORD_LENGTH && !KEYWORD_STOP_WORDS.has(w) && /[a-z]/.test(w))
|
|
291
|
+
.map(stemKeyword)
|
|
292
|
+
.filter((w) => w.length >= MIN_KEYWORD_LENGTH && !KEYWORD_STOP_WORDS.has(w));
|
|
293
|
+
|
|
294
|
+
return [...new Set(words)];
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
// Relevance Scoring
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* Score a skill against a set of keywords.
|
|
301
|
+
*
|
|
302
|
+
* Scoring rules:
|
|
303
|
+
* +3 skill name contains a keyword (exact match)
|
|
304
|
+
* +2 skill name contains a keyword as substring
|
|
305
|
+
* +2 a frontmatter trigger phrase occurs in the prompt (word-bounded)
|
|
306
|
+
* +1 skill description contains a keyword
|
|
307
|
+
* +1 skill filePath contains a keyword (e.g. "research" in "research/SKILL.md")
|
|
308
|
+
*
|
|
309
|
+
* A trigger hit counts as a name hit: the phrase is the skill author's own
|
|
310
|
+
* relevance signal, so it qualifies the skill the same way a name match does.
|
|
311
|
+
*
|
|
312
|
+
* Qualification bar: a skill whose match never touches its NAME (description
|
|
313
|
+
* and/or filePath hits only) must reach a total score of at least
|
|
314
|
+
* MIN_NON_NAME_SCORE — one description keyword is too weak a signal and
|
|
315
|
+
* lets generic skills fire on almost any prompt. Name and trigger matches
|
|
316
|
+
* always qualify.
|
|
317
|
+
*
|
|
318
|
+
* `promptText` (lowercased by the caller or raw — matching is case-insensitive
|
|
319
|
+
* on our side) enables trigger matching; omit it where the raw prompt is not
|
|
320
|
+
* available and only keyword scoring should run.
|
|
321
|
+
*
|
|
322
|
+
* Returns 0 if the skill does not qualify.
|
|
323
|
+
*/
|
|
324
|
+
export function scoreSkill(skill: CachedSkill, keywords: string[], promptText?: string): number {
|
|
325
|
+
let score = 0;
|
|
326
|
+
let nameHit = false;
|
|
327
|
+
const name = skill.name.toLowerCase();
|
|
328
|
+
const desc = skill.description.toLowerCase();
|
|
329
|
+
const path = skill.filePath.toLowerCase();
|
|
330
|
+
|
|
331
|
+
for (const trig of skill.triggers ?? []) {
|
|
332
|
+
if (triggerMatches(trig, promptText ?? "")) {
|
|
333
|
+
score += 2;
|
|
334
|
+
nameHit = true;
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
for (const kw of keywords) {
|
|
339
|
+
// Exact token match in name
|
|
340
|
+
if (name.split(/[^a-z0-9]+/).includes(kw)) {
|
|
341
|
+
score += 3;
|
|
342
|
+
nameHit = true;
|
|
343
|
+
continue;
|
|
344
|
+
}
|
|
345
|
+
// Substring match in name (catches compound names like "code-search")
|
|
346
|
+
if (name.includes(kw)) {
|
|
347
|
+
score += 2;
|
|
348
|
+
nameHit = true;
|
|
349
|
+
continue;
|
|
350
|
+
}
|
|
351
|
+
// Description contains keyword
|
|
352
|
+
if (desc.includes(kw)) {
|
|
353
|
+
score += 1;
|
|
354
|
+
continue;
|
|
355
|
+
}
|
|
356
|
+
// File path matches (e.g. "research" in "research/SKILL.md")
|
|
357
|
+
if (path.includes(kw)) {
|
|
358
|
+
score += 1;
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
if (!nameHit && score < MIN_NON_NAME_SCORE) return 0;
|
|
363
|
+
return score;
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/**
|
|
367
|
+
* Decide which scored skills to suggest given the session injection state.
|
|
368
|
+
* Pure — mirrors the handler's decision path so it can be unit-tested:
|
|
369
|
+
* sort (score desc, name asc) → cooldown filter (global floor + per-skill
|
|
370
|
+
* loaded extension) → slot budget over ACTIVE held slots (a loaded skill
|
|
371
|
+
* released its slot) → top-N slice.
|
|
372
|
+
*
|
|
373
|
+
* Returns the chosen scored items (empty when nothing qualifies). The
|
|
374
|
+
* caller is responsible for recording the picks in session state.
|
|
375
|
+
*/
|
|
376
|
+
export function selectSuggestions(
|
|
377
|
+
scored: Array<{ skill: CachedSkill; score: number }>,
|
|
378
|
+
injected: InjectedSkill[],
|
|
379
|
+
currentTurn: number,
|
|
380
|
+
): Array<{ skill: CachedSkill; score: number }> {
|
|
381
|
+
if (!scored.length) return [];
|
|
382
|
+
|
|
383
|
+
const sorted = [...scored].sort(
|
|
384
|
+
(a, b) => b.score - a.score || a.skill.name.localeCompare(b.skill.name),
|
|
385
|
+
);
|
|
386
|
+
|
|
387
|
+
const available = sorted.filter((s) => !onCooldown(s.skill.name, injected, currentTurn));
|
|
388
|
+
if (!available.length) return [];
|
|
389
|
+
|
|
390
|
+
// Active slots: not-yet-loaded injections. A loaded skill sits in the
|
|
391
|
+
// agent's context — its slot is released for the next match.
|
|
392
|
+
const active = injected.filter((i) => i.loadedTurn === undefined);
|
|
393
|
+
const slotBudget = MAX_INJECTED - active.length;
|
|
394
|
+
if (slotBudget <= 0) return [];
|
|
395
|
+
|
|
396
|
+
return available.slice(0, slotBudget);
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
/**
|
|
400
|
+
* Cooldown gate: the global floor applies to every injection; a skill that
|
|
401
|
+
* was loaded after its injection additionally cools down for
|
|
402
|
+
* LOADED_COOLDOWN_TURNS from the load (it is already in context).
|
|
403
|
+
*/
|
|
404
|
+
function onCooldown(name: string, injected: InjectedSkill[], currentTurn: number): boolean {
|
|
405
|
+
const prev = injected.find((i) => i.name === name);
|
|
406
|
+
if (!prev) return false;
|
|
407
|
+
if (currentTurn - prev.turnNumber < COOLDOWN_TURNS) return true;
|
|
408
|
+
if (prev.loadedTurn !== undefined && currentTurn - prev.loadedTurn < LOADED_COOLDOWN_TURNS) {
|
|
409
|
+
return true;
|
|
410
|
+
}
|
|
411
|
+
return false;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
// Steer Whisper Content
|
|
415
|
+
|
|
416
|
+
/**
|
|
417
|
+
* Strip YAML frontmatter from a SKILL.md body. Pure.
|
|
418
|
+
*
|
|
419
|
+
* Agent Skills files open with `---\nkey: value...\n---`; the frontmatter
|
|
420
|
+
* duplicates the metadata we already have (name/description), so the excerpt
|
|
421
|
+
* starts at the actual instructions. Tolerant: files without frontmatter
|
|
422
|
+
* (or with an unclosed `---` block) are returned as-is.
|
|
423
|
+
*/
|
|
424
|
+
export function stripSkillFrontmatter(content: string): string {
|
|
425
|
+
const text = content.replace(/^\uFEFF/, "");
|
|
426
|
+
if (!text.startsWith("---")) return text;
|
|
427
|
+
const lines = text.split(/\r?\n/);
|
|
428
|
+
if (lines.length < 3) return text;
|
|
429
|
+
for (let i = 1; i < lines.length; i++) {
|
|
430
|
+
if (lines[i].trim() === "---") {
|
|
431
|
+
return lines
|
|
432
|
+
.slice(i + 1)
|
|
433
|
+
.join("\n")
|
|
434
|
+
.trim();
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
return text; // no closing delimiter — treat the whole doc as body
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
/**
|
|
441
|
+
* Bounded excerpt of a skill body: strip frontmatter, trim, cap at maxChars,
|
|
442
|
+
* mark truncation. Pure.
|
|
443
|
+
*/
|
|
444
|
+
export function extractSkillExcerpt(content: string, maxChars: number = MAX_EXCERPT_CHARS): string {
|
|
445
|
+
const body = stripSkillFrontmatter(content).trim();
|
|
446
|
+
if (body.length <= maxChars) return body;
|
|
447
|
+
const cut = body.slice(0, maxChars);
|
|
448
|
+
// Cut at a word boundary when possible; always collapse trailing whitespace.
|
|
449
|
+
const boundary = cut.lastIndexOf(" ");
|
|
450
|
+
const slice = (boundary > maxChars * 0.6 ? cut.slice(0, boundary) : cut).trimEnd();
|
|
451
|
+
return slice + "…";
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
/**
|
|
455
|
+
* Read a SKILL.md from disk and return a bounded body excerpt.
|
|
456
|
+
* Returns "" on any error (missing file, unreadable) — the caller falls
|
|
457
|
+
* back to the skill description.
|
|
458
|
+
*/
|
|
459
|
+
export function readSkillExcerpt(filePath: string, maxChars: number = MAX_EXCERPT_CHARS): string {
|
|
460
|
+
try {
|
|
461
|
+
return extractSkillExcerpt(readFileSync(filePath, "utf-8"), maxChars);
|
|
462
|
+
} catch {
|
|
463
|
+
return "";
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
|
|
467
|
+
/** Collapse whitespace/newlines to single spaces for a one-line whisper bullet. */
|
|
468
|
+
function toOneLine(text: string): string {
|
|
469
|
+
return text.replace(/\s+/g, " ").trim();
|
|
470
|
+
}
|
|
471
|
+
|
|
472
|
+
/**
|
|
473
|
+
* Format the steer whisper content for a set of recommended skills.
|
|
474
|
+
*
|
|
475
|
+
* Each bullet carries a BOUNDED excerpt of the SKILL.md body (frontmatter
|
|
476
|
+
* stripped, ≤ MAX_EXCERPT_CHARS, collapsed to one line) plus an explicit
|
|
477
|
+
* read pointer to the full file — the agent sees real skill content at the
|
|
478
|
+
* moment of domain match, not just a truncated description. Unreadable
|
|
479
|
+
* files fall back to the description (also bounded, one line).
|
|
480
|
+
*/
|
|
481
|
+
export function formatWhisper(skills: CachedSkill[]): string {
|
|
482
|
+
const lines = skills.map((s) => {
|
|
483
|
+
const excerpt = readSkillExcerpt(s.filePath) || s.description;
|
|
484
|
+
// Strip the truncation mark (if any) — the read pointer follows immediately.
|
|
485
|
+
const lead = toOneLine(excerpt)
|
|
486
|
+
.slice(0, MAX_EXCERPT_CHARS)
|
|
487
|
+
.replace(/\.\.\.$/, "")
|
|
488
|
+
.replace(/…$/, "");
|
|
489
|
+
return `- ${s.name}: ${lead} — read \`${s.filePath}\` for the full skill.`;
|
|
490
|
+
});
|
|
491
|
+
return (
|
|
492
|
+
`[SKILL SUGGESTION] These skills match your current task; their content is excerpted below:\n` +
|
|
493
|
+
lines.join("\n") +
|
|
494
|
+
`\n(Use \`list_skills\` to see all available skills; read a SKILL.md file for full context.)`
|
|
495
|
+
);
|
|
496
|
+
}
|
|
497
|
+
|
|
498
|
+
// Adoption counters
|
|
499
|
+
|
|
500
|
+
/** Per-skill usage counters, session-scoped (a durable cross-session copy is mirrored below). */
|
|
501
|
+
export interface SkillStats {
|
|
502
|
+
/** Times this skill was suggested via the auto-inject whisper. */
|
|
503
|
+
suggested: number;
|
|
504
|
+
/** Total loads: probe claims plus detected SKILL.md reads. */
|
|
505
|
+
loaded: number;
|
|
506
|
+
/** Loads claimed verbally via the LOADED probe reply (honor system). */
|
|
507
|
+
claimed: number;
|
|
508
|
+
/** Loads detected by the read tool (SKILL.md read via tool_result). */
|
|
509
|
+
actual: number;
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
const STATS_KEY = "skills-usage-stats";
|
|
513
|
+
|
|
514
|
+
function getStats(ctx: ExtensionContext): Record<string, SkillStats> {
|
|
515
|
+
return getExtensionState(ctx, STATS_KEY, () => ({}));
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
/** Read the session's per-skill usage counters (for the skill_stats tool). */
|
|
519
|
+
export function getSkillStats(ctx: ExtensionContext): Record<string, SkillStats> {
|
|
520
|
+
return getStats(ctx);
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
/** Increment `suggested` for each skill name — called only AFTER a whisper
|
|
524
|
+
* was accepted for delivery, so the counter measures arrivals. */
|
|
525
|
+
export function recordSkillSuggestion(ctx: ExtensionContext, names: string[]): void {
|
|
526
|
+
const stats = getStats(ctx);
|
|
527
|
+
for (const name of names) {
|
|
528
|
+
const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
|
|
529
|
+
s.suggested++;
|
|
530
|
+
recordDurable(name, "suggested");
|
|
531
|
+
}
|
|
532
|
+
}
|
|
533
|
+
|
|
534
|
+
/**
|
|
535
|
+
* Record a DETECTED load (SKILL.md read via the read tool) — the primary,
|
|
536
|
+
* verified load signal. Increments `loaded` + `actual`, and flips the
|
|
537
|
+
* session's durable adoption record to hadSkillLoad (the monthly rollup
|
|
538
|
+
* numerator; claims never set it).
|
|
539
|
+
*/
|
|
540
|
+
export function recordSkillLoad(ctx: ExtensionContext, name: string): void {
|
|
541
|
+
if (!name) return;
|
|
542
|
+
const stats = getStats(ctx);
|
|
543
|
+
const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
|
|
544
|
+
s.loaded++;
|
|
545
|
+
s.actual++;
|
|
546
|
+
recordDurable(name, "actual");
|
|
547
|
+
recordSessionSkillLoad(ctx);
|
|
548
|
+
}
|
|
549
|
+
|
|
550
|
+
/**
|
|
551
|
+
* Record a CLAIMED load (a verbal "LOADED <name>" reply — the honor-system
|
|
552
|
+
* signal). The suggestion whisper does not solicit the reply, so this has no
|
|
553
|
+
* production caller; the export exists to keep `claimed` monotone in the
|
|
554
|
+
* durable store's published series. Increments `loaded` + `claimed`.
|
|
555
|
+
*/
|
|
556
|
+
export function recordSkillClaim(ctx: ExtensionContext, name: string): void {
|
|
557
|
+
if (!name) return;
|
|
558
|
+
const stats = getStats(ctx);
|
|
559
|
+
const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
|
|
560
|
+
s.loaded++;
|
|
561
|
+
s.claimed++;
|
|
562
|
+
recordDurable(name, "claim");
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
// Durable adoption counters (cross-session)
|
|
566
|
+
|
|
567
|
+
/**
|
|
568
|
+
* Which counting regime produced an entry's `suggested` number:
|
|
569
|
+
* "delivered" — every increment counted a whisper ACCEPTED for delivery
|
|
570
|
+
* (the only regime current code writes).
|
|
571
|
+
* "mixed" — the row predates the epoch split and may contain
|
|
572
|
+
* increments counted before delivery acceptance (inflated).
|
|
573
|
+
* A mixed row stays mixed when new increments land on it: the inflation
|
|
574
|
+
* cannot be split out of the counter, so the epoch never silently improves.
|
|
575
|
+
*/
|
|
576
|
+
export type SuggestedEpoch = "delivered" | "mixed";
|
|
577
|
+
|
|
578
|
+
/**
|
|
579
|
+
* Per-skill durable counters, persisted to getSkillsUsageFilePath() so the
|
|
580
|
+
* adoption baseline survives process restart. Unlike the session-scoped state
|
|
581
|
+
* above, this is process-global BY DESIGN (cross-session telemetry, disk-backed)
|
|
582
|
+
* — the same exception class as `_skillsCache` above: the value must be
|
|
583
|
+
* reachable from whisper-path code with no ctx threading, and the file is the
|
|
584
|
+
* source of truth, not the cache.
|
|
585
|
+
*/
|
|
586
|
+
export interface DurableSkillStats {
|
|
587
|
+
/** All-time suggestion count (see `epoch` for which regime it mixes). */
|
|
588
|
+
suggested: number;
|
|
589
|
+
/** All-time load count (claims + detected reads). */
|
|
590
|
+
loaded: number;
|
|
591
|
+
/** All-time count of verbally claimed loads (LOADED probe reply). */
|
|
592
|
+
claimed: number;
|
|
593
|
+
/** All-time count of detected loads (SKILL.md read via the read tool). */
|
|
594
|
+
actual: number;
|
|
595
|
+
/** ISO timestamp of the most recent recorded event. */
|
|
596
|
+
lastAt: string;
|
|
597
|
+
/** Which counting regime `suggested` mixes (see SuggestedEpoch). */
|
|
598
|
+
epoch: SuggestedEpoch;
|
|
599
|
+
}
|
|
600
|
+
|
|
601
|
+
let _durableStore: Record<string, DurableSkillStats> | undefined;
|
|
602
|
+
|
|
603
|
+
/** Normalize one raw file entry; undefined when the entry is not usable. */
|
|
604
|
+
function normalizeDurableEntry(raw: unknown): DurableSkillStats | undefined {
|
|
605
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) return undefined;
|
|
606
|
+
const r = raw as Record<string, unknown>;
|
|
607
|
+
const suggested =
|
|
608
|
+
typeof r.suggested === "number" && Number.isFinite(r.suggested) ? r.suggested : 0;
|
|
609
|
+
const loaded = typeof r.loaded === "number" && Number.isFinite(r.loaded) ? r.loaded : 0;
|
|
610
|
+
const claimed = typeof r.claimed === "number" && Number.isFinite(r.claimed) ? r.claimed : 0;
|
|
611
|
+
// Rows written before the claimed/actual split carry only `loaded`:
|
|
612
|
+
// treat the whole count as actual (claimed 0) — no migration needed.
|
|
613
|
+
const actual =
|
|
614
|
+
typeof r.actual === "number" && Number.isFinite(r.actual)
|
|
615
|
+
? r.actual
|
|
616
|
+
: Math.max(0, loaded - claimed);
|
|
617
|
+
return {
|
|
618
|
+
suggested,
|
|
619
|
+
loaded,
|
|
620
|
+
claimed,
|
|
621
|
+
actual,
|
|
622
|
+
lastAt: typeof r.lastAt === "string" ? r.lastAt : "",
|
|
623
|
+
// Rows without an epoch predate the split: their `suggested` may mix
|
|
624
|
+
// pre-delivery-regime increments with delivered ones.
|
|
625
|
+
epoch: r.epoch === "delivered" ? "delivered" : "mixed",
|
|
626
|
+
};
|
|
627
|
+
}
|
|
628
|
+
|
|
629
|
+
/**
|
|
630
|
+
* Read the durable store from disk. Missing OR corrupt file → fresh start
|
|
631
|
+
* ({}). Never throws: the suggestion path depends on this staying safe.
|
|
632
|
+
*/
|
|
633
|
+
function readDurableStore(): Record<string, DurableSkillStats> {
|
|
634
|
+
try {
|
|
635
|
+
const parsed: unknown = JSON.parse(readFileSync(getSkillsUsageFilePath(), "utf-8"));
|
|
636
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
|
|
637
|
+
const out: Record<string, DurableSkillStats> = {};
|
|
638
|
+
for (const [name, entry] of Object.entries(parsed as Record<string, unknown>)) {
|
|
639
|
+
const normalized = normalizeDurableEntry(entry);
|
|
640
|
+
if (normalized) out[name] = normalized;
|
|
641
|
+
}
|
|
642
|
+
return out;
|
|
643
|
+
} catch {
|
|
644
|
+
return {}; // missing or corrupt → fresh start
|
|
645
|
+
}
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
/** In-memory durable store, lazily loaded once per process. */
|
|
649
|
+
function getDurableStore(): Record<string, DurableSkillStats> {
|
|
650
|
+
if (!_durableStore) _durableStore = readDurableStore();
|
|
651
|
+
return _durableStore;
|
|
652
|
+
}
|
|
653
|
+
|
|
654
|
+
/**
|
|
655
|
+
* Best-effort atomic-ish write (temp file + rename) of the durable store.
|
|
656
|
+
* Swallows every error: this runs on the whisper path — a stats failure must
|
|
657
|
+
* NEVER break suggestions. The first refusal in a process still warns (the
|
|
658
|
+
* sink may be refusing because no absolute braid root resolves); later ones
|
|
659
|
+
* stay at debug.
|
|
660
|
+
*/
|
|
661
|
+
function persistDurableStore(): void {
|
|
662
|
+
try {
|
|
663
|
+
if (!_durableStore) return;
|
|
664
|
+
const file = getSkillsUsageFilePath();
|
|
665
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
666
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
667
|
+
writeFileSync(tmp, JSON.stringify(_durableStore, null, 2));
|
|
668
|
+
renameSync(tmp, file);
|
|
669
|
+
} catch (err) {
|
|
670
|
+
reportDurableFailure("write", err);
|
|
671
|
+
}
|
|
672
|
+
}
|
|
673
|
+
|
|
674
|
+
/** Warned once per process about a refused durable skills store. */
|
|
675
|
+
let _warnedDurableFailure = false;
|
|
676
|
+
|
|
677
|
+
function reportDurableFailure(action: string, err: unknown): void {
|
|
678
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
679
|
+
if (_warnedDurableFailure) {
|
|
680
|
+
log.debug(`[skills-auto-inject] durable stats ${action} failed (best-effort): ${message}`);
|
|
681
|
+
return;
|
|
682
|
+
}
|
|
683
|
+
_warnedDurableFailure = true;
|
|
684
|
+
log.warn(`[skills-auto-inject] durable stats ${action} failed (best-effort): ${message}`);
|
|
685
|
+
}
|
|
686
|
+
|
|
687
|
+
/** Record one durable event and flush to disk (best-effort). */
|
|
688
|
+
function recordDurable(name: string, kind: "suggested" | "claim" | "actual"): void {
|
|
689
|
+
try {
|
|
690
|
+
const store = getDurableStore();
|
|
691
|
+
const entry = (store[name] ??= {
|
|
692
|
+
suggested: 0,
|
|
693
|
+
loaded: 0,
|
|
694
|
+
claimed: 0,
|
|
695
|
+
actual: 0,
|
|
696
|
+
lastAt: "",
|
|
697
|
+
epoch: "delivered",
|
|
698
|
+
});
|
|
699
|
+
if (kind === "suggested") {
|
|
700
|
+
entry.suggested++;
|
|
701
|
+
} else {
|
|
702
|
+
entry.loaded++;
|
|
703
|
+
if (kind === "claim") entry.claimed++;
|
|
704
|
+
else entry.actual++;
|
|
705
|
+
}
|
|
706
|
+
entry.lastAt = new Date().toISOString();
|
|
707
|
+
persistDurableStore();
|
|
708
|
+
} catch (err) {
|
|
709
|
+
reportDurableFailure("update", err);
|
|
710
|
+
}
|
|
711
|
+
}
|
|
712
|
+
|
|
713
|
+
/** Read the durable per-skill counters (for the skill_stats tool). */
|
|
714
|
+
export function getDurableSkillStats(): Record<string, DurableSkillStats> {
|
|
715
|
+
return getDurableStore();
|
|
716
|
+
}
|
|
717
|
+
|
|
718
|
+
/**
|
|
719
|
+
* Resolve a skill name from a read-tool result: the SKILL.md frontmatter
|
|
720
|
+
* signature (`---\nname: <name>`) first, then the file path against the
|
|
721
|
+
* cached catalog. Returns undefined when the read is not a skill load.
|
|
722
|
+
*
|
|
723
|
+
* Exported for the read-detector tests (the list→read load path): the
|
|
724
|
+
* function is pure given the module-level cache, which tests seed via
|
|
725
|
+
* updateSkillCache().
|
|
726
|
+
*/
|
|
727
|
+
export function skillNameFromRead(filePath: string | undefined, text: string): string | undefined {
|
|
728
|
+
const fm = text.match(/^\s*---\s*\r?\n\s*name:\s*([^\s]+)/);
|
|
729
|
+
if (fm) return fm[1];
|
|
730
|
+
if (filePath) {
|
|
731
|
+
const hit = _skillsCache.find((s) => s.filePath === filePath);
|
|
732
|
+
if (hit) return hit.name;
|
|
733
|
+
const base = filePath.split(/[\\/]/).pop() ?? "";
|
|
734
|
+
if (base === "SKILL.md") {
|
|
735
|
+
const dir = filePath.split(/[\\/]/).slice(-2, -1)[0] ?? "";
|
|
736
|
+
const byDir = _skillsCache.find((s) => s.name === dir);
|
|
737
|
+
if (byDir) return byDir.name;
|
|
738
|
+
}
|
|
739
|
+
}
|
|
740
|
+
return undefined;
|
|
741
|
+
}
|
|
742
|
+
|
|
743
|
+
// Discovery-mode record (post-compaction catalog re-entry)
|
|
744
|
+
|
|
745
|
+
/** Session-scoped record of the discovery surface's state. */
|
|
746
|
+
interface DiscoveryState {
|
|
747
|
+
/** Successful compactions seen this session. */
|
|
748
|
+
compactions: number;
|
|
749
|
+
/** A compaction landed since the last transcript check. */
|
|
750
|
+
pendingCatalogCheck: boolean;
|
|
751
|
+
/** Reason of the most recent compaction (manual / threshold / overflow). */
|
|
752
|
+
lastCompactionReason?: string;
|
|
753
|
+
/** Result of the last transcript check. */
|
|
754
|
+
stockCatalogSeen?: boolean;
|
|
755
|
+
/** ISO timestamp of the last transcript check. */
|
|
756
|
+
checkedAt?: string;
|
|
757
|
+
}
|
|
758
|
+
|
|
759
|
+
const DISCOVERY_STATE_KEY = "skills-discovery";
|
|
760
|
+
|
|
761
|
+
/** The stock catalog's own tag — braid never writes this section itself. */
|
|
762
|
+
const STOCK_SKILLS_MARKER = "<available_skills>";
|
|
763
|
+
|
|
764
|
+
function getDiscoveryState(ctx: ExtensionContext): DiscoveryState {
|
|
765
|
+
return getExtensionState(ctx, DISCOVERY_STATE_KEY, () => ({
|
|
766
|
+
compactions: 0,
|
|
767
|
+
pendingCatalogCheck: false,
|
|
768
|
+
}));
|
|
769
|
+
}
|
|
770
|
+
|
|
771
|
+
/** True when a persisted system message carries pi's stock skill catalog. */
|
|
772
|
+
function transcriptHasStockCatalog(ctx: ExtensionContext): boolean {
|
|
773
|
+
const entries = ctx.sessionManager?.getEntries?.() ?? [];
|
|
774
|
+
return entries.some((entry) => {
|
|
775
|
+
const msg = (entry as { message?: { role?: string; sections?: Record<string, unknown> } })
|
|
776
|
+
?.message;
|
|
777
|
+
if (msg?.role !== "system" || typeof msg.sections?.skills !== "string") return false;
|
|
778
|
+
return (msg.sections.skills as string).includes(STOCK_SKILLS_MARKER);
|
|
779
|
+
});
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
/**
|
|
783
|
+
* Run the pending transcript check (one per compaction) and record the
|
|
784
|
+
* discovery mode. Returns the current record for skill_stats.
|
|
785
|
+
*/
|
|
786
|
+
export function resolveDiscoveryMode(ctx: ExtensionContext): DiscoveryState {
|
|
787
|
+
const state = getDiscoveryState(ctx);
|
|
788
|
+
if (state.pendingCatalogCheck) {
|
|
789
|
+
state.pendingCatalogCheck = false;
|
|
790
|
+
state.stockCatalogSeen = transcriptHasStockCatalog(ctx);
|
|
791
|
+
state.checkedAt = new Date().toISOString();
|
|
792
|
+
if (state.stockCatalogSeen) {
|
|
793
|
+
log.info(
|
|
794
|
+
`[skills-auto-inject] stock skill catalog present in the transcript after compaction ` +
|
|
795
|
+
`(reason: ${state.lastCompactionReason ?? "unknown"})`,
|
|
796
|
+
);
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
return state;
|
|
800
|
+
}
|
|
801
|
+
|
|
802
|
+
// Main Handler
|
|
803
|
+
|
|
804
|
+
/**
|
|
805
|
+
* Register the auto-inject handler on before_agent_start plus the
|
|
806
|
+
* read-tool load detector on tool_result.
|
|
807
|
+
*
|
|
808
|
+
* Call this from the skills-tool extension factory, after registering
|
|
809
|
+
* the list_skills tool.
|
|
810
|
+
*/
|
|
811
|
+
export function registerAutoInject(pi: ExtensionAPI): void {
|
|
812
|
+
// Count SKILL.md reads (the list→read load path) via the read tool, and
|
|
813
|
+
// per-skill: mark the matching injection as loaded (releases its slot and
|
|
814
|
+
// extends its cooldown — the skill is in the agent's context now).
|
|
815
|
+
pi.on("tool_result", (event: unknown, ctx: ExtensionContext) => {
|
|
816
|
+
try {
|
|
817
|
+
const ev = event as {
|
|
818
|
+
toolName?: string;
|
|
819
|
+
isError?: boolean;
|
|
820
|
+
input?: { path?: string };
|
|
821
|
+
content?: Array<{ text?: string }>;
|
|
822
|
+
};
|
|
823
|
+
if (ev?.toolName !== "read") return;
|
|
824
|
+
// A failed read returns the error text, not the file — counting it
|
|
825
|
+
// inflated `loaded` with phantom loads (the read-detector never saw
|
|
826
|
+
// the skill content, and no SKILL.md was opened).
|
|
827
|
+
if (ev.isError) return;
|
|
828
|
+
const text = (ev.content ?? []).map((c) => c.text ?? "").join("\n");
|
|
829
|
+
const name = skillNameFromRead(ev.input?.path, text);
|
|
830
|
+
if (name) {
|
|
831
|
+
const state = getState(ctx);
|
|
832
|
+
const held = state.injected.find((i) => i.name === name && i.loadedTurn === undefined);
|
|
833
|
+
if (held) held.loadedTurn = state.currentTurn;
|
|
834
|
+
recordSkillLoad(ctx, name);
|
|
835
|
+
log.debug(`[skills-auto-inject] counted actual load of "${name}" via read`);
|
|
836
|
+
}
|
|
837
|
+
} catch {
|
|
838
|
+
// best-effort — never break the tool loop over a counter
|
|
839
|
+
}
|
|
840
|
+
});
|
|
841
|
+
|
|
842
|
+
// Post-compaction the transcript can regain pi's stock skill catalog (the
|
|
843
|
+
// section diff is computed against pi's own prompt options, not braid's
|
|
844
|
+
// mutated ones). Recording that state change keeps the discovery surface
|
|
845
|
+
// honest; stripping the block would mean mutating persisted session
|
|
846
|
+
// entries — no sanctioned seam, not worth it.
|
|
847
|
+
pi.on(SESSION_COMPACT, (event: unknown, ctx: ExtensionContext) => {
|
|
848
|
+
try {
|
|
849
|
+
const state = getDiscoveryState(ctx);
|
|
850
|
+
state.compactions++;
|
|
851
|
+
state.lastCompactionReason =
|
|
852
|
+
typeof (event as { reason?: unknown })?.reason === "string"
|
|
853
|
+
? ((event as { reason: string }).reason as string)
|
|
854
|
+
: undefined;
|
|
855
|
+
state.pendingCatalogCheck = true;
|
|
856
|
+
} catch {
|
|
857
|
+
// best-effort
|
|
858
|
+
}
|
|
859
|
+
});
|
|
860
|
+
|
|
861
|
+
// The rebuilt system message persists when the post-compaction run starts,
|
|
862
|
+
// so the check runs at settle — after the run's entries are on disk.
|
|
863
|
+
pi.on(AGENT_SETTLED, (_event: unknown, ctx: ExtensionContext) => {
|
|
864
|
+
try {
|
|
865
|
+
resolveDiscoveryMode(ctx);
|
|
866
|
+
} catch {
|
|
867
|
+
// best-effort
|
|
868
|
+
}
|
|
869
|
+
});
|
|
870
|
+
|
|
871
|
+
pi.on("before_agent_start", async (event: unknown, ctx: ExtensionContext) => {
|
|
872
|
+
try {
|
|
873
|
+
// Once-per-session durable adoption record (the rollup denominator).
|
|
874
|
+
recordSessionStart(ctx);
|
|
875
|
+
const state = getState(ctx);
|
|
876
|
+
state.currentTurn++;
|
|
877
|
+
// Explicit-invocation-only skills are not advertised: pi hides them
|
|
878
|
+
// from its prompt block, so the suggestion whisper must not put them
|
|
879
|
+
// back in front of the model. The unfiltered cache still resolves an
|
|
880
|
+
// explicit read in skillNameFromRead().
|
|
881
|
+
const skills = _skillsCache.filter((s) => !s.disableModelInvocation);
|
|
882
|
+
|
|
883
|
+
const ev = event as {
|
|
884
|
+
prompt?: string;
|
|
885
|
+
systemPrompt?: string;
|
|
886
|
+
systemPromptOptions?: { skills?: unknown[] };
|
|
887
|
+
};
|
|
888
|
+
const prompt = ev.prompt ?? "";
|
|
889
|
+
if (!prompt.trim()) {
|
|
890
|
+
return; // No user input to match against
|
|
891
|
+
}
|
|
892
|
+
|
|
893
|
+
// One-shot profile hint: the first non-empty prompt of a session whose
|
|
894
|
+
// configured profile carries a hint gets exactly one steer — the hint
|
|
895
|
+
// text itself, byte-for-byte. Profiles without a hint and sessions
|
|
896
|
+
// matching no profile get nothing; an empty first prompt defers the
|
|
897
|
+
// fire to the next non-empty prompt, still once per session. Sent
|
|
898
|
+
// before the keyword path so the hint reaches the agent even when the
|
|
899
|
+
// skill cache is not populated yet.
|
|
900
|
+
const profile = getSessionProfile(ctx);
|
|
901
|
+
if (!state.hintSent && profile.hint) {
|
|
902
|
+
state.hintSent = true;
|
|
903
|
+
log.info(
|
|
904
|
+
`[skills-auto-inject] profile hint whisper (profile "${profile.name}", first non-empty prompt)`,
|
|
905
|
+
);
|
|
906
|
+
sendTrackedMessage(
|
|
907
|
+
pi,
|
|
908
|
+
{
|
|
909
|
+
customType: "skills-boot",
|
|
910
|
+
content: [{ type: "text" as const, text: profile.hint }],
|
|
911
|
+
display: true,
|
|
912
|
+
details: {
|
|
913
|
+
[BRAID_INJECTED]: true,
|
|
914
|
+
[BRAID_SOURCE]: "skills-auto-inject",
|
|
915
|
+
},
|
|
916
|
+
},
|
|
917
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
918
|
+
{ type: "context", source: "skills-auto-inject" },
|
|
919
|
+
);
|
|
920
|
+
}
|
|
921
|
+
|
|
922
|
+
if (!skills.length) {
|
|
923
|
+
return; // No skills loaded yet — nothing to suggest
|
|
924
|
+
}
|
|
925
|
+
|
|
926
|
+
const keywords = extractKeywords(prompt);
|
|
927
|
+
if (!keywords.length) {
|
|
928
|
+
return; // No significant keywords to match
|
|
929
|
+
}
|
|
930
|
+
|
|
931
|
+
// Score each skill. The raw prompt rides along for trigger matching.
|
|
932
|
+
const scored = skills
|
|
933
|
+
.map((s) => ({ skill: s, score: scoreSkill(s, keywords, prompt) }))
|
|
934
|
+
.filter((s) => s.score > 0);
|
|
935
|
+
|
|
936
|
+
if (!scored.length) {
|
|
937
|
+
return; // No relevant skills found
|
|
938
|
+
}
|
|
939
|
+
|
|
940
|
+
// Cooldown + slot budget (pure decision, exported for tests).
|
|
941
|
+
const toInject = selectSuggestions(scored, state.injected, state.currentTurn);
|
|
942
|
+
|
|
943
|
+
if (!toInject.length) {
|
|
944
|
+
return;
|
|
945
|
+
}
|
|
946
|
+
|
|
947
|
+
const skillsToInject = toInject.map((s) => s.skill);
|
|
948
|
+
const text = formatWhisper(skillsToInject);
|
|
949
|
+
|
|
950
|
+
// Delivery first, bookkeeping second: a suggestion that a suppression
|
|
951
|
+
// path drops must neither consume its cooldown slot nor move a counter.
|
|
952
|
+
// See the module header for why the cap is bypassed here.
|
|
953
|
+
const delivered = sendTrackedMessage(
|
|
954
|
+
pi,
|
|
955
|
+
{
|
|
956
|
+
customType: "skills-suggestion",
|
|
957
|
+
content: [{ type: "text" as const, text }],
|
|
958
|
+
display: true,
|
|
959
|
+
details: {
|
|
960
|
+
[BRAID_INJECTED]: true,
|
|
961
|
+
[BRAID_SOURCE]: "skills-auto-inject",
|
|
962
|
+
skills: skillsToInject.map((s) => s.name),
|
|
963
|
+
},
|
|
964
|
+
},
|
|
965
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
966
|
+
{ type: "context", source: "skills-auto-inject" },
|
|
967
|
+
{ bypassFloodCap: true },
|
|
968
|
+
);
|
|
969
|
+
|
|
970
|
+
if (!delivered) {
|
|
971
|
+
log.debug("[skills-auto-inject] suggestion suppressed before delivery; not counted");
|
|
972
|
+
return;
|
|
973
|
+
}
|
|
974
|
+
|
|
975
|
+
log.info(
|
|
976
|
+
`[skills-auto-inject] Suggesting ${skillsToInject.map((s) => s.name).join(", ")} ` +
|
|
977
|
+
`(turn ${state.currentTurn}, keywords: ${keywords.slice(0, 5).join(", ")})`,
|
|
978
|
+
);
|
|
979
|
+
|
|
980
|
+
for (const item of toInject) {
|
|
981
|
+
state.injected.push({
|
|
982
|
+
name: item.skill.name,
|
|
983
|
+
turnNumber: state.currentTurn,
|
|
984
|
+
filePath: item.skill.filePath,
|
|
985
|
+
});
|
|
986
|
+
}
|
|
987
|
+
// Bound the history: an entry whose loaded cooldown fully expired can
|
|
988
|
+
// no longer affect any cooldown or slot decision.
|
|
989
|
+
state.injected = state.injected.filter(
|
|
990
|
+
(i) =>
|
|
991
|
+
state.currentTurn - i.turnNumber < LOADED_COOLDOWN_TURNS ||
|
|
992
|
+
(i.loadedTurn !== undefined && state.currentTurn - i.loadedTurn < LOADED_COOLDOWN_TURNS),
|
|
993
|
+
);
|
|
994
|
+
|
|
995
|
+
// E3: per-skill suggestion counter — counts deliveries, not intent.
|
|
996
|
+
recordSkillSuggestion(
|
|
997
|
+
ctx,
|
|
998
|
+
skillsToInject.map((s) => s.name),
|
|
999
|
+
);
|
|
1000
|
+
} catch (err) {
|
|
1001
|
+
log.debug(`[skills-auto-inject] Error in before_agent_start: ${err}`);
|
|
1002
|
+
}
|
|
1003
|
+
});
|
|
1004
|
+
}
|