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,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agent Event Bus - unified async event routing
|
|
3
|
+
*
|
|
4
|
+
* Event-driven handlers for cross-cutting events that span multiple
|
|
5
|
+
* extensions. Sources: heartbeat tick, memory eviction, tool errors,
|
|
6
|
+
* analytics alerts, enforcement violations, SOP suggestions.
|
|
7
|
+
*
|
|
8
|
+
* Note: the `timer_fire` event type is kept in the union for type
|
|
9
|
+
* safety (test-event-bus.mjs uses it as a generic test type) but is
|
|
10
|
+
* NOT currently emitted by the timer module - the actual wake-up
|
|
11
|
+
* path is direct (sendUserMessage for wake:true, sendTrackedMessage
|
|
12
|
+
* for wake:false). If a future feature needs to react to timer fires
|
|
13
|
+
* asynchronously, add a listener in this file's listeners section.
|
|
14
|
+
*
|
|
15
|
+
* Paper: 2604.14178 - Cognitive Scheduling with Event-Driven Architecture
|
|
16
|
+
*/
|
|
17
|
+
import { createLogger } from "../core/logger.js";
|
|
18
|
+
const log = createLogger("event-bus");
|
|
19
|
+
// ── Event Bus ────────────────────────────────────────────────────────────────
|
|
20
|
+
class EventBus {
|
|
21
|
+
handlers = new Map();
|
|
22
|
+
onceHandlers = new Map();
|
|
23
|
+
/**
|
|
24
|
+
* Register a handler for an event type.
|
|
25
|
+
*/
|
|
26
|
+
on(eventType, handler) {
|
|
27
|
+
if (!this.handlers.has(eventType)) {
|
|
28
|
+
this.handlers.set(eventType, new Set());
|
|
29
|
+
}
|
|
30
|
+
this.handlers.get(eventType).add(handler);
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Register a one-shot handler for an event type.
|
|
34
|
+
*/
|
|
35
|
+
once(eventType, handler) {
|
|
36
|
+
if (!this.onceHandlers.has(eventType)) {
|
|
37
|
+
this.onceHandlers.set(eventType, new Set());
|
|
38
|
+
}
|
|
39
|
+
this.onceHandlers.get(eventType).add(handler);
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Emit an event to all registered handlers.
|
|
43
|
+
*/
|
|
44
|
+
emit(event) {
|
|
45
|
+
const handlers = this.handlers.get(event.type);
|
|
46
|
+
if (handlers) {
|
|
47
|
+
for (const handler of handlers) {
|
|
48
|
+
try {
|
|
49
|
+
handler(event);
|
|
50
|
+
}
|
|
51
|
+
catch (err) {
|
|
52
|
+
log.error(`Handler error for ${event.type}:`, err);
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
const onceHandlers = this.onceHandlers.get(event.type);
|
|
57
|
+
if (onceHandlers) {
|
|
58
|
+
for (const handler of onceHandlers) {
|
|
59
|
+
try {
|
|
60
|
+
handler(event);
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
log.error(`Once-handler error for ${event.type}:`, err);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
this.onceHandlers.delete(event.type);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Remove a handler for an event type.
|
|
71
|
+
*/
|
|
72
|
+
off(eventType, handler) {
|
|
73
|
+
this.handlers.get(eventType)?.delete(handler);
|
|
74
|
+
this.onceHandlers.get(eventType)?.delete(handler);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Remove all handlers for an event type.
|
|
78
|
+
*/
|
|
79
|
+
clear(eventType) {
|
|
80
|
+
if (eventType) {
|
|
81
|
+
this.handlers.delete(eventType);
|
|
82
|
+
this.onceHandlers.delete(eventType);
|
|
83
|
+
}
|
|
84
|
+
else {
|
|
85
|
+
this.handlers.clear();
|
|
86
|
+
this.onceHandlers.clear();
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Get handler counts for diagnostics.
|
|
91
|
+
*/
|
|
92
|
+
getStats() {
|
|
93
|
+
const stats = {};
|
|
94
|
+
const allTypes = new Set([...this.handlers.keys(), ...this.onceHandlers.keys()]);
|
|
95
|
+
for (const type of allTypes) {
|
|
96
|
+
stats[type] = {
|
|
97
|
+
persistent: this.handlers.get(type)?.size ?? 0,
|
|
98
|
+
once: this.onceHandlers.get(type)?.size ?? 0,
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
return stats;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Global singleton event bus instance.
|
|
106
|
+
*/
|
|
107
|
+
export const eventBus = new EventBus();
|
|
108
|
+
//# sourceMappingURL=event-bus.js.map
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Safe Event Registration - centralizes pi.on() type escapes.
|
|
3
|
+
*
|
|
4
|
+
* pi's ExtensionAPI.on() uses overloaded literal types for event names.
|
|
5
|
+
* Custom braid events (enforcement_signals, session_before_compact, etc.) and
|
|
6
|
+
* handlers with `any` parameter types don't match the strict overloads.
|
|
7
|
+
*
|
|
8
|
+
* Instead of scattering `as never` casts across 20+ sites, use the helper
|
|
9
|
+
* below. The permissive `on` type isolates the escape - all callers get
|
|
10
|
+
* proper typing without individual casts.
|
|
11
|
+
*
|
|
12
|
+
* Key design: handler RETURN type is constrained to known outcome types
|
|
13
|
+
* (void, block object, systemPrompt object) instead of `any`. This catches
|
|
14
|
+
* accidental returns at compile time. Handler parameters remain permissive
|
|
15
|
+
* because pi's event shapes vary per event and duplicating all of them is
|
|
16
|
+
* too fragile.
|
|
17
|
+
*/
|
|
18
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
19
|
+
type ValidReturns = void | undefined | {
|
|
20
|
+
block?: boolean;
|
|
21
|
+
reason?: string;
|
|
22
|
+
} | {
|
|
23
|
+
systemPrompt?: string;
|
|
24
|
+
} | {
|
|
25
|
+
skillPaths?: string[];
|
|
26
|
+
};
|
|
27
|
+
type OnEventReturn = ValidReturns | Promise<ValidReturns> | Promise<ValidReturns | undefined>;
|
|
28
|
+
/**
|
|
29
|
+
* Register an event handler with return-type safety.
|
|
30
|
+
*
|
|
31
|
+
* Return type is constrained to known pi event outcomes (void, block, systemPrompt).
|
|
32
|
+
* Handler parameters are permissive (pi's per-event parameter types vary).
|
|
33
|
+
*
|
|
34
|
+
* Usage:
|
|
35
|
+
* onEvent(pi, "tool_call", handler)
|
|
36
|
+
*/
|
|
37
|
+
export declare function onEvent(pi: ExtensionAPI, event: string, handler: (...args: any[]) => OnEventReturn): void;
|
|
38
|
+
export {};
|
|
39
|
+
//# sourceMappingURL=event-types.d.ts.map
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Safe Event Registration - centralizes pi.on() type escapes.
|
|
3
|
+
*
|
|
4
|
+
* pi's ExtensionAPI.on() uses overloaded literal types for event names.
|
|
5
|
+
* Custom braid events (enforcement_signals, session_before_compact, etc.) and
|
|
6
|
+
* handlers with `any` parameter types don't match the strict overloads.
|
|
7
|
+
*
|
|
8
|
+
* Instead of scattering `as never` casts across 20+ sites, use the helper
|
|
9
|
+
* below. The permissive `on` type isolates the escape - all callers get
|
|
10
|
+
* proper typing without individual casts.
|
|
11
|
+
*
|
|
12
|
+
* Key design: handler RETURN type is constrained to known outcome types
|
|
13
|
+
* (void, block object, systemPrompt object) instead of `any`. This catches
|
|
14
|
+
* accidental returns at compile time. Handler parameters remain permissive
|
|
15
|
+
* because pi's event shapes vary per event and duplicating all of them is
|
|
16
|
+
* too fragile.
|
|
17
|
+
*/
|
|
18
|
+
/**
|
|
19
|
+
* Register an event handler with return-type safety.
|
|
20
|
+
*
|
|
21
|
+
* Return type is constrained to known pi event outcomes (void, block, systemPrompt).
|
|
22
|
+
* Handler parameters are permissive (pi's per-event parameter types vary).
|
|
23
|
+
*
|
|
24
|
+
* Usage:
|
|
25
|
+
* onEvent(pi, "tool_call", handler)
|
|
26
|
+
*/
|
|
27
|
+
export function onEvent(pi, event, handler) {
|
|
28
|
+
pi.on(event, handler);
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=event-types.js.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Timer Reminder Bus - bridges timer fires to heartbeat surface to agent
|
|
3
|
+
*
|
|
4
|
+
* Timer extension emits fires -> heartbeat scheduler surfaces reminders.
|
|
5
|
+
* This is a module-level singleton so extensions can communicate
|
|
6
|
+
* without direct imports (separate extension loading contexts).
|
|
7
|
+
*/
|
|
8
|
+
import type { ScheduledTimer } from "./timer-types.js";
|
|
9
|
+
export interface TimerReminder {
|
|
10
|
+
timer: ScheduledTimer;
|
|
11
|
+
firedAt: number;
|
|
12
|
+
}
|
|
13
|
+
type ReminderHandler = (reminder: TimerReminder) => void;
|
|
14
|
+
/** Timer extension calls this when a timer fires */
|
|
15
|
+
export declare function emitTimerReminder(timer: ScheduledTimer): void;
|
|
16
|
+
/** Heartbeat scheduler calls this on each turn to get pending reminders */
|
|
17
|
+
export declare function drainTimerReminders(): TimerReminder[];
|
|
18
|
+
/** Heartbeat registers a handler for immediate reminder surfacing */
|
|
19
|
+
export declare function onTimerReminder(handler: ReminderHandler): () => void;
|
|
20
|
+
export {};
|
|
21
|
+
//# sourceMappingURL=timer-bus.d.ts.map
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Timer Reminder Bus - bridges timer fires to heartbeat surface to agent
|
|
3
|
+
*
|
|
4
|
+
* Timer extension emits fires -> heartbeat scheduler surfaces reminders.
|
|
5
|
+
* This is a module-level singleton so extensions can communicate
|
|
6
|
+
* without direct imports (separate extension loading contexts).
|
|
7
|
+
*/
|
|
8
|
+
import { createLogger } from "../core/logger.js";
|
|
9
|
+
const log = createLogger("timer-bus");
|
|
10
|
+
const handlers = new Set();
|
|
11
|
+
let pendingReminders = [];
|
|
12
|
+
/** Timer extension calls this when a timer fires */
|
|
13
|
+
export function emitTimerReminder(timer) {
|
|
14
|
+
const reminder = { timer, firedAt: Date.now() };
|
|
15
|
+
// Normally drained by the heartbeat each turn; cap 100 drop-oldest
|
|
16
|
+
// so an undrained (idle/disabled-heartbeat) window cannot grow unbounded.
|
|
17
|
+
pendingReminders.push(reminder);
|
|
18
|
+
if (pendingReminders.length > 100) {
|
|
19
|
+
pendingReminders = pendingReminders.slice(-100);
|
|
20
|
+
}
|
|
21
|
+
for (const h of handlers) {
|
|
22
|
+
try {
|
|
23
|
+
h(reminder);
|
|
24
|
+
}
|
|
25
|
+
catch (err) {
|
|
26
|
+
log.warn(`Timer reminder handler failed: ${err}`);
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
/** Heartbeat scheduler calls this on each turn to get pending reminders */
|
|
31
|
+
export function drainTimerReminders() {
|
|
32
|
+
const drained = pendingReminders;
|
|
33
|
+
pendingReminders = [];
|
|
34
|
+
return drained;
|
|
35
|
+
}
|
|
36
|
+
/** Heartbeat registers a handler for immediate reminder surfacing */
|
|
37
|
+
export function onTimerReminder(handler) {
|
|
38
|
+
handlers.add(handler);
|
|
39
|
+
return () => handlers.delete(handler);
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=timer-bus.js.map
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Timer Types - shared type definitions for the timer event system.
|
|
3
|
+
*
|
|
4
|
+
* Lives in lib/ so lib/events/timer-bus.ts can import the types without
|
|
5
|
+
* creating a lib->extensions dependency.
|
|
6
|
+
*/
|
|
7
|
+
export interface ScheduledTimer {
|
|
8
|
+
id: string;
|
|
9
|
+
firesAt: number;
|
|
10
|
+
reason: string;
|
|
11
|
+
tag?: string;
|
|
12
|
+
createdAt: number;
|
|
13
|
+
/**
|
|
14
|
+
* If true, the timer fire whisper uses triggerTurn: true to wake the
|
|
15
|
+
* agent (auto-resume behavior). Used by the post-compaction resume
|
|
16
|
+
* timer to recover from a stuck session. Default: false (safer).
|
|
17
|
+
*
|
|
18
|
+
* The busy guard (TOOL_CALL -> busy=true, TURN_END -> busy=false)
|
|
19
|
+
* still prevents mid-tool-execution firing even when wake: true.
|
|
20
|
+
*/
|
|
21
|
+
wake?: boolean;
|
|
22
|
+
/**
|
|
23
|
+
* Recurrence interval in milliseconds. When set, the timer is NOT
|
|
24
|
+
* removed on fire: the expiry path re-arms `firesAt` to the next
|
|
25
|
+
* cadence (`Math.max(prev firesAt + intervalMs, now + intervalMs)`)
|
|
26
|
+
* instead of deleting it, and the fire path persists the re-arm so
|
|
27
|
+
* the recurrence survives a reload. Undefined (default) = one-shot
|
|
28
|
+
* timer.
|
|
29
|
+
*/
|
|
30
|
+
intervalMs?: number;
|
|
31
|
+
/**
|
|
32
|
+
* Optional bound on a recurring timer's LIFETIME: the total number of
|
|
33
|
+
* fires it will deliver before removing itself (count exhaustion).
|
|
34
|
+
* When set on a recurring timer, the timer self-removes after its
|
|
35
|
+
* `count`-th fire instead of re-arming — the native answer to a finite
|
|
36
|
+
* baby-sit window ("check every 60s, 5 times, then stop").
|
|
37
|
+
*
|
|
38
|
+
* Undefined (default) = unbounded recurrence: re-fires on cadence
|
|
39
|
+
* until cancelled (behavior unchanged). A recurring timer
|
|
40
|
+
* with `count` still stops early on cancelTimer/cancelTimersByTag.
|
|
41
|
+
* Ignored when `intervalMs` is unset (one-shot timers fire once by
|
|
42
|
+
* definition).
|
|
43
|
+
*/
|
|
44
|
+
count?: number;
|
|
45
|
+
/**
|
|
46
|
+
* How many times this (recurring) timer has fired so far. Starts at 0
|
|
47
|
+
* on creation; incremented on every fire. The DELIVERED snapshot on a
|
|
48
|
+
* fire carries the fire number for that delivery (so `list` can show
|
|
49
|
+
* e.g. "repeat 3/5"); the LIVE map entry carries the running count
|
|
50
|
+
* only while it survives (i.e. it is cleared the moment the timer is
|
|
51
|
+
* removed on exhaustion/cancel). Persisted so a bounded recurrence
|
|
52
|
+
* resumes mid-cadence after a reload. Undefined = never fired (fresh
|
|
53
|
+
* or legacy one-shot).
|
|
54
|
+
*/
|
|
55
|
+
fires?: number;
|
|
56
|
+
/**
|
|
57
|
+
* Owning session ID. Each pi session has its own timer bucket. The
|
|
58
|
+
* timer module uses this to scope cancel/list operations to one
|
|
59
|
+
* session, preventing cross-session timer leaks when multiple pi
|
|
60
|
+
* sessions run in the same Node process.
|
|
61
|
+
*/
|
|
62
|
+
sessionId?: string;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=timer-types.d.ts.map
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn-End Coordinator - centralized dispatch for post-turn analysis.
|
|
3
|
+
*
|
|
4
|
+
* Problem: Enforcement owned the turn_end slot exclusively. Every new
|
|
5
|
+
* post-turn concern had to be added to enforcement's handler chain,
|
|
6
|
+
* creating a 3000-line god module.
|
|
7
|
+
*
|
|
8
|
+
* Solution: A lightweight coordinator that extensions can register against.
|
|
9
|
+
* Each handler gets a name and priority. Handlers run in priority order
|
|
10
|
+
* and are independently testable.
|
|
11
|
+
*
|
|
12
|
+
* Usage:
|
|
13
|
+
* import { registerTurnEndHandler, dispatchTurnEnd } from "../../lib/events/turn-end-coordinator.js";
|
|
14
|
+
*
|
|
15
|
+
* // In extension factory:
|
|
16
|
+
* registerTurnEndHandler("claim-tracker", 80, async (event, ctx) => { ... });
|
|
17
|
+
*
|
|
18
|
+
* // In the single pi.on("turn_end") registration:
|
|
19
|
+
* pi.on("turn_end", (event, ctx) => dispatchTurnEnd(event, ctx));
|
|
20
|
+
*/
|
|
21
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
22
|
+
export type TurnEndHandler = (event: any, ctx: ExtensionContext) => void | Promise<void>;
|
|
23
|
+
/**
|
|
24
|
+
* Register a handler to run on turn_end.
|
|
25
|
+
* Handlers run in descending priority order (higher = first).
|
|
26
|
+
* Handlers with the same name are deduplicated (last registration wins).
|
|
27
|
+
*/
|
|
28
|
+
export declare function registerTurnEndHandler(name: string, priority: number, handler: TurnEndHandler): void;
|
|
29
|
+
/**
|
|
30
|
+
* Unregister a previously registered handler.
|
|
31
|
+
* Safe to call even if the handler wasn't registered.
|
|
32
|
+
*/
|
|
33
|
+
export declare function unregisterTurnEndHandler(name: string): void;
|
|
34
|
+
/**
|
|
35
|
+
* Run all registered turn_end handlers in priority order.
|
|
36
|
+
* Each handler is wrapped in try/catch so a failure in one
|
|
37
|
+
* doesn't prevent others from running.
|
|
38
|
+
*/
|
|
39
|
+
export declare function dispatchTurnEnd(event: any, ctx: ExtensionContext): Promise<void>;
|
|
40
|
+
/**
|
|
41
|
+
* Get the list of registered handler names (for debugging).
|
|
42
|
+
*/
|
|
43
|
+
export declare function getRegisteredHandlers(): string[];
|
|
44
|
+
/**
|
|
45
|
+
* Clear all registered handlers. Used in tests and session teardown.
|
|
46
|
+
*/
|
|
47
|
+
export declare function clearHandlers(): void;
|
|
48
|
+
/**
|
|
49
|
+
* Get the count of registered handlers.
|
|
50
|
+
*/
|
|
51
|
+
export declare function handlerCount(): number;
|
|
52
|
+
//# sourceMappingURL=turn-end-coordinator.d.ts.map
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn-End Coordinator - centralized dispatch for post-turn analysis.
|
|
3
|
+
*
|
|
4
|
+
* Problem: Enforcement owned the turn_end slot exclusively. Every new
|
|
5
|
+
* post-turn concern had to be added to enforcement's handler chain,
|
|
6
|
+
* creating a 3000-line god module.
|
|
7
|
+
*
|
|
8
|
+
* Solution: A lightweight coordinator that extensions can register against.
|
|
9
|
+
* Each handler gets a name and priority. Handlers run in priority order
|
|
10
|
+
* and are independently testable.
|
|
11
|
+
*
|
|
12
|
+
* Usage:
|
|
13
|
+
* import { registerTurnEndHandler, dispatchTurnEnd } from "../../lib/events/turn-end-coordinator.js";
|
|
14
|
+
*
|
|
15
|
+
* // In extension factory:
|
|
16
|
+
* registerTurnEndHandler("claim-tracker", 80, async (event, ctx) => { ... });
|
|
17
|
+
*
|
|
18
|
+
* // In the single pi.on("turn_end") registration:
|
|
19
|
+
* pi.on("turn_end", (event, ctx) => dispatchTurnEnd(event, ctx));
|
|
20
|
+
*/
|
|
21
|
+
import { createLogger } from "../core/logger.js";
|
|
22
|
+
const log = createLogger("turn-end");
|
|
23
|
+
// _handlers: PROCESS-GLOBAL registry. Handler registration happens
|
|
24
|
+
// at extension-load time and persists for the lifetime of the
|
|
25
|
+
// process. Each session's `dispatchTurnEnd` walks the same list.
|
|
26
|
+
// Not a leak risk because handler registration is intentionally
|
|
27
|
+
// cross-session (the same extension registers once on first load).
|
|
28
|
+
const _handlers = [];
|
|
29
|
+
/**
|
|
30
|
+
* Register a handler to run on turn_end.
|
|
31
|
+
* Handlers run in descending priority order (higher = first).
|
|
32
|
+
* Handlers with the same name are deduplicated (last registration wins).
|
|
33
|
+
*/
|
|
34
|
+
export function registerTurnEndHandler(name, priority, handler) {
|
|
35
|
+
const existing = _handlers.findIndex((h) => h.name === name);
|
|
36
|
+
if (existing >= 0) {
|
|
37
|
+
_handlers[existing] = { name, priority, handler };
|
|
38
|
+
}
|
|
39
|
+
else {
|
|
40
|
+
_handlers.push({ name, priority, handler });
|
|
41
|
+
}
|
|
42
|
+
_handlers.sort((a, b) => b.priority - a.priority);
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Unregister a previously registered handler.
|
|
46
|
+
* Safe to call even if the handler wasn't registered.
|
|
47
|
+
*/
|
|
48
|
+
export function unregisterTurnEndHandler(name) {
|
|
49
|
+
const idx = _handlers.findIndex((h) => h.name === name);
|
|
50
|
+
if (idx >= 0) {
|
|
51
|
+
_handlers.splice(idx, 1);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Run all registered turn_end handlers in priority order.
|
|
56
|
+
* Each handler is wrapped in try/catch so a failure in one
|
|
57
|
+
* doesn't prevent others from running.
|
|
58
|
+
*/
|
|
59
|
+
export async function dispatchTurnEnd(event, ctx) {
|
|
60
|
+
if (_handlers.length === 0)
|
|
61
|
+
return;
|
|
62
|
+
for (const entry of _handlers) {
|
|
63
|
+
try {
|
|
64
|
+
await entry.handler(event, ctx);
|
|
65
|
+
}
|
|
66
|
+
catch (err) {
|
|
67
|
+
log.error(`turn_end handler "${entry.name}" failed:`, err);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Get the list of registered handler names (for debugging).
|
|
73
|
+
*/
|
|
74
|
+
export function getRegisteredHandlers() {
|
|
75
|
+
return _handlers.map((h) => `${h.name} (priority ${h.priority})`);
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Clear all registered handlers. Used in tests and session teardown.
|
|
79
|
+
*/
|
|
80
|
+
export function clearHandlers() {
|
|
81
|
+
_handlers.length = 0;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Get the count of registered handlers.
|
|
85
|
+
*/
|
|
86
|
+
export function handlerCount() {
|
|
87
|
+
return _handlers.length;
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=turn-end-coordinator.js.map
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Failure Trace Collector - passive observer that collects failure signatures
|
|
3
|
+
* from existing detectors and stores them for Weakness Mining.
|
|
4
|
+
*
|
|
5
|
+
* Live source: the tool-loop detector's per-session state, written by the
|
|
6
|
+
* enforcement extension on every tool call and turn end. The collector is
|
|
7
|
+
* PURE OBSERVATION: it reads existing state, does not add new instrumentation.
|
|
8
|
+
* This keeps the coupling minimal and the failure surface bounded.
|
|
9
|
+
*/
|
|
10
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
11
|
+
import type { FailureSignature, HarnessState } from "./types.js";
|
|
12
|
+
export declare function getHarnessState(ctx: ExtensionContext): HarnessState;
|
|
13
|
+
/**
|
|
14
|
+
* Collect tool-loop signatures from the tool-loop-detector state.
|
|
15
|
+
* Checks for any detected loops and records them as failure signatures.
|
|
16
|
+
*/
|
|
17
|
+
export declare function collectToolLoopSignatures(state: HarnessState, ctx: ExtensionContext): FailureSignature[];
|
|
18
|
+
/**
|
|
19
|
+
* Collect all failure signatures from all available sources.
|
|
20
|
+
* This is the main entry point for the heartbeat module.
|
|
21
|
+
*/
|
|
22
|
+
export declare function collectAllFailureSignatures(ctx: ExtensionContext): FailureSignature[];
|
|
23
|
+
/**
|
|
24
|
+
* Get the current number of collected signatures.
|
|
25
|
+
*/
|
|
26
|
+
export declare function getCollectedCount(ctx: ExtensionContext): number;
|
|
27
|
+
/**
|
|
28
|
+
* Reset the harness state (for testing or session boundary).
|
|
29
|
+
*/
|
|
30
|
+
export declare function resetHarnessState(ctx: ExtensionContext): void;
|
|
31
|
+
//# sourceMappingURL=failure-trace-collector.d.ts.map
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Failure Trace Collector - passive observer that collects failure signatures
|
|
3
|
+
* from existing detectors and stores them for Weakness Mining.
|
|
4
|
+
*
|
|
5
|
+
* Live source: the tool-loop detector's per-session state, written by the
|
|
6
|
+
* enforcement extension on every tool call and turn end. The collector is
|
|
7
|
+
* PURE OBSERVATION: it reads existing state, does not add new instrumentation.
|
|
8
|
+
* This keeps the coupling minimal and the failure surface bounded.
|
|
9
|
+
*/
|
|
10
|
+
import { nextId } from "../utils/id.js";
|
|
11
|
+
import { getExtensionState } from "../state/extension-state.js";
|
|
12
|
+
import { createLogger } from "../core/logger.js";
|
|
13
|
+
import { createHarnessState } from "./types.js";
|
|
14
|
+
import { getToolLoopState, detectToolLoop } from "../detection/tool-loop-detector.js";
|
|
15
|
+
// ── Module-level state key (used by getExtensionState) ─────────────────────
|
|
16
|
+
const HARNESS_STATE_KEY = "self-harness";
|
|
17
|
+
// ── Logger ─────────────────────────────────────────────────────────────────
|
|
18
|
+
const log = createLogger("harness:collector");
|
|
19
|
+
// ── State Accessors ────────────────────────────────────────────────────────
|
|
20
|
+
export function getHarnessState(ctx) {
|
|
21
|
+
return getExtensionState(ctx, HARNESS_STATE_KEY, createHarnessState);
|
|
22
|
+
}
|
|
23
|
+
// ── Dedup helpers ──────────────────────────────────────────────────────────
|
|
24
|
+
/**
|
|
25
|
+
* Build a dedup key for a failure signature. Two signatures with the same
|
|
26
|
+
* key are considered duplicates (same type + same tool/error in same turn).
|
|
27
|
+
*/
|
|
28
|
+
function dedupKey(sig) {
|
|
29
|
+
return `${sig.type}:${sig.toolName ?? sig.errorPrefix ?? "unknown"}:${sig.turn}`;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Check if a signature is already recorded (by dedup key).
|
|
33
|
+
*/
|
|
34
|
+
function isDuplicate(state, sig) {
|
|
35
|
+
return state.seenPatterns.includes(dedupKey(sig));
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Record a signature into state, deduplicating.
|
|
39
|
+
*/
|
|
40
|
+
function recordSignature(state, sig) {
|
|
41
|
+
if (isDuplicate(state, sig))
|
|
42
|
+
return;
|
|
43
|
+
state.signatures.push(sig);
|
|
44
|
+
state.totalCollected++;
|
|
45
|
+
state.seenPatterns.push(dedupKey(sig));
|
|
46
|
+
}
|
|
47
|
+
// ── Signal Signatures ──────────────────────────────────────────────────────
|
|
48
|
+
/**
|
|
49
|
+
* Create a failure signature from raw signal data.
|
|
50
|
+
*/
|
|
51
|
+
function makeSignature(type, source, toolName, count, turn, message, errorPrefix) {
|
|
52
|
+
return {
|
|
53
|
+
id: nextId("fsig"),
|
|
54
|
+
type,
|
|
55
|
+
source,
|
|
56
|
+
toolName,
|
|
57
|
+
count,
|
|
58
|
+
turn,
|
|
59
|
+
message,
|
|
60
|
+
timestamp: new Date().toISOString(),
|
|
61
|
+
errorPrefix,
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
// ── Collection from Signal Sources ─────────────────────────────────────────
|
|
65
|
+
/**
|
|
66
|
+
* Collect tool-loop signatures from the tool-loop-detector state.
|
|
67
|
+
* Checks for any detected loops and records them as failure signatures.
|
|
68
|
+
*/
|
|
69
|
+
export function collectToolLoopSignatures(state, ctx) {
|
|
70
|
+
const collected = [];
|
|
71
|
+
const loopState = getToolLoopState(ctx);
|
|
72
|
+
const result = detectToolLoop(loopState);
|
|
73
|
+
if (result.isLoop) {
|
|
74
|
+
const sig = makeSignature("tool-loop", "tool-loop-detector", result.tool, result.count, loopState.turnCount, result.message);
|
|
75
|
+
if (!isDuplicate(state, sig)) {
|
|
76
|
+
recordSignature(state, sig);
|
|
77
|
+
collected.push(sig);
|
|
78
|
+
log.info(`Collected tool-loop: ${result.tool} x${result.count}`);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return collected;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Collect all failure signatures from all available sources.
|
|
85
|
+
* This is the main entry point for the heartbeat module.
|
|
86
|
+
*/
|
|
87
|
+
export function collectAllFailureSignatures(ctx) {
|
|
88
|
+
const state = getHarnessState(ctx);
|
|
89
|
+
const collected = collectToolLoopSignatures(state, ctx);
|
|
90
|
+
if (collected.length > 0) {
|
|
91
|
+
log.info(`Collected ${collected.length} new failure signatures (total: ${state.totalCollected})`);
|
|
92
|
+
}
|
|
93
|
+
return collected;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Get the current number of collected signatures.
|
|
97
|
+
*/
|
|
98
|
+
export function getCollectedCount(ctx) {
|
|
99
|
+
return getHarnessState(ctx).totalCollected;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Reset the harness state (for testing or session boundary).
|
|
103
|
+
*/
|
|
104
|
+
export function resetHarnessState(ctx) {
|
|
105
|
+
const state = getHarnessState(ctx);
|
|
106
|
+
state.signatures = [];
|
|
107
|
+
state.clusters = [];
|
|
108
|
+
state.lastMiningTurn = -1;
|
|
109
|
+
state.totalCollected = 0;
|
|
110
|
+
state.hasMined = false;
|
|
111
|
+
state.seenPatterns = [];
|
|
112
|
+
log.info("Harness state reset");
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=failure-trace-collector.js.map
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Self-Harness Loop (LP-1) — Public API
|
|
3
|
+
*
|
|
4
|
+
* Failure Trace Collection + Weakness Mining.
|
|
5
|
+
*
|
|
6
|
+
* Usage:
|
|
7
|
+
* import { collectAllFailureSignatures, mineWeaknesses, summarizeClusters } from "../lib/harness/index.js";
|
|
8
|
+
*
|
|
9
|
+
* // In heartbeat module or turn-end handler:
|
|
10
|
+
* const collected = collectAllFailureSignatures(ctx);
|
|
11
|
+
* const state = getHarnessState(ctx);
|
|
12
|
+
* const clusters = mineWeaknesses(state.signatures, turnCount);
|
|
13
|
+
* const summary = summarizeClusters(clusters);
|
|
14
|
+
* whisper(summary);
|
|
15
|
+
*/
|
|
16
|
+
export type { FailureSignature, FailureSignatureType, WeaknessCluster, HarnessTargetSurface, HarnessState, } from "./types.js";
|
|
17
|
+
export { createHarnessState } from "./types.js";
|
|
18
|
+
export { getHarnessState, collectAllFailureSignatures, collectToolLoopSignatures, getCollectedCount, resetHarnessState, } from "./failure-trace-collector.js";
|
|
19
|
+
export { mineWeaknesses, summarizeClusters } from "./weakness-miner.js";
|
|
20
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Self-Harness Loop (LP-1) — Public API
|
|
3
|
+
*
|
|
4
|
+
* Failure Trace Collection + Weakness Mining.
|
|
5
|
+
*
|
|
6
|
+
* Usage:
|
|
7
|
+
* import { collectAllFailureSignatures, mineWeaknesses, summarizeClusters } from "../lib/harness/index.js";
|
|
8
|
+
*
|
|
9
|
+
* // In heartbeat module or turn-end handler:
|
|
10
|
+
* const collected = collectAllFailureSignatures(ctx);
|
|
11
|
+
* const state = getHarnessState(ctx);
|
|
12
|
+
* const clusters = mineWeaknesses(state.signatures, turnCount);
|
|
13
|
+
* const summary = summarizeClusters(clusters);
|
|
14
|
+
* whisper(summary);
|
|
15
|
+
*/
|
|
16
|
+
export { createHarnessState } from "./types.js";
|
|
17
|
+
// ── Failure Trace Collector ────────────────────────────────────────────────
|
|
18
|
+
export { getHarnessState, collectAllFailureSignatures, collectToolLoopSignatures, getCollectedCount, resetHarnessState, } from "./failure-trace-collector.js";
|
|
19
|
+
// ── Weakness Miner ─────────────────────────────────────────────────────────
|
|
20
|
+
export { mineWeaknesses, summarizeClusters } from "./weakness-miner.js";
|
|
21
|
+
//# sourceMappingURL=index.js.map
|