pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,52 @@
|
|
|
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
|
+
import type { SelfStateSample } from "../../../lib/telemetry/context-heartbeat.js";
|
|
15
|
+
export interface WhisperBufferEntry {
|
|
16
|
+
message: string;
|
|
17
|
+
priority: string;
|
|
18
|
+
}
|
|
19
|
+
export type WhisperSendFn = (msg: string, opts?: {
|
|
20
|
+
category?: string;
|
|
21
|
+
priority?: string;
|
|
22
|
+
}) => void;
|
|
23
|
+
/**
|
|
24
|
+
* Self-state line (2 directive): every heartbeat
|
|
25
|
+
* summary makes the agent self-aware of its own context health. ONE line,
|
|
26
|
+
* <= 40 tokens, appended to every heartbeat summary:
|
|
27
|
+
*
|
|
28
|
+
* self-state: ctx 213K tok · cache 96% · dup 39 · tps-ema 87
|
|
29
|
+
*
|
|
30
|
+
* An unavailable metric renders "n/a" — never zero (a zero looks like a
|
|
31
|
+
* healthy reading; "n/a" honestly says the telemetry is missing).
|
|
32
|
+
*/
|
|
33
|
+
export declare function buildSelfStateLine(sample: Partial<SelfStateSample> | null | undefined): string;
|
|
34
|
+
/**
|
|
35
|
+
* Flush batched whispers: group by priority tier, concatenate per tier,
|
|
36
|
+
* and send as aggregated messages. This prevents N separate injected
|
|
37
|
+
* messages per heartbeat tick when multiple modules activate.
|
|
38
|
+
*
|
|
39
|
+
* Fresh clock: every batched summary
|
|
40
|
+
* (and its single-message form) prepends a `now:` line rendered by the
|
|
41
|
+
* ONE local-time formatter (lib/utils/local-time.ts) so the agent never
|
|
42
|
+
* reasons on a stale clock mid-session.
|
|
43
|
+
*
|
|
44
|
+
* Self-state (Refine-2): when `selfState` is provided (the caller
|
|
45
|
+
* samples context tokens / cache-hit share / near-duplicates / tok/s trend
|
|
46
|
+
* via lib/telemetry/context-heartbeat.ts getSelfStateSample), the summary
|
|
47
|
+
* gains ONE self-state line right after the `now:` line — every heartbeat
|
|
48
|
+
* summary makes the agent aware of its own context health. Absent sample =
|
|
49
|
+
* no line (callers opt in).
|
|
50
|
+
*/
|
|
51
|
+
export declare function flushWhisperBuffer(buffer: WhisperBufferEntry[], send: WhisperSendFn | undefined, selfState?: string): void;
|
|
52
|
+
//# sourceMappingURL=whisper-batcher.d.ts.map
|
|
@@ -0,0 +1,83 @@
|
|
|
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
|
+
import { formatLocalTime } from "../../../lib/utils/local-time.js";
|
|
15
|
+
import { formatTokensK } from "../../../lib/detection/context-usage.js";
|
|
16
|
+
/** Render a token count compactly: 0 -> "0K", 1234 -> "1K", 237785 -> "238K". */
|
|
17
|
+
function renderTokensK(tokens) {
|
|
18
|
+
return formatTokensK(tokens);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Self-state line (2 directive): every heartbeat
|
|
22
|
+
* summary makes the agent self-aware of its own context health. ONE line,
|
|
23
|
+
* <= 40 tokens, appended to every heartbeat summary:
|
|
24
|
+
*
|
|
25
|
+
* self-state: ctx 213K tok · cache 96% · dup 39 · tps-ema 87
|
|
26
|
+
*
|
|
27
|
+
* An unavailable metric renders "n/a" — never zero (a zero looks like a
|
|
28
|
+
* healthy reading; "n/a" honestly says the telemetry is missing).
|
|
29
|
+
*/
|
|
30
|
+
export function buildSelfStateLine(sample) {
|
|
31
|
+
const s = sample ?? {};
|
|
32
|
+
const ctxTok = typeof s.contextTokens === "number" ? `${renderTokensK(s.contextTokens)} tok` : "n/a";
|
|
33
|
+
const cache = typeof s.cacheHitShare === "number" ? `${Math.round(s.cacheHitShare)}%` : "n/a";
|
|
34
|
+
const dup = typeof s.nearDupCount === "number" ? String(s.nearDupCount) : "n/a";
|
|
35
|
+
const tps = typeof s.tpsEma === "number" ? `${Math.round(s.tpsEma)} tok/s` : "n/a";
|
|
36
|
+
const acts = typeof s.hygieneActs === "number" ? String(s.hygieneActs) : null;
|
|
37
|
+
const actPart = acts ? ` · acts ${acts}` : "";
|
|
38
|
+
return `self-state: ctx ${ctxTok} · cache ${cache} · dup ${dup} · tps-ema ${tps}${actPart}`;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Flush batched whispers: group by priority tier, concatenate per tier,
|
|
42
|
+
* and send as aggregated messages. This prevents N separate injected
|
|
43
|
+
* messages per heartbeat tick when multiple modules activate.
|
|
44
|
+
*
|
|
45
|
+
* Fresh clock: every batched summary
|
|
46
|
+
* (and its single-message form) prepends a `now:` line rendered by the
|
|
47
|
+
* ONE local-time formatter (lib/utils/local-time.ts) so the agent never
|
|
48
|
+
* reasons on a stale clock mid-session.
|
|
49
|
+
*
|
|
50
|
+
* Self-state (Refine-2): when `selfState` is provided (the caller
|
|
51
|
+
* samples context tokens / cache-hit share / near-duplicates / tok/s trend
|
|
52
|
+
* via lib/telemetry/context-heartbeat.ts getSelfStateSample), the summary
|
|
53
|
+
* gains ONE self-state line right after the `now:` line — every heartbeat
|
|
54
|
+
* summary makes the agent aware of its own context health. Absent sample =
|
|
55
|
+
* no line (callers opt in).
|
|
56
|
+
*/
|
|
57
|
+
export function flushWhisperBuffer(buffer, send, selfState) {
|
|
58
|
+
if (buffer.length === 0 || !send)
|
|
59
|
+
return;
|
|
60
|
+
const groups = new Map();
|
|
61
|
+
for (const entry of buffer) {
|
|
62
|
+
const p = entry.priority;
|
|
63
|
+
if (!groups.has(p))
|
|
64
|
+
groups.set(p, []);
|
|
65
|
+
groups.get(p).push(entry.message);
|
|
66
|
+
}
|
|
67
|
+
// Flush one message per priority tier
|
|
68
|
+
for (const [priority, messages] of groups) {
|
|
69
|
+
const nowLine = `now: ${formatLocalTime(new Date(), true)}`;
|
|
70
|
+
const selfStateSuffix = selfState ? `\n${selfState}` : "";
|
|
71
|
+
if (messages.length === 1) {
|
|
72
|
+
send(`${nowLine}${selfStateSuffix}\n${messages[0]}`, {
|
|
73
|
+
category: "cognitive",
|
|
74
|
+
priority: priority,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
else {
|
|
78
|
+
const combined = `[Heartbeat Summary]\n${nowLine}${selfStateSuffix}\n${messages.map((m, i) => `${i + 1}. ${m}`).join("\n")}`;
|
|
79
|
+
send(combined, { category: "cognitive", priority: priority });
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=whisper-batcher.js.map
|
|
@@ -0,0 +1,32 @@
|
|
|
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
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
10
|
+
export interface ManifestEntry {
|
|
11
|
+
/** Unique extension identifier (e.g. "enforcement", "core/metacognition"). */
|
|
12
|
+
id: string;
|
|
13
|
+
/** Factory function called with pi API to register tools + event handlers. */
|
|
14
|
+
fn: (pi: ExtensionAPI) => Promise<void> | void;
|
|
15
|
+
/** Human-readable description. */
|
|
16
|
+
desc: string;
|
|
17
|
+
/** Core - cannot be disabled, always loaded. */
|
|
18
|
+
alwaysOn?: boolean;
|
|
19
|
+
/** Opt-in - disabled by default unless explicitly enabled. */
|
|
20
|
+
disabledByDefault?: boolean;
|
|
21
|
+
/** Extension IDs this depends on (loaded first). */
|
|
22
|
+
dependencies?: string[];
|
|
23
|
+
/** Convenience module label for subagent API commands (no structural role). */
|
|
24
|
+
module?: string;
|
|
25
|
+
}
|
|
26
|
+
export declare const MANIFEST: ManifestEntry[];
|
|
27
|
+
export declare function getEntry(id: string): ManifestEntry | undefined;
|
|
28
|
+
export declare function getModuleGroup(mod: string): ManifestEntry[];
|
|
29
|
+
export declare function getModuleNames(): string[];
|
|
30
|
+
export declare function getDefaultEnabledIds(): string[];
|
|
31
|
+
export declare function getAlwaysOnIds(): string[];
|
|
32
|
+
//# sourceMappingURL=manifest.d.ts.map
|
|
@@ -0,0 +1,251 @@
|
|
|
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
|
+
// core (input/output shaping: platform, env, prompt)
|
|
10
|
+
import corePolyfillFn from "./core/polyfill/index.js";
|
|
11
|
+
// orchestrator (multi-agent coordination)
|
|
12
|
+
import orchestratorFn from "./orchestrator/index.js";
|
|
13
|
+
// context-management (tool profile switching)
|
|
14
|
+
import contextManagementFn from "./context-management/index.js";
|
|
15
|
+
import coreAgentEnvFn from "./core/agent-environment/index.js";
|
|
16
|
+
import corePromptBuilderFn from "./core/prompt-builder/index.js";
|
|
17
|
+
// cognitive (reasoning tools + detectors: think, verify, topic-drift, MARS reflection, ...)
|
|
18
|
+
import metacognitionFn from "./cognitive/metacognition/index.js";
|
|
19
|
+
import reasoningFn from "./cognitive/reasoning/index.js";
|
|
20
|
+
import topicDriftFn from "./cognitive/topic-drift/index.js";
|
|
21
|
+
import sycophancyDetectorFn from "./cognitive/sycophancy-detector/index.js";
|
|
22
|
+
import turnOutcomeFn from "./cognitive/turn-outcome/index.js";
|
|
23
|
+
import marsReflectorFn from "./cognitive/mars-reflector/index.js";
|
|
24
|
+
// memory (persistent state: three stores, bridge, session recall, working memory, file state)
|
|
25
|
+
import memoryStoresFn from "./memory/three-memory-stores/index.js";
|
|
26
|
+
import memoryAgentBridgeFn from "./memory/memory-agent-bridge/index.js";
|
|
27
|
+
import sessionRecallFn from "./memory/session-recall/index.js";
|
|
28
|
+
import contextManagerFn from "./memory/context-manager/index.js";
|
|
29
|
+
import contextLifecycleFn from "./memory/context-lifecycle/index.js";
|
|
30
|
+
import scratchpadFn from "./memory/scratchpad/index.js";
|
|
31
|
+
import workspaceSnapshotFn from "./memory/workspace-snapshot/index.js";
|
|
32
|
+
// scheduling (time-based events: reminders)
|
|
33
|
+
import timerFn from "./scheduling/timer/index.js";
|
|
34
|
+
// tools (on-demand utilities)
|
|
35
|
+
import skillsToolFn from "./core/skills-tool/index.js";
|
|
36
|
+
// self (self-management: health, errors, recovery, behavior, session monitor)
|
|
37
|
+
import healthMaintenanceFn from "./self/health-maintenance/index.js";
|
|
38
|
+
import errorCaptureFn from "./self/error-tracking/index.js";
|
|
39
|
+
import watchdogFn from "./self/watchdog/index.js";
|
|
40
|
+
import autoRecoveryFn from "./self/auto-recovery/index.js";
|
|
41
|
+
import latentActivatorFn from "./self/latent-activator/index.js";
|
|
42
|
+
// enforcement (turn pipeline: handlers, detection, substate)
|
|
43
|
+
import enforcementFn from "./enforcement/index.js";
|
|
44
|
+
// heartbeat (proactive background services: scheduler, analytics)
|
|
45
|
+
import heartbeatSchedulerFn from "./heartbeat/heartbeat-scheduler/index.js";
|
|
46
|
+
import analyticsFn from "./heartbeat/analytics/index.js";
|
|
47
|
+
export const MANIFEST = [
|
|
48
|
+
{
|
|
49
|
+
id: "polyfill",
|
|
50
|
+
fn: corePolyfillFn,
|
|
51
|
+
alwaysOn: true,
|
|
52
|
+
desc: "pi API polyfills, vision model config",
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
id: "metacognition",
|
|
56
|
+
fn: metacognitionFn,
|
|
57
|
+
alwaysOn: true,
|
|
58
|
+
desc: "think, hypothesize, finalize, verify tools",
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
id: "scratchpad",
|
|
62
|
+
fn: scratchpadFn,
|
|
63
|
+
alwaysOn: true,
|
|
64
|
+
desc: "scratchpad tool",
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
id: "prompt-builder",
|
|
68
|
+
fn: corePromptBuilderFn,
|
|
69
|
+
alwaysOn: true,
|
|
70
|
+
desc: "System prompt assembly",
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
id: "agent-environment",
|
|
74
|
+
fn: coreAgentEnvFn,
|
|
75
|
+
alwaysOn: true,
|
|
76
|
+
desc: "time_status, L1 context injection",
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
id: "workspace-snapshot",
|
|
80
|
+
fn: workspaceSnapshotFn,
|
|
81
|
+
alwaysOn: true,
|
|
82
|
+
desc: "workspace_snapshot tool - capture/list/diff/restore file snapshots",
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
id: "reasoning",
|
|
86
|
+
fn: reasoningFn,
|
|
87
|
+
desc: "Reasoning quality detector (stability analysis + verify-before-done nudge)",
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
id: "topic-drift",
|
|
91
|
+
fn: topicDriftFn,
|
|
92
|
+
dependencies: ["agent-environment"],
|
|
93
|
+
desc: "check/reset topic drift tools",
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
id: "sycophancy-detector",
|
|
97
|
+
fn: sycophancyDetectorFn,
|
|
98
|
+
dependencies: ["agent-environment"],
|
|
99
|
+
desc: "Contrast-based sycophancy detection",
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
id: "turn-outcome",
|
|
103
|
+
fn: turnOutcomeFn,
|
|
104
|
+
dependencies: ["agent-environment"],
|
|
105
|
+
desc: "Turn outcome loop detection",
|
|
106
|
+
},
|
|
107
|
+
{
|
|
108
|
+
id: "mars-reflector",
|
|
109
|
+
fn: marsReflectorFn,
|
|
110
|
+
desc: "MARS principle + procedure reflection on task completion",
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
id: "enforcement",
|
|
114
|
+
fn: enforcementFn,
|
|
115
|
+
dependencies: ["agent-environment"],
|
|
116
|
+
desc: "RepE-based behavioral enforcement, turn validation",
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
id: "three-memory-stores",
|
|
120
|
+
fn: memoryStoresFn,
|
|
121
|
+
dependencies: ["agent-environment"],
|
|
122
|
+
desc: "Core memory infrastructure",
|
|
123
|
+
module: "memory",
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
id: "session-recall",
|
|
127
|
+
fn: sessionRecallFn,
|
|
128
|
+
dependencies: ["three-memory-stores"],
|
|
129
|
+
desc: "Session recall tools (session_search, session_query)",
|
|
130
|
+
module: "memory",
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
id: "context-manager",
|
|
134
|
+
fn: contextManagerFn,
|
|
135
|
+
dependencies: ["three-memory-stores"],
|
|
136
|
+
desc: "Context compaction/pruning tools",
|
|
137
|
+
module: "memory",
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
id: "context-lifecycle",
|
|
141
|
+
fn: contextLifecycleFn,
|
|
142
|
+
dependencies: ["three-memory-stores"],
|
|
143
|
+
desc: "Context proposals, signal, lifecycle",
|
|
144
|
+
module: "memory",
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
id: "memory-agent-bridge",
|
|
148
|
+
fn: memoryAgentBridgeFn,
|
|
149
|
+
dependencies: ["three-memory-stores"],
|
|
150
|
+
desc: "Agent-facing memory tools (store/recall/list/get)",
|
|
151
|
+
module: "memory",
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
id: "heartbeat-scheduler",
|
|
155
|
+
fn: heartbeatSchedulerFn,
|
|
156
|
+
dependencies: ["memory-agent-bridge"],
|
|
157
|
+
desc: "Cognitive scheduling engine",
|
|
158
|
+
module: "heartbeat",
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
id: "analytics",
|
|
162
|
+
fn: analyticsFn,
|
|
163
|
+
dependencies: ["memory-agent-bridge"],
|
|
164
|
+
desc: "Session metrics tools",
|
|
165
|
+
module: "heartbeat",
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
id: "timer",
|
|
169
|
+
fn: timerFn,
|
|
170
|
+
desc: "Timer tool",
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
id: "skills-tool",
|
|
174
|
+
fn: skillsToolFn,
|
|
175
|
+
desc: "list_skills tool — on-demand skill discovery",
|
|
176
|
+
},
|
|
177
|
+
{
|
|
178
|
+
id: "orchestrator",
|
|
179
|
+
fn: orchestratorFn,
|
|
180
|
+
desc: "orchestrate tool — multi-agent coordination (branch-per-worker, file-lock, conflict detection, merge verification)",
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
id: "auto-recovery",
|
|
184
|
+
fn: autoRecoveryFn,
|
|
185
|
+
desc: "Auto-recovery from hangs",
|
|
186
|
+
},
|
|
187
|
+
{
|
|
188
|
+
id: "latent-activator",
|
|
189
|
+
fn: latentActivatorFn,
|
|
190
|
+
desc: "Latent behavior activator",
|
|
191
|
+
},
|
|
192
|
+
// Watchdog (default-ON — liveness/stall state machine)
|
|
193
|
+
// Default-ON per TG-HEARTBEAT-WATCHDOG-DESIGN.md ("default ON, NO new env
|
|
194
|
+
// vars"); override via `broker.watchdog` in the one settings path that
|
|
195
|
+
// config.ts reads (~/.pi/agent/settings.json, or ${PI_CODING_AGENT_DIR}/
|
|
196
|
+
// settings.json when set). Not opt-in like error-tracking/health-maintenance.
|
|
197
|
+
{
|
|
198
|
+
id: "watchdog",
|
|
199
|
+
fn: watchdogFn,
|
|
200
|
+
dependencies: ["agent-environment"],
|
|
201
|
+
desc: "Session monitoring + liveness/stall watchdog (default-on)",
|
|
202
|
+
},
|
|
203
|
+
// Health Maintenance (opt-in)
|
|
204
|
+
{
|
|
205
|
+
id: "health-maintenance",
|
|
206
|
+
fn: healthMaintenanceFn,
|
|
207
|
+
disabledByDefault: true,
|
|
208
|
+
dependencies: ["agent-environment"],
|
|
209
|
+
desc: "Health-based checkpointing, degradation detection, rollback",
|
|
210
|
+
},
|
|
211
|
+
{
|
|
212
|
+
id: "context-management",
|
|
213
|
+
fn: contextManagementFn,
|
|
214
|
+
alwaysOn: true,
|
|
215
|
+
desc: "Tool profile switching via pi.setActiveTools() — a curated active set (about a dozen tools) by default",
|
|
216
|
+
},
|
|
217
|
+
// Error Tracking (opt-in)
|
|
218
|
+
{
|
|
219
|
+
id: "error-tracking",
|
|
220
|
+
fn: errorCaptureFn,
|
|
221
|
+
disabledByDefault: true,
|
|
222
|
+
dependencies: ["agent-environment"],
|
|
223
|
+
desc: "Error logging tools: error_list, error_get",
|
|
224
|
+
},
|
|
225
|
+
];
|
|
226
|
+
const _byId = new Map(MANIFEST.map((e) => [e.id, e]));
|
|
227
|
+
const _byModule = new Map();
|
|
228
|
+
for (const entry of MANIFEST) {
|
|
229
|
+
const mod = entry.module ?? entry.id.split("/")[0] ?? "other";
|
|
230
|
+
const list = _byModule.get(mod);
|
|
231
|
+
if (list)
|
|
232
|
+
list.push(entry);
|
|
233
|
+
else
|
|
234
|
+
_byModule.set(mod, [entry]);
|
|
235
|
+
}
|
|
236
|
+
export function getEntry(id) {
|
|
237
|
+
return _byId.get(id);
|
|
238
|
+
}
|
|
239
|
+
export function getModuleGroup(mod) {
|
|
240
|
+
return _byModule.get(mod) ?? [];
|
|
241
|
+
}
|
|
242
|
+
export function getModuleNames() {
|
|
243
|
+
return [...new Set(MANIFEST.map((e) => e.module ?? e.id.split("/")[0] ?? "other"))];
|
|
244
|
+
}
|
|
245
|
+
export function getDefaultEnabledIds() {
|
|
246
|
+
return MANIFEST.filter((e) => !e.disabledByDefault).map((e) => e.id);
|
|
247
|
+
}
|
|
248
|
+
export function getAlwaysOnIds() {
|
|
249
|
+
return MANIFEST.filter((e) => e.alwaysOn).map((e) => e.id);
|
|
250
|
+
}
|
|
251
|
+
//# sourceMappingURL=manifest.js.map
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Helper utilities for context-lifecycle.
|
|
3
|
+
*
|
|
4
|
+
* Stateless utility functions, testable in isolation.
|
|
5
|
+
*
|
|
6
|
+
* The `ctx` parameter is typed as `unknown` (with safe narrowing inside) because
|
|
7
|
+
* helpers are called from many different call sites: ExtensionContext from
|
|
8
|
+
* tool exec, partial ctx objects from event handlers, the writable
|
|
9
|
+
* SessionManager, etc. They all expose a duck-typed `getContextUsage()`,
|
|
10
|
+
* `sessionManager.getEntries()`, `sessionManager.getBranch()` shape - but
|
|
11
|
+
* TypeScript can't unify them statically, so we use unknown + narrowing.
|
|
12
|
+
*/
|
|
13
|
+
import type { ContextProposal, ContextSnapshot } from "./types.js";
|
|
14
|
+
/** Get current context usage as a percentage (0-100). Returns 0 on error. */
|
|
15
|
+
export declare function getContextUsage(ctx: unknown): number;
|
|
16
|
+
/** Get current context token count. Returns 0 on error. */
|
|
17
|
+
export declare function getContextTokens(ctx: unknown): number;
|
|
18
|
+
/** Get all session entries. Returns [] on error. */
|
|
19
|
+
export declare function getAllEntries(ctx: unknown): unknown[];
|
|
20
|
+
/** Get current branch entries. Returns [] on error. */
|
|
21
|
+
export declare function getBranchEntries(ctx: unknown): unknown[];
|
|
22
|
+
/**
|
|
23
|
+
* Read all context proposals from session entries. Caches them in
|
|
24
|
+
* state().proposalsByEntryId for fast lookup.
|
|
25
|
+
*/
|
|
26
|
+
export declare function readProposalsFromSession(entries: readonly unknown[]): ContextProposal[];
|
|
27
|
+
/**
|
|
28
|
+
* Read all context snapshots from session entries. Filters out
|
|
29
|
+
* expired snapshots (expires_at <= now).
|
|
30
|
+
*/
|
|
31
|
+
export declare function readSnapshotsFromSession(entries: readonly unknown[]): ContextSnapshot[];
|
|
32
|
+
/**
|
|
33
|
+
* Stable key for same-suggestion proposal dedupe ().
|
|
34
|
+
*
|
|
35
|
+
* Mirrors the reprime body-key lesson (injection-tracker.ts reprimeBodyKey): collapse whitespace AND standalone digit runs so a
|
|
36
|
+
* persisting suggestion whose numbers keep ticking ("Context at 55%" ->
|
|
37
|
+
* "Context at #%") compares equal and stays de-duplicated. The suggested
|
|
38
|
+
* tool action is folded into the key so two policies that suggest different
|
|
39
|
+
* tools never collide, even if their copy happens to overlap.
|
|
40
|
+
*
|
|
41
|
+
* Boundary-aware digit collapse: only STANDALONE numeric tokens are noise.
|
|
42
|
+
* Digits attached to a word/unit/identifier ("30K", "ref-2") are SIGNAL and
|
|
43
|
+
* stay distinct, so genuinely-different suggestions don't collide.
|
|
44
|
+
*/
|
|
45
|
+
export declare function proposalKeyFor(message: string, suggestedAction?: string): string;
|
|
46
|
+
/** Format a duration in ms as a human-readable string. */
|
|
47
|
+
export declare function formatDuration(ms: number): string;
|
|
48
|
+
/**
|
|
49
|
+
* Interpolate template placeholders in a message:
|
|
50
|
+
* - {percent} -> current context usage %
|
|
51
|
+
* - {tokens} -> current context tokens (in K)
|
|
52
|
+
* - {<key>} -> arbitrary signal data field
|
|
53
|
+
*/
|
|
54
|
+
export declare function interpolateMessage(message: string, ctx: unknown, signalData?: Record<string, unknown>): string;
|
|
55
|
+
//# sourceMappingURL=helpers.d.ts.map
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Helper utilities for context-lifecycle.
|
|
3
|
+
*
|
|
4
|
+
* Stateless utility functions, testable in isolation.
|
|
5
|
+
*
|
|
6
|
+
* The `ctx` parameter is typed as `unknown` (with safe narrowing inside) because
|
|
7
|
+
* helpers are called from many different call sites: ExtensionContext from
|
|
8
|
+
* tool exec, partial ctx objects from event handlers, the writable
|
|
9
|
+
* SessionManager, etc. They all expose a duck-typed `getContextUsage()`,
|
|
10
|
+
* `sessionManager.getEntries()`, `sessionManager.getBranch()` shape - but
|
|
11
|
+
* TypeScript can't unify them statically, so we use unknown + narrowing.
|
|
12
|
+
*/
|
|
13
|
+
import { isProposalEntry, isSnapshotEntry } from "./types.js";
|
|
14
|
+
import { state } from "./state.js";
|
|
15
|
+
import { hashForDedup } from "../../../lib/utils/dedup.js";
|
|
16
|
+
import { formatTokensK } from "../../../lib/detection/context-usage.js";
|
|
17
|
+
import { getContextUsage as extractContextUsage } from "../../../lib/detection/context-tiers.js";
|
|
18
|
+
/** Get current context usage as a percentage (0-100). Returns 0 on error. */
|
|
19
|
+
export function getContextUsage(ctx) {
|
|
20
|
+
try {
|
|
21
|
+
return extractContextUsage(ctx)?.percent ?? 0;
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return 0;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
/** Get current context token count. Returns 0 on error. */
|
|
28
|
+
export function getContextTokens(ctx) {
|
|
29
|
+
try {
|
|
30
|
+
return extractContextUsage(ctx)?.tokens ?? 0;
|
|
31
|
+
}
|
|
32
|
+
catch {
|
|
33
|
+
return 0;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/** Get all session entries. Returns [] on error. */
|
|
37
|
+
export function getAllEntries(ctx) {
|
|
38
|
+
try {
|
|
39
|
+
const c = ctx;
|
|
40
|
+
return c.sessionManager?.getEntries?.() ?? [];
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
return [];
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
/** Get current branch entries. Returns [] on error. */
|
|
47
|
+
export function getBranchEntries(ctx) {
|
|
48
|
+
try {
|
|
49
|
+
const c = ctx;
|
|
50
|
+
return c.sessionManager?.getBranch?.() ?? [];
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return [];
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
// Entry readers (scan session entries for proposals/snapshots)
|
|
57
|
+
/**
|
|
58
|
+
* Read all context proposals from session entries. Caches them in
|
|
59
|
+
* state().proposalsByEntryId for fast lookup.
|
|
60
|
+
*/
|
|
61
|
+
export function readProposalsFromSession(entries) {
|
|
62
|
+
const proposals = [];
|
|
63
|
+
for (const raw of entries) {
|
|
64
|
+
if (isProposalEntry(raw)) {
|
|
65
|
+
const entry = raw;
|
|
66
|
+
// Use details (set via appendCustomMessageEntry's 4th param)
|
|
67
|
+
const data = entry.details;
|
|
68
|
+
if (data && data.id && data.created_at !== undefined) {
|
|
69
|
+
proposals.push(data);
|
|
70
|
+
state().proposalsByEntryId.set(entry.id, data);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return proposals;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Read all context snapshots from session entries. Filters out
|
|
78
|
+
* expired snapshots (expires_at <= now).
|
|
79
|
+
*/
|
|
80
|
+
export function readSnapshotsFromSession(entries) {
|
|
81
|
+
const now = Date.now();
|
|
82
|
+
const snapshots = [];
|
|
83
|
+
for (const raw of entries) {
|
|
84
|
+
if (isSnapshotEntry(raw)) {
|
|
85
|
+
// custom entries carry their payload in .data
|
|
86
|
+
const e = raw;
|
|
87
|
+
const data = e.data;
|
|
88
|
+
if (data && data.id && data.expires_at > now) {
|
|
89
|
+
snapshots.push(data);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return snapshots;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Stable key for same-suggestion proposal dedupe ().
|
|
97
|
+
*
|
|
98
|
+
* Mirrors the reprime body-key lesson (injection-tracker.ts reprimeBodyKey): collapse whitespace AND standalone digit runs so a
|
|
99
|
+
* persisting suggestion whose numbers keep ticking ("Context at 55%" ->
|
|
100
|
+
* "Context at #%") compares equal and stays de-duplicated. The suggested
|
|
101
|
+
* tool action is folded into the key so two policies that suggest different
|
|
102
|
+
* tools never collide, even if their copy happens to overlap.
|
|
103
|
+
*
|
|
104
|
+
* Boundary-aware digit collapse: only STANDALONE numeric tokens are noise.
|
|
105
|
+
* Digits attached to a word/unit/identifier ("30K", "ref-2") are SIGNAL and
|
|
106
|
+
* stay distinct, so genuinely-different suggestions don't collide.
|
|
107
|
+
*/
|
|
108
|
+
export function proposalKeyFor(message, suggestedAction) {
|
|
109
|
+
const body = message
|
|
110
|
+
.trim()
|
|
111
|
+
.replace(/\s+/g, " ")
|
|
112
|
+
.replace(/(?<![\w-])\d+(?:\.\d+)?(?!\w)/g, "#");
|
|
113
|
+
return hashForDedup(`${suggestedAction ?? ""}\u0000${body}`);
|
|
114
|
+
}
|
|
115
|
+
/** Format a duration in ms as a human-readable string. */
|
|
116
|
+
export function formatDuration(ms) {
|
|
117
|
+
if (ms < 1000)
|
|
118
|
+
return `${ms}ms`;
|
|
119
|
+
if (ms < 60000)
|
|
120
|
+
return `${(ms / 1000).toFixed(0)}s`;
|
|
121
|
+
return `${(ms / 60000).toFixed(0)}m`;
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Interpolate template placeholders in a message:
|
|
125
|
+
* - {percent} -> current context usage %
|
|
126
|
+
* - {tokens} -> current context tokens (in K)
|
|
127
|
+
* - {<key>} -> arbitrary signal data field
|
|
128
|
+
*/
|
|
129
|
+
export function interpolateMessage(message, ctx, signalData) {
|
|
130
|
+
const usage = getContextUsage(ctx);
|
|
131
|
+
const tokens = getContextTokens(ctx);
|
|
132
|
+
let result = message.replace("{percent}", `${usage.toFixed(0)}%`);
|
|
133
|
+
result = result.replace("{tokens}", formatTokensK(tokens));
|
|
134
|
+
// Interpolate signal data fields (e.g., {noise}, {signal}, {count}, {density}, {token_ratio})
|
|
135
|
+
if (signalData) {
|
|
136
|
+
for (const [key, value] of Object.entries(signalData)) {
|
|
137
|
+
result = result.replaceAll(`{${key}}`, String(value ?? ""));
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
return result;
|
|
141
|
+
}
|
|
142
|
+
//# sourceMappingURL=helpers.js.map
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Lifecycle Extension - S-MMU Active Context Management
|
|
3
|
+
*
|
|
4
|
+
* AUTOMATION layer that works WITH context-manager.
|
|
5
|
+
* NO new tools - uses existing context_navigate, context_compress, etc.
|
|
6
|
+
*
|
|
7
|
+
* R-CCAM-inspired loop:
|
|
8
|
+
* - Retrieval: Signal detection from session content
|
|
9
|
+
* - Cognition: Policy evaluation with governance
|
|
10
|
+
* - Control: Action selection with constraint checking
|
|
11
|
+
* - Action: Proposal injection or immediate execution
|
|
12
|
+
* - Memory: CustomEntry persistence with outcome tracking
|
|
13
|
+
*/
|
|
14
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
15
|
+
export { getContextUsage, getContextTokens, getAllEntries, getBranchEntries, readProposalsFromSession, readSnapshotsFromSession, formatDuration, interpolateMessage, proposalKeyFor, } from "./helpers.js";
|
|
16
|
+
export default function contextLifecycleExtension(pi: ExtensionAPI): void;
|
|
17
|
+
//# sourceMappingURL=index.d.ts.map
|