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,240 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* list_skills tool — on-demand skill discovery.
|
|
3
|
+
*
|
|
4
|
+
* The full skill catalog is NOT rendered in-prompt (bloat reduction).
|
|
5
|
+
* Instead, the agent calls this tool to discover skills by name,
|
|
6
|
+
* description, path, and source, then reads the chosen SKILL.md via
|
|
7
|
+
* the `read` tool. Tool output is transient — compact after reading.
|
|
8
|
+
*
|
|
9
|
+
* Populated by prompt-builder's `before_agent_start` via `setCachedSkills()`.
|
|
10
|
+
* The cache lives in this module and is reset each session.
|
|
11
|
+
*
|
|
12
|
+
* One action:
|
|
13
|
+
* list — paginated catalog (name, filePath, description, source)
|
|
14
|
+
*
|
|
15
|
+
* Skills discovery (list_skills tool) plus the scoring-based auto-inject
|
|
16
|
+
* whisper supersede an LLM top-N recommender: a second relevance engine
|
|
17
|
+
* would duplicate scoreSkill at the cost of an extra model call, against
|
|
18
|
+
* the lean-prompt constraint.
|
|
19
|
+
*
|
|
20
|
+
* Also registers `skill_stats` — the adoption counter surface.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
24
|
+
import { Type } from "typebox";
|
|
25
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
26
|
+
import {
|
|
27
|
+
registerAutoInject,
|
|
28
|
+
updateSkillCache,
|
|
29
|
+
getSkillStats,
|
|
30
|
+
getDurableSkillStats,
|
|
31
|
+
resolveDiscoveryMode,
|
|
32
|
+
} from "./auto-inject.js";
|
|
33
|
+
import { readSkillTriggers } from "./skill-triggers.js";
|
|
34
|
+
import { getMonthlyAdoptionRollup } from "./session-records.js";
|
|
35
|
+
|
|
36
|
+
const log = createLogger("skills-tool");
|
|
37
|
+
|
|
38
|
+
// Module-level skill cache (populated by before_agent_start)
|
|
39
|
+
|
|
40
|
+
interface CachedSkill {
|
|
41
|
+
name: string;
|
|
42
|
+
filePath: string;
|
|
43
|
+
description: string;
|
|
44
|
+
baseDir: string;
|
|
45
|
+
sourceInfo?: { source?: string; package?: string };
|
|
46
|
+
/**
|
|
47
|
+
* pi frontmatter flag: the skill is excluded from model selection and is
|
|
48
|
+
* reachable only through its explicit /skill:name command. braid must keep
|
|
49
|
+
* it out of the surfaces that advertise skills to the model.
|
|
50
|
+
*/
|
|
51
|
+
disableModelInvocation?: boolean;
|
|
52
|
+
/** Frontmatter trigger phrases, resolved from SKILL.md at cache time. */
|
|
53
|
+
triggers?: string[];
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
let cachedSkills: CachedSkill[] = [];
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Called from prompt-builder's before_agent_start to populate the cache.
|
|
60
|
+
* Resolves each skill's frontmatter trigger phrases here, once per turn:
|
|
61
|
+
* the matcher scores triggers, pi's skill objects never carry them (fixed
|
|
62
|
+
* shape), and the memoized read makes repeat turns stat-only.
|
|
63
|
+
*/
|
|
64
|
+
export function setCachedSkills(skills: CachedSkill[]): void {
|
|
65
|
+
cachedSkills = skills.map((s) => ({
|
|
66
|
+
...s,
|
|
67
|
+
triggers: readSkillTriggers(s.filePath, s.description),
|
|
68
|
+
}));
|
|
69
|
+
// Sync with auto-inject subsystem (enriched cache — triggers ride along)
|
|
70
|
+
updateSkillCache(cachedSkills);
|
|
71
|
+
log.debug(`Cached ${skills.length} skills for list_skills tool`);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* The installed visible skill names — the same set the list_skills catalog
|
|
76
|
+
* serves (disableModelInvocation skills excluded). Source of truth for any
|
|
77
|
+
* prompt text that must name only skills the catalog actually shows.
|
|
78
|
+
*/
|
|
79
|
+
export function getCachedVisibleSkillNames(): string[] {
|
|
80
|
+
return cachedSkills.filter((s) => !s.disableModelInvocation).map((s) => s.name);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** Format a skill's source provenance for display. */
|
|
84
|
+
function formatSource(skill: CachedSkill): string {
|
|
85
|
+
const si = skill.sourceInfo;
|
|
86
|
+
if (!si) return "unknown";
|
|
87
|
+
const src = si.source || "unknown";
|
|
88
|
+
const pkg = si.package;
|
|
89
|
+
if (pkg) return `package:${pkg}`;
|
|
90
|
+
if (src === "user") return "user-global";
|
|
91
|
+
if (src === "project") return "project";
|
|
92
|
+
return src;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
// Extension factory:
|
|
96
|
+
|
|
97
|
+
export default function skillsToolExtension(pi: ExtensionAPI): void {
|
|
98
|
+
registerAutoInject(pi);
|
|
99
|
+
|
|
100
|
+
pi.registerTool({
|
|
101
|
+
name: "list_skills",
|
|
102
|
+
label: "List Skills",
|
|
103
|
+
description:
|
|
104
|
+
"Discover skills on demand: paginated catalog (name, filePath, description, source); `read` a SKILL.md to load it.",
|
|
105
|
+
parameters: Type.Object({
|
|
106
|
+
action: Type.Literal("list", {
|
|
107
|
+
description: "list = paginated catalog (name, filePath, description, source)",
|
|
108
|
+
}),
|
|
109
|
+
page: Type.Optional(
|
|
110
|
+
Type.Number({
|
|
111
|
+
minimum: 1,
|
|
112
|
+
default: 1,
|
|
113
|
+
description: "Page number for list (1-based)",
|
|
114
|
+
}),
|
|
115
|
+
),
|
|
116
|
+
pageSize: Type.Optional(
|
|
117
|
+
Type.Number({
|
|
118
|
+
minimum: 1,
|
|
119
|
+
maximum: 50,
|
|
120
|
+
default: 10,
|
|
121
|
+
description: "Entries per page for list",
|
|
122
|
+
}),
|
|
123
|
+
),
|
|
124
|
+
}),
|
|
125
|
+
execute: async (_id, params, _signal, _onUpdate, _ctx) => {
|
|
126
|
+
const page = (params.page as number) ?? 1;
|
|
127
|
+
const pageSize = (params.pageSize as number) ?? 10;
|
|
128
|
+
const start = (page - 1) * pageSize;
|
|
129
|
+
// Explicit-invocation-only skills stay out of the catalog; the cache
|
|
130
|
+
// itself stays unfiltered for the read-detector that counts explicit
|
|
131
|
+
// loads.
|
|
132
|
+
const visible = cachedSkills.filter((s) => !s.disableModelInvocation);
|
|
133
|
+
const slice = visible.slice(start, start + pageSize);
|
|
134
|
+
const total = visible.length;
|
|
135
|
+
const hasMore = start + pageSize < total;
|
|
136
|
+
|
|
137
|
+
const skills = slice.map((s) => ({
|
|
138
|
+
name: s.name,
|
|
139
|
+
filePath: s.filePath,
|
|
140
|
+
description: (s.description ?? "").slice(0, 280),
|
|
141
|
+
source: formatSource(s),
|
|
142
|
+
}));
|
|
143
|
+
|
|
144
|
+
return {
|
|
145
|
+
content: [
|
|
146
|
+
{
|
|
147
|
+
type: "text" as const,
|
|
148
|
+
text: JSON.stringify({ page, pageSize, total, hasMore, skills }, null, 2),
|
|
149
|
+
},
|
|
150
|
+
],
|
|
151
|
+
details: { total, page, pageSize, hasMore, returned: skills.length },
|
|
152
|
+
};
|
|
153
|
+
},
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
// Per-skill usage counters (suggested / claimed / actual / loaded) for this
|
|
157
|
+
// session, plus the durable all-time counters persisted in skills-usage.json
|
|
158
|
+
// (getSkillsUsageFilePath).
|
|
159
|
+
// `suggested` counts DELIVERED suggestions (the whisper was accepted by the
|
|
160
|
+
// tracked send path); only a detected SKILL.md read counts as actual —
|
|
161
|
+
// sessionHasSkillLoad gates on actual loads, and allTimeTotals sums the
|
|
162
|
+
// durable store for a one-glance adoption figure. `claimed` is the
|
|
163
|
+
// honor-system reply grade; nothing produces it today, and the counter
|
|
164
|
+
// stays monotone so published numbers stay readable.
|
|
165
|
+
// adoption_rate = sessions_with_≥1_skill_load / sessions (measured
|
|
166
|
+
// monthly, bucketed by session profile name) — the actual counter feeds
|
|
167
|
+
// it, and the monthly object below is computed from the durable
|
|
168
|
+
// per-session record store (see session-records.ts).
|
|
169
|
+
pi.registerTool({
|
|
170
|
+
name: "skill_stats",
|
|
171
|
+
exposure: "deferred",
|
|
172
|
+
label: "Skill Stats",
|
|
173
|
+
description:
|
|
174
|
+
"Per-skill usage counters this session (suggested, claimed, actual); adoption feed.",
|
|
175
|
+
parameters: Type.Object({}),
|
|
176
|
+
execute: async (_id, _params, _signal, _onUpdate, ctx) => {
|
|
177
|
+
const stats = getSkillStats(ctx);
|
|
178
|
+
const allTime = getDurableSkillStats();
|
|
179
|
+
// Detected reads are the primary signal: a session where the agent only
|
|
180
|
+
// verbally claimed loads does not count as an adoption session.
|
|
181
|
+
const actualAny = Object.values(stats).some((s) => s.actual > 0);
|
|
182
|
+
const totals = { suggested: 0, loaded: 0, claimed: 0, actual: 0 };
|
|
183
|
+
let suggestedDelivered = 0;
|
|
184
|
+
let suggestedMixed = 0;
|
|
185
|
+
for (const s of Object.values(allTime)) {
|
|
186
|
+
totals.suggested += s.suggested;
|
|
187
|
+
totals.loaded += s.loaded;
|
|
188
|
+
totals.claimed += s.claimed;
|
|
189
|
+
totals.actual += s.actual;
|
|
190
|
+
if (s.epoch === "delivered") suggestedDelivered += s.suggested;
|
|
191
|
+
else suggestedMixed += s.suggested;
|
|
192
|
+
}
|
|
193
|
+
const monthly = getMonthlyAdoptionRollup();
|
|
194
|
+
const discovery = resolveDiscoveryMode(ctx);
|
|
195
|
+
return {
|
|
196
|
+
content: [
|
|
197
|
+
{
|
|
198
|
+
type: "text" as const,
|
|
199
|
+
text: JSON.stringify(
|
|
200
|
+
{
|
|
201
|
+
sessionHasSkillLoad: actualAny,
|
|
202
|
+
skills: stats,
|
|
203
|
+
allTime,
|
|
204
|
+
allTimeTotals: {
|
|
205
|
+
...totals,
|
|
206
|
+
// suggested sums BOTH regimes; suggestedDelivered counts
|
|
207
|
+
// only delivered-regime increments, suggestedMixed may
|
|
208
|
+
// include pre-delivery-regime inflation. Only a
|
|
209
|
+
// "delivered" epoch means the suggested number is clean.
|
|
210
|
+
suggestedDelivered,
|
|
211
|
+
suggestedMixed,
|
|
212
|
+
suggestedEpoch: suggestedMixed === 0 ? "delivered" : "mixed",
|
|
213
|
+
},
|
|
214
|
+
monthly,
|
|
215
|
+
discovery: {
|
|
216
|
+
// Whether the stock skill catalog sits in the persisted
|
|
217
|
+
// transcript (it re-enters via pi's post-compaction
|
|
218
|
+
// section rebuild; braid suppresses it per-turn).
|
|
219
|
+
catalog: discovery.stockCatalogSeen ? "rebuilt" : "suppressed",
|
|
220
|
+
lastCompactionReason: discovery.lastCompactionReason,
|
|
221
|
+
checkedAt: discovery.checkedAt,
|
|
222
|
+
compactions: discovery.compactions,
|
|
223
|
+
},
|
|
224
|
+
},
|
|
225
|
+
null,
|
|
226
|
+
2,
|
|
227
|
+
),
|
|
228
|
+
},
|
|
229
|
+
],
|
|
230
|
+
details: {
|
|
231
|
+
sessionHasSkillLoad: actualAny,
|
|
232
|
+
trackedSkills: Object.keys(stats).length,
|
|
233
|
+
allTimeSkills: Object.keys(allTime).length,
|
|
234
|
+
allTimeTotals: { ...totals, suggestedDelivered, suggestedMixed },
|
|
235
|
+
monthly,
|
|
236
|
+
},
|
|
237
|
+
};
|
|
238
|
+
},
|
|
239
|
+
});
|
|
240
|
+
}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Skills-loading directive, owned by the skills-tool module.
|
|
3
|
+
*
|
|
4
|
+
* The skills-tool module owns the strategy text for using its own tool;
|
|
5
|
+
* prompt-builder imports it and renders it as the "skills-loading" section
|
|
6
|
+
* ONLY when both `read` and `list_skills` are active tools.
|
|
7
|
+
*
|
|
8
|
+
* Current rule: task-start list_skills puts the full catalog (name, path,
|
|
9
|
+
* purpose) in view so the domain-match trigger is decidable; the catalog
|
|
10
|
+
* one-liner is metadata, the SKILL.md path is the knowledge — no skill
|
|
11
|
+
* content is injected into the prompt. The trigger has a mechanical form
|
|
12
|
+
* (a tool call whose family word appears in a skill's name) because the
|
|
13
|
+
* judgment form loses sessions that are inside a skill's domain by
|
|
14
|
+
* construction. Decision logic lives in the prompt, mechanics in tool
|
|
15
|
+
* descriptions (strategy-only contract; each fact in exactly one place).
|
|
16
|
+
*
|
|
17
|
+
* The mechanical trigger's worked examples are derived at assembly time from
|
|
18
|
+
* the live tool and skill names (mechanicalTriggerExamples): a tool's family
|
|
19
|
+
* token paired with an installed visible skill's dash-token. The text never
|
|
20
|
+
* hardcodes a tool or skill name, so it cannot name a pair that does not
|
|
21
|
+
* exist in the running session; when no pair computes, the sentence renders
|
|
22
|
+
* without a parenthetical.
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
/** Paragraph 1: the discovery rule (pinned verbatim by test-prompt-budget.mjs). */
|
|
26
|
+
export const SKILLS_DISCOVERY_RULE = `You discover skills on demand, not in advance: at the start of a task, call list_skills once to see the catalog (name, path, purpose). When the task enters a listed skill's domain, read the WHOLE SKILL.md before acting in that domain; never act from memory of a skill's contents.`;
|
|
27
|
+
|
|
28
|
+
/** Paragraph 2: the pointer rule (pinned verbatim by test-prompt-budget.mjs). */
|
|
29
|
+
export const SKILLS_POINTER_RULE = `Pointer rule: the catalog one-liner is metadata, not content — the SKILL.md path is the knowledge. Mid-task, enter a domain absent from the visible catalog → call list_skills again (catalog is paginated). The prompt already covering the domain is the only reason to skip the read.`;
|
|
30
|
+
|
|
31
|
+
const MECHANICAL_TRIGGER_LEAD = `Mechanical trigger, no judgment call: about to use a tool family whose word appears in a skill's name`;
|
|
32
|
+
const MECHANICAL_TRIGGER_TAIL = `→ read that SKILL.md before the first call in the family.`;
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Worked examples for the mechanical trigger, derived from the live inputs.
|
|
36
|
+
*
|
|
37
|
+
* A pair exists when a tool's family token (the first underscore-delimited
|
|
38
|
+
* token of the tool name: `herdr_layout` → `herdr`) equals a dash-delimited
|
|
39
|
+
* token of a skill name (`herdr-topology` → `herdr`), case-insensitively.
|
|
40
|
+
* One example renders per distinct family token: the trigger fires per
|
|
41
|
+
* family ("before the first call in the family"), so enumerating every tool
|
|
42
|
+
* in a family would restate one fact; the representative tool is the
|
|
43
|
+
* lexicographically smallest active tool carrying that token. The arrow
|
|
44
|
+
* target keeps the skill's own casing. Sorted by family token, so identical
|
|
45
|
+
* inputs render byte-identical text in any input order, and no tool or skill
|
|
46
|
+
* outside the inputs is ever named.
|
|
47
|
+
*/
|
|
48
|
+
export function mechanicalTriggerExamples(toolNames: string[], skillNames: string[]): string[] {
|
|
49
|
+
// Family token (lowercased) -> lexicographically smallest active tool name.
|
|
50
|
+
const familyTool = new Map<string, string>();
|
|
51
|
+
for (const tool of toolNames) {
|
|
52
|
+
const family = tool.split("_")[0].toLowerCase();
|
|
53
|
+
const incumbent = familyTool.get(family);
|
|
54
|
+
if (incumbent === undefined || tool < incumbent) familyTool.set(family, tool);
|
|
55
|
+
}
|
|
56
|
+
// Family token (lowercased) -> the matched skill token in the skill's own
|
|
57
|
+
// casing, taken from the lexicographically smallest matching skill name
|
|
58
|
+
// (order-independent when several skills spell the token differently).
|
|
59
|
+
const tokenCasing = new Map<string, { casing: string; skill: string }>();
|
|
60
|
+
for (const skill of skillNames) {
|
|
61
|
+
for (const token of skill.split("-")) {
|
|
62
|
+
if (!token) continue;
|
|
63
|
+
const family = token.toLowerCase();
|
|
64
|
+
if (!familyTool.has(family)) continue;
|
|
65
|
+
const incumbent = tokenCasing.get(family);
|
|
66
|
+
if (incumbent === undefined || skill < incumbent.skill) {
|
|
67
|
+
tokenCasing.set(family, { casing: token, skill });
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
return [...tokenCasing.entries()]
|
|
72
|
+
.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
|
|
73
|
+
.map(([family, { casing }]) => `\`${familyTool.get(family)}\` → ${casing}`);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* The full skills-loading text: discovery rule, pointer rule, and the
|
|
78
|
+
* mechanical trigger with only the pairs computed from the given tool and
|
|
79
|
+
* skill names. prompt-builder feeds it the active tool names and the
|
|
80
|
+
* skills-tool module's visible-catalog names.
|
|
81
|
+
*/
|
|
82
|
+
export function skillsLoadingText(toolNames: string[], skillNames: string[]): string {
|
|
83
|
+
const examples = mechanicalTriggerExamples(toolNames, skillNames);
|
|
84
|
+
const trigger =
|
|
85
|
+
examples.length > 0
|
|
86
|
+
? `${MECHANICAL_TRIGGER_LEAD} (${examples.join(", ")}) ${MECHANICAL_TRIGGER_TAIL}`
|
|
87
|
+
: `${MECHANICAL_TRIGGER_LEAD} ${MECHANICAL_TRIGGER_TAIL}`;
|
|
88
|
+
return `${SKILLS_DISCOVERY_RULE}\n\n${SKILLS_POINTER_RULE}\n\n${trigger}\n`;
|
|
89
|
+
}
|
|
@@ -0,0 +1,328 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Durable per-session skill-adoption records + monthly adoption rollup.
|
|
3
|
+
*
|
|
4
|
+
* Every session that reaches an agent turn gets ONE logical record:
|
|
5
|
+
* { sessionId, role, month, hadSkillLoad, updatedAt }
|
|
6
|
+
* `role` carries the session's profile name from the braid config (see
|
|
7
|
+
* lib/config/session-profiles.ts), or the neutral default when no profile
|
|
8
|
+
* matches; `month` is the local-time "YYYY-MM" of the write, and
|
|
9
|
+
* `hadSkillLoad` is true only after a DETECTED SKILL.md read — a verbal
|
|
10
|
+
* load claim does not count, matching the `actual` counter and
|
|
11
|
+
* sessionHasSkillLoad semantics in auto-inject.
|
|
12
|
+
*
|
|
13
|
+
* Store: append-only JSONL (getSkillsSessionsFilePath()). Writers only
|
|
14
|
+
* append whole lines — there is no read-modify-write — so sessions running
|
|
15
|
+
* concurrently in separate processes cannot lose each other's records.
|
|
16
|
+
* The upsert (one logical record per sessionId) happens at read time:
|
|
17
|
+
* records fold in file order, and for the same sessionId the latest role
|
|
18
|
+
* and month win while `hadSkillLoad` ORs across all occurrences (a
|
|
19
|
+
* session that starts in one month and loads a skill in the next is
|
|
20
|
+
* counted once, in the month of the load). Residual race: simultaneous
|
|
21
|
+
* appends from two processes can theoretically tear a line on some
|
|
22
|
+
* filesystems; the tolerant reader skips unparseable lines, the window is
|
|
23
|
+
* a single small write, and this is accepted as best-effort telemetry.
|
|
24
|
+
*
|
|
25
|
+
* Back-compat: records written before profiles existed carry a role from
|
|
26
|
+
* the retired fixed set; those values pass the profile-name gate
|
|
27
|
+
* unchanged, so older buckets keep folding under their original names.
|
|
28
|
+
* Records whose role does not pass the gate (missing, non-string, empty,
|
|
29
|
+
* malformed) fold to the neutral default.
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
|
|
33
|
+
import { dirname } from "node:path";
|
|
34
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
35
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
36
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
37
|
+
import { getSkillsSessionsFilePath } from "../../../lib/config/braid-paths.js";
|
|
38
|
+
import {
|
|
39
|
+
NEUTRAL_SESSION_PROFILE,
|
|
40
|
+
normalizeProfileName,
|
|
41
|
+
resolveSessionProfileForCwd,
|
|
42
|
+
type ResolvedSessionProfile,
|
|
43
|
+
} from "../../../lib/config/session-profiles.js";
|
|
44
|
+
|
|
45
|
+
const log = createLogger("skills-tool");
|
|
46
|
+
|
|
47
|
+
/** One durable per-session adoption record (a single JSONL line on disk). */
|
|
48
|
+
export interface SkillSessionRecord {
|
|
49
|
+
/** pi session id (from ctx.sessionManager.getSessionId()). */
|
|
50
|
+
sessionId: string;
|
|
51
|
+
/**
|
|
52
|
+
* Session profile name resolved from the braid config, or the neutral
|
|
53
|
+
* default; the monthly rollup excludes the neutral bucket.
|
|
54
|
+
*/
|
|
55
|
+
role: string;
|
|
56
|
+
/** Local-time calendar month of this write, "YYYY-MM". */
|
|
57
|
+
month: string;
|
|
58
|
+
/** True only after a DETECTED SKILL.md read in this session. */
|
|
59
|
+
hadSkillLoad: boolean;
|
|
60
|
+
/** ISO timestamp of this write. */
|
|
61
|
+
updatedAt: string;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** Local-time calendar month of a date, "YYYY-MM". */
|
|
65
|
+
export function monthOf(date: Date): string {
|
|
66
|
+
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}`;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// Store I/O (append-only JSONL)
|
|
70
|
+
|
|
71
|
+
/** Normalize one raw JSONL entry; undefined when the entry is not usable. */
|
|
72
|
+
function normalizeRecord(raw: unknown): SkillSessionRecord | undefined {
|
|
73
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) return undefined;
|
|
74
|
+
const r = raw as Record<string, unknown>;
|
|
75
|
+
if (typeof r.sessionId !== "string" || !r.sessionId) return undefined;
|
|
76
|
+
if (typeof r.month !== "string" || !/^\d{4}-\d{2}$/.test(r.month)) return undefined;
|
|
77
|
+
const role = normalizeProfileName(r.role) ?? NEUTRAL_SESSION_PROFILE;
|
|
78
|
+
return {
|
|
79
|
+
sessionId: r.sessionId,
|
|
80
|
+
role,
|
|
81
|
+
month: r.month,
|
|
82
|
+
hadSkillLoad: r.hadSkillLoad === true,
|
|
83
|
+
updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : "",
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Fold raw records into one logical record per sessionId (the upsert
|
|
89
|
+
* semantics): the latest role and month win, `hadSkillLoad` ORs across
|
|
90
|
+
* all occurrences, `updatedAt` keeps the newest timestamp. Pure.
|
|
91
|
+
*/
|
|
92
|
+
export function foldSessionRecords(records: SkillSessionRecord[]): SkillSessionRecord[] {
|
|
93
|
+
const byId = new Map<string, SkillSessionRecord>();
|
|
94
|
+
for (const rec of records) {
|
|
95
|
+
const prev = byId.get(rec.sessionId);
|
|
96
|
+
byId.set(
|
|
97
|
+
rec.sessionId,
|
|
98
|
+
prev
|
|
99
|
+
? {
|
|
100
|
+
sessionId: rec.sessionId,
|
|
101
|
+
role: rec.role,
|
|
102
|
+
month: rec.month,
|
|
103
|
+
hadSkillLoad: prev.hadSkillLoad || rec.hadSkillLoad,
|
|
104
|
+
updatedAt: prev.updatedAt > rec.updatedAt ? prev.updatedAt : rec.updatedAt,
|
|
105
|
+
}
|
|
106
|
+
: rec,
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
return [...byId.values()];
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* Read + fold the store. Missing or unreadable file → empty (never
|
|
114
|
+
* throws); corrupt lines are skipped.
|
|
115
|
+
*/
|
|
116
|
+
export function readSessionRecords(storePath: string): SkillSessionRecord[] {
|
|
117
|
+
let text: string;
|
|
118
|
+
try {
|
|
119
|
+
text = readFileSync(storePath, "utf-8");
|
|
120
|
+
} catch {
|
|
121
|
+
return []; // missing or unreadable → no records
|
|
122
|
+
}
|
|
123
|
+
const out: SkillSessionRecord[] = [];
|
|
124
|
+
for (const line of text.split("\n")) {
|
|
125
|
+
const trimmed = line.trim();
|
|
126
|
+
if (!trimmed) continue;
|
|
127
|
+
try {
|
|
128
|
+
const rec = normalizeRecord(JSON.parse(trimmed));
|
|
129
|
+
if (rec) out.push(rec);
|
|
130
|
+
} catch {
|
|
131
|
+
// torn or corrupt line — skip
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
return out;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Append one record. Best-effort: every error is swallowed (this runs on
|
|
139
|
+
* the agent-loop and tool-result paths — a telemetry failure must never
|
|
140
|
+
* break a turn). Returns true when the line landed on disk.
|
|
141
|
+
*/
|
|
142
|
+
export function appendSessionRecord(record: SkillSessionRecord, storePath: string): boolean {
|
|
143
|
+
try {
|
|
144
|
+
mkdirSync(dirname(storePath), { recursive: true });
|
|
145
|
+
appendFileSync(storePath, `${JSON.stringify(record)}\n`, "utf-8");
|
|
146
|
+
return true;
|
|
147
|
+
} catch (err) {
|
|
148
|
+
reportRecordFailure(err);
|
|
149
|
+
return false;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/** Warned once per process about a refused adoption-record append. */
|
|
154
|
+
let _warnedRecordFailure = false;
|
|
155
|
+
|
|
156
|
+
function reportRecordFailure(err: unknown): void {
|
|
157
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
158
|
+
if (_warnedRecordFailure) {
|
|
159
|
+
log.debug(`session adoption record write failed (best-effort): ${message}`);
|
|
160
|
+
return;
|
|
161
|
+
}
|
|
162
|
+
_warnedRecordFailure = true;
|
|
163
|
+
log.warn(`session adoption record write failed (best-effort): ${message}`);
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
interface SessionRecordState {
|
|
167
|
+
/** Set once the session's start record has been written. */
|
|
168
|
+
startRecorded: boolean;
|
|
169
|
+
/** Session-scoped profile resolution — the config is read once per session. */
|
|
170
|
+
profile?: ResolvedSessionProfile;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
const RECORDS_STATE_KEY = "skills-session-records";
|
|
174
|
+
|
|
175
|
+
/** Extract (sessionId, cwd) from a real extension context; undefined otherwise. */
|
|
176
|
+
function resolveSession(ctx: ExtensionContext): { sessionId: string; cwd?: string } | undefined {
|
|
177
|
+
try {
|
|
178
|
+
const sessionId = ctx.sessionManager.getSessionId();
|
|
179
|
+
return sessionId ? { sessionId, cwd: ctx.cwd } : undefined;
|
|
180
|
+
} catch {
|
|
181
|
+
return undefined; // fake/partial ctx (tests) or session not ready
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* The session's effective profile, resolved from the braid config on first
|
|
187
|
+
* use and cached with the records state, so telemetry and the hint path
|
|
188
|
+
* always agree on one name for one session.
|
|
189
|
+
*/
|
|
190
|
+
export function getSessionProfile(ctx: ExtensionContext): ResolvedSessionProfile {
|
|
191
|
+
const state = getExtensionState(
|
|
192
|
+
ctx,
|
|
193
|
+
RECORDS_STATE_KEY,
|
|
194
|
+
(): SessionRecordState => ({ startRecorded: false }),
|
|
195
|
+
);
|
|
196
|
+
if (!state.profile) state.profile = resolveSessionProfileForCwd(ctx.cwd);
|
|
197
|
+
return state.profile;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Write the session's start record (hadSkillLoad=false) exactly once per
|
|
202
|
+
* session — the denominator of the adoption rate. Later writes for the
|
|
203
|
+
* same session only ever flip the flag upward (see fold semantics).
|
|
204
|
+
*/
|
|
205
|
+
export function recordSessionStart(ctx: ExtensionContext, storePath?: string): void {
|
|
206
|
+
try {
|
|
207
|
+
const sess = resolveSession(ctx);
|
|
208
|
+
if (!sess) return;
|
|
209
|
+
const state = getExtensionState(
|
|
210
|
+
ctx,
|
|
211
|
+
RECORDS_STATE_KEY,
|
|
212
|
+
(): SessionRecordState => ({
|
|
213
|
+
startRecorded: false,
|
|
214
|
+
}),
|
|
215
|
+
);
|
|
216
|
+
if (state.startRecorded) return;
|
|
217
|
+
const ok = appendSessionRecord(
|
|
218
|
+
{
|
|
219
|
+
sessionId: sess.sessionId,
|
|
220
|
+
role: getSessionProfile(ctx).name,
|
|
221
|
+
month: monthOf(new Date()),
|
|
222
|
+
hadSkillLoad: false,
|
|
223
|
+
updatedAt: new Date().toISOString(),
|
|
224
|
+
},
|
|
225
|
+
storePath ?? getSkillsSessionsFilePath(),
|
|
226
|
+
);
|
|
227
|
+
if (ok) state.startRecorded = true;
|
|
228
|
+
} catch (err) {
|
|
229
|
+
reportRecordFailure(err);
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Append a hadSkillLoad=true record after a DETECTED SKILL.md read (the
|
|
235
|
+
* numerator of the adoption rate). Claims must NOT route here.
|
|
236
|
+
*/
|
|
237
|
+
export function recordSessionSkillLoad(ctx: ExtensionContext, storePath?: string): void {
|
|
238
|
+
try {
|
|
239
|
+
const sess = resolveSession(ctx);
|
|
240
|
+
if (!sess) return;
|
|
241
|
+
appendSessionRecord(
|
|
242
|
+
{
|
|
243
|
+
sessionId: sess.sessionId,
|
|
244
|
+
role: getSessionProfile(ctx).name,
|
|
245
|
+
month: monthOf(new Date()),
|
|
246
|
+
hadSkillLoad: true,
|
|
247
|
+
updatedAt: new Date().toISOString(),
|
|
248
|
+
},
|
|
249
|
+
storePath ?? getSkillsSessionsFilePath(),
|
|
250
|
+
);
|
|
251
|
+
} catch (err) {
|
|
252
|
+
reportRecordFailure(err);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/** Adoption numbers for one profile in one month. */
|
|
257
|
+
export interface ProfileAdoption {
|
|
258
|
+
/** Sessions active in the month (records with a turn). */
|
|
259
|
+
sessions: number;
|
|
260
|
+
/** Of those, sessions with at least one detected skill load. */
|
|
261
|
+
sessionsWithLoad: number;
|
|
262
|
+
/** sessionsWithLoad / sessions, rounded to 2 decimals; 0 when no sessions. */
|
|
263
|
+
adoptionRate: number;
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/** current month first, then the two previous — month → profile name → numbers. */
|
|
267
|
+
export type MonthlyAdoptionRollup = Record<string, Record<string, ProfileAdoption>>;
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* Compute the monthly adoption rollup for the current + previous 2
|
|
271
|
+
* months, keyed by session profile name. Pure (given records + now).
|
|
272
|
+
* Sessions recorded before the rollup existed simply don't exist in the
|
|
273
|
+
* store — the rollup starts from deployment and deliberately undercounts
|
|
274
|
+
* rather than estimating history. The neutral profile stays out: it is
|
|
275
|
+
* the "no profile configured" bucket, not an adoption target.
|
|
276
|
+
*
|
|
277
|
+
* Profile buckets are staged in a Map and copied out at the end, so a
|
|
278
|
+
* profile named like an Object.prototype member (e.g. "constructor")
|
|
279
|
+
* cannot corrupt the rollup.
|
|
280
|
+
*/
|
|
281
|
+
export function computeMonthlyRollup(
|
|
282
|
+
records: SkillSessionRecord[],
|
|
283
|
+
now: Date = new Date(),
|
|
284
|
+
): MonthlyAdoptionRollup {
|
|
285
|
+
const months = [0, 1, 2].map((i) => monthOf(new Date(now.getFullYear(), now.getMonth() - i, 1)));
|
|
286
|
+
const bucketsByMonth = new Map<string, Map<string, ProfileAdoption>>();
|
|
287
|
+
for (const month of months) bucketsByMonth.set(month, new Map());
|
|
288
|
+
for (const rec of foldSessionRecords(records)) {
|
|
289
|
+
const monthBuckets = bucketsByMonth.get(rec.month);
|
|
290
|
+
if (!monthBuckets) continue; // outside the 3-month window
|
|
291
|
+
if (rec.role === NEUTRAL_SESSION_PROFILE) continue; // neutral excluded from the rollup
|
|
292
|
+
let bucket = monthBuckets.get(rec.role);
|
|
293
|
+
if (!bucket) {
|
|
294
|
+
bucket = { sessions: 0, sessionsWithLoad: 0, adoptionRate: 0 };
|
|
295
|
+
monthBuckets.set(rec.role, bucket);
|
|
296
|
+
}
|
|
297
|
+
bucket.sessions++;
|
|
298
|
+
if (rec.hadSkillLoad) bucket.sessionsWithLoad++;
|
|
299
|
+
}
|
|
300
|
+
const rollup: MonthlyAdoptionRollup = {};
|
|
301
|
+
for (const month of months) {
|
|
302
|
+
const monthRollup: Record<string, ProfileAdoption> = {};
|
|
303
|
+
for (const [name, bucket] of bucketsByMonth.get(month)!) {
|
|
304
|
+
bucket.adoptionRate =
|
|
305
|
+
bucket.sessions > 0
|
|
306
|
+
? Math.round((bucket.sessionsWithLoad / bucket.sessions) * 100) / 100
|
|
307
|
+
: 0;
|
|
308
|
+
monthRollup[name] = bucket;
|
|
309
|
+
}
|
|
310
|
+
rollup[month] = monthRollup;
|
|
311
|
+
}
|
|
312
|
+
return rollup;
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
/** Read the store and compute the rollup (store path injectable for tests). */
|
|
316
|
+
export function getMonthlyAdoptionRollup(
|
|
317
|
+
options: { now?: Date; storePath?: string } = {},
|
|
318
|
+
): MonthlyAdoptionRollup {
|
|
319
|
+
let storePath: string;
|
|
320
|
+
try {
|
|
321
|
+
storePath = options.storePath ?? getSkillsSessionsFilePath();
|
|
322
|
+
} catch (err) {
|
|
323
|
+
// Reader: a refused path (no absolute braid root) is a miss, not a throw.
|
|
324
|
+
reportRecordFailure(err);
|
|
325
|
+
return {};
|
|
326
|
+
}
|
|
327
|
+
return computeMonthlyRollup(readSessionRecords(storePath), options.now);
|
|
328
|
+
}
|