pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Durable per-session skill-adoption records + monthly adoption rollup.
|
|
3
|
+
*
|
|
4
|
+
* Every session that reaches an agent turn gets ONE logical record:
|
|
5
|
+
* { sessionId, role, month, hadSkillLoad, updatedAt }
|
|
6
|
+
* `role` carries the session's profile name from the braid config (see
|
|
7
|
+
* lib/config/session-profiles.ts), or the neutral default when no profile
|
|
8
|
+
* matches; `month` is the local-time "YYYY-MM" of the write, and
|
|
9
|
+
* `hadSkillLoad` is true only after a DETECTED SKILL.md read — a verbal
|
|
10
|
+
* load claim does not count, matching the `actual` counter and
|
|
11
|
+
* sessionHasSkillLoad semantics in auto-inject.
|
|
12
|
+
*
|
|
13
|
+
* Store: append-only JSONL (getSkillsSessionsFilePath()). Writers only
|
|
14
|
+
* append whole lines — there is no read-modify-write — so sessions running
|
|
15
|
+
* concurrently in separate processes cannot lose each other's records.
|
|
16
|
+
* The upsert (one logical record per sessionId) happens at read time:
|
|
17
|
+
* records fold in file order, and for the same sessionId the latest role
|
|
18
|
+
* and month win while `hadSkillLoad` ORs across all occurrences (a
|
|
19
|
+
* session that starts in one month and loads a skill in the next is
|
|
20
|
+
* counted once, in the month of the load). Residual race: simultaneous
|
|
21
|
+
* appends from two processes can theoretically tear a line on some
|
|
22
|
+
* filesystems; the tolerant reader skips unparseable lines, the window is
|
|
23
|
+
* a single small write, and this is accepted as best-effort telemetry.
|
|
24
|
+
*
|
|
25
|
+
* Back-compat: records written before profiles existed carry a role from
|
|
26
|
+
* the retired fixed set; those values pass the profile-name gate
|
|
27
|
+
* unchanged, so older buckets keep folding under their original names.
|
|
28
|
+
* Records whose role does not pass the gate (missing, non-string, empty,
|
|
29
|
+
* malformed) fold to the neutral default.
|
|
30
|
+
*/
|
|
31
|
+
import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
|
|
32
|
+
import { dirname } from "node:path";
|
|
33
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
34
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
35
|
+
import { getSkillsSessionsFilePath } from "../../../lib/config/braid-paths.js";
|
|
36
|
+
import { NEUTRAL_SESSION_PROFILE, normalizeProfileName, resolveSessionProfileForCwd, } from "../../../lib/config/session-profiles.js";
|
|
37
|
+
const log = createLogger("skills-tool");
|
|
38
|
+
/** Local-time calendar month of a date, "YYYY-MM". */
|
|
39
|
+
export function monthOf(date) {
|
|
40
|
+
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}`;
|
|
41
|
+
}
|
|
42
|
+
// Store I/O (append-only JSONL)
|
|
43
|
+
/** Normalize one raw JSONL entry; undefined when the entry is not usable. */
|
|
44
|
+
function normalizeRecord(raw) {
|
|
45
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw))
|
|
46
|
+
return undefined;
|
|
47
|
+
const r = raw;
|
|
48
|
+
if (typeof r.sessionId !== "string" || !r.sessionId)
|
|
49
|
+
return undefined;
|
|
50
|
+
if (typeof r.month !== "string" || !/^\d{4}-\d{2}$/.test(r.month))
|
|
51
|
+
return undefined;
|
|
52
|
+
const role = normalizeProfileName(r.role) ?? NEUTRAL_SESSION_PROFILE;
|
|
53
|
+
return {
|
|
54
|
+
sessionId: r.sessionId,
|
|
55
|
+
role,
|
|
56
|
+
month: r.month,
|
|
57
|
+
hadSkillLoad: r.hadSkillLoad === true,
|
|
58
|
+
updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : "",
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Fold raw records into one logical record per sessionId (the upsert
|
|
63
|
+
* semantics): the latest role and month win, `hadSkillLoad` ORs across
|
|
64
|
+
* all occurrences, `updatedAt` keeps the newest timestamp. Pure.
|
|
65
|
+
*/
|
|
66
|
+
export function foldSessionRecords(records) {
|
|
67
|
+
const byId = new Map();
|
|
68
|
+
for (const rec of records) {
|
|
69
|
+
const prev = byId.get(rec.sessionId);
|
|
70
|
+
byId.set(rec.sessionId, prev
|
|
71
|
+
? {
|
|
72
|
+
sessionId: rec.sessionId,
|
|
73
|
+
role: rec.role,
|
|
74
|
+
month: rec.month,
|
|
75
|
+
hadSkillLoad: prev.hadSkillLoad || rec.hadSkillLoad,
|
|
76
|
+
updatedAt: prev.updatedAt > rec.updatedAt ? prev.updatedAt : rec.updatedAt,
|
|
77
|
+
}
|
|
78
|
+
: rec);
|
|
79
|
+
}
|
|
80
|
+
return [...byId.values()];
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Read + fold the store. Missing or unreadable file → empty (never
|
|
84
|
+
* throws); corrupt lines are skipped.
|
|
85
|
+
*/
|
|
86
|
+
export function readSessionRecords(storePath) {
|
|
87
|
+
let text;
|
|
88
|
+
try {
|
|
89
|
+
text = readFileSync(storePath, "utf-8");
|
|
90
|
+
}
|
|
91
|
+
catch {
|
|
92
|
+
return []; // missing or unreadable → no records
|
|
93
|
+
}
|
|
94
|
+
const out = [];
|
|
95
|
+
for (const line of text.split("\n")) {
|
|
96
|
+
const trimmed = line.trim();
|
|
97
|
+
if (!trimmed)
|
|
98
|
+
continue;
|
|
99
|
+
try {
|
|
100
|
+
const rec = normalizeRecord(JSON.parse(trimmed));
|
|
101
|
+
if (rec)
|
|
102
|
+
out.push(rec);
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
// torn or corrupt line — skip
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return out;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Append one record. Best-effort: every error is swallowed (this runs on
|
|
112
|
+
* the agent-loop and tool-result paths — a telemetry failure must never
|
|
113
|
+
* break a turn). Returns true when the line landed on disk.
|
|
114
|
+
*/
|
|
115
|
+
export function appendSessionRecord(record, storePath) {
|
|
116
|
+
try {
|
|
117
|
+
mkdirSync(dirname(storePath), { recursive: true });
|
|
118
|
+
appendFileSync(storePath, `${JSON.stringify(record)}\n`, "utf-8");
|
|
119
|
+
return true;
|
|
120
|
+
}
|
|
121
|
+
catch (err) {
|
|
122
|
+
reportRecordFailure(err);
|
|
123
|
+
return false;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
/** Warned once per process about a refused adoption-record append. */
|
|
127
|
+
let _warnedRecordFailure = false;
|
|
128
|
+
function reportRecordFailure(err) {
|
|
129
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
130
|
+
if (_warnedRecordFailure) {
|
|
131
|
+
log.debug(`session adoption record write failed (best-effort): ${message}`);
|
|
132
|
+
return;
|
|
133
|
+
}
|
|
134
|
+
_warnedRecordFailure = true;
|
|
135
|
+
log.warn(`session adoption record write failed (best-effort): ${message}`);
|
|
136
|
+
}
|
|
137
|
+
const RECORDS_STATE_KEY = "skills-session-records";
|
|
138
|
+
/** Extract (sessionId, cwd) from a real extension context; undefined otherwise. */
|
|
139
|
+
function resolveSession(ctx) {
|
|
140
|
+
try {
|
|
141
|
+
const sessionId = ctx.sessionManager.getSessionId();
|
|
142
|
+
return sessionId ? { sessionId, cwd: ctx.cwd } : undefined;
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
return undefined; // fake/partial ctx (tests) or session not ready
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* The session's effective profile, resolved from the braid config on first
|
|
150
|
+
* use and cached with the records state, so telemetry and the hint path
|
|
151
|
+
* always agree on one name for one session.
|
|
152
|
+
*/
|
|
153
|
+
export function getSessionProfile(ctx) {
|
|
154
|
+
const state = getExtensionState(ctx, RECORDS_STATE_KEY, () => ({ startRecorded: false }));
|
|
155
|
+
if (!state.profile)
|
|
156
|
+
state.profile = resolveSessionProfileForCwd(ctx.cwd);
|
|
157
|
+
return state.profile;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* Write the session's start record (hadSkillLoad=false) exactly once per
|
|
161
|
+
* session — the denominator of the adoption rate. Later writes for the
|
|
162
|
+
* same session only ever flip the flag upward (see fold semantics).
|
|
163
|
+
*/
|
|
164
|
+
export function recordSessionStart(ctx, storePath) {
|
|
165
|
+
try {
|
|
166
|
+
const sess = resolveSession(ctx);
|
|
167
|
+
if (!sess)
|
|
168
|
+
return;
|
|
169
|
+
const state = getExtensionState(ctx, RECORDS_STATE_KEY, () => ({
|
|
170
|
+
startRecorded: false,
|
|
171
|
+
}));
|
|
172
|
+
if (state.startRecorded)
|
|
173
|
+
return;
|
|
174
|
+
const ok = appendSessionRecord({
|
|
175
|
+
sessionId: sess.sessionId,
|
|
176
|
+
role: getSessionProfile(ctx).name,
|
|
177
|
+
month: monthOf(new Date()),
|
|
178
|
+
hadSkillLoad: false,
|
|
179
|
+
updatedAt: new Date().toISOString(),
|
|
180
|
+
}, storePath ?? getSkillsSessionsFilePath());
|
|
181
|
+
if (ok)
|
|
182
|
+
state.startRecorded = true;
|
|
183
|
+
}
|
|
184
|
+
catch (err) {
|
|
185
|
+
reportRecordFailure(err);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Append a hadSkillLoad=true record after a DETECTED SKILL.md read (the
|
|
190
|
+
* numerator of the adoption rate). Claims must NOT route here.
|
|
191
|
+
*/
|
|
192
|
+
export function recordSessionSkillLoad(ctx, storePath) {
|
|
193
|
+
try {
|
|
194
|
+
const sess = resolveSession(ctx);
|
|
195
|
+
if (!sess)
|
|
196
|
+
return;
|
|
197
|
+
appendSessionRecord({
|
|
198
|
+
sessionId: sess.sessionId,
|
|
199
|
+
role: getSessionProfile(ctx).name,
|
|
200
|
+
month: monthOf(new Date()),
|
|
201
|
+
hadSkillLoad: true,
|
|
202
|
+
updatedAt: new Date().toISOString(),
|
|
203
|
+
}, storePath ?? getSkillsSessionsFilePath());
|
|
204
|
+
}
|
|
205
|
+
catch (err) {
|
|
206
|
+
reportRecordFailure(err);
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Compute the monthly adoption rollup for the current + previous 2
|
|
211
|
+
* months, keyed by session profile name. Pure (given records + now).
|
|
212
|
+
* Sessions recorded before the rollup existed simply don't exist in the
|
|
213
|
+
* store — the rollup starts from deployment and deliberately undercounts
|
|
214
|
+
* rather than estimating history. The neutral profile stays out: it is
|
|
215
|
+
* the "no profile configured" bucket, not an adoption target.
|
|
216
|
+
*
|
|
217
|
+
* Profile buckets are staged in a Map and copied out at the end, so a
|
|
218
|
+
* profile named like an Object.prototype member (e.g. "constructor")
|
|
219
|
+
* cannot corrupt the rollup.
|
|
220
|
+
*/
|
|
221
|
+
export function computeMonthlyRollup(records, now = new Date()) {
|
|
222
|
+
const months = [0, 1, 2].map((i) => monthOf(new Date(now.getFullYear(), now.getMonth() - i, 1)));
|
|
223
|
+
const bucketsByMonth = new Map();
|
|
224
|
+
for (const month of months)
|
|
225
|
+
bucketsByMonth.set(month, new Map());
|
|
226
|
+
for (const rec of foldSessionRecords(records)) {
|
|
227
|
+
const monthBuckets = bucketsByMonth.get(rec.month);
|
|
228
|
+
if (!monthBuckets)
|
|
229
|
+
continue; // outside the 3-month window
|
|
230
|
+
if (rec.role === NEUTRAL_SESSION_PROFILE)
|
|
231
|
+
continue; // neutral excluded from the rollup
|
|
232
|
+
let bucket = monthBuckets.get(rec.role);
|
|
233
|
+
if (!bucket) {
|
|
234
|
+
bucket = { sessions: 0, sessionsWithLoad: 0, adoptionRate: 0 };
|
|
235
|
+
monthBuckets.set(rec.role, bucket);
|
|
236
|
+
}
|
|
237
|
+
bucket.sessions++;
|
|
238
|
+
if (rec.hadSkillLoad)
|
|
239
|
+
bucket.sessionsWithLoad++;
|
|
240
|
+
}
|
|
241
|
+
const rollup = {};
|
|
242
|
+
for (const month of months) {
|
|
243
|
+
const monthRollup = {};
|
|
244
|
+
for (const [name, bucket] of bucketsByMonth.get(month)) {
|
|
245
|
+
bucket.adoptionRate =
|
|
246
|
+
bucket.sessions > 0
|
|
247
|
+
? Math.round((bucket.sessionsWithLoad / bucket.sessions) * 100) / 100
|
|
248
|
+
: 0;
|
|
249
|
+
monthRollup[name] = bucket;
|
|
250
|
+
}
|
|
251
|
+
rollup[month] = monthRollup;
|
|
252
|
+
}
|
|
253
|
+
return rollup;
|
|
254
|
+
}
|
|
255
|
+
/** Read the store and compute the rollup (store path injectable for tests). */
|
|
256
|
+
export function getMonthlyAdoptionRollup(options = {}) {
|
|
257
|
+
let storePath;
|
|
258
|
+
try {
|
|
259
|
+
storePath = options.storePath ?? getSkillsSessionsFilePath();
|
|
260
|
+
}
|
|
261
|
+
catch (err) {
|
|
262
|
+
// Reader: a refused path (no absolute braid root) is a miss, not a throw.
|
|
263
|
+
reportRecordFailure(err);
|
|
264
|
+
return {};
|
|
265
|
+
}
|
|
266
|
+
return computeMonthlyRollup(readSessionRecords(storePath), options.now);
|
|
267
|
+
}
|
|
268
|
+
//# sourceMappingURL=session-records.js.map
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Frontmatter `triggers:` phrases for the suggestion matcher.
|
|
3
|
+
*
|
|
4
|
+
* pi's skill objects carry a fixed shape (name, description, path, source),
|
|
5
|
+
* so curated trigger phrases never reach braid through the prompt-builder
|
|
6
|
+
* cache — read them from the SKILL.md frontmatter directly. Reads are
|
|
7
|
+
* memoized by file mtime + size: repeated turns stat, only changed or
|
|
8
|
+
* first-seen files parse.
|
|
9
|
+
*
|
|
10
|
+
* A trigger hit scores like a name hit and qualifies a skill whose
|
|
11
|
+
* description alone would stay under the qualification bar — the phrase is
|
|
12
|
+
* the author's own signal of when the skill applies, sharper than any
|
|
13
|
+
* description keyword.
|
|
14
|
+
*/
|
|
15
|
+
/** Max trigger phrases read per skill — a longer list is an authoring bug, not a matcher input. */
|
|
16
|
+
export declare const MAX_TRIGGERS = 12;
|
|
17
|
+
/** Max characters of one trigger phrase. */
|
|
18
|
+
export declare const MAX_TRIGGER_CHARS = 64;
|
|
19
|
+
/**
|
|
20
|
+
* Normalize a frontmatter `triggers` value into clean phrases. Accepts a YAML
|
|
21
|
+
* list or a comma-separated string; drops empty, overlong, and surplus
|
|
22
|
+
* entries. Pure.
|
|
23
|
+
*/
|
|
24
|
+
export declare function normalizeTriggers(value: unknown): string[];
|
|
25
|
+
/**
|
|
26
|
+
* Read a skill's trigger phrases: frontmatter `triggers:` first (canonical),
|
|
27
|
+
* then the description's trailing "Triggers: …" segment — the pack's existing
|
|
28
|
+
* convention (7 of 32 skills carry one) predates the frontmatter field, and
|
|
29
|
+
* the matcher should honor what authors already wrote. Missing/unreadable
|
|
30
|
+
* file or malformed YAML → no triggers (the matcher falls back to
|
|
31
|
+
* name/description scoring alone). Memoized: unchanged files never re-read.
|
|
32
|
+
*/
|
|
33
|
+
export declare function readSkillTriggers(filePath: string, description?: string): string[];
|
|
34
|
+
/**
|
|
35
|
+
* Trigger phrases from a description's trailing "Triggers: …" segment —
|
|
36
|
+
* the contrib pack convention ("… Use when X. Triggers: meme, image macro.").
|
|
37
|
+
* Pure.
|
|
38
|
+
*/
|
|
39
|
+
export declare function parseDescriptionTriggers(description: string): string[];
|
|
40
|
+
/** Test seam: forget every memoized frontmatter read. */
|
|
41
|
+
export declare function clearSkillTriggerCache(): void;
|
|
42
|
+
/**
|
|
43
|
+
* True when the phrase occurs in the prompt on word boundaries ("pane" does
|
|
44
|
+
* not match "paneled"). Multi-word phrases match literally; hyphenated
|
|
45
|
+
* prompt tokens count as boundaries.
|
|
46
|
+
*/
|
|
47
|
+
export declare function triggerMatches(phrase: string, promptText: string): boolean;
|
|
48
|
+
//# sourceMappingURL=skill-triggers.d.ts.map
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Frontmatter `triggers:` phrases for the suggestion matcher.
|
|
3
|
+
*
|
|
4
|
+
* pi's skill objects carry a fixed shape (name, description, path, source),
|
|
5
|
+
* so curated trigger phrases never reach braid through the prompt-builder
|
|
6
|
+
* cache — read them from the SKILL.md frontmatter directly. Reads are
|
|
7
|
+
* memoized by file mtime + size: repeated turns stat, only changed or
|
|
8
|
+
* first-seen files parse.
|
|
9
|
+
*
|
|
10
|
+
* A trigger hit scores like a name hit and qualifies a skill whose
|
|
11
|
+
* description alone would stay under the qualification bar — the phrase is
|
|
12
|
+
* the author's own signal of when the skill applies, sharper than any
|
|
13
|
+
* description keyword.
|
|
14
|
+
*/
|
|
15
|
+
import { statSync, readFileSync } from "node:fs";
|
|
16
|
+
import { parseFrontmatter } from "@earendil-works/pi-coding-agent";
|
|
17
|
+
/** Max trigger phrases read per skill — a longer list is an authoring bug, not a matcher input. */
|
|
18
|
+
export const MAX_TRIGGERS = 12;
|
|
19
|
+
/** Max characters of one trigger phrase. */
|
|
20
|
+
export const MAX_TRIGGER_CHARS = 64;
|
|
21
|
+
const cache = new Map();
|
|
22
|
+
/** Compiled word-boundary matchers, memoized per normalized phrase. */
|
|
23
|
+
const regexCache = new Map();
|
|
24
|
+
/**
|
|
25
|
+
* Normalize a frontmatter `triggers` value into clean phrases. Accepts a YAML
|
|
26
|
+
* list or a comma-separated string; drops empty, overlong, and surplus
|
|
27
|
+
* entries. Pure.
|
|
28
|
+
*/
|
|
29
|
+
export function normalizeTriggers(value) {
|
|
30
|
+
const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
|
|
31
|
+
const cleaned = [];
|
|
32
|
+
for (const item of raw) {
|
|
33
|
+
if (typeof item !== "string")
|
|
34
|
+
continue;
|
|
35
|
+
const phrase = item.trim().toLowerCase();
|
|
36
|
+
if (!phrase || phrase.length > MAX_TRIGGER_CHARS || cleaned.includes(phrase))
|
|
37
|
+
continue;
|
|
38
|
+
cleaned.push(phrase);
|
|
39
|
+
if (cleaned.length >= MAX_TRIGGERS)
|
|
40
|
+
break;
|
|
41
|
+
}
|
|
42
|
+
return cleaned;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Read a skill's trigger phrases: frontmatter `triggers:` first (canonical),
|
|
46
|
+
* then the description's trailing "Triggers: …" segment — the pack's existing
|
|
47
|
+
* convention (7 of 32 skills carry one) predates the frontmatter field, and
|
|
48
|
+
* the matcher should honor what authors already wrote. Missing/unreadable
|
|
49
|
+
* file or malformed YAML → no triggers (the matcher falls back to
|
|
50
|
+
* name/description scoring alone). Memoized: unchanged files never re-read.
|
|
51
|
+
*/
|
|
52
|
+
export function readSkillTriggers(filePath, description) {
|
|
53
|
+
let st;
|
|
54
|
+
try {
|
|
55
|
+
st = statSync(filePath);
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
cache.delete(filePath);
|
|
59
|
+
return [];
|
|
60
|
+
}
|
|
61
|
+
const cached = cache.get(filePath);
|
|
62
|
+
if (cached && cached.mtimeMs === st.mtimeMs && cached.size === st.size)
|
|
63
|
+
return cached.triggers;
|
|
64
|
+
let triggers;
|
|
65
|
+
try {
|
|
66
|
+
const { frontmatter } = parseFrontmatter(readFileSync(filePath, "utf-8"));
|
|
67
|
+
triggers = normalizeTriggers(frontmatter.triggers);
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
triggers = []; // malformed frontmatter — score on name/description only
|
|
71
|
+
}
|
|
72
|
+
if (!triggers.length && description)
|
|
73
|
+
triggers = parseDescriptionTriggers(description);
|
|
74
|
+
cache.set(filePath, { mtimeMs: st.mtimeMs, size: st.size, triggers });
|
|
75
|
+
return triggers;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Trigger phrases from a description's trailing "Triggers: …" segment —
|
|
79
|
+
* the contrib pack convention ("… Use when X. Triggers: meme, image macro.").
|
|
80
|
+
* Pure.
|
|
81
|
+
*/
|
|
82
|
+
export function parseDescriptionTriggers(description) {
|
|
83
|
+
const idx = description.toLowerCase().lastIndexOf("triggers:");
|
|
84
|
+
if (idx < 0)
|
|
85
|
+
return [];
|
|
86
|
+
const tail = description
|
|
87
|
+
.slice(idx + "triggers:".length)
|
|
88
|
+
.replace(/[.。]*\s*$/, "")
|
|
89
|
+
.trim();
|
|
90
|
+
if (!tail || tail.length > 200)
|
|
91
|
+
return [];
|
|
92
|
+
return normalizeTriggers(tail);
|
|
93
|
+
}
|
|
94
|
+
/** Test seam: forget every memoized frontmatter read. */
|
|
95
|
+
export function clearSkillTriggerCache() {
|
|
96
|
+
cache.clear();
|
|
97
|
+
regexCache.clear();
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* True when the phrase occurs in the prompt on word boundaries ("pane" does
|
|
101
|
+
* not match "paneled"). Multi-word phrases match literally; hyphenated
|
|
102
|
+
* prompt tokens count as boundaries.
|
|
103
|
+
*/
|
|
104
|
+
export function triggerMatches(phrase, promptText) {
|
|
105
|
+
let re = regexCache.get(phrase);
|
|
106
|
+
if (!re) {
|
|
107
|
+
const escaped = phrase.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
108
|
+
re = new RegExp(`(?:^|[^a-z0-9])${escaped}(?:$|[^a-z0-9])`);
|
|
109
|
+
regexCache.set(phrase, re);
|
|
110
|
+
}
|
|
111
|
+
return re.test(promptText);
|
|
112
|
+
}
|
|
113
|
+
//# sourceMappingURL=skill-triggers.js.map
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Malformed Tool Call Detection
|
|
3
|
+
*
|
|
4
|
+
* Detects when the agent outputs XML-like tool tags as plain text
|
|
5
|
+
* instead of using proper function calling format.
|
|
6
|
+
*/
|
|
7
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
8
|
+
export declare function detectMalformedToolCalls(text: string, pi: ExtensionAPI, ctx: ExtensionContext): void;
|
|
9
|
+
//# sourceMappingURL=malformed.d.ts.map
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Malformed Tool Call Detection
|
|
3
|
+
*
|
|
4
|
+
* Detects when the agent outputs XML-like tool tags as plain text
|
|
5
|
+
* instead of using proper function calling format.
|
|
6
|
+
*/
|
|
7
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
8
|
+
import { getNudgeManager } from "../nudge-manager.js";
|
|
9
|
+
import { MALFORMED_TOOL_CALL_RE, MALFORMED_TOOL_NAME_RE, } from "../../../lib/constants/tool-constants.js";
|
|
10
|
+
export function detectMalformedToolCalls(text, pi, ctx) {
|
|
11
|
+
MALFORMED_TOOL_CALL_RE.lastIndex = 0;
|
|
12
|
+
const match = MALFORMED_TOOL_CALL_RE.exec(text);
|
|
13
|
+
MALFORMED_TOOL_CALL_RE.lastIndex = 0;
|
|
14
|
+
if (match) {
|
|
15
|
+
const toolNameMatch = text.match(MALFORMED_TOOL_NAME_RE);
|
|
16
|
+
const detectedTool = toolNameMatch ? toolNameMatch[1].toLowerCase() : "unknown";
|
|
17
|
+
// Rate-limit via NudgeManager: the 10s cooldown with no-dedup
|
|
18
|
+
// config is the right shape for a malformed-tool flood: a single
|
|
19
|
+
// malformed call is enough to fire, but repeat fires within 10s are
|
|
20
|
+
// suppressed so the agent isn't hammered while iterating on the fix.
|
|
21
|
+
const message = "Malformed tool call detected: <" +
|
|
22
|
+
detectedTool +
|
|
23
|
+
"> as TEXT. Use proper function calling format - do NOT output XML tags as plain text.";
|
|
24
|
+
const { shouldSend } = getNudgeManager(ctx).shouldSendNudge("malformed", message);
|
|
25
|
+
if (shouldSend) {
|
|
26
|
+
sendEnforcementWhisper(pi, ctx, message);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=malformed.js.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Thorough Work Verification
|
|
3
|
+
*
|
|
4
|
+
* Detects missing verification after code changes.
|
|
5
|
+
*/
|
|
6
|
+
import type { ExtensionContext, ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
7
|
+
export declare const VERIFICATION_REMINDER_THRESHOLD = 12;
|
|
8
|
+
export declare function detectMissingVerification(pi: ExtensionAPI, ctx: ExtensionContext, currentTurn: number): void;
|
|
9
|
+
export declare function recordCodeChange(turn: number, ctx?: ExtensionContext): void;
|
|
10
|
+
//# sourceMappingURL=verification.d.ts.map
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Thorough Work Verification
|
|
3
|
+
*
|
|
4
|
+
* Detects missing verification after code changes.
|
|
5
|
+
*/
|
|
6
|
+
import { sendEnforcementWhisper } from "../whisper.js";
|
|
7
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
8
|
+
function getVerificationState(ctx) {
|
|
9
|
+
if (ctx)
|
|
10
|
+
return getExtensionState(ctx, "enforcement-verification", () => ({
|
|
11
|
+
pendingCodeChanges: false,
|
|
12
|
+
lastCodeChangeTurn: -100,
|
|
13
|
+
}));
|
|
14
|
+
return _default;
|
|
15
|
+
}
|
|
16
|
+
const _default = { pendingCodeChanges: false, lastCodeChangeTurn: -100 };
|
|
17
|
+
export const VERIFICATION_REMINDER_THRESHOLD = 12; // turns
|
|
18
|
+
export function detectMissingVerification(pi, ctx, currentTurn) {
|
|
19
|
+
const s = getVerificationState(ctx);
|
|
20
|
+
const turnsSinceCodeChange = currentTurn - s.lastCodeChangeTurn;
|
|
21
|
+
// If there were code changes but no bash command within threshold turns, nudge
|
|
22
|
+
if (s.pendingCodeChanges && turnsSinceCodeChange >= VERIFICATION_REMINDER_THRESHOLD) {
|
|
23
|
+
sendEnforcementWhisper(pi, ctx, "You modified code but haven't verified it works. " +
|
|
24
|
+
"Run tests or commands to confirm your implementation is correct.\n\n" +
|
|
25
|
+
"You verify code changes before declaring the task complete.");
|
|
26
|
+
s.pendingCodeChanges = false; // Only remind once per change session
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
export function recordCodeChange(turn, ctx) {
|
|
30
|
+
const s = getVerificationState(ctx);
|
|
31
|
+
s.lastCodeChangeTurn = turn;
|
|
32
|
+
s.pendingCodeChanges = true;
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=verification.js.map
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement types - shared interfaces and constants.
|
|
3
|
+
*
|
|
4
|
+
* This file exists to break the circular dependency between
|
|
5
|
+
* state.ts <-> session-state.ts (via ENFORCEMENT_PARAMS) and
|
|
6
|
+
* state.ts <-> verification-judge-state.ts (via EnforcementState).
|
|
7
|
+
*
|
|
8
|
+
* Both sub-state files can import from here without creating cycles.
|
|
9
|
+
*
|
|
10
|
+
* Contents:
|
|
11
|
+
* - ENFORCEMENT_PARAMS: the tunable thresholds config
|
|
12
|
+
* - EnforcementState: the composed interface (intersection of sub-states)
|
|
13
|
+
*/
|
|
14
|
+
import type { ToolTrackingState } from "./substate/tool-tracking-state.js";
|
|
15
|
+
import type { ErrorTrackingState } from "./substate/error-tracking-state.js";
|
|
16
|
+
import type { SessionState } from "./substate/session-state.js";
|
|
17
|
+
import type { MemoryHygieneState } from "./substate/memory-hygiene-state.js";
|
|
18
|
+
import type { ScratchpadState, ContextHygieneState } from "./substate/context-hygiene-state.js";
|
|
19
|
+
import type { ThoughtChainState } from "./substate/thought-chain-state.js";
|
|
20
|
+
export declare const ENFORCEMENT_PARAMS: {
|
|
21
|
+
readonly memoryNudgeThreshold: 15;
|
|
22
|
+
readonly maxSilentTurns: 6;
|
|
23
|
+
readonly warnOnToolSequenceRepetition: 3;
|
|
24
|
+
readonly judgeCooldownMs: 20000;
|
|
25
|
+
readonly judgeSkipTurns: 1;
|
|
26
|
+
readonly verificationJudgeInterval: 15;
|
|
27
|
+
readonly maxClaimsBeforeVerification: 5;
|
|
28
|
+
readonly blockExploreBeforeWrite: true;
|
|
29
|
+
};
|
|
30
|
+
/** Full enforcement state - intersection of all sub-states. */
|
|
31
|
+
export interface EnforcementState extends ToolTrackingState, ErrorTrackingState, SessionState, MemoryHygieneState, ScratchpadState, ContextHygieneState, ThoughtChainState {
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=enforcement-types.d.ts.map
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement types - shared interfaces and constants.
|
|
3
|
+
*
|
|
4
|
+
* This file exists to break the circular dependency between
|
|
5
|
+
* state.ts <-> session-state.ts (via ENFORCEMENT_PARAMS) and
|
|
6
|
+
* state.ts <-> verification-judge-state.ts (via EnforcementState).
|
|
7
|
+
*
|
|
8
|
+
* Both sub-state files can import from here without creating cycles.
|
|
9
|
+
*
|
|
10
|
+
* Contents:
|
|
11
|
+
* - ENFORCEMENT_PARAMS: the tunable thresholds config
|
|
12
|
+
* - EnforcementState: the composed interface (intersection of sub-states)
|
|
13
|
+
*/
|
|
14
|
+
export const ENFORCEMENT_PARAMS = {
|
|
15
|
+
memoryNudgeThreshold: 15,
|
|
16
|
+
maxSilentTurns: 6,
|
|
17
|
+
warnOnToolSequenceRepetition: 3,
|
|
18
|
+
judgeCooldownMs: 20000,
|
|
19
|
+
judgeSkipTurns: 1,
|
|
20
|
+
verificationJudgeInterval: 15,
|
|
21
|
+
maxClaimsBeforeVerification: 5,
|
|
22
|
+
blockExploreBeforeWrite: true,
|
|
23
|
+
};
|
|
24
|
+
//# sourceMappingURL=enforcement-types.js.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Handler Registry - thin coordinator.
|
|
3
|
+
*
|
|
4
|
+
* Imports and registers each focused handler. Each handler lives in its own
|
|
5
|
+
* file under handlers/ for independent testing.
|
|
6
|
+
*/
|
|
7
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
8
|
+
/**
|
|
9
|
+
* Register all enforcement event handlers on the given pi instance.
|
|
10
|
+
*/
|
|
11
|
+
export declare function registerHandlers(pi: ExtensionAPI): void;
|
|
12
|
+
//# sourceMappingURL=handler-registry.d.ts.map
|