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,300 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Top-level pi extension discovery.
|
|
3
|
+
*
|
|
4
|
+
* Discovers pi extension PACKAGES (package.json with a `pi` field)
|
|
5
|
+
* from the settings `packages` field — never a walk over cwd/siblings.
|
|
6
|
+
* Sources in pi-core precedence: project (<cwd>/.pi/settings.json)
|
|
7
|
+
* then user (~/.pi/agent/settings.json); project scope wins for the
|
|
8
|
+
* same identity. Entries: absolute local path, `npm:` (via `npm root
|
|
9
|
+
* -g`), or `git:` (best-effort skip), tagged project / user-global.
|
|
10
|
+
* Best-effort: unreadable or missing packages are silently skipped —
|
|
11
|
+
* no "failed to resolve" noise in the prompt.
|
|
12
|
+
*/
|
|
13
|
+
import { execSync } from "node:child_process";
|
|
14
|
+
import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
|
|
15
|
+
import { join, resolve } from "node:path";
|
|
16
|
+
/**
|
|
17
|
+
* Read and parse a JSON settings file. Returns an empty object on
|
|
18
|
+
* any failure (missing, unreadable, malformed) -- settings reads
|
|
19
|
+
* are best-effort, never throw into the prompt builder.
|
|
20
|
+
*/
|
|
21
|
+
function readSettings(filePath) {
|
|
22
|
+
if (!existsSync(filePath))
|
|
23
|
+
return {};
|
|
24
|
+
try {
|
|
25
|
+
return JSON.parse(readFileSync(filePath, "utf8"));
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return {};
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Read a settings file at `path` and return each `packages` entry's
|
|
33
|
+
* source string. Tolerates both string and object entry shapes
|
|
34
|
+
* (`"npm:foo"` and `{ source: "npm:foo", ... }`).
|
|
35
|
+
*/
|
|
36
|
+
function readPackageEntries(filePath) {
|
|
37
|
+
const settings = readSettings(filePath);
|
|
38
|
+
const out = [];
|
|
39
|
+
for (const entry of settings.packages ?? []) {
|
|
40
|
+
if (typeof entry === "string") {
|
|
41
|
+
out.push({ source: entry });
|
|
42
|
+
}
|
|
43
|
+
else if (entry && typeof entry.source === "string") {
|
|
44
|
+
out.push({ source: entry.source });
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return out;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Read package.json from `dir` and return a TopLevelExtension if it
|
|
51
|
+
* declares ANY `pi` field. Returns null for directories that are
|
|
52
|
+
* not pi packages (e.g. a plain node_modules dep with no `pi`
|
|
53
|
+
* field).
|
|
54
|
+
*
|
|
55
|
+
* We accept any pi-resource declaration -- extensions, skills,
|
|
56
|
+
* prompts, or themes -- because all four are equally "what the user
|
|
57
|
+
* configured pi to load". Filtering to only extension providers
|
|
58
|
+
* would hide pure skill packs (e.g. `pi-braid-skills`) from the
|
|
59
|
+
* prompt even though they ship real, loadable runtime content.
|
|
60
|
+
*/
|
|
61
|
+
function readPiPackage(dir, source) {
|
|
62
|
+
const pkgPath = join(dir, "package.json");
|
|
63
|
+
if (!existsSync(pkgPath))
|
|
64
|
+
return null;
|
|
65
|
+
try {
|
|
66
|
+
const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
|
|
67
|
+
if (!pkg.pi)
|
|
68
|
+
return null;
|
|
69
|
+
// Require at least one pi-resource declaration. A package.json
|
|
70
|
+
// with `pi: {}` is structurally present but provides nothing.
|
|
71
|
+
const hasExtension = (Array.isArray(pkg.pi.extensions) && pkg.pi.extensions.length > 0) ||
|
|
72
|
+
typeof pkg.pi.extension === "string";
|
|
73
|
+
const hasSkill = Array.isArray(pkg.pi.skills) && pkg.pi.skills.length > 0;
|
|
74
|
+
const hasPrompt = Array.isArray(pkg.pi.prompts) && pkg.pi.prompts.length > 0;
|
|
75
|
+
if (!hasExtension && !hasSkill && !hasPrompt)
|
|
76
|
+
return null;
|
|
77
|
+
const entries = [];
|
|
78
|
+
if (Array.isArray(pkg.pi.extensions))
|
|
79
|
+
entries.push(...pkg.pi.extensions);
|
|
80
|
+
if (typeof pkg.pi.extension === "string")
|
|
81
|
+
entries.push(pkg.pi.extension);
|
|
82
|
+
return {
|
|
83
|
+
name: pkg.name ?? basename(dir),
|
|
84
|
+
version: pkg.version ?? "unknown",
|
|
85
|
+
root: resolve(dir),
|
|
86
|
+
source,
|
|
87
|
+
entries,
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
catch {
|
|
91
|
+
return null;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
/** Last path segment, ignoring trailing slashes. */
|
|
95
|
+
function basename(p) {
|
|
96
|
+
const parts = p.split("/").filter(Boolean);
|
|
97
|
+
return parts[parts.length - 1] ?? p;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Resolve a single `packages` entry source string to a directory
|
|
101
|
+
* containing a valid pi-extension package. Returns null if the
|
|
102
|
+
* source is unsupported or cannot be located on disk.
|
|
103
|
+
*
|
|
104
|
+
* Supported shapes:
|
|
105
|
+
* - `npm:<spec>` (e.g. `npm:pi-web-access`) -- looks in the global
|
|
106
|
+
* npm root (`npm root -g`), under each scoped directory.
|
|
107
|
+
* - absolute local path (starts with `/`) -- used as-is.
|
|
108
|
+
* - relative local path -- resolved relative to `cwd`.
|
|
109
|
+
*/
|
|
110
|
+
function resolveEntryToPackage(source, scope, cwd) {
|
|
111
|
+
const trimmed = source.trim();
|
|
112
|
+
if (!trimmed)
|
|
113
|
+
return null;
|
|
114
|
+
// npm:<spec> -- find in global node_modules.
|
|
115
|
+
if (trimmed.startsWith("npm:")) {
|
|
116
|
+
const spec = trimmed.slice("npm:".length).trim();
|
|
117
|
+
const at = spec.lastIndexOf("@");
|
|
118
|
+
// Specs of the form `@scope/name` have the version boundary at
|
|
119
|
+
// the SECOND `@`; the first `@` is part of the scope. We only
|
|
120
|
+
// strip a trailing `@version` if it parses as semver-ish.
|
|
121
|
+
let name = spec;
|
|
122
|
+
let version;
|
|
123
|
+
if (at > 0 && at < spec.length - 1 && /[\d.]/.test(spec[at + 1])) {
|
|
124
|
+
name = spec.slice(0, at);
|
|
125
|
+
version = spec.slice(at + 1);
|
|
126
|
+
}
|
|
127
|
+
if (!name)
|
|
128
|
+
return null;
|
|
129
|
+
const installedDir = findNpmPackageDir(name, version);
|
|
130
|
+
if (!installedDir)
|
|
131
|
+
return null;
|
|
132
|
+
return readPiPackage(installedDir, scope);
|
|
133
|
+
}
|
|
134
|
+
// Local path: absolute or relative-to-cwd.
|
|
135
|
+
const localPath = trimmed.startsWith("/") || trimmed.startsWith("~")
|
|
136
|
+
? expandHome(trimmed)
|
|
137
|
+
: resolve(cwd, trimmed);
|
|
138
|
+
if (!existsSync(localPath))
|
|
139
|
+
return null;
|
|
140
|
+
let isDir;
|
|
141
|
+
try {
|
|
142
|
+
isDir = statSync(localPath).isDirectory();
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
return null;
|
|
146
|
+
}
|
|
147
|
+
if (!isDir)
|
|
148
|
+
return null;
|
|
149
|
+
return readPiPackage(localPath, scope);
|
|
150
|
+
}
|
|
151
|
+
/** Minimal `~` expansion (no env-var interpolation beyond $HOME). */
|
|
152
|
+
function expandHome(p) {
|
|
153
|
+
if (p === "~")
|
|
154
|
+
return process.env.HOME ?? p;
|
|
155
|
+
if (p.startsWith("~/")) {
|
|
156
|
+
return join(process.env.HOME ?? "", p.slice(2));
|
|
157
|
+
}
|
|
158
|
+
return p;
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Locate a globally-installed npm package by name. Walks the
|
|
162
|
+
* scope directories under the global npm root (`npm root -g`).
|
|
163
|
+
* Optional `version` filters to a directory whose `package.json`
|
|
164
|
+
* version matches; if absent, the first matching directory wins.
|
|
165
|
+
*
|
|
166
|
+
* Returns the absolute directory path, or null if not found.
|
|
167
|
+
*/
|
|
168
|
+
function findNpmPackageDir(name, version) {
|
|
169
|
+
const globalRoot = getGlobalNpmRoot();
|
|
170
|
+
if (!globalRoot)
|
|
171
|
+
return null;
|
|
172
|
+
if (!existsSync(globalRoot))
|
|
173
|
+
return null;
|
|
174
|
+
// Scoped package: @scope/name -> look under globalRoot/@scope/name.
|
|
175
|
+
if (name.startsWith("@")) {
|
|
176
|
+
const dir = join(globalRoot, name);
|
|
177
|
+
return packageDirMatches(dir, version) ? dir : null;
|
|
178
|
+
}
|
|
179
|
+
// Unscoped: scan globalRoot itself for a directory whose
|
|
180
|
+
// package.json `name` matches. npm installs both flat and nested layouts.
|
|
181
|
+
let entries;
|
|
182
|
+
try {
|
|
183
|
+
entries = readdirSync(globalRoot);
|
|
184
|
+
}
|
|
185
|
+
catch {
|
|
186
|
+
return null;
|
|
187
|
+
}
|
|
188
|
+
for (const entry of entries) {
|
|
189
|
+
const dir = join(globalRoot, entry);
|
|
190
|
+
let isDir;
|
|
191
|
+
try {
|
|
192
|
+
isDir = statSync(dir).isDirectory();
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
if (!isDir)
|
|
198
|
+
continue;
|
|
199
|
+
if (packageDirMatches(dir, version, name))
|
|
200
|
+
return dir;
|
|
201
|
+
}
|
|
202
|
+
return null;
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* Does the directory at `dir` look like the package we want?
|
|
206
|
+
* - If `expectedName` is given, the package.json's `name` field
|
|
207
|
+
* must match (used for unscoped lookup where the directory name
|
|
208
|
+
* may differ from the package name).
|
|
209
|
+
* - If `expectedVersion` is given, the package.json's `version`
|
|
210
|
+
* field must match exactly.
|
|
211
|
+
* - Otherwise, just require a package.json to exist.
|
|
212
|
+
*/
|
|
213
|
+
function packageDirMatches(dir, expectedVersion, expectedName) {
|
|
214
|
+
const pkgPath = join(dir, "package.json");
|
|
215
|
+
if (!existsSync(pkgPath))
|
|
216
|
+
return false;
|
|
217
|
+
try {
|
|
218
|
+
const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
|
|
219
|
+
if (expectedName && pkg.name !== expectedName)
|
|
220
|
+
return false;
|
|
221
|
+
if (expectedVersion && pkg.version !== expectedVersion)
|
|
222
|
+
return false;
|
|
223
|
+
return true;
|
|
224
|
+
}
|
|
225
|
+
catch {
|
|
226
|
+
return false;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Resolve the global npm root via `npm root -g`. Returns null if
|
|
231
|
+
* the command fails or produces no output. Cached after first
|
|
232
|
+
* successful call so the (slow) `npm root -g` invocation runs at
|
|
233
|
+
* most once per process -- the value never changes inside one
|
|
234
|
+
* pi session.
|
|
235
|
+
*
|
|
236
|
+
* Implemented as an IIFE-wrapped closure so the cache `let`
|
|
237
|
+
* stays function-scoped (the project's no-module-level-let
|
|
238
|
+
* policy keeps top-level `let` out of every file except the
|
|
239
|
+
* documented exceptions in `src/lib/state/`).
|
|
240
|
+
*/
|
|
241
|
+
const getGlobalNpmRoot = (() => {
|
|
242
|
+
let cached;
|
|
243
|
+
return () => {
|
|
244
|
+
if (cached !== undefined)
|
|
245
|
+
return cached;
|
|
246
|
+
try {
|
|
247
|
+
const out = execSync("npm root -g 2>/dev/null || true", {
|
|
248
|
+
encoding: "utf8",
|
|
249
|
+
timeout: 5000,
|
|
250
|
+
}).trim();
|
|
251
|
+
cached = out || null;
|
|
252
|
+
}
|
|
253
|
+
catch {
|
|
254
|
+
cached = null;
|
|
255
|
+
}
|
|
256
|
+
return cached;
|
|
257
|
+
};
|
|
258
|
+
})();
|
|
259
|
+
/**
|
|
260
|
+
* Discover top-level pi extension packages from pi-core's settings.
|
|
261
|
+
*
|
|
262
|
+
* Walks both settings scopes (project, then user-global) in pi's
|
|
263
|
+
* own precedence order, dedupes by absolute root path (project
|
|
264
|
+
* wins over user-global on collision), and returns the resolved
|
|
265
|
+
* packages. Unresolved entries are silently skipped -- a missing
|
|
266
|
+
* package should never surface as "unknown" in the prompt.
|
|
267
|
+
*
|
|
268
|
+
* Settings-file paths:
|
|
269
|
+
* - project: `<cwd>/.pi/settings.json`
|
|
270
|
+
* - user-global: read from `PI_CODING_AGENT_DIR` env override,
|
|
271
|
+
* falling back to `~/.pi/agent/settings.json`.
|
|
272
|
+
*/
|
|
273
|
+
export function discoverTopLevelExtensions(cwd = process.cwd(), options) {
|
|
274
|
+
const projectPath = options?.projectSettingsPath ?? join(cwd, ".pi", "settings.json");
|
|
275
|
+
const userPath = options?.userSettingsPath ??
|
|
276
|
+
process.env.PI_CODING_AGENT_DIR ??
|
|
277
|
+
join(process.env.HOME ?? "~", ".pi", "agent", "settings.json");
|
|
278
|
+
const seen = new Set();
|
|
279
|
+
const out = [];
|
|
280
|
+
const add = (pkg, source) => {
|
|
281
|
+
if (!pkg)
|
|
282
|
+
return;
|
|
283
|
+
if (seen.has(pkg.root))
|
|
284
|
+
return;
|
|
285
|
+
seen.add(pkg.root);
|
|
286
|
+
out.push({ pkg, source });
|
|
287
|
+
};
|
|
288
|
+
// Project scope first (matches pi-core's precedence).
|
|
289
|
+
for (const entry of readPackageEntries(projectPath)) {
|
|
290
|
+
add(resolveEntryToPackage(entry.source, "project", cwd), "project");
|
|
291
|
+
}
|
|
292
|
+
// User-global scope.
|
|
293
|
+
for (const entry of readPackageEntries(userPath)) {
|
|
294
|
+
add(resolveEntryToPackage(entry.source, "user-global", cwd), "user-global");
|
|
295
|
+
}
|
|
296
|
+
// Sort within each scope by name for stable output.
|
|
297
|
+
out.sort((a, b) => a.pkg.name.localeCompare(b.pkg.name));
|
|
298
|
+
return out.map((r) => r.pkg);
|
|
299
|
+
}
|
|
300
|
+
//# sourceMappingURL=top-level-extensions.js.map
|
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Skills Auto-Injection — relevant skill suggestion via steer whisper.
|
|
3
|
+
*
|
|
4
|
+
* Agenda:
|
|
5
|
+
* Instead of requiring the agent to discover skills via `list_skills` tool,
|
|
6
|
+
* proactively detect when a skill is relevant to the current task and inject
|
|
7
|
+
* a suggestion via the steer whisper pattern.
|
|
8
|
+
*
|
|
9
|
+
* Design:
|
|
10
|
+
* 1. Relevance detection: keyword match of skill name/description plus
|
|
11
|
+
* frontmatter trigger phrases against the user's current prompt.
|
|
12
|
+
* Qualification bar: a skill whose match never touches its NAME (name
|
|
13
|
+
* token or trigger phrase) must reach a score of at least
|
|
14
|
+
* MIN_NON_NAME_SCORE — a lone description/path keyword hit is too weak
|
|
15
|
+
* a signal: it fires broad skills on almost any prompt.
|
|
16
|
+
* Keywords are stemmed with one suffix rule (trailing s/es) so plural
|
|
17
|
+
* prompts hit singular name tokens ("skills" → "skill").
|
|
18
|
+
* 2. Session-scoped state: track which skills were injected on which turn.
|
|
19
|
+
* Cooldown is per-skill on top of the global floor: an injected skill
|
|
20
|
+
* cools down at least COOLDOWN_TURNS, and once it was actually loaded
|
|
21
|
+
* (detected read) it cools down LOADED_COOLDOWN_TURNS — re-suggesting
|
|
22
|
+
* a skill that is already in context is noise.
|
|
23
|
+
* 3. Slot management: at most MAX_INJECTED skills hold a slot. A loaded
|
|
24
|
+
* skill releases its slot — it is in the agent's context now. A slot
|
|
25
|
+
* whose skill was never loaded stays held until its entry ages out of
|
|
26
|
+
* the cooldown history: measured over the recorded suggestion corpus,
|
|
27
|
+
* every recycling variant (score-margin eviction, windowed slots, a
|
|
28
|
+
* third slot) admits fills that convert far below the incumbent rate,
|
|
29
|
+
* so the cap deliberately throttles. Injection history is pruned once
|
|
30
|
+
* every cooldown window it can influence has expired.
|
|
31
|
+
* 4. Injection: sendTrackedMessage with deliverAs: "steer", triggerTurn: false,
|
|
32
|
+
* bypassing the per-turn whisper cap. The steer whisper is non-blocking
|
|
33
|
+
* (the agent reads it but does not pause its turn loop). The bypass is
|
|
34
|
+
* the module's delivery guarantee: this whisper is the only channel that
|
|
35
|
+
* can surface a matching skill, it is bounded by the module's own budget
|
|
36
|
+
* (COOLDOWN_TURNS, MAX_INJECTED, one send per turn), and the
|
|
37
|
+
* once-per-session hygiene whisper is delivered earlier in the same
|
|
38
|
+
* before_agent_start at the same priority, so without the bypass the
|
|
39
|
+
* cap would drop the suggestion exactly in the turn where a skill is
|
|
40
|
+
* most likely to match.
|
|
41
|
+
* `sendTrackedMessage` reports whether the message was accepted; a
|
|
42
|
+
* suppressed suggestion is neither sent nor counted.
|
|
43
|
+
* 5. Content delivery: the whisper carries a BOUNDED
|
|
44
|
+
* excerpt of the matching skill's SKILL.md body (frontmatter stripped,
|
|
45
|
+
* ≤ MAX_EXCERPT_CHARS) plus an explicit read pointer to the full file —
|
|
46
|
+
* so skill content actually reaches the agent's view at the moment a
|
|
47
|
+
* domain matches, not just a truncated description. Best-effort: an
|
|
48
|
+
* unreadable file falls back to the description.
|
|
49
|
+
* 6. No reply ritual: the whisper points at the SKILL.md read and stops
|
|
50
|
+
* there — a read is the conversion signal, and the solicited one-line
|
|
51
|
+
* reply is honored 2% of the time (channel noise, not information).
|
|
52
|
+
* 7. Adoption counter: per-skill `suggested`/`loaded` counters,
|
|
53
|
+
* incremented on delivery and on load, surfaced by the `skill_stats`
|
|
54
|
+
* tool. `suggested` counts DELIVERED suggestions: the counter increments
|
|
55
|
+
* only after `sendTrackedMessage` reports the whisper was accepted, so
|
|
56
|
+
* the number measures the suggestion channel rather than the intent to
|
|
57
|
+
* use it. A load has two evidence grades — a verbal claim (the LOADED
|
|
58
|
+
* probe reply, an honor-system grade the whisper does not solicit; the
|
|
59
|
+
* counter stays monotone for the store's series) and a detected actual
|
|
60
|
+
* load (SKILL.md read seen by the tool_result read-detector; failed
|
|
61
|
+
* reads are skipped — an error result is not a load). Both increment
|
|
62
|
+
* `loaded`, so the all-time series stays continuous;
|
|
63
|
+
* `claimed`/`actual` record which trigger fired, and the detected read
|
|
64
|
+
* is the primary signal — sessionHasSkillLoad gates on actual loads
|
|
65
|
+
* only. Durable store rows carry an `epoch` marking which counting
|
|
66
|
+
* regime their `suggested` number mixes (rows written before the
|
|
67
|
+
* delivered-only regime normalize to "mixed": inflated, not comparable
|
|
68
|
+
* to delivered-regime counts), and rows written before the
|
|
69
|
+
* claimed/actual split normalize with actual = loaded, claimed = 0.
|
|
70
|
+
* 8. Discovery record: after a compaction, pi's section rebuild can put
|
|
71
|
+
* the stock skill catalog back into the persisted transcript (braid
|
|
72
|
+
* suppresses it per-turn, but the post-compaction diff runs against
|
|
73
|
+
* pi's own options). The module records whether the catalog is present
|
|
74
|
+
* and surfaces the state through skill_stats instead of mutating the
|
|
75
|
+
* transcript.
|
|
76
|
+
* 9. Best-effort: failures are non-fatal, logged at debug level.
|
|
77
|
+
*
|
|
78
|
+
* Structure matches the existing steer whisper pattern used by topic-drift,
|
|
79
|
+
* turn-outcome, compaction-retry, context-lifecycle, and others.
|
|
80
|
+
*
|
|
81
|
+
* Integration:
|
|
82
|
+
* Registered in skills-tool/index.ts extension factory.
|
|
83
|
+
* Consumes the module-level skill cache populated by prompt-builder's
|
|
84
|
+
* before_agent_start handler.
|
|
85
|
+
*/
|
|
86
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
87
|
+
/**
|
|
88
|
+
* Max skill suggestions holding a slot at any time.
|
|
89
|
+
*
|
|
90
|
+
* The cap is the channel's throttle, and measurement says it must stay 2: a
|
|
91
|
+
* third slot's fills convert far below the incumbent rate, and every
|
|
92
|
+
* eviction/recycling variant that frees slots admits fills no better — the
|
|
93
|
+
* loads a bigger cap would "recover" were outranked by other live matches,
|
|
94
|
+
* not starved of slots.
|
|
95
|
+
*/
|
|
96
|
+
export declare const MAX_INJECTED = 2;
|
|
97
|
+
/**
|
|
98
|
+
* Global cooldown floor: minimum turns before ANY skill can be re-injected.
|
|
99
|
+
* Every injected skill cools down at least this long, whatever its own history.
|
|
100
|
+
*/
|
|
101
|
+
export declare const COOLDOWN_TURNS = 10;
|
|
102
|
+
/**
|
|
103
|
+
* Per-skill cooldown extension: a suggested skill that was actually loaded
|
|
104
|
+
* sits in the agent's context, so after its load it cools down for
|
|
105
|
+
* LOADED_COOLDOWN_TURNS (3× the floor) and releases its suggestion slot for
|
|
106
|
+
* the next match — re-suggesting an in-context skill is noise.
|
|
107
|
+
*/
|
|
108
|
+
export declare const LOADED_COOLDOWN_TURNS = 30;
|
|
109
|
+
/**
|
|
110
|
+
* Max characters of SKILL.md body content carried in a suggestion whisper,
|
|
111
|
+
* per skill. Bounded so the steer stays a whisper (~2 skills × 300 chars +
|
|
112
|
+
* boilerplate). The whisper always points at the full file for the rest.
|
|
113
|
+
*/
|
|
114
|
+
export declare const MAX_EXCERPT_CHARS = 300;
|
|
115
|
+
/**
|
|
116
|
+
* Minimum score for a skill whose match never touches its NAME (description
|
|
117
|
+
* and/or filePath keyword hits only). Name matches qualify at any score.
|
|
118
|
+
*/
|
|
119
|
+
export declare const MIN_NON_NAME_SCORE = 2;
|
|
120
|
+
export interface InjectedSkill {
|
|
121
|
+
name: string;
|
|
122
|
+
turnNumber: number;
|
|
123
|
+
filePath: string;
|
|
124
|
+
/** Turn the skill was detected loaded after injection; releases the slot, extends the cooldown. */
|
|
125
|
+
loadedTurn?: number;
|
|
126
|
+
}
|
|
127
|
+
export interface CachedSkill {
|
|
128
|
+
name: string;
|
|
129
|
+
filePath: string;
|
|
130
|
+
description: string;
|
|
131
|
+
baseDir: string;
|
|
132
|
+
sourceInfo?: {
|
|
133
|
+
source?: string;
|
|
134
|
+
package?: string;
|
|
135
|
+
};
|
|
136
|
+
/** pi frontmatter flag: excluded from model selection (explicit invocation only). */
|
|
137
|
+
disableModelInvocation?: boolean;
|
|
138
|
+
/** Frontmatter trigger phrases (setCachedSkills resolves them from SKILL.md). */
|
|
139
|
+
triggers?: string[];
|
|
140
|
+
}
|
|
141
|
+
/** Called by index.ts's setCachedSkills to keep the auto-inject cache in sync. */
|
|
142
|
+
export declare function updateSkillCache(skills: CachedSkill[]): void;
|
|
143
|
+
/**
|
|
144
|
+
* One-rule stemmer: strip a trailing plural s/es so "skills" matches the
|
|
145
|
+
* "skill" name token. Kept deliberately crude — one suffix rule, no
|
|
146
|
+
* dictionary — because the matcher needs recall on plurals, not linguistics:
|
|
147
|
+
* "sses"/"xes"/"zes"/"ches"/"shes" → strip es (classes→class, boxes→box)
|
|
148
|
+
* other trailing s (not ss) → strip s (skills→skill, memes→meme)
|
|
149
|
+
* Everything else passes through unchanged.
|
|
150
|
+
*/
|
|
151
|
+
export declare function stemKeyword(word: string): string;
|
|
152
|
+
/**
|
|
153
|
+
* Extract significant keywords from a text string.
|
|
154
|
+
* Filters out stop words, short words, and non-alphabetic tokens, then stems
|
|
155
|
+
* trailing plurals; the stem result must still pass the length and stop-word
|
|
156
|
+
* bar (stemming "tasks" lands on the noise word "task", which stays out).
|
|
157
|
+
*/
|
|
158
|
+
export declare function extractKeywords(text: string): string[];
|
|
159
|
+
/**
|
|
160
|
+
* Score a skill against a set of keywords.
|
|
161
|
+
*
|
|
162
|
+
* Scoring rules:
|
|
163
|
+
* +3 skill name contains a keyword (exact match)
|
|
164
|
+
* +2 skill name contains a keyword as substring
|
|
165
|
+
* +2 a frontmatter trigger phrase occurs in the prompt (word-bounded)
|
|
166
|
+
* +1 skill description contains a keyword
|
|
167
|
+
* +1 skill filePath contains a keyword (e.g. "research" in "research/SKILL.md")
|
|
168
|
+
*
|
|
169
|
+
* A trigger hit counts as a name hit: the phrase is the skill author's own
|
|
170
|
+
* relevance signal, so it qualifies the skill the same way a name match does.
|
|
171
|
+
*
|
|
172
|
+
* Qualification bar: a skill whose match never touches its NAME (description
|
|
173
|
+
* and/or filePath hits only) must reach a total score of at least
|
|
174
|
+
* MIN_NON_NAME_SCORE — one description keyword is too weak a signal and
|
|
175
|
+
* lets generic skills fire on almost any prompt. Name and trigger matches
|
|
176
|
+
* always qualify.
|
|
177
|
+
*
|
|
178
|
+
* `promptText` (lowercased by the caller or raw — matching is case-insensitive
|
|
179
|
+
* on our side) enables trigger matching; omit it where the raw prompt is not
|
|
180
|
+
* available and only keyword scoring should run.
|
|
181
|
+
*
|
|
182
|
+
* Returns 0 if the skill does not qualify.
|
|
183
|
+
*/
|
|
184
|
+
export declare function scoreSkill(skill: CachedSkill, keywords: string[], promptText?: string): number;
|
|
185
|
+
/**
|
|
186
|
+
* Decide which scored skills to suggest given the session injection state.
|
|
187
|
+
* Pure — mirrors the handler's decision path so it can be unit-tested:
|
|
188
|
+
* sort (score desc, name asc) → cooldown filter (global floor + per-skill
|
|
189
|
+
* loaded extension) → slot budget over ACTIVE held slots (a loaded skill
|
|
190
|
+
* released its slot) → top-N slice.
|
|
191
|
+
*
|
|
192
|
+
* Returns the chosen scored items (empty when nothing qualifies). The
|
|
193
|
+
* caller is responsible for recording the picks in session state.
|
|
194
|
+
*/
|
|
195
|
+
export declare function selectSuggestions(scored: Array<{
|
|
196
|
+
skill: CachedSkill;
|
|
197
|
+
score: number;
|
|
198
|
+
}>, injected: InjectedSkill[], currentTurn: number): Array<{
|
|
199
|
+
skill: CachedSkill;
|
|
200
|
+
score: number;
|
|
201
|
+
}>;
|
|
202
|
+
/**
|
|
203
|
+
* Strip YAML frontmatter from a SKILL.md body. Pure.
|
|
204
|
+
*
|
|
205
|
+
* Agent Skills files open with `---\nkey: value...\n---`; the frontmatter
|
|
206
|
+
* duplicates the metadata we already have (name/description), so the excerpt
|
|
207
|
+
* starts at the actual instructions. Tolerant: files without frontmatter
|
|
208
|
+
* (or with an unclosed `---` block) are returned as-is.
|
|
209
|
+
*/
|
|
210
|
+
export declare function stripSkillFrontmatter(content: string): string;
|
|
211
|
+
/**
|
|
212
|
+
* Bounded excerpt of a skill body: strip frontmatter, trim, cap at maxChars,
|
|
213
|
+
* mark truncation. Pure.
|
|
214
|
+
*/
|
|
215
|
+
export declare function extractSkillExcerpt(content: string, maxChars?: number): string;
|
|
216
|
+
/**
|
|
217
|
+
* Read a SKILL.md from disk and return a bounded body excerpt.
|
|
218
|
+
* Returns "" on any error (missing file, unreadable) — the caller falls
|
|
219
|
+
* back to the skill description.
|
|
220
|
+
*/
|
|
221
|
+
export declare function readSkillExcerpt(filePath: string, maxChars?: number): string;
|
|
222
|
+
/**
|
|
223
|
+
* Format the steer whisper content for a set of recommended skills.
|
|
224
|
+
*
|
|
225
|
+
* Each bullet carries a BOUNDED excerpt of the SKILL.md body (frontmatter
|
|
226
|
+
* stripped, ≤ MAX_EXCERPT_CHARS, collapsed to one line) plus an explicit
|
|
227
|
+
* read pointer to the full file — the agent sees real skill content at the
|
|
228
|
+
* moment of domain match, not just a truncated description. Unreadable
|
|
229
|
+
* files fall back to the description (also bounded, one line).
|
|
230
|
+
*/
|
|
231
|
+
export declare function formatWhisper(skills: CachedSkill[]): string;
|
|
232
|
+
/** Per-skill usage counters, session-scoped (a durable cross-session copy is mirrored below). */
|
|
233
|
+
export interface SkillStats {
|
|
234
|
+
/** Times this skill was suggested via the auto-inject whisper. */
|
|
235
|
+
suggested: number;
|
|
236
|
+
/** Total loads: probe claims plus detected SKILL.md reads. */
|
|
237
|
+
loaded: number;
|
|
238
|
+
/** Loads claimed verbally via the LOADED probe reply (honor system). */
|
|
239
|
+
claimed: number;
|
|
240
|
+
/** Loads detected by the read tool (SKILL.md read via tool_result). */
|
|
241
|
+
actual: number;
|
|
242
|
+
}
|
|
243
|
+
/** Read the session's per-skill usage counters (for the skill_stats tool). */
|
|
244
|
+
export declare function getSkillStats(ctx: ExtensionContext): Record<string, SkillStats>;
|
|
245
|
+
/** Increment `suggested` for each skill name — called only AFTER a whisper
|
|
246
|
+
* was accepted for delivery, so the counter measures arrivals. */
|
|
247
|
+
export declare function recordSkillSuggestion(ctx: ExtensionContext, names: string[]): void;
|
|
248
|
+
/**
|
|
249
|
+
* Record a DETECTED load (SKILL.md read via the read tool) — the primary,
|
|
250
|
+
* verified load signal. Increments `loaded` + `actual`, and flips the
|
|
251
|
+
* session's durable adoption record to hadSkillLoad (the monthly rollup
|
|
252
|
+
* numerator; claims never set it).
|
|
253
|
+
*/
|
|
254
|
+
export declare function recordSkillLoad(ctx: ExtensionContext, name: string): void;
|
|
255
|
+
/**
|
|
256
|
+
* Record a CLAIMED load (a verbal "LOADED <name>" reply — the honor-system
|
|
257
|
+
* signal). The suggestion whisper does not solicit the reply, so this has no
|
|
258
|
+
* production caller; the export exists to keep `claimed` monotone in the
|
|
259
|
+
* durable store's published series. Increments `loaded` + `claimed`.
|
|
260
|
+
*/
|
|
261
|
+
export declare function recordSkillClaim(ctx: ExtensionContext, name: string): void;
|
|
262
|
+
/**
|
|
263
|
+
* Which counting regime produced an entry's `suggested` number:
|
|
264
|
+
* "delivered" — every increment counted a whisper ACCEPTED for delivery
|
|
265
|
+
* (the only regime current code writes).
|
|
266
|
+
* "mixed" — the row predates the epoch split and may contain
|
|
267
|
+
* increments counted before delivery acceptance (inflated).
|
|
268
|
+
* A mixed row stays mixed when new increments land on it: the inflation
|
|
269
|
+
* cannot be split out of the counter, so the epoch never silently improves.
|
|
270
|
+
*/
|
|
271
|
+
export type SuggestedEpoch = "delivered" | "mixed";
|
|
272
|
+
/**
|
|
273
|
+
* Per-skill durable counters, persisted to getSkillsUsageFilePath() so the
|
|
274
|
+
* adoption baseline survives process restart. Unlike the session-scoped state
|
|
275
|
+
* above, this is process-global BY DESIGN (cross-session telemetry, disk-backed)
|
|
276
|
+
* — the same exception class as `_skillsCache` above: the value must be
|
|
277
|
+
* reachable from whisper-path code with no ctx threading, and the file is the
|
|
278
|
+
* source of truth, not the cache.
|
|
279
|
+
*/
|
|
280
|
+
export interface DurableSkillStats {
|
|
281
|
+
/** All-time suggestion count (see `epoch` for which regime it mixes). */
|
|
282
|
+
suggested: number;
|
|
283
|
+
/** All-time load count (claims + detected reads). */
|
|
284
|
+
loaded: number;
|
|
285
|
+
/** All-time count of verbally claimed loads (LOADED probe reply). */
|
|
286
|
+
claimed: number;
|
|
287
|
+
/** All-time count of detected loads (SKILL.md read via the read tool). */
|
|
288
|
+
actual: number;
|
|
289
|
+
/** ISO timestamp of the most recent recorded event. */
|
|
290
|
+
lastAt: string;
|
|
291
|
+
/** Which counting regime `suggested` mixes (see SuggestedEpoch). */
|
|
292
|
+
epoch: SuggestedEpoch;
|
|
293
|
+
}
|
|
294
|
+
/** Read the durable per-skill counters (for the skill_stats tool). */
|
|
295
|
+
export declare function getDurableSkillStats(): Record<string, DurableSkillStats>;
|
|
296
|
+
/**
|
|
297
|
+
* Resolve a skill name from a read-tool result: the SKILL.md frontmatter
|
|
298
|
+
* signature (`---\nname: <name>`) first, then the file path against the
|
|
299
|
+
* cached catalog. Returns undefined when the read is not a skill load.
|
|
300
|
+
*
|
|
301
|
+
* Exported for the read-detector tests (the list→read load path): the
|
|
302
|
+
* function is pure given the module-level cache, which tests seed via
|
|
303
|
+
* updateSkillCache().
|
|
304
|
+
*/
|
|
305
|
+
export declare function skillNameFromRead(filePath: string | undefined, text: string): string | undefined;
|
|
306
|
+
/** Session-scoped record of the discovery surface's state. */
|
|
307
|
+
interface DiscoveryState {
|
|
308
|
+
/** Successful compactions seen this session. */
|
|
309
|
+
compactions: number;
|
|
310
|
+
/** A compaction landed since the last transcript check. */
|
|
311
|
+
pendingCatalogCheck: boolean;
|
|
312
|
+
/** Reason of the most recent compaction (manual / threshold / overflow). */
|
|
313
|
+
lastCompactionReason?: string;
|
|
314
|
+
/** Result of the last transcript check. */
|
|
315
|
+
stockCatalogSeen?: boolean;
|
|
316
|
+
/** ISO timestamp of the last transcript check. */
|
|
317
|
+
checkedAt?: string;
|
|
318
|
+
}
|
|
319
|
+
/**
|
|
320
|
+
* Run the pending transcript check (one per compaction) and record the
|
|
321
|
+
* discovery mode. Returns the current record for skill_stats.
|
|
322
|
+
*/
|
|
323
|
+
export declare function resolveDiscoveryMode(ctx: ExtensionContext): DiscoveryState;
|
|
324
|
+
/**
|
|
325
|
+
* Register the auto-inject handler on before_agent_start plus the
|
|
326
|
+
* read-tool load detector on tool_result.
|
|
327
|
+
*
|
|
328
|
+
* Call this from the skills-tool extension factory, after registering
|
|
329
|
+
* the list_skills tool.
|
|
330
|
+
*/
|
|
331
|
+
export declare function registerAutoInject(pi: ExtensionAPI): void;
|
|
332
|
+
export {};
|
|
333
|
+
//# sourceMappingURL=auto-inject.d.ts.map
|