pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Types for the Heartbeat Scheduler extension.
|
|
3
|
+
*
|
|
4
|
+
* Heartbeat Scheduler - proactive cognitive scheduling based on paper 2604.14178.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
8
|
+
import type { Episode } from "../../../lib/types/episode-types.js";
|
|
9
|
+
import type { HeuristicRule } from "../../memory/three-memory-stores/index.js";
|
|
10
|
+
|
|
11
|
+
export interface MemoryStoresState {
|
|
12
|
+
episodes: Episode[];
|
|
13
|
+
heuristics: HeuristicRule[];
|
|
14
|
+
toolStats: Map<string, any>;
|
|
15
|
+
currentSessionTools: string[];
|
|
16
|
+
sessionStartTime: number;
|
|
17
|
+
lastSkillType: string;
|
|
18
|
+
skillTransitionCount: number;
|
|
19
|
+
recentErrors: string[];
|
|
20
|
+
currentSessionId: string;
|
|
21
|
+
lastRecallTime: number;
|
|
22
|
+
lastSemanticRecallHashes: string[];
|
|
23
|
+
lastEpisodeRecallSignature: string;
|
|
24
|
+
lastSemanticRecallTime: number;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface CognitiveModule {
|
|
28
|
+
name: string;
|
|
29
|
+
description: string;
|
|
30
|
+
priority: number;
|
|
31
|
+
shouldActivate(context: ModuleContext): boolean;
|
|
32
|
+
activate(context: ModuleContext): Promise<void>;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export interface ModuleContext {
|
|
36
|
+
ctx: ExtensionContext;
|
|
37
|
+
turnCount: number;
|
|
38
|
+
lastActivation: Map<string, number>;
|
|
39
|
+
sessionAge: number;
|
|
40
|
+
toolCallsSinceLastTick: string[];
|
|
41
|
+
totalToolCalls: number;
|
|
42
|
+
silentTurns: number;
|
|
43
|
+
metadata: Record<string, unknown>;
|
|
44
|
+
/**
|
|
45
|
+
* AbortSignal that fires on session_shutdown. Modules that make LLM
|
|
46
|
+
* calls (via callLlm or classify) MUST thread this signal through to
|
|
47
|
+
* prevent orphaned calls from running for their full timeout after the
|
|
48
|
+
* session ends. Created per-tick in the heartbeat tick handler.
|
|
49
|
+
*/
|
|
50
|
+
abortSignal?: AbortSignal;
|
|
51
|
+
/**
|
|
52
|
+
* Prefer `whisper()` over `ctx.whisper?.()`.
|
|
53
|
+
* The heartbeat tick handler batches all module whispers into one
|
|
54
|
+
* aggregated message and flushes via sendTrackedMessage, which
|
|
55
|
+
* honors the per-source flood cap. Calling `ctx.whisper` directly
|
|
56
|
+
* bypasses the cap and injection tracking. See heartbeat-batcher.ts.
|
|
57
|
+
*/
|
|
58
|
+
whisper(msg: string, opts?: { category?: string; priority?: string }): void;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export interface HeartbeatConfig {
|
|
62
|
+
interval: number; // Turns between ticks
|
|
63
|
+
historyWindow: number; // Turns to analyze
|
|
64
|
+
maxActivationsPerTick: number;
|
|
65
|
+
enabled: boolean;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export interface HeartbeatState {
|
|
69
|
+
enabled: boolean;
|
|
70
|
+
turnCount: number;
|
|
71
|
+
modules: Map<string, RegisteredModule>;
|
|
72
|
+
lastActivation: Map<string, number>;
|
|
73
|
+
activationHistory: ActivationRecord[];
|
|
74
|
+
stats: {
|
|
75
|
+
totalTicks: number;
|
|
76
|
+
totalActivations: number;
|
|
77
|
+
activationsByModule: Record<string, number>;
|
|
78
|
+
};
|
|
79
|
+
policyEngineReady: boolean;
|
|
80
|
+
policyTurnCount: number;
|
|
81
|
+
policyLastFire: Map<string, number>;
|
|
82
|
+
metaLearning: MetaLearningState;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export interface MetaLearningState {
|
|
86
|
+
tickInterval: number;
|
|
87
|
+
baseInterval: number;
|
|
88
|
+
effectivenessHistory: number[];
|
|
89
|
+
activationSignalWindow: Map<string, number>;
|
|
90
|
+
postActivationToolCount: number;
|
|
91
|
+
pendingSignals: Map<string, number>;
|
|
92
|
+
toolTracking: ToolTracking;
|
|
93
|
+
tokenWarningFired: Set<number>;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export interface RegisteredModule {
|
|
97
|
+
module: CognitiveModule;
|
|
98
|
+
enabled: boolean;
|
|
99
|
+
activations: number;
|
|
100
|
+
lastActivated: number;
|
|
101
|
+
effectiveness: number;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export interface ActivationRecord {
|
|
105
|
+
tick: number;
|
|
106
|
+
moduleName: string;
|
|
107
|
+
timestamp: number;
|
|
108
|
+
reason: string;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
export interface ToolTracking {
|
|
112
|
+
verificationCount: number;
|
|
113
|
+
lastVerificationTurn: number;
|
|
114
|
+
lastWebFetchTurn: number;
|
|
115
|
+
lastCodeExecutionTurn: number;
|
|
116
|
+
totalToolsUsed: number;
|
|
117
|
+
lastToolCallTurn: number;
|
|
118
|
+
/** Rich trajectory data from tool_end events */
|
|
119
|
+
trajectory?: Array<{ toolName: string; success: boolean; turn: number }>;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
import type { Policy, PolicyContext } from "../../../lib/store/belief-store.js";
|
|
123
|
+
|
|
124
|
+
export interface PolicyEngine {
|
|
125
|
+
register(policy: Policy): void;
|
|
126
|
+
unregister(id: string): boolean;
|
|
127
|
+
evaluate(context: PolicyContext): Promise<Policy[]>;
|
|
128
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whisper batcher for heartbeat ticks.
|
|
3
|
+
*
|
|
4
|
+
* During a heartbeat tick, multiple cognitive modules may want to
|
|
5
|
+
* whisper to the agent. If we just forward them through ctx.whisper,
|
|
6
|
+
* the agent gets N separate messages -- which is both noisy and
|
|
7
|
+
* expensive (each message becomes a turn boundary in the agent's
|
|
8
|
+
* context).
|
|
9
|
+
*
|
|
10
|
+
* The batcher intercepts the whisper call during the tick, buffers
|
|
11
|
+
* messages grouped by priority, and flushes them as aggregated
|
|
12
|
+
* messages per priority tier. High-priority messages flush first.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { formatLocalTime } from "../../../lib/utils/local-time.js";
|
|
16
|
+
import { formatTokensK } from "../../../lib/detection/context-usage.js";
|
|
17
|
+
import type { SelfStateSample } from "../../../lib/telemetry/context-heartbeat.js";
|
|
18
|
+
|
|
19
|
+
export interface WhisperBufferEntry {
|
|
20
|
+
message: string;
|
|
21
|
+
priority: string;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export type WhisperSendFn = (msg: string, opts?: { category?: string; priority?: string }) => void;
|
|
25
|
+
|
|
26
|
+
/** Render a token count compactly: 0 -> "0K", 1234 -> "1K", 237785 -> "238K". */
|
|
27
|
+
function renderTokensK(tokens: number): string {
|
|
28
|
+
return formatTokensK(tokens);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Self-state line (2 directive): every heartbeat
|
|
33
|
+
* summary makes the agent self-aware of its own context health. ONE line,
|
|
34
|
+
* <= 40 tokens, appended to every heartbeat summary:
|
|
35
|
+
*
|
|
36
|
+
* self-state: ctx 213K tok · cache 96% · dup 39 · tps-ema 87
|
|
37
|
+
*
|
|
38
|
+
* An unavailable metric renders "n/a" — never zero (a zero looks like a
|
|
39
|
+
* healthy reading; "n/a" honestly says the telemetry is missing).
|
|
40
|
+
*/
|
|
41
|
+
export function buildSelfStateLine(sample: Partial<SelfStateSample> | null | undefined): string {
|
|
42
|
+
const s = sample ?? {};
|
|
43
|
+
const ctxTok =
|
|
44
|
+
typeof s.contextTokens === "number" ? `${renderTokensK(s.contextTokens)} tok` : "n/a";
|
|
45
|
+
const cache = typeof s.cacheHitShare === "number" ? `${Math.round(s.cacheHitShare)}%` : "n/a";
|
|
46
|
+
const dup = typeof s.nearDupCount === "number" ? String(s.nearDupCount) : "n/a";
|
|
47
|
+
const tps = typeof s.tpsEma === "number" ? `${Math.round(s.tpsEma)} tok/s` : "n/a";
|
|
48
|
+
const acts = typeof s.hygieneActs === "number" ? String(s.hygieneActs) : null;
|
|
49
|
+
const actPart = acts ? ` · acts ${acts}` : "";
|
|
50
|
+
return `self-state: ctx ${ctxTok} · cache ${cache} · dup ${dup} · tps-ema ${tps}${actPart}`;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Flush batched whispers: group by priority tier, concatenate per tier,
|
|
55
|
+
* and send as aggregated messages. This prevents N separate injected
|
|
56
|
+
* messages per heartbeat tick when multiple modules activate.
|
|
57
|
+
*
|
|
58
|
+
* Fresh clock: every batched summary
|
|
59
|
+
* (and its single-message form) prepends a `now:` line rendered by the
|
|
60
|
+
* ONE local-time formatter (lib/utils/local-time.ts) so the agent never
|
|
61
|
+
* reasons on a stale clock mid-session.
|
|
62
|
+
*
|
|
63
|
+
* Self-state (Refine-2): when `selfState` is provided (the caller
|
|
64
|
+
* samples context tokens / cache-hit share / near-duplicates / tok/s trend
|
|
65
|
+
* via lib/telemetry/context-heartbeat.ts getSelfStateSample), the summary
|
|
66
|
+
* gains ONE self-state line right after the `now:` line — every heartbeat
|
|
67
|
+
* summary makes the agent aware of its own context health. Absent sample =
|
|
68
|
+
* no line (callers opt in).
|
|
69
|
+
*/
|
|
70
|
+
export function flushWhisperBuffer(
|
|
71
|
+
buffer: WhisperBufferEntry[],
|
|
72
|
+
send: WhisperSendFn | undefined,
|
|
73
|
+
selfState?: string,
|
|
74
|
+
): void {
|
|
75
|
+
if (buffer.length === 0 || !send) return;
|
|
76
|
+
|
|
77
|
+
const groups = new Map<string, string[]>();
|
|
78
|
+
for (const entry of buffer) {
|
|
79
|
+
const p = entry.priority;
|
|
80
|
+
if (!groups.has(p)) groups.set(p, []);
|
|
81
|
+
groups.get(p)!.push(entry.message);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// Flush one message per priority tier
|
|
85
|
+
for (const [priority, messages] of groups) {
|
|
86
|
+
const nowLine = `now: ${formatLocalTime(new Date(), true)}`;
|
|
87
|
+
const selfStateSuffix = selfState ? `\n${selfState}` : "";
|
|
88
|
+
if (messages.length === 1) {
|
|
89
|
+
send(`${nowLine}${selfStateSuffix}\n${messages[0]}`, {
|
|
90
|
+
category: "cognitive",
|
|
91
|
+
priority: priority,
|
|
92
|
+
});
|
|
93
|
+
} else {
|
|
94
|
+
const combined = `[Heartbeat Summary]\n${nowLine}${selfStateSuffix}\n${messages.map((m, i) => `${i + 1}. ${m}`).join("\n")}`;
|
|
95
|
+
send(combined, { category: "cognitive", priority: priority });
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flat extension manifest - replaces src/modules/definitions.ts.
|
|
3
|
+
*
|
|
4
|
+
* Each extension registers itself here with its factory function and metadata.
|
|
5
|
+
* There is no module grouping abstraction - just a flat list. The `module`
|
|
6
|
+
* tag on each entry is a convenience label for the subagent API commands
|
|
7
|
+
* (e.g. "disable enforcement") but has no structural role.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
11
|
+
|
|
12
|
+
// core (input/output shaping: platform, env, prompt)
|
|
13
|
+
import corePolyfillFn from "./core/polyfill/index.js";
|
|
14
|
+
|
|
15
|
+
// orchestrator (multi-agent coordination)
|
|
16
|
+
import orchestratorFn from "./orchestrator/index.js";
|
|
17
|
+
|
|
18
|
+
// context-management (tool profile switching)
|
|
19
|
+
import contextManagementFn from "./context-management/index.js";
|
|
20
|
+
import coreAgentEnvFn from "./core/agent-environment/index.js";
|
|
21
|
+
import corePromptBuilderFn from "./core/prompt-builder/index.js";
|
|
22
|
+
|
|
23
|
+
// cognitive (reasoning tools + detectors: think, verify, topic-drift, MARS reflection, ...)
|
|
24
|
+
import metacognitionFn from "./cognitive/metacognition/index.js";
|
|
25
|
+
import reasoningFn from "./cognitive/reasoning/index.js";
|
|
26
|
+
import topicDriftFn from "./cognitive/topic-drift/index.js";
|
|
27
|
+
import sycophancyDetectorFn from "./cognitive/sycophancy-detector/index.js";
|
|
28
|
+
import turnOutcomeFn from "./cognitive/turn-outcome/index.js";
|
|
29
|
+
import marsReflectorFn from "./cognitive/mars-reflector/index.js";
|
|
30
|
+
|
|
31
|
+
// memory (persistent state: three stores, bridge, session recall, working memory, file state)
|
|
32
|
+
import memoryStoresFn from "./memory/three-memory-stores/index.js";
|
|
33
|
+
import memoryAgentBridgeFn from "./memory/memory-agent-bridge/index.js";
|
|
34
|
+
import sessionRecallFn from "./memory/session-recall/index.js";
|
|
35
|
+
import contextManagerFn from "./memory/context-manager/index.js";
|
|
36
|
+
import contextLifecycleFn from "./memory/context-lifecycle/index.js";
|
|
37
|
+
import scratchpadFn from "./memory/scratchpad/index.js";
|
|
38
|
+
import workspaceSnapshotFn from "./memory/workspace-snapshot/index.js";
|
|
39
|
+
|
|
40
|
+
// scheduling (time-based events: reminders)
|
|
41
|
+
import timerFn from "./scheduling/timer/index.js";
|
|
42
|
+
|
|
43
|
+
// tools (on-demand utilities)
|
|
44
|
+
import skillsToolFn from "./core/skills-tool/index.js";
|
|
45
|
+
|
|
46
|
+
// self (self-management: health, errors, recovery, behavior, session monitor)
|
|
47
|
+
import healthMaintenanceFn from "./self/health-maintenance/index.js";
|
|
48
|
+
import errorCaptureFn from "./self/error-tracking/index.js";
|
|
49
|
+
import watchdogFn from "./self/watchdog/index.js";
|
|
50
|
+
import autoRecoveryFn from "./self/auto-recovery/index.js";
|
|
51
|
+
import latentActivatorFn from "./self/latent-activator/index.js";
|
|
52
|
+
|
|
53
|
+
// enforcement (turn pipeline: handlers, detection, substate)
|
|
54
|
+
import enforcementFn from "./enforcement/index.js";
|
|
55
|
+
|
|
56
|
+
// heartbeat (proactive background services: scheduler, analytics)
|
|
57
|
+
import heartbeatSchedulerFn from "./heartbeat/heartbeat-scheduler/index.js";
|
|
58
|
+
import analyticsFn from "./heartbeat/analytics/index.js";
|
|
59
|
+
|
|
60
|
+
export interface ManifestEntry {
|
|
61
|
+
/** Unique extension identifier (e.g. "enforcement", "core/metacognition"). */
|
|
62
|
+
id: string;
|
|
63
|
+
/** Factory function called with pi API to register tools + event handlers. */
|
|
64
|
+
fn: (pi: ExtensionAPI) => Promise<void> | void;
|
|
65
|
+
/** Human-readable description. */
|
|
66
|
+
desc: string;
|
|
67
|
+
/** Core - cannot be disabled, always loaded. */
|
|
68
|
+
alwaysOn?: boolean;
|
|
69
|
+
/** Opt-in - disabled by default unless explicitly enabled. */
|
|
70
|
+
disabledByDefault?: boolean;
|
|
71
|
+
/** Extension IDs this depends on (loaded first). */
|
|
72
|
+
dependencies?: string[];
|
|
73
|
+
/** Convenience module label for subagent API commands (no structural role). */
|
|
74
|
+
module?: string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export const MANIFEST: ManifestEntry[] = [
|
|
78
|
+
{
|
|
79
|
+
id: "polyfill",
|
|
80
|
+
fn: corePolyfillFn,
|
|
81
|
+
alwaysOn: true,
|
|
82
|
+
desc: "pi API polyfills, vision model config",
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
id: "metacognition",
|
|
86
|
+
fn: metacognitionFn,
|
|
87
|
+
alwaysOn: true,
|
|
88
|
+
desc: "think, hypothesize, finalize, verify tools",
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
id: "scratchpad",
|
|
92
|
+
fn: scratchpadFn,
|
|
93
|
+
alwaysOn: true,
|
|
94
|
+
desc: "scratchpad tool",
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
id: "prompt-builder",
|
|
98
|
+
fn: corePromptBuilderFn,
|
|
99
|
+
alwaysOn: true,
|
|
100
|
+
desc: "System prompt assembly",
|
|
101
|
+
},
|
|
102
|
+
{
|
|
103
|
+
id: "agent-environment",
|
|
104
|
+
fn: coreAgentEnvFn,
|
|
105
|
+
alwaysOn: true,
|
|
106
|
+
desc: "time_status, L1 context injection",
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
id: "workspace-snapshot",
|
|
110
|
+
fn: workspaceSnapshotFn,
|
|
111
|
+
alwaysOn: true,
|
|
112
|
+
desc: "workspace_snapshot tool - capture/list/diff/restore file snapshots",
|
|
113
|
+
},
|
|
114
|
+
|
|
115
|
+
{
|
|
116
|
+
id: "reasoning",
|
|
117
|
+
fn: reasoningFn,
|
|
118
|
+
desc: "Reasoning quality detector (stability analysis + verify-before-done nudge)",
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
id: "topic-drift",
|
|
122
|
+
fn: topicDriftFn,
|
|
123
|
+
dependencies: ["agent-environment"],
|
|
124
|
+
desc: "check/reset topic drift tools",
|
|
125
|
+
},
|
|
126
|
+
{
|
|
127
|
+
id: "sycophancy-detector",
|
|
128
|
+
fn: sycophancyDetectorFn,
|
|
129
|
+
dependencies: ["agent-environment"],
|
|
130
|
+
desc: "Contrast-based sycophancy detection",
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
id: "turn-outcome",
|
|
134
|
+
fn: turnOutcomeFn,
|
|
135
|
+
dependencies: ["agent-environment"],
|
|
136
|
+
desc: "Turn outcome loop detection",
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
id: "mars-reflector",
|
|
140
|
+
fn: marsReflectorFn,
|
|
141
|
+
desc: "MARS principle + procedure reflection on task completion",
|
|
142
|
+
},
|
|
143
|
+
|
|
144
|
+
{
|
|
145
|
+
id: "enforcement",
|
|
146
|
+
fn: enforcementFn,
|
|
147
|
+
dependencies: ["agent-environment"],
|
|
148
|
+
desc: "RepE-based behavioral enforcement, turn validation",
|
|
149
|
+
},
|
|
150
|
+
|
|
151
|
+
{
|
|
152
|
+
id: "three-memory-stores",
|
|
153
|
+
fn: memoryStoresFn,
|
|
154
|
+
dependencies: ["agent-environment"],
|
|
155
|
+
desc: "Core memory infrastructure",
|
|
156
|
+
module: "memory",
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
id: "session-recall",
|
|
160
|
+
fn: sessionRecallFn,
|
|
161
|
+
dependencies: ["three-memory-stores"],
|
|
162
|
+
desc: "Session recall tools (session_search, session_query)",
|
|
163
|
+
module: "memory",
|
|
164
|
+
},
|
|
165
|
+
{
|
|
166
|
+
id: "context-manager",
|
|
167
|
+
fn: contextManagerFn,
|
|
168
|
+
dependencies: ["three-memory-stores"],
|
|
169
|
+
desc: "Context compaction/pruning tools",
|
|
170
|
+
module: "memory",
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
id: "context-lifecycle",
|
|
174
|
+
fn: contextLifecycleFn,
|
|
175
|
+
dependencies: ["three-memory-stores"],
|
|
176
|
+
desc: "Context proposals, signal, lifecycle",
|
|
177
|
+
module: "memory",
|
|
178
|
+
},
|
|
179
|
+
{
|
|
180
|
+
id: "memory-agent-bridge",
|
|
181
|
+
fn: memoryAgentBridgeFn,
|
|
182
|
+
dependencies: ["three-memory-stores"],
|
|
183
|
+
desc: "Agent-facing memory tools (store/recall/list/get)",
|
|
184
|
+
module: "memory",
|
|
185
|
+
},
|
|
186
|
+
|
|
187
|
+
{
|
|
188
|
+
id: "heartbeat-scheduler",
|
|
189
|
+
fn: heartbeatSchedulerFn,
|
|
190
|
+
dependencies: ["memory-agent-bridge"],
|
|
191
|
+
desc: "Cognitive scheduling engine",
|
|
192
|
+
module: "heartbeat",
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
id: "analytics",
|
|
196
|
+
fn: analyticsFn,
|
|
197
|
+
dependencies: ["memory-agent-bridge"],
|
|
198
|
+
desc: "Session metrics tools",
|
|
199
|
+
module: "heartbeat",
|
|
200
|
+
},
|
|
201
|
+
|
|
202
|
+
{
|
|
203
|
+
id: "timer",
|
|
204
|
+
fn: timerFn,
|
|
205
|
+
desc: "Timer tool",
|
|
206
|
+
},
|
|
207
|
+
{
|
|
208
|
+
id: "skills-tool",
|
|
209
|
+
fn: skillsToolFn,
|
|
210
|
+
desc: "list_skills tool — on-demand skill discovery",
|
|
211
|
+
},
|
|
212
|
+
{
|
|
213
|
+
id: "orchestrator",
|
|
214
|
+
fn: orchestratorFn,
|
|
215
|
+
desc: "orchestrate tool — multi-agent coordination (branch-per-worker, file-lock, conflict detection, merge verification)",
|
|
216
|
+
},
|
|
217
|
+
{
|
|
218
|
+
id: "auto-recovery",
|
|
219
|
+
fn: autoRecoveryFn,
|
|
220
|
+
desc: "Auto-recovery from hangs",
|
|
221
|
+
},
|
|
222
|
+
{
|
|
223
|
+
id: "latent-activator",
|
|
224
|
+
fn: latentActivatorFn,
|
|
225
|
+
desc: "Latent behavior activator",
|
|
226
|
+
},
|
|
227
|
+
|
|
228
|
+
// Watchdog (default-ON — liveness/stall state machine)
|
|
229
|
+
// Default-ON per TG-HEARTBEAT-WATCHDOG-DESIGN.md ("default ON, NO new env
|
|
230
|
+
// vars"); override via `broker.watchdog` in the one settings path that
|
|
231
|
+
// config.ts reads (~/.pi/agent/settings.json, or ${PI_CODING_AGENT_DIR}/
|
|
232
|
+
// settings.json when set). Not opt-in like error-tracking/health-maintenance.
|
|
233
|
+
{
|
|
234
|
+
id: "watchdog",
|
|
235
|
+
fn: watchdogFn,
|
|
236
|
+
dependencies: ["agent-environment"],
|
|
237
|
+
desc: "Session monitoring + liveness/stall watchdog (default-on)",
|
|
238
|
+
},
|
|
239
|
+
|
|
240
|
+
// Health Maintenance (opt-in)
|
|
241
|
+
{
|
|
242
|
+
id: "health-maintenance",
|
|
243
|
+
fn: healthMaintenanceFn,
|
|
244
|
+
disabledByDefault: true,
|
|
245
|
+
dependencies: ["agent-environment"],
|
|
246
|
+
desc: "Health-based checkpointing, degradation detection, rollback",
|
|
247
|
+
},
|
|
248
|
+
|
|
249
|
+
{
|
|
250
|
+
id: "context-management",
|
|
251
|
+
fn: contextManagementFn,
|
|
252
|
+
alwaysOn: true,
|
|
253
|
+
desc: "Tool profile switching via pi.setActiveTools() — a curated active set (about a dozen tools) by default",
|
|
254
|
+
},
|
|
255
|
+
|
|
256
|
+
// Error Tracking (opt-in)
|
|
257
|
+
{
|
|
258
|
+
id: "error-tracking",
|
|
259
|
+
fn: errorCaptureFn,
|
|
260
|
+
disabledByDefault: true,
|
|
261
|
+
dependencies: ["agent-environment"],
|
|
262
|
+
desc: "Error logging tools: error_list, error_get",
|
|
263
|
+
},
|
|
264
|
+
];
|
|
265
|
+
|
|
266
|
+
const _byId = new Map(MANIFEST.map((e) => [e.id, e]));
|
|
267
|
+
const _byModule = new Map<string, ManifestEntry[]>();
|
|
268
|
+
for (const entry of MANIFEST) {
|
|
269
|
+
const mod = entry.module ?? entry.id.split("/")[0] ?? "other";
|
|
270
|
+
const list = _byModule.get(mod);
|
|
271
|
+
if (list) list.push(entry);
|
|
272
|
+
else _byModule.set(mod, [entry]);
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
export function getEntry(id: string): ManifestEntry | undefined {
|
|
276
|
+
return _byId.get(id);
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
export function getModuleGroup(mod: string): ManifestEntry[] {
|
|
280
|
+
return _byModule.get(mod) ?? [];
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
export function getModuleNames(): string[] {
|
|
284
|
+
return [...new Set(MANIFEST.map((e) => e.module ?? e.id.split("/")[0] ?? "other"))];
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
export function getDefaultEnabledIds(): string[] {
|
|
288
|
+
return MANIFEST.filter((e) => !e.disabledByDefault).map((e) => e.id);
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
export function getAlwaysOnIds(): string[] {
|
|
292
|
+
return MANIFEST.filter((e) => e.alwaysOn).map((e) => e.id);
|
|
293
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Memory Module
|
|
4
|
+
|
|
5
|
+
Context lifecycle, three-memory-stores, memory-agent-bridge, session-recall.
|
|
6
|
+
|
|
7
|
+
## Compaction fails safe instead of looping
|
|
8
|
+
|
|
9
|
+
Every compaction failure class ends in a landed entry, or the session is declared
|
|
10
|
+
unable to summarize itself and cuts deterministically. Three mechanisms carry that
|
|
11
|
+
contract (`context-manager/handlers/`):
|
|
12
|
+
|
|
13
|
+
- **Ladder integrity** - the retry ladders (`compaction-retry.ts`) walk plain retries,
|
|
14
|
+
then a bounded chunked summarizer, then a no-LLM deterministic cut. The attempt a
|
|
15
|
+
retry spends survives its own dispatch: `RetryState.inFlight` holds it across the
|
|
16
|
+
`turn_end` that pi-core's manual `compact()` causes by aborting the in-flight turn
|
|
17
|
+
first. The exhausted rungs reset the ladder so the ceiling is a sequence boundary,
|
|
18
|
+
not a session sentence.
|
|
19
|
+
- **Guard release** - `compactionRetryActive` / `overflowRetryActive` are released by
|
|
20
|
+
the cycle OUTCOME, whichever it is. Releasing them only on success left the first
|
|
21
|
+
failed retry guarding the session forever, and every later dispatch then reset the
|
|
22
|
+
ladder instead of climbing it.
|
|
23
|
+
- **No-progress fail-safe** - `COMPACTION_NO_PROGRESS_LIMIT` consecutive cycles that
|
|
24
|
+
land no entry while usage is at or above `USAGE_WHISPER_CRITICAL` arm one
|
|
25
|
+
deterministic cut (`shared.ts` fail-safe state, consumed at the top of
|
|
26
|
+
`session_before_compact`). A cut needs no provider, so it holds for every failure
|
|
27
|
+
class: an aborted cycle carries no error text at all, and a spent-allowance 402 has
|
|
28
|
+
nowhere to rotate because the compaction path selects no model - it uses the session
|
|
29
|
+
model (`ctx.model`) or pi-core's own. An operator slide keeps precedence and leaves
|
|
30
|
+
the cut armed; a dispatched retry owns the next cycle and consumes it there.
|
|
31
|
+
Fixture: `packages/core/test/runtime/memory/test-compaction-failsafe.mjs`.
|
|
32
|
+
|
|
33
|
+
## Compaction paths and stale-timer cleanup
|
|
34
|
+
|
|
35
|
+
All three code paths cancel stale compaction-resume timers to prevent misplaced `[timer]` whispers on later TURN_END events. The timer itself was **removed in 2026-07-11** because pi-core's internal `_runAutoCompaction()` continues the agent on its own - but only on `willRetry` (overflow recovery) or when queued messages exist (`agent.hasQueuedMessages()` → `agent.continue()`). That auto-continue does **NOT** cover the manual `ctx.compact()` path that the agent-initiated `context_compress` tool uses: manual compaction calls `_disconnectFromAgent() + abort()` (killing the loop) and never resumes it. For that path the resume is the enforcement `session_compact` re-orientation whisper (`enforcement/handlers/register-session-compact.ts`) gated on `autoResumeAfterCompaction`, delivered with `triggerTurn: true`. The 3-minute fallback timer was removed as spurious noise for the auto path, but the agent-initiated manual path depends on the whisper wake - verified 2026-08-02 after the whisper's `triggerTurn` was found defeated by a `deliverAs: "nextTurn"` default; see `enforcement/whisper.ts`.
|
|
36
|
+
|
|
37
|
+
Operator-initiated manual compaction (`/compact`, RPC) with a message queued mid-compaction is a **full stop** (verified 2026-09-16): the compaction's queued message is parked via the context-manager pre-append, and the context-manager input-hook hold (`context-manager/handlers/compaction.ts`, armed on `session_compact` with `reason === "manual"`) swallows the TUI flush's replay prompt (`{action: "handled"}`), so no assistant turn starts from pre-compaction input; the operator's next input or a wake (whisper/timer with `triggerTurn: true`) starts the next turn. Auto compactions (`threshold`/`overflow`) keep the flush replay as their resume and are never armed. Fixture: `packages/core/test/runtime/memory/test-manual-compaction-stop.mjs`.
|
|
38
|
+
|
|
39
|
+
| Path | File | Cancels tags? |
|
|
40
|
+
| ------------------------------------- | ---------------------------------------------------- | ----------------------- |
|
|
41
|
+
| Manual `context_compress` tool | `context-manager/handlers/tools/context-compress.ts` | YES (defensive cleanup) |
|
|
42
|
+
| Auto-compact escalation | `context-lifecycle/index.ts` | YES (defensive cleanup) |
|
|
43
|
+
| `session_compact` enforcement handler | `enforcement/handlers/register-session-compact.ts` | YES (defensive cleanup) |
|
|
44
|
+
|
|
45
|
+
The `cancelTimersByTag` helper from `extensions/scheduling/timer/index.ts` is the shared API. Cancellation is kept as a safety measure to clean up any timers that were scheduled before the removal.
|
|
46
|
+
|
|
47
|
+
## Parallel-tool-call constraint
|
|
48
|
+
|
|
49
|
+
`context_compress` returns its result immediately and defers the actual
|
|
50
|
+
`ctx.compact()` to the agent-run settle point (batch-settle scheduler:
|
|
51
|
+
armed on the compress tool's action, fired after `agent_settled` once the
|
|
52
|
+
batch's tool-result messages have landed - see
|
|
53
|
+
`context-manager/handlers/tools/context-compress.ts`). This removes the old
|
|
54
|
+
mid-batch abort race: a still-executing parallel sibling's tool result is
|
|
55
|
+
delivered BEFORE the aborting compact fires and is no longer discarded
|
|
56
|
+
(pinned by `test/runtime/memory/test-compress-batch-settle.mjs`). The
|
|
57
|
+
degraded path (batch-settle bookkeeping unavailable) uses a bounded
|
|
58
|
+
`DEGRADED_DEFERRAL_MS` (150ms) deferral - never a raw `setTimeout(0)`.
|
|
59
|
+
|
|
60
|
+
The agent-facing guidance in the tool description still warns against
|
|
61
|
+
parallel batches ("Never in a parallel batch (it aborts the turn)"): the
|
|
62
|
+
deferred `ctx.compact()` still aborts the run at the settle point, so
|
|
63
|
+
compaction remains a turn-boundary action, not a mid-batch one. The
|
|
64
|
+
mechanism is loss-preserving; the boundary discipline stands.
|
|
65
|
+
|
|
66
|
+
## Whisper wake-up policy in this module
|
|
67
|
+
|
|
68
|
+
Whispers from compaction-retry, navigation, and memory hooks use `triggerTurn: true` for messages that demand the agent's action:
|
|
69
|
+
|
|
70
|
+
- **compaction-retry** (`context-manager/handlers/compaction-retry.ts`): exhausted / context-window / threshold errors all wake the agent. In-progress retry messages (`overflow`, `transient`, `threshold`, `summary-cap`) park (`delivery: "park"`, no forced continuation turn) because the agent is mid-retry; a summary-cap failure self-recovers on the retry cycle with a bounded chunked summary (compaction-chunked.ts), so only its exhausted path wakes.
|
|
71
|
+
- **navigation** (`context-manager/handlers/navigation.ts`): "Context checkout prepared" with a direct action instruction wakes the agent.
|
|
72
|
+
- **three-memory-stores** (`memory/three-memory-stores/index.ts`): tool reliability alerts (gap > 0.2) wake the agent so it can switch tools.
|
|
73
|
+
- **rotation** (`context-manager/handlers/shared.ts:327`, `rotation.ts`): emergency rotation wakes. The size notice parks while a run is streaming (flushed at the same `turn_end`) and keeps its wake only when the session is idle; a notice still in flight suppresses a second emission through the unresolved-advisory registry in `lib/utils/injection-tracker.ts`.
|
|
74
|
+
|
|
75
|
+
Advisory whispers (memory recall, past insights, hint injection, SOP suggestions) park (`delivery: "park"`) - they provide context for the agent's natural flow.
|
|
76
|
+
|
|
77
|
+
## Re-entrancy safety
|
|
78
|
+
|
|
79
|
+
Both `context-lifecycle/index.ts` (line 56) and `lib/utils/injection-tracker.ts` (line 47) maintain re-entrancy guards for `before_agent_start` and `sendTrackedMessage` respectively. The latter uses `MAX_REENTRY_DEPTH = 1` - only 1 synchronous `pi.sendMessage` call is allowed before deferring to `queueMicrotask`. This is the safe floor for the runtime's re-entry depth (which the counter cannot see, since each extension's before_agent_start hook re-enters independently).
|
|
80
|
+
|
|
81
|
+
## Agent-facing tool summary
|
|
82
|
+
|
|
83
|
+
The memory extensions expose 4 LLM-callable tools. The unified `memory` tool covers the three read-heavy domains (recall/episodes/heuristics) with 9 actions.
|
|
84
|
+
|
|
85
|
+
| Tool | Extension | Store | When to use |
|
|
86
|
+
| -------------- | ------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
87
|
+
| `memory_store` | memory-agent-bridge | semantic (unified) | Save insights/patterns for cross-session recall |
|
|
88
|
+
| `memory` | memory-agent-bridge | all three | Unified access: `recall_search` (semantic search, also cross-searches episodes), `recall_list`, `recall_get`, `episodes_search` (case-based reasoning), `episodes_list`, `episodes_add`, `heuristics_list`, `heuristics_add`, `heuristics_evolve` |
|
|
89
|
+
| `session` | session-recall | session log | Search past sessions (action=search) or query one (action=query) |
|
|
90
|
+
|
|
91
|
+
**Rule of thumb:** start with `memory` action=recall_search for "have I seen this before?". Use `memory` action=episodes_search for "how did a similar task go?". Use `memory` action=heuristics_list when investigating behavior tuning. Use `session` for cross-session history.
|
|
92
|
+
|
|
93
|
+
The data-layer functions (`addEpisode`, `addPrinciple`, `recordToolCall`, etc.) live in `three-memory-stores/episodes.ts`, `heuristics.ts`, `tool-reliability.ts` and are imported by many extensions (e.g. `finalize.ts` adds episodes on task completion). These are infrastructure and should not be moved out of the directory.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# Context Lifecycle Extension
|
|
4
|
+
|
|
5
|
+
The AUTOMATION layer for context management. Works WITH
|
|
6
|
+
`context-manager` (which exposes the tools) - does NOT expose new tools.
|
|
7
|
+
Implements the R-CCAM (Retrieval-Cognition-Control-Action-Memory) loop
|
|
8
|
+
in cognitive-memory theory.
|
|
9
|
+
|
|
10
|
+
## Architecture
|
|
11
|
+
|
|
12
|
+
| File | Purpose |
|
|
13
|
+
| -------------------- | --------------------------------------------------------------------------- |
|
|
14
|
+
| `index.ts` | Extension entry point; registers event listeners and proposal handler |
|
|
15
|
+
| `state.ts` | Session-scoped state (proposals, decisions, history) |
|
|
16
|
+
| `types.ts` | Type definitions for proposals, policies, signals |
|
|
17
|
+
| `policy-engine.ts` | Evaluates a proposal against active policies (token budget, cooldown, etc.) |
|
|
18
|
+
| `signal-detector.ts` | Detects when the agent is approaching context limits from session content |
|
|
19
|
+
| `helpers.ts` | Shared utilities |
|
|
20
|
+
|
|
21
|
+
## What it does
|
|
22
|
+
|
|
23
|
+
The R-CCAM loop runs on `turn_end`:
|
|
24
|
+
|
|
25
|
+
1. **Retrieval**: `signal-detector.ts` scans the latest turn for signals
|
|
26
|
+
(high token growth, error patterns, repeated tools)
|
|
27
|
+
2. **Cognition**: `policy-engine.ts` evaluates a proposed action (e.g.
|
|
28
|
+
"archive 30% of older messages")
|
|
29
|
+
3. **Control**: Constraint check (cooldown, cost-benefit, agent's
|
|
30
|
+
recent explicit instructions)
|
|
31
|
+
4. **Action**: Either inject a `propose` entry for the agent to act on,
|
|
32
|
+
or auto-execute if the policy says so
|
|
33
|
+
5. **Memory**: Record the outcome (proposed/accepted/rejected/auto-executed)
|
|
34
|
+
for meta-learning
|
|
35
|
+
|
|
36
|
+
## Relationship to context-manager
|
|
37
|
+
|
|
38
|
+
`context-manager` exposes the LLM-callable tools (`context_compress`,
|
|
39
|
+
`context_navigate`, `context_inspect`, `context_archive`,
|
|
40
|
+
`context_proposals`). `context-lifecycle` AUTOMATES the use of those
|
|
41
|
+
tools by detecting when they're needed and either proposing them
|
|
42
|
+
(via custom entry) or executing them directly.
|
|
43
|
+
|
|
44
|
+
**The LLM never calls context-lifecycle directly** - it's a daemon.
|
|
45
|
+
The LLM can call the context-manager tools at any time, in which case
|
|
46
|
+
context-lifecycle sees the result and updates its state.
|
|
47
|
+
|
|
48
|
+
## Event-bus contract
|
|
49
|
+
|
|
50
|
+
| Emits | Listens to |
|
|
51
|
+
| ------ | ------------------------------------------------------------- |
|
|
52
|
+
| (none) | `memory_evict` (from `lib/store/...`) - updates its own state |
|
|
53
|
+
|
|
54
|
+
## Local Contracts
|
|
55
|
+
|
|
56
|
+
- **Session-scoped state** via `getExtensionState(ctx, key, factory)`.
|
|
57
|
+
- **No new tools** - the design is "extend the agent's context
|
|
58
|
+
awareness without adding to its tool inventory".
|
|
59
|
+
- **Proposal injection** uses `customEntry` (`propose` type) so the
|
|
60
|
+
LLM sees it as a suggestion, not an instruction.
|
|
61
|
+
- **Cooldown**: proposals of the same type are debounced for N turns
|
|
62
|
+
(default 5) to avoid nagging the agent.
|