pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: voice-replies
|
|
3
|
+
description: "Reply to Telegram voice messages with synthesized speech: edge-tts (RU/EN/HE voices) → ffmpeg ogg/opus → Bot API sendVoice, matching the incoming message's language. Use when a voice message arrived and the reply should be a voice note in the same language, or when asked to send a Telegram voice reply. Triggers: voice reply, voice message, sendVoice, TTS, text-to-speech, edge-tts, Telegram audio reply. Includes offline fallbacks (piper, macOS say)."
|
|
4
|
+
trigger: "voice replies, voice message reply, sendVoice, TTS, text-to-speech, edge-tts, piper, Telegram audio reply, responding in voice"
|
|
5
|
+
validated: 2026-09-09
|
|
6
|
+
verdict: UNVALIDATED
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Voice Replies
|
|
10
|
+
|
|
11
|
+
Send Telegram VOICE replies (ogg/opus) synthesized with edge-tts. The full pipeline:
|
|
12
|
+
edge-tts (TTS) → ffmpeg (ogg/opus convert) → Bot API `sendVoice`.
|
|
13
|
+
|
|
14
|
+
## Modality Rule
|
|
15
|
+
|
|
16
|
+
Reply in the same modality **and language** as received:
|
|
17
|
+
voice message in → voice reply in the same language. Text received → text reply.
|
|
18
|
+
RU voiced in → Dmitry (RU). EN voiced in → Guy (EN). HE voiced in → Avri (HE).
|
|
19
|
+
|
|
20
|
+
## Install
|
|
21
|
+
|
|
22
|
+
Primary: `uvx edge-tts` (ephemeral, zero install) - OR a persistent venv you
|
|
23
|
+
created yourself (e.g. `python -m venv .venv && .venv/bin/pip install edge-tts`),
|
|
24
|
+
located by setting `$EDGE_TTS_PY` to the venv's python executable. Use the venv
|
|
25
|
+
for repeated runs to skip the per-run uvx download.
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
uvx edge-tts --list-voices # uvx default (no venv needed)
|
|
29
|
+
$EDGE_TTS_PY -m edge_tts --list-voices # sanity: persistent venv works
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Version floor (2026-10-09): use the latest `edge-tts` from uvx (7.2.8 at the
|
|
33
|
+
time) - old pins break (6.1.12 dies with `WSServerHandshakeError 403` after an
|
|
34
|
+
upstream Microsoft auth change), so pin nothing. `NoAudioReceived` is
|
|
35
|
+
intermittent - three occurrences on 2026-10-09 alternated fail/ok, and retries
|
|
36
|
+
succeeded - so retry the synthesize step 2-3 times before calling it a failure.
|
|
37
|
+
|
|
38
|
+
## Synthesize
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
uvx edge-tts -v <voice> --file <text.txt> --write-media out.mp3
|
|
42
|
+
# or with a persistent venv set in $EDGE_TTS_PY:
|
|
43
|
+
$EDGE_TTS_PY -m edge_tts --voice <voice> --file <text.txt> --write-media out.mp3
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Owner default rate: add `--rate=+20%` (2026-10-09).
|
|
47
|
+
|
|
48
|
+
Proven voices:
|
|
49
|
+
|
|
50
|
+
| Lang | Voice | Note |
|
|
51
|
+
| ---- | -------------------- | ------------- |
|
|
52
|
+
| RU | `ru-RU-DmitryNeural` | male, primary |
|
|
53
|
+
| EN | `en-US-GuyNeural` | male, primary |
|
|
54
|
+
| HE | `he-IL-AvriNeural` | male, primary |
|
|
55
|
+
|
|
56
|
+
## Convert to OGG/Opus
|
|
57
|
+
|
|
58
|
+
Telegram `sendVoice` requires ogg/opus. Convert with ffmpeg:
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
ffmpeg -y -v error -i out.mp3 -c:a libopus -b:a 40k -ar 48000 -ac 1 out.ogg
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Send
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendVoice" \
|
|
68
|
+
-F "chat_id=$TELEGRAM_CHAT_ID" \
|
|
69
|
+
-F "voice=@out.ogg" \
|
|
70
|
+
-F "duration=NN"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
- Env names: `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID`.
|
|
74
|
+
- NO `parse_mode` on voice (sendVoice has none).
|
|
75
|
+
|
|
76
|
+
## In-code path (telegram_send voice:true)
|
|
77
|
+
|
|
78
|
+
`telegram_send voice:true` runs this pipeline in-process. Source config:
|
|
79
|
+
`braid.telegram.tts` in `~/.pi/agent/settings.json` (default `edge-tts`, rate
|
|
80
|
+
`+20%`, voices above; an absent block means edge-tts). `source` values:
|
|
81
|
+
`edge-tts` (default), `edge-tts+say` (say only after the edge attempts are
|
|
82
|
+
exhausted), `say`, `none` (disable - `voice:true` then refuses with a clear
|
|
83
|
+
error, never text). Seams: `packages/telegram/src/lib/tts.ts`
|
|
84
|
+
(`populateVoiceTts`) wired at `packages/telegram/src/index.ts`; send at
|
|
85
|
+
`packages/telegram/src/lib/tool-logic.ts`. The in-code conversion uses
|
|
86
|
+
`-b:a 48k`; the manual 40k recipe above is equally valid for Telegram.
|
|
87
|
+
|
|
88
|
+
## Sanity / Verify
|
|
89
|
+
|
|
90
|
+
```
|
|
91
|
+
file out.ogg # Ogg data, Opus audio
|
|
92
|
+
uvx edge-tts --list-voices | grep -i <lang> # voice exists
|
|
93
|
+
# or: $EDGE_TTS_PY -m edge_tts --list-voices | grep -i <lang>
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Offline Alternatives (lower priority)
|
|
97
|
+
|
|
98
|
+
edge-tts is the primary zero-key path for RU/EN/HE. Offline fallbacks:
|
|
99
|
+
|
|
100
|
+
**piper** (offline, RU only):
|
|
101
|
+
|
|
102
|
+
```
|
|
103
|
+
uv tool install piper-tts
|
|
104
|
+
# ru_RU-dmitri-medium voice at ~/.local/share/piper/voices/ru/ (onnx+json, 22050Hz espeak)
|
|
105
|
+
echo "<text>" | piper --model <ru-model.onnx> --output_file out.wav
|
|
106
|
+
ffmpeg -y -v error -i out.wav -c:a libopus -b:a 40k -ar 48000 -ac 1 out.ogg
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
**macOS say** (any installed voice, no extra install):
|
|
110
|
+
|
|
111
|
+
```
|
|
112
|
+
say -v Milena -o out.aiff "<text>" # Milena = ru-female
|
|
113
|
+
ffmpeg -y -v error -i out.aiff -c:a libopus -b:a 40k -ar 48000 -ac 1 out.ogg
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
In code, `say` is emergency-only (the owner dislikes its quality) and stays
|
|
117
|
+
behind an explicit config choice (`source: "say"` or `"edge-tts+say"`).
|
|
118
|
+
|
|
119
|
+
## Dependency Note
|
|
120
|
+
|
|
121
|
+
edge-tts and piper live in this skill (procedure), not in code - third-party deps
|
|
122
|
+
live as documented install+usage skills, like the orchestration pipeline skill.
|
|
123
|
+
`ripgrep` (probed by session-recall/search) and `find`/`head`
|
|
124
|
+
(memory-agent-bridge/explore-paths) are standard POSIX/rg - no skill
|
|
125
|
+
needed.
|
package/src/AGENTS.md
ADDED
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/ - Top-Level Architecture
|
|
4
|
+
|
|
5
|
+
The pi-braid codebase is organized into four top-level directories, each
|
|
6
|
+
with a distinct role.
|
|
7
|
+
|
|
8
|
+
## The four-way split
|
|
9
|
+
|
|
10
|
+
| Directory | Role | What's inside |
|
|
11
|
+
| ------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
|
|
12
|
+
| `extensions/` | Extension modules (loaded by the manifest) | One subdir per extension, each with `index.ts` exporting a default factory. |
|
|
13
|
+
| `lib/` | Library code (imported by extensions) | Pure utilities, state, types, event infrastructure. NOT loaded as extensions. |
|
|
14
|
+
| `loader/` | Extension loader and subagent API | The flat-extension loader. Reads `BRAID_MODULES` / `settings.json` / runtime overrides, invokes each factory. |
|
|
15
|
+
| `types/` | Ambient `.d.ts` declarations | Type augmentations for the `ExtensionContext` interface. Listed in `tsconfig.json` `typeRoots`. |
|
|
16
|
+
|
|
17
|
+
## The contract between `extensions/` and `lib/`
|
|
18
|
+
|
|
19
|
+
- **`extensions/`** contains code that gets loaded by the manifest and registered with pi core as an extension. Each subdir's `index.ts` exports a default function `(pi: ExtensionAPI) => void | Promise<void>`.
|
|
20
|
+
- **`lib/`** contains code that gets imported by extensions. It is never directly loaded by the manifest.
|
|
21
|
+
- **`extensions/` can import from `lib/`.** `lib/` MUST NOT import from `extensions/`. (Exceptions noted where unavoidable.)
|
|
22
|
+
- If a module needs to be both, put it in `lib/` and have the extension import it.
|
|
23
|
+
|
|
24
|
+
## Why a flat `extensions/` tree?
|
|
25
|
+
|
|
26
|
+
Each extension is one subdir of `extensions/`. There is no nested grouping
|
|
27
|
+
in the directory tree (e.g., no `extensions/ai/`, `extensions/utilities/`).
|
|
28
|
+
Grouping happens at the manifest level via the `module` tag on each entry.
|
|
29
|
+
The flat tree keeps the layout predictable and makes `find src/extensions/...` reliable.
|
|
30
|
+
|
|
31
|
+
## Sub-extensions
|
|
32
|
+
|
|
33
|
+
Some extensions are large enough to have their own sub-structure:
|
|
34
|
+
|
|
35
|
+
- `extensions/memory/` - 7 sub-extensions (context-lifecycle, context-manager, memory-agent-bridge, scratchpad, session-recall, three-memory-stores, workspace-snapshot)
|
|
36
|
+
- `extensions/cognitive/` - 6 sub-extensions (metacognition, reasoning, sycophancy-detector, tool-safety, topic-drift, turn-outcome)
|
|
37
|
+
- `extensions/core/` - 4 sub-extensions (polyfill, agent-environment, prompt-builder, skills-tool)
|
|
38
|
+
- `extensions/self/` - 5 sub-extensions (health-maintenance, error-tracking, watchdog, auto-recovery, latent-activator)
|
|
39
|
+
- `extensions/scheduling/` - 1 sub-extension (timer)
|
|
40
|
+
- `extensions/heartbeat/` - 2 sub-extensions (heartbeat-scheduler, analytics)
|
|
41
|
+
- `extensions/enforcement/` - 1 root + 3 private sub-dirs (detection, handlers, substate)
|
|
42
|
+
|
|
43
|
+
A sub-extension follows the same pattern: a subdir with `index.ts`.
|
|
44
|
+
|
|
45
|
+
## See also
|
|
46
|
+
|
|
47
|
+
- `extensions/AGENTS.md` - not present; each extension subdir has its own AGENTS.md
|
|
48
|
+
- `lib/AGENTS.md` - index of all `lib/` subdirs
|
|
49
|
+
- `../AGENTS.md` (root) - build, test, extension loading
|
|
50
|
+
|
|
51
|
+
## The "What does NOT belong here" pattern
|
|
52
|
+
|
|
53
|
+
Every `extensions/<name>/AGENTS.md` should contain a `### What does NOT belong here`
|
|
54
|
+
section that explicitly enumerates the things that other AGENTS.md or sibling
|
|
55
|
+
extension directories are responsible for. This prevents:
|
|
56
|
+
|
|
57
|
+
- Code that belongs to extension A drifting into extension B.
|
|
58
|
+
- Tool-name coupling (e.g., enforcement knowing the name of a tool registered
|
|
59
|
+
by context-manager).
|
|
60
|
+
- New contributors putting logic in the first folder they find that imports
|
|
61
|
+
the right lib module.
|
|
62
|
+
|
|
63
|
+
The first `AGENTS.md` to use this pattern was `core/prompt-builder/AGENTS.md`.
|
|
64
|
+
The convention is:
|
|
65
|
+
|
|
66
|
+
> If the same paragraph could be written in two siblings' AGENTS.md, write
|
|
67
|
+
> it once in the parent (`extensions/<category>/AGENTS.md`) or the top-level
|
|
68
|
+
> `src/AGENTS.md` and link to it from each child.
|
|
69
|
+
|
|
70
|
+
A `### What does NOT belong here` section should answer four questions:
|
|
71
|
+
|
|
72
|
+
1. What do sibling extensions own that I should NOT touch?
|
|
73
|
+
2. What does `lib/` own that I should NOT re-implement?
|
|
74
|
+
3. What tools / events / types do other extensions publish that I consume?
|
|
75
|
+
4. What is the canonical pattern for something I want to do that has
|
|
76
|
+
already been done in another extension?
|
|
77
|
+
|
|
78
|
+
## Top-level extension layout (agent-loop model)
|
|
79
|
+
|
|
80
|
+
Each category corresponds to a phase of the agent's processing loop or
|
|
81
|
+
a cross-cutting concern:
|
|
82
|
+
|
|
83
|
+
| Directory | Loop phase | Sub-extensions |
|
|
84
|
+
| -------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
85
|
+
| `core/` | Input/Output (what LLM sees) | polyfill, agent-environment, prompt-builder, skills-tool |
|
|
86
|
+
| `cognitive/` | Thinking (reasoning + detection) | metacognition, reasoning, sycophancy-detector, tool-safety, topic-drift, turn-outcome |
|
|
87
|
+
| `memory/` | Remembering (all persistent state) | three-memory-stores, memory-agent-bridge, session-recall, context-manager, context-lifecycle, scratchpad, workspace-snapshot |
|
|
88
|
+
| `scheduling/` | When to act (time triggers) | timer |
|
|
89
|
+
| `self/` | Self-management (state, health, modes) | health-maintenance, error-tracking, watchdog, auto-recovery, latent-activator |
|
|
90
|
+
| `heartbeat/` | Background proactive | heartbeat-scheduler, analytics |
|
|
91
|
+
| `enforcement/` | Turn pipeline infrastructure | (1 root + detection/handlers/substate) |
|
|
92
|
+
|
|
93
|
+
## Delivery channel rules
|
|
94
|
+
|
|
95
|
+
There are two audiences. Pick the channel that matches:
|
|
96
|
+
|
|
97
|
+
| Audience | Sees | Channels |
|
|
98
|
+
| ------------------------------------ | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
99
|
+
| **User** (the human in the TUI) | TUI notifications, persistent UI, in-memory log buffer (via `/logs`) | `ctx.ui.notify`, `ctx.ui.setStatus`, `ctx.ui.setWidget`, `log.*` (routes to `ctx.ui.notify` when ctx is bound) |
|
|
100
|
+
| **Agent** (the LLM in its next turn) | Injected messages, exactly as if the system said them | `sendTrackedMessage` -- the **only** path |
|
|
101
|
+
|
|
102
|
+
Rules:
|
|
103
|
+
|
|
104
|
+
1. **`ctx.ui.notify(msg, severity)`** -- use for user-facing notifications tied to user-initiated actions (tool result confirmations). Severity: `info` / `warning` / `error`. Appears as a TUI notification. **This is the correct native API for user-facing messages.**
|
|
105
|
+
2. **`ctx.ui.setStatus(key, text)` / `ctx.ui.setWidget(key, lines)`** -- use for persistent state the user should see across renders. Footer indicator, content above/below editor. For ongoing operations ("compaction in progress", "X nudges suppressed").
|
|
106
|
+
3. **`log.*` (createLogger)** -- the abstraction handles routing. When a session ctx is bound (via `setLoggerContext` from `src/index.ts` on session_start), log lines route to `ctx.ui.notify`. When unbound (lib/ code, pre-session-start), they go to the in-memory buffer (retrievable via `/logs`). The TUI is never corrupted. **The 206 existing call sites need no changes** -- the abstraction routes transparently. Do not put "consider X" / "you should Y" advice here -- the agent cannot read scrollback.
|
|
107
|
+
4. **`console.*`** -- **suppressed by default** in third-party extensions. Will corrupt TUI rendering. Use only via `/logs level <X>` for explicit debug sessions.
|
|
108
|
+
5. **`sendTrackedMessage(pi, params, options, meta, bypass?)`** -- the **only** path for messages the agent will read on its next turn. Non-waking sends declare `delivery: "live" | "park"` (live steers the running loop; park records for the end-of-turn flush) - see the delivery contract in `lib/utils/injection-tracker.ts`. Set `bypassFloodCap: true` ONLY for correctness-critical wake-ups (timer fires, post-compaction resume, overflow recovery exhausted).
|
|
109
|
+
6. **Never** call `pi.sendMessage(...)` directly outside `src/lib/utils/injection-tracker.ts`.
|
|
110
|
+
|
|
111
|
+
Common anti-pattern: putting actionable advice in `log.warn`. The agent cannot see scrollback. If the message contains "consider X" or names a tool the agent can call, it belongs in `sendTrackedMessage`.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
|
|
3
|
+
# src/extensions/cognitive/ - Cognitive Analysis & Reasoning
|
|
4
|
+
|
|
5
|
+
The `cognitive` group contains the agent's reasoning tools and the detectors
|
|
6
|
+
that produce signals for the enforcement layer. All extensions here analyze
|
|
7
|
+
either the agent's own behavior or its outputs.
|
|
8
|
+
|
|
9
|
+
## Sub-extensions
|
|
10
|
+
|
|
11
|
+
| Path | Role | Purpose |
|
|
12
|
+
| ---------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
13
|
+
| `metacognition/` | tools | `think`, `hypothesize`, `verify`, `finalize`, `verify_claim` for structured reasoning. |
|
|
14
|
+
| `topic-drift/` | detector + tool | Detects when the agent drifts from the original task. Exposes `topic_drift` (action=check\|reset) for direct agent use. |
|
|
15
|
+
| `reasoning/` | detector | Runs `measureStability()` on assistant responses; emits `reasoning/unstable` signals on the belief bus. |
|
|
16
|
+
| `sycophancy-detector/` | detector | Detects when the agent is agreeing with the user just to be agreeable. |
|
|
17
|
+
| `turn-outcome/` | detector | Classifies the outcome of each turn (success/partial/failure/loop). |
|
|
18
|
+
| `mars-reflector/` | utility | MARS principle+procedure reflection on task completion. Utility consumed by enforcement/mars-handler. Moved from lib/reasoning/ (July 29). |
|
|
19
|
+
| `tool-safety/` | gate | Allow-list/deny-list for dangerous tool operations (file mutations, etc). |
|
|
20
|
+
|
|
21
|
+
> **Note:** `metacognition/` was moved here from `core/` so the entire
|
|
22
|
+
> reasoning family (think, hypothesize, verify, finalize, verify_claim)
|
|
23
|
+
> lives in one place.
|
|
24
|
+
|
|
25
|
+
## Local Contracts
|
|
26
|
+
|
|
27
|
+
- Detectors are **read-only** - they analyze events, they don't mutate state.
|
|
28
|
+
- Detectors are **stateless across turns** - they read state from `getExtensionState(ctx, ...)`.
|
|
29
|
+
- See `extensions/enforcement/handlers/analysis/` for how detectors are wired into the turn pipeline.
|
|
@@ -0,0 +1,415 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MARS (Memory-Augmented Reflection) — principle + procedure reflection.
|
|
3
|
+
*
|
|
4
|
+
* Based on MARS (2601.11974) which introduces two reflection types:
|
|
5
|
+
* 1. Principle reflection: After task completion, extract general rules
|
|
6
|
+
* ("what should I follow to avoid errors?") → store as heuristics.
|
|
7
|
+
* 2. Procedure reflection: After successful task, extract steps that
|
|
8
|
+
* led to success → store as episodic memory.
|
|
9
|
+
*
|
|
10
|
+
* Triggers: on task completion (finalize called with completed=true, or
|
|
11
|
+
* significant work done without finalize). Not every turn — the MARS
|
|
12
|
+
* paper fires reflection only at episode boundaries. The statistical
|
|
13
|
+
* tool-usage analyzer lives in `tool-usage-analyzer.ts`.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
17
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
18
|
+
import { getMemoryState } from "../../heartbeat/heartbeat-scheduler/state.js";
|
|
19
|
+
import { addPrinciple, addEpisode } from "../../memory/three-memory-stores/index.js";
|
|
20
|
+
import { deriveProjectIdFromCwd } from "../../../lib/memory/past-insights.js";
|
|
21
|
+
import { describeWriteDecision, selectRecentEpisodes } from "../../../lib/memory/write-quality.js";
|
|
22
|
+
import { applyWriteGateLogged } from "../../../lib/memory/write-log.js";
|
|
23
|
+
import { getMemoryWriteGateConfig } from "../../../lib/config/braid-settings.js";
|
|
24
|
+
|
|
25
|
+
/** Derive a short project id from the current working directory. */
|
|
26
|
+
function deriveProject(ctx: ExtensionContext): string {
|
|
27
|
+
return typeof ctx.cwd === "string" ? deriveProjectIdFromCwd(ctx.cwd) : "unknown";
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
const log = createLogger("mars");
|
|
31
|
+
|
|
32
|
+
/** A single reflection produced by MARS. */
|
|
33
|
+
export interface MARSReflection {
|
|
34
|
+
/** Principle (heuristic rule) or procedure (episodic steps). */
|
|
35
|
+
type: "principle" | "procedure";
|
|
36
|
+
/** The reflection content — the principle rule or procedure steps. */
|
|
37
|
+
content: string;
|
|
38
|
+
/** Model confidence (0-1) based on pattern strength. */
|
|
39
|
+
confidence: number;
|
|
40
|
+
/** Context summary for the task that triggered this reflection. */
|
|
41
|
+
taskContext: string;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Session data snapshot for the reflection to analyze. */
|
|
45
|
+
export interface SessionSnapshot {
|
|
46
|
+
toolsUsed: string[];
|
|
47
|
+
uniqueToolCount: number;
|
|
48
|
+
totalToolCalls: number;
|
|
49
|
+
errorCount: number;
|
|
50
|
+
thinkCalls: number;
|
|
51
|
+
scratchpadCalls: number;
|
|
52
|
+
verifyCalls: number;
|
|
53
|
+
editCalls: number;
|
|
54
|
+
writeCalls: number;
|
|
55
|
+
finalizeCalled: boolean;
|
|
56
|
+
turnCount: number;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** Minimum tool calls before reflection is meaningful. */
|
|
60
|
+
const MIN_TOOL_CALLS_FOR_REFLECTION = 5;
|
|
61
|
+
|
|
62
|
+
/** Minimum session turns before reflection fires. */
|
|
63
|
+
const MIN_TURNS_FOR_REFLECTION = 3;
|
|
64
|
+
|
|
65
|
+
/** Confidence boost for a strong pattern (multiple data points). */
|
|
66
|
+
const STRONG_PATTERN_CONFIDENCE = 0.85;
|
|
67
|
+
|
|
68
|
+
/** Moderate pattern confidence. */
|
|
69
|
+
const MODERATE_PATTERN_CONFIDENCE = 0.6;
|
|
70
|
+
|
|
71
|
+
/** Weak pattern confidence. */
|
|
72
|
+
const WEAK_PATTERN_CONFIDENCE = 0.4;
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Analyze the session snapshot and produce principle reflections.
|
|
76
|
+
* Principle reflections are general rules extracted from failure/success
|
|
77
|
+
* patterns: "After editing, always verify" or "Use think before edits."
|
|
78
|
+
*
|
|
79
|
+
* @param ctx - Extension context
|
|
80
|
+
* @param session - Session snapshot at task completion
|
|
81
|
+
* @returns Array of principle reflections
|
|
82
|
+
*/
|
|
83
|
+
export function reflectPrinciples(
|
|
84
|
+
ctx: ExtensionContext,
|
|
85
|
+
session: SessionSnapshot,
|
|
86
|
+
): MARSReflection[] {
|
|
87
|
+
const principles: MARSReflection[] = [];
|
|
88
|
+
const taskContext = buildTaskContext(session);
|
|
89
|
+
|
|
90
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION) return principles;
|
|
91
|
+
|
|
92
|
+
// Pattern: edits without prior think
|
|
93
|
+
if (session.editCalls > 0 && session.thinkCalls === 0) {
|
|
94
|
+
principles.push({
|
|
95
|
+
type: "principle",
|
|
96
|
+
content:
|
|
97
|
+
"Before editing files, call think(observation, decision, reason) to validate your reasoning first. Editing without thinking is the most common source of wasted turns.",
|
|
98
|
+
confidence: session.editCalls > 3 ? STRONG_PATTERN_CONFIDENCE : MODERATE_PATTERN_CONFIDENCE,
|
|
99
|
+
taskContext,
|
|
100
|
+
});
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// Pattern: edits without verification
|
|
104
|
+
if (session.editCalls + session.writeCalls > 0 && session.verifyCalls === 0) {
|
|
105
|
+
principles.push({
|
|
106
|
+
type: "principle",
|
|
107
|
+
content:
|
|
108
|
+
'After changing code, run verify(target="code", criteria=["...", "..."]) before moving on. Verification catches errors that rereading would miss.',
|
|
109
|
+
confidence:
|
|
110
|
+
session.editCalls + session.writeCalls > 3
|
|
111
|
+
? STRONG_PATTERN_CONFIDENCE
|
|
112
|
+
: MODERATE_PATTERN_CONFIDENCE,
|
|
113
|
+
taskContext,
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// Pattern: work without scratchpad
|
|
118
|
+
if (session.totalToolCalls > 5 && session.scratchpadCalls === 0) {
|
|
119
|
+
principles.push({
|
|
120
|
+
type: "principle",
|
|
121
|
+
content:
|
|
122
|
+
'Before starting work, set a goal with scratchpad(action="set_goal", text="...") and break it into steps with scratchpad(action="add_plan", text="..."). A clear plan prevents drift and enables session resumption.',
|
|
123
|
+
confidence: session.totalToolCalls > 10 ? STRONG_PATTERN_CONFIDENCE : WEAK_PATTERN_CONFIDENCE,
|
|
124
|
+
taskContext,
|
|
125
|
+
});
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
// Pattern: high error rate
|
|
129
|
+
if (session.errorCount > 0 && session.totalToolCalls > 0) {
|
|
130
|
+
const errorRate = session.errorCount / session.totalToolCalls;
|
|
131
|
+
if (errorRate > 0.3) {
|
|
132
|
+
principles.push({
|
|
133
|
+
type: "principle",
|
|
134
|
+
content:
|
|
135
|
+
'When tool errors recur, step back and think(type="reflection") to identify the root cause. The tools work reliably — the failure is almost always an agent mistake: wrong arguments, stale content, or incorrect indentation.',
|
|
136
|
+
confidence: errorRate > 0.5 ? STRONG_PATTERN_CONFIDENCE : MODERATE_PATTERN_CONFIDENCE,
|
|
137
|
+
taskContext,
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// Pattern: narrow tool diversity (over-reliance on a single tool category)
|
|
143
|
+
if (session.uniqueToolCount <= 3 && session.totalToolCalls >= 8) {
|
|
144
|
+
principles.push({
|
|
145
|
+
type: "principle",
|
|
146
|
+
content: `Used only ${session.uniqueToolCount} unique tools across ${session.totalToolCalls} calls. Consider a broader approach: grep/find for code search, read for context, think for reasoning — each tool serves a different purpose.`,
|
|
147
|
+
confidence: MODERATE_PATTERN_CONFIDENCE,
|
|
148
|
+
taskContext,
|
|
149
|
+
});
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
return principles;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
/**
|
|
156
|
+
* Analyze the session snapshot and produce procedure reflections.
|
|
157
|
+
* Procedure reflections capture the concrete steps that led to success,
|
|
158
|
+
* stored as episodic memory for cross-session retrieval.
|
|
159
|
+
*
|
|
160
|
+
* @param ctx - Extension context
|
|
161
|
+
* @param session - Session snapshot at task completion
|
|
162
|
+
* @returns Array of procedure reflections
|
|
163
|
+
*/
|
|
164
|
+
export function reflectProcedures(
|
|
165
|
+
ctx: ExtensionContext,
|
|
166
|
+
session: SessionSnapshot,
|
|
167
|
+
): MARSReflection[] {
|
|
168
|
+
const procedures: MARSReflection[] = [];
|
|
169
|
+
const taskContext = buildTaskContext(session);
|
|
170
|
+
|
|
171
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION) return procedures;
|
|
172
|
+
|
|
173
|
+
// Classify task type based on tool distribution
|
|
174
|
+
const taskType = classifyTaskType(session);
|
|
175
|
+
|
|
176
|
+
const procedureSteps = buildProcedureDescription(session, taskType);
|
|
177
|
+
if (procedureSteps) {
|
|
178
|
+
procedures.push({
|
|
179
|
+
type: "procedure",
|
|
180
|
+
content: procedureSteps,
|
|
181
|
+
confidence: session.finalizeCalled ? MODERATE_PATTERN_CONFIDENCE : WEAK_PATTERN_CONFIDENCE,
|
|
182
|
+
taskContext,
|
|
183
|
+
});
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
return procedures;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* Full reflection pass — runs both principle and procedure reflection
|
|
191
|
+
* and stores the results to heuristics/episodic memory. This is the
|
|
192
|
+
* main entry point for the mars-handler.
|
|
193
|
+
*
|
|
194
|
+
* @param ctx - Extension context
|
|
195
|
+
* @param session - Session snapshot at task completion
|
|
196
|
+
* @returns Array of all reflections produced
|
|
197
|
+
*/
|
|
198
|
+
export function reflectOnTaskCompletion(
|
|
199
|
+
ctx: ExtensionContext,
|
|
200
|
+
session: SessionSnapshot,
|
|
201
|
+
): MARSReflection[] {
|
|
202
|
+
if (session.totalToolCalls < MIN_TOOL_CALLS_FOR_REFLECTION) return [];
|
|
203
|
+
if (session.turnCount < MIN_TURNS_FOR_REFLECTION) return [];
|
|
204
|
+
|
|
205
|
+
const reflections: MARSReflection[] = [];
|
|
206
|
+
|
|
207
|
+
// Principle reflections
|
|
208
|
+
const principles = reflectPrinciples(ctx, session);
|
|
209
|
+
for (const p of principles) {
|
|
210
|
+
log.info(`Principle reflection: "${p.content.slice(0, 80)}..." (confidence=${p.confidence})`);
|
|
211
|
+
storePrinciple(ctx, p);
|
|
212
|
+
}
|
|
213
|
+
reflections.push(...principles);
|
|
214
|
+
|
|
215
|
+
// Procedure reflections — only on actual completion
|
|
216
|
+
if (session.finalizeCalled) {
|
|
217
|
+
const procedures = reflectProcedures(ctx, session);
|
|
218
|
+
for (const p of procedures) {
|
|
219
|
+
log.info(`Procedure reflection: "${p.content.slice(0, 80)}..." (confidence=${p.confidence})`);
|
|
220
|
+
storeProcedure(ctx, p);
|
|
221
|
+
}
|
|
222
|
+
reflections.push(...procedures);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
return reflections;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Store a principle reflection as a heuristic rule via the three-memory-stores.
|
|
230
|
+
* Principles with sufficient confidence are added as heuristics; evolver.ts
|
|
231
|
+
* will boost/discount them over time based on actual usage.
|
|
232
|
+
*/
|
|
233
|
+
function storePrinciple(ctx: ExtensionContext, reflection: MARSReflection): void {
|
|
234
|
+
if (reflection.confidence < WEAK_PATTERN_CONFIDENCE) return;
|
|
235
|
+
|
|
236
|
+
const memState = getMemoryState(ctx);
|
|
237
|
+
if (!memState) {
|
|
238
|
+
log.debug("Cannot store principle: no memory state available");
|
|
239
|
+
return;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
const condition = extractCondition(reflection.content);
|
|
243
|
+
addPrinciple(memState, reflection.content, condition);
|
|
244
|
+
log.info(
|
|
245
|
+
`Stored principle "${reflection.content.slice(0, 60)}..." as heuristic [condition=${condition}]`,
|
|
246
|
+
);
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* Store a procedure reflection as an episodic memory entry.
|
|
251
|
+
* Procedures are stored with tags for cross-session retrieval.
|
|
252
|
+
*/
|
|
253
|
+
function storeProcedure(ctx: ExtensionContext, reflection: MARSReflection): void {
|
|
254
|
+
// Parity with storePrinciple: reflections below weak confidence are noise.
|
|
255
|
+
if (reflection.confidence < WEAK_PATTERN_CONFIDENCE) return;
|
|
256
|
+
|
|
257
|
+
const memState = getMemoryState(ctx);
|
|
258
|
+
if (!memState) {
|
|
259
|
+
log.debug("Cannot store procedure: no memory state available");
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
const tags = extractProcedureTags(reflection.taskContext);
|
|
264
|
+
const project = deriveProject(ctx);
|
|
265
|
+
const gate = applyWriteGateLogged(getMemoryWriteGateConfig(), {
|
|
266
|
+
site: "mars",
|
|
267
|
+
task: reflection.taskContext,
|
|
268
|
+
solution: reflection.content,
|
|
269
|
+
recent: selectRecentEpisodes(memState.episodes, project),
|
|
270
|
+
});
|
|
271
|
+
if (!gate.write) {
|
|
272
|
+
log.info(
|
|
273
|
+
`Procedure reflection ${describeWriteDecision(gate.decision)}: ` +
|
|
274
|
+
`"${reflection.taskContext.slice(0, 60)}..."`,
|
|
275
|
+
);
|
|
276
|
+
return;
|
|
277
|
+
}
|
|
278
|
+
addEpisode(
|
|
279
|
+
memState,
|
|
280
|
+
reflection.taskContext,
|
|
281
|
+
gate.solution,
|
|
282
|
+
"success",
|
|
283
|
+
[],
|
|
284
|
+
[...tags, "mars-reflection", "procedure"],
|
|
285
|
+
project,
|
|
286
|
+
);
|
|
287
|
+
log.info(`Stored procedure for "${reflection.taskContext.slice(0, 60)}..." as episode`);
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
/**
|
|
291
|
+
* Build a human-readable task context string from the session snapshot.
|
|
292
|
+
*/
|
|
293
|
+
function buildTaskContext(session: SessionSnapshot): string {
|
|
294
|
+
if (session.toolsUsed.length === 0) return "empty session";
|
|
295
|
+
|
|
296
|
+
const uniqueTools = [...new Set(session.toolsUsed.slice(-10))].slice(0, 5);
|
|
297
|
+
const toolStr = uniqueTools.join(", ");
|
|
298
|
+
|
|
299
|
+
return `${session.totalToolCalls} tool calls, ${session.uniqueToolCount} unique tools (${toolStr}), ${session.turnCount} turns, ${session.errorCount} errors`;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* Classify the task type based on tool distribution.
|
|
304
|
+
*/
|
|
305
|
+
function classifyTaskType(session: SessionSnapshot): string {
|
|
306
|
+
const hasCodeTools = session.editCalls > 0 || session.writeCalls > 0;
|
|
307
|
+
const hasVerifyTools = session.verifyCalls > 0;
|
|
308
|
+
const hasSearchTools = session.toolsUsed.some((t) => ["grep", "find", "read"].includes(t));
|
|
309
|
+
const hasBrowserTools = session.toolsUsed.some((t) =>
|
|
310
|
+
["browser_navigate", "browser_snapshot"].includes(t),
|
|
311
|
+
);
|
|
312
|
+
|
|
313
|
+
if (hasCodeTools && hasVerifyTools) return "code-change-with-verification";
|
|
314
|
+
if (hasCodeTools) return "code-change";
|
|
315
|
+
if (hasBrowserTools) return "web-research";
|
|
316
|
+
if (hasSearchTools && !hasCodeTools) return "code-exploration";
|
|
317
|
+
if (hasSearchTools) return "research";
|
|
318
|
+
return "general";
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
/**
|
|
322
|
+
* Build a procedure description from the session tool usage pattern.
|
|
323
|
+
*/
|
|
324
|
+
function buildProcedureDescription(session: SessionSnapshot, taskType: string): string | null {
|
|
325
|
+
const steps: string[] = [];
|
|
326
|
+
|
|
327
|
+
switch (taskType) {
|
|
328
|
+
case "code-change-with-verification":
|
|
329
|
+
steps.push("1. Understand the problem (read error, grep for symptom)");
|
|
330
|
+
steps.push("2. Plan the fix (think about root cause, consider alternatives)");
|
|
331
|
+
steps.push("3. Edit the fix (use edit/write for targeted changes)");
|
|
332
|
+
steps.push("4. Verify correctness (use verify tool to check)");
|
|
333
|
+
steps.push("5. Confirm completion (run tests, call finalize)");
|
|
334
|
+
break;
|
|
335
|
+
|
|
336
|
+
case "code-change":
|
|
337
|
+
steps.push("1. Read the relevant files to understand current state");
|
|
338
|
+
steps.push("2. Think about the approach and alternatives");
|
|
339
|
+
steps.push("3. Make the code change (edit/write)");
|
|
340
|
+
steps.push("4. Verify the change before moving on");
|
|
341
|
+
break;
|
|
342
|
+
|
|
343
|
+
case "web-research":
|
|
344
|
+
steps.push("1. Navigate to the source (browser_navigate)");
|
|
345
|
+
steps.push("2. Extract relevant content (browser_*)");
|
|
346
|
+
steps.push("3. Synthesize findings into structured notes");
|
|
347
|
+
break;
|
|
348
|
+
|
|
349
|
+
case "code-exploration":
|
|
350
|
+
steps.push("1. Search for relevant symbols/types (grep/find)");
|
|
351
|
+
steps.push("2. Read the files to understand structure (read)");
|
|
352
|
+
steps.push("3. Map dependencies and interfaces");
|
|
353
|
+
break;
|
|
354
|
+
|
|
355
|
+
case "research":
|
|
356
|
+
steps.push("1. Fetch the source material (fetch_content/read)");
|
|
357
|
+
steps.push("2. Extract key claims and evidence");
|
|
358
|
+
steps.push("3. Verify claims against multiple sources");
|
|
359
|
+
break;
|
|
360
|
+
|
|
361
|
+
default:
|
|
362
|
+
return null;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
return `Procedure for ${taskType}:\n${steps.join("\n")}`;
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
/**
|
|
369
|
+
* Extract a heuristic condition from a principle's content.
|
|
370
|
+
* The condition is used by the recaller to match against current context.
|
|
371
|
+
*/
|
|
372
|
+
function extractCondition(principleContent: string): string {
|
|
373
|
+
const patterns = [
|
|
374
|
+
/(before\s+\w+)/i,
|
|
375
|
+
/(after\s+\w+)/i,
|
|
376
|
+
/(when\s+\w+)/i,
|
|
377
|
+
/(\w+\s+is\s+the most common)/i,
|
|
378
|
+
];
|
|
379
|
+
|
|
380
|
+
for (const pattern of patterns) {
|
|
381
|
+
const match = principleContent.match(pattern);
|
|
382
|
+
if (match) return match[1].toLowerCase();
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
// Fallback: use first meaningful verb phrase
|
|
386
|
+
const firstSentence = principleContent.split(/[.!]/)[0];
|
|
387
|
+
return firstSentence.slice(0, 60).toLowerCase();
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
* Extract tags from the task context for episodic storage.
|
|
392
|
+
*/
|
|
393
|
+
function extractProcedureTags(taskContext: string): string[] {
|
|
394
|
+
const tags: string[] = [];
|
|
395
|
+
if (taskContext.includes("error")) tags.push("error-recovery");
|
|
396
|
+
if (taskContext.includes("code")) tags.push("code");
|
|
397
|
+
if (taskContext.includes("research")) tags.push("research");
|
|
398
|
+
if (/unique|diverse/.test(taskContext)) tags.push("tool-usage");
|
|
399
|
+
return tags;
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/**
|
|
403
|
+
* MARS Reflector extension factory.
|
|
404
|
+
*
|
|
405
|
+
* This extension provides reflection utilities consumed by the enforcement
|
|
406
|
+
* mars-handler. It does not register any tools or event handlers of its own;
|
|
407
|
+
* the factory is a no-op required for manifest registration.
|
|
408
|
+
*
|
|
409
|
+
* Reflection dispatch happens in enforcement/mars-handler (turn_end handler)
|
|
410
|
+
* which imports reflectOnTaskCompletion from this module.
|
|
411
|
+
*/
|
|
412
|
+
export default function marsReflectorExtension(): void {
|
|
413
|
+
// No-op: utility-only extension.
|
|
414
|
+
// Reflection is triggered by enforcement/mars-handler on turn_end.
|
|
415
|
+
}
|