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,106 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement Nudge System - Smart Nudge Management
|
|
3
|
+
*
|
|
4
|
+
* Prevents notification fatigue with:
|
|
5
|
+
* - Adaptive thresholds (scale based on session context)
|
|
6
|
+
* - Message deduplication (block similar nudges)
|
|
7
|
+
* - Per-type cooldowns (different rules per nudge category)
|
|
8
|
+
* - Context-aware escalation
|
|
9
|
+
*/
|
|
10
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
11
|
+
export type NudgeType = "validation" | "recordFailure" | "malformed" | "memory" | "scratchpad" | "context" | "sessionSignals";
|
|
12
|
+
export interface NudgeConfig {
|
|
13
|
+
/** Base cooldown in ms (minimum between nudges of this type) */
|
|
14
|
+
baseCooldownMs: number;
|
|
15
|
+
/** Escalation: how many nudges until we escalate severity */
|
|
16
|
+
escalateAfter: number;
|
|
17
|
+
/** Whether to deduplicate messages (prevent same text repeated) */
|
|
18
|
+
deduplicate: boolean;
|
|
19
|
+
}
|
|
20
|
+
export declare const DEFAULT_NUDGE_CONFIGS: Record<NudgeType, NudgeConfig>;
|
|
21
|
+
interface NudgeHistory {
|
|
22
|
+
lastSent: number;
|
|
23
|
+
count: number;
|
|
24
|
+
lastMessageHash: string;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Get the per-session NudgeManager. Cooldowns are scoped to the session:
|
|
28
|
+
* a new session starts with a fresh history (no carry-over). This is the
|
|
29
|
+
* canonical accessor — construct NudgeManager only here.
|
|
30
|
+
*
|
|
31
|
+
* Passes settings.json overrides (validated via parseNudgeConfigOverrides)
|
|
32
|
+
* into the NudgeManager constructor through the `customConfig` parameter.
|
|
33
|
+
*/
|
|
34
|
+
export declare function getNudgeManager(ctx: ExtensionContext): NudgeManager;
|
|
35
|
+
export interface NudgeConfigValidation {
|
|
36
|
+
valid: boolean;
|
|
37
|
+
/** Human-readable error messages; logged but never thrown. */
|
|
38
|
+
errors: string[];
|
|
39
|
+
/**
|
|
40
|
+
* The validated partial. Invalid fields are dropped from `parsed`;
|
|
41
|
+
* the rest of the override is preserved (defense in depth: one bad
|
|
42
|
+
* field doesn't lose the whole entry).
|
|
43
|
+
*/
|
|
44
|
+
parsed: Partial<NudgeConfig>;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Validate a single NudgeConfig partial.
|
|
48
|
+
*
|
|
49
|
+
* Rules:
|
|
50
|
+
* - cfg must be a plain object (not null, not array)
|
|
51
|
+
* - each key must be a valid NudgeConfig field name
|
|
52
|
+
* (`baseCooldownMs` | `escalateAfter` | `deduplicate`)
|
|
53
|
+
* - `deduplicate` must be boolean
|
|
54
|
+
* - `baseCooldownMs` and `escalateAfter` must be non-negative integers
|
|
55
|
+
*
|
|
56
|
+
* Invalid fields are dropped from `parsed`; valid fields in the same
|
|
57
|
+
* entry are preserved. Empty `{}` is valid (no overrides).
|
|
58
|
+
*/
|
|
59
|
+
export declare function validateNudgeConfig(type: string, cfg: unknown): NudgeConfigValidation;
|
|
60
|
+
/**
|
|
61
|
+
* Parse the raw braid.enforcement.nudgeConfigs block into the shape
|
|
62
|
+
* NudgeManager expects.
|
|
63
|
+
*
|
|
64
|
+
* Two layers of filtering:
|
|
65
|
+
* 1. Unknown NudgeType keys are dropped (with a warning).
|
|
66
|
+
* 2. Per-entry validation drops invalid fields but keeps valid
|
|
67
|
+
* ones in the same entry.
|
|
68
|
+
*
|
|
69
|
+
* The result is always usable (empty on full failure); NudgeManager
|
|
70
|
+
* always falls back to DEFAULT_NUDGE_CONFIGS for any type without
|
|
71
|
+
* an override entry.
|
|
72
|
+
*/
|
|
73
|
+
export declare function parseNudgeConfigOverrides(raw: Record<string, unknown>): Partial<Record<NudgeType, Partial<NudgeConfig>>>;
|
|
74
|
+
export declare class NudgeManager {
|
|
75
|
+
private history;
|
|
76
|
+
private readonly config;
|
|
77
|
+
constructor(customConfig?: Partial<Record<NudgeType, Partial<NudgeConfig>>>);
|
|
78
|
+
/**
|
|
79
|
+
* Decide whether to send a nudge.
|
|
80
|
+
*
|
|
81
|
+
* @param type Nudge category (cooldown + dedup config bucket).
|
|
82
|
+
* @param message The full message text -- used for hash dedup.
|
|
83
|
+
* @param subKey Optional. When set, isolates this call's history
|
|
84
|
+
* from other sub-signals of the same type. Without
|
|
85
|
+
* subKey, the call shares history with all other
|
|
86
|
+
* callers of the same type (legacy behavior).
|
|
87
|
+
* @param _now Optional override for the current time (tests).
|
|
88
|
+
*/
|
|
89
|
+
shouldSendNudge(type: NudgeType, message: string, subKey?: string, _now?: number): {
|
|
90
|
+
shouldSend: boolean;
|
|
91
|
+
escalated: boolean;
|
|
92
|
+
};
|
|
93
|
+
private hashMessage;
|
|
94
|
+
/**
|
|
95
|
+
* Look up history for a (type, subKey) pair. Without subKey, returns
|
|
96
|
+
* the un-scoped history for that type.
|
|
97
|
+
*/
|
|
98
|
+
getHistory(type: NudgeType, subKey?: string): NudgeHistory | undefined;
|
|
99
|
+
getAllStats(): Record<string, {
|
|
100
|
+
count: number;
|
|
101
|
+
lastSent: number;
|
|
102
|
+
}>;
|
|
103
|
+
reset(): void;
|
|
104
|
+
}
|
|
105
|
+
export {};
|
|
106
|
+
//# sourceMappingURL=nudge-manager.d.ts.map
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import { hashForDedup } from "../../lib/utils/dedup.js";
|
|
2
|
+
import { getExtensionState } from "../../lib/state/extension-state.js";
|
|
3
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
4
|
+
import { getRawNudgeConfigOverrides } from "../../lib/config/braid-settings.js";
|
|
5
|
+
const log = createLogger("enforcement:nudge-manager");
|
|
6
|
+
export const DEFAULT_NUDGE_CONFIGS = {
|
|
7
|
+
validation: { baseCooldownMs: 20_000, escalateAfter: 3, deduplicate: true },
|
|
8
|
+
recordFailure: { baseCooldownMs: 20_000, escalateAfter: 1, deduplicate: true },
|
|
9
|
+
malformed: { baseCooldownMs: 10_000, escalateAfter: 1, deduplicate: false },
|
|
10
|
+
// L2 bundle sub-signal cooldowns (each sub-signal gets its own
|
|
11
|
+
// history entry via the subKey parameter). These are wired in
|
|
12
|
+
memory: { baseCooldownMs: 45_000, escalateAfter: 2, deduplicate: false },
|
|
13
|
+
scratchpad: { baseCooldownMs: 60_000, escalateAfter: 2, deduplicate: true },
|
|
14
|
+
// Context bundle covers both `context-tokens` and `context-percent`
|
|
15
|
+
// sub-signals. subKey distinguishes them; both share this config.
|
|
16
|
+
context: { baseCooldownMs: 90_000, escalateAfter: 2, deduplicate: true },
|
|
17
|
+
// Fallback for L2 sub-signals without a dedicated NudgeType
|
|
18
|
+
// (`think`, `localization`). 60s matches the prior bundle-wide cooldown.
|
|
19
|
+
sessionSignals: { baseCooldownMs: 60_000, escalateAfter: 2, deduplicate: true },
|
|
20
|
+
};
|
|
21
|
+
// Nudge Manager
|
|
22
|
+
/**
|
|
23
|
+
* Get the per-session NudgeManager. Cooldowns are scoped to the session:
|
|
24
|
+
* a new session starts with a fresh history (no carry-over). This is the
|
|
25
|
+
* canonical accessor — construct NudgeManager only here.
|
|
26
|
+
*
|
|
27
|
+
* Passes settings.json overrides (validated via parseNudgeConfigOverrides)
|
|
28
|
+
* into the NudgeManager constructor through the `customConfig` parameter.
|
|
29
|
+
*/
|
|
30
|
+
export function getNudgeManager(ctx) {
|
|
31
|
+
const overrides = parseNudgeConfigOverrides(getRawNudgeConfigOverrides());
|
|
32
|
+
return getExtensionState(ctx, "enforcement/nudge-manager", () => new NudgeManager(overrides));
|
|
33
|
+
}
|
|
34
|
+
const VALID_NUDGE_CONFIG_FIELDS = new Set([
|
|
35
|
+
"baseCooldownMs",
|
|
36
|
+
"escalateAfter",
|
|
37
|
+
"deduplicate",
|
|
38
|
+
]);
|
|
39
|
+
/**
|
|
40
|
+
* Validate a single NudgeConfig partial.
|
|
41
|
+
*
|
|
42
|
+
* Rules:
|
|
43
|
+
* - cfg must be a plain object (not null, not array)
|
|
44
|
+
* - each key must be a valid NudgeConfig field name
|
|
45
|
+
* (`baseCooldownMs` | `escalateAfter` | `deduplicate`)
|
|
46
|
+
* - `deduplicate` must be boolean
|
|
47
|
+
* - `baseCooldownMs` and `escalateAfter` must be non-negative integers
|
|
48
|
+
*
|
|
49
|
+
* Invalid fields are dropped from `parsed`; valid fields in the same
|
|
50
|
+
* entry are preserved. Empty `{}` is valid (no overrides).
|
|
51
|
+
*/
|
|
52
|
+
export function validateNudgeConfig(type, cfg) {
|
|
53
|
+
const errors = [];
|
|
54
|
+
const parsed = {};
|
|
55
|
+
if (typeof cfg !== "object" || cfg === null || Array.isArray(cfg)) {
|
|
56
|
+
const got = cfg === null ? "null" : Array.isArray(cfg) ? "array" : typeof cfg;
|
|
57
|
+
errors.push(`[nudge-config] braid.enforcement.nudgeConfigs.${type} must be an object, got ${got}`);
|
|
58
|
+
return { valid: false, errors, parsed };
|
|
59
|
+
}
|
|
60
|
+
const obj = cfg;
|
|
61
|
+
for (const [key, value] of Object.entries(obj)) {
|
|
62
|
+
const path = `braid.enforcement.nudgeConfigs.${type}.${key}`;
|
|
63
|
+
if (!VALID_NUDGE_CONFIG_FIELDS.has(key)) {
|
|
64
|
+
errors.push(`[nudge-config] ${path} is not a valid field ` +
|
|
65
|
+
`(valid: ${[...VALID_NUDGE_CONFIG_FIELDS].join(", ")})`);
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
if (key === "deduplicate") {
|
|
69
|
+
if (typeof value !== "boolean") {
|
|
70
|
+
errors.push(`[nudge-config] ${path} must be a boolean, got ${typeof value}`);
|
|
71
|
+
}
|
|
72
|
+
else {
|
|
73
|
+
parsed.deduplicate = value;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
else {
|
|
77
|
+
// baseCooldownMs | escalateAfter
|
|
78
|
+
if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
|
|
79
|
+
const got = typeof value === "number" ? String(value) : typeof value;
|
|
80
|
+
errors.push(`[nudge-config] ${path} must be a non-negative integer, got ${got}`);
|
|
81
|
+
}
|
|
82
|
+
else if (key === "baseCooldownMs") {
|
|
83
|
+
parsed.baseCooldownMs = value;
|
|
84
|
+
}
|
|
85
|
+
else {
|
|
86
|
+
parsed.escalateAfter = value;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return { valid: errors.length === 0, errors, parsed };
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Parse the raw braid.enforcement.nudgeConfigs block into the shape
|
|
94
|
+
* NudgeManager expects.
|
|
95
|
+
*
|
|
96
|
+
* Two layers of filtering:
|
|
97
|
+
* 1. Unknown NudgeType keys are dropped (with a warning).
|
|
98
|
+
* 2. Per-entry validation drops invalid fields but keeps valid
|
|
99
|
+
* ones in the same entry.
|
|
100
|
+
*
|
|
101
|
+
* The result is always usable (empty on full failure); NudgeManager
|
|
102
|
+
* always falls back to DEFAULT_NUDGE_CONFIGS for any type without
|
|
103
|
+
* an override entry.
|
|
104
|
+
*/
|
|
105
|
+
export function parseNudgeConfigOverrides(raw) {
|
|
106
|
+
const validTypes = new Set(Object.keys(DEFAULT_NUDGE_CONFIGS));
|
|
107
|
+
const overrides = {};
|
|
108
|
+
for (const [type, cfg] of Object.entries(raw)) {
|
|
109
|
+
if (!validTypes.has(type)) {
|
|
110
|
+
log.warn(`[nudge-config] braid.enforcement.nudgeConfigs.${type} is not a valid NudgeType ` +
|
|
111
|
+
`(valid: ${[...validTypes].join(", ")}); ignored`);
|
|
112
|
+
continue;
|
|
113
|
+
}
|
|
114
|
+
const { errors, parsed } = validateNudgeConfig(type, cfg);
|
|
115
|
+
for (const err of errors)
|
|
116
|
+
log.warn(err);
|
|
117
|
+
if (Object.keys(parsed).length > 0) {
|
|
118
|
+
overrides[type] = parsed;
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return overrides;
|
|
122
|
+
}
|
|
123
|
+
export class NudgeManager {
|
|
124
|
+
// History is keyed by composite `${type}:${subKey ?? ""}` so
|
|
125
|
+
// a single NudgeType can have independent cooldown + dedup slots per
|
|
126
|
+
// sub-signal. When subKey is omitted, the key reduces to just the
|
|
127
|
+
// type -- preserving the original single-slot-per-type behavior.
|
|
128
|
+
history = new Map();
|
|
129
|
+
config;
|
|
130
|
+
constructor(customConfig) {
|
|
131
|
+
this.config = { ...DEFAULT_NUDGE_CONFIGS };
|
|
132
|
+
if (customConfig) {
|
|
133
|
+
for (const [type, overrides] of Object.entries(customConfig)) {
|
|
134
|
+
const t = type;
|
|
135
|
+
if (this.config[t]) {
|
|
136
|
+
this.config[t] = { ...this.config[t], ...overrides };
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
/**
|
|
142
|
+
* Decide whether to send a nudge.
|
|
143
|
+
*
|
|
144
|
+
* @param type Nudge category (cooldown + dedup config bucket).
|
|
145
|
+
* @param message The full message text -- used for hash dedup.
|
|
146
|
+
* @param subKey Optional. When set, isolates this call's history
|
|
147
|
+
* from other sub-signals of the same type. Without
|
|
148
|
+
* subKey, the call shares history with all other
|
|
149
|
+
* callers of the same type (legacy behavior).
|
|
150
|
+
* @param _now Optional override for the current time (tests).
|
|
151
|
+
*/
|
|
152
|
+
shouldSendNudge(type, message, subKey, _now = Date.now()) {
|
|
153
|
+
const cfg = this.config[type];
|
|
154
|
+
if (!cfg)
|
|
155
|
+
return { shouldSend: false, escalated: false };
|
|
156
|
+
const key = subKey ? `${type}:${subKey}` : type;
|
|
157
|
+
const existing = this.history.get(key);
|
|
158
|
+
const history = existing
|
|
159
|
+
? { ...existing }
|
|
160
|
+
: { lastSent: 0, count: 0, lastMessageHash: "" };
|
|
161
|
+
// 1. Check cooldown
|
|
162
|
+
const timeSinceLast = _now - history.lastSent;
|
|
163
|
+
if (timeSinceLast < cfg.baseCooldownMs) {
|
|
164
|
+
return { shouldSend: false, escalated: false };
|
|
165
|
+
}
|
|
166
|
+
// 2. Check deduplication
|
|
167
|
+
if (cfg.deduplicate && existing?.lastMessageHash) {
|
|
168
|
+
const msgHash = this.hashMessage(message);
|
|
169
|
+
if (msgHash === existing.lastMessageHash) {
|
|
170
|
+
return { shouldSend: false, escalated: false };
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
// 3. Update state
|
|
174
|
+
history.lastSent = _now;
|
|
175
|
+
history.lastMessageHash = this.hashMessage(message);
|
|
176
|
+
history.count++;
|
|
177
|
+
const escalated = history.count % cfg.escalateAfter === 0;
|
|
178
|
+
this.history.set(key, history);
|
|
179
|
+
return { shouldSend: true, escalated };
|
|
180
|
+
}
|
|
181
|
+
hashMessage(message) {
|
|
182
|
+
return hashForDedup(message.trim());
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* Look up history for a (type, subKey) pair. Without subKey, returns
|
|
186
|
+
* the un-scoped history for that type.
|
|
187
|
+
*/
|
|
188
|
+
getHistory(type, subKey) {
|
|
189
|
+
const key = subKey ? `${type}:${subKey}` : type;
|
|
190
|
+
return this.history.get(key);
|
|
191
|
+
}
|
|
192
|
+
getAllStats() {
|
|
193
|
+
const stats = {};
|
|
194
|
+
for (const [type, hist] of this.history) {
|
|
195
|
+
stats[type] = { count: hist.count, lastSent: hist.lastSent };
|
|
196
|
+
}
|
|
197
|
+
return stats;
|
|
198
|
+
}
|
|
199
|
+
reset() {
|
|
200
|
+
this.history.clear();
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
//# sourceMappingURL=nudge-manager.js.map
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Self-state claim detector for the verification judge.
|
|
3
|
+
*
|
|
4
|
+
* Motivation (a prior probe): delivery/liveness self-state claims were
|
|
5
|
+
* asserted 10/10 with honest nuance 0/10. The judge had no decisive
|
|
6
|
+
* in-session check for "messages reach me", and a bare core clause did not
|
|
7
|
+
* elicit a hedge. The prompt side (a state-aware TG inbound row) is the
|
|
8
|
+
* other half; this module is the enforcement side.
|
|
9
|
+
*
|
|
10
|
+
* Pure and LLM-free: scan the agent's visible response for claims whose
|
|
11
|
+
* predicate matches liveness/delivery/progress terms, and suppress every
|
|
12
|
+
* candidate when the evidence window (toolsUsed / taskEvidence / toolLog)
|
|
13
|
+
* already contains a probe call. buildVerificationPrompt() renders a
|
|
14
|
+
* SELF-STATE CLAIMS section only when candidates survive; with no candidates
|
|
15
|
+
* the prompt is byte-unchanged (no unconditional token growth).
|
|
16
|
+
*
|
|
17
|
+
* Claim surface is `lastResponse` (the asserted, visible text) only.
|
|
18
|
+
* Thinking blocks are exploratory ("maybe the poller died"), not assertions;
|
|
19
|
+
* scanning them would flag speculation and punish hedging.
|
|
20
|
+
*/
|
|
21
|
+
/**
|
|
22
|
+
* Probe tools whose presence in the evidence window makes a self-state claim
|
|
23
|
+
* verifiable in-session. A test/build run verifies work, not delivery: that
|
|
24
|
+
* gap is exactly what the probe measured. `context_inspect` is deliberately NOT a
|
|
25
|
+
* probe here: it inspects session context state, and this claim class is
|
|
26
|
+
* channel liveness/delivery/progress, not context state.
|
|
27
|
+
*/
|
|
28
|
+
export declare const SELF_STATE_PROBE_TOOLS: readonly ["session_health", "health_maintenance", "v2raytun_status", "telegram_send"];
|
|
29
|
+
/**
|
|
30
|
+
* Prompt-section cap for listed claims, with an explicit suppressed-count
|
|
31
|
+
* line beyond it (same never-silent-truncation pattern as task-evidence.ts).
|
|
32
|
+
*/
|
|
33
|
+
export declare const MAX_SELF_STATE_CLAIMS_IN_PROMPT = 6;
|
|
34
|
+
/** A claim segment matched in the response text, verbatim. */
|
|
35
|
+
export interface SelfStateClaim {
|
|
36
|
+
/** The matched clause, verbatim from the response. */
|
|
37
|
+
claim: string;
|
|
38
|
+
/** Id of the pattern that matched. */
|
|
39
|
+
patternId: string;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Detection patterns. Recall-biased: a false render costs a few prompt tokens
|
|
43
|
+
* (the LLM arbitrates against the probe rule); a miss leaves an ungrounded
|
|
44
|
+
* claim unflagged, which is the failure mode this detector exists to catch.
|
|
45
|
+
*/
|
|
46
|
+
export declare const SELF_STATE_PATTERNS: ReadonlyArray<{
|
|
47
|
+
id: string;
|
|
48
|
+
re: RegExp;
|
|
49
|
+
}>;
|
|
50
|
+
/** Scan input: a subset of JudgeContext fields. */
|
|
51
|
+
export interface SelfStateScanInput {
|
|
52
|
+
/** Agent's visible response text (the claim surface). */
|
|
53
|
+
responseText?: string;
|
|
54
|
+
/** Unique tool names used in the session. */
|
|
55
|
+
toolsUsed?: string[];
|
|
56
|
+
/** Task-wide evidence lines since the last real user message. */
|
|
57
|
+
taskEvidence?: string[];
|
|
58
|
+
/** Current-window tool execution log lines. */
|
|
59
|
+
toolLog?: string[];
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Does the evidence window contain a probe call? toolsUsed matches by exact
|
|
63
|
+
* tool name; evidence/log lines match by substring (tool names render inline,
|
|
64
|
+
* e.g. `telegram_send [OK]: {...}`).
|
|
65
|
+
*/
|
|
66
|
+
export declare function hasSelfStateProbe(input: SelfStateScanInput): boolean;
|
|
67
|
+
/**
|
|
68
|
+
* Find self-state claim candidates in the response text. Returns ALL
|
|
69
|
+
* distinct clauses that matched a pattern and survived the guards (deduped,
|
|
70
|
+
* uncapped); the prompt renderer applies the cap.
|
|
71
|
+
*/
|
|
72
|
+
export declare function findSelfStateClaims(input: SelfStateScanInput): SelfStateClaim[];
|
|
73
|
+
/**
|
|
74
|
+
* Render the SELF-STATE CLAIMS prompt section. Self-contained rule: the
|
|
75
|
+
* judge system prompt is not touched, so judge calls without candidates pay
|
|
76
|
+
* nothing.
|
|
77
|
+
*/
|
|
78
|
+
export declare function renderSelfStateClaimsSection(claims: SelfStateClaim[]): string;
|
|
79
|
+
//# sourceMappingURL=self-state-claims.d.ts.map
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Self-state claim detector for the verification judge.
|
|
3
|
+
*
|
|
4
|
+
* Motivation (a prior probe): delivery/liveness self-state claims were
|
|
5
|
+
* asserted 10/10 with honest nuance 0/10. The judge had no decisive
|
|
6
|
+
* in-session check for "messages reach me", and a bare core clause did not
|
|
7
|
+
* elicit a hedge. The prompt side (a state-aware TG inbound row) is the
|
|
8
|
+
* other half; this module is the enforcement side.
|
|
9
|
+
*
|
|
10
|
+
* Pure and LLM-free: scan the agent's visible response for claims whose
|
|
11
|
+
* predicate matches liveness/delivery/progress terms, and suppress every
|
|
12
|
+
* candidate when the evidence window (toolsUsed / taskEvidence / toolLog)
|
|
13
|
+
* already contains a probe call. buildVerificationPrompt() renders a
|
|
14
|
+
* SELF-STATE CLAIMS section only when candidates survive; with no candidates
|
|
15
|
+
* the prompt is byte-unchanged (no unconditional token growth).
|
|
16
|
+
*
|
|
17
|
+
* Claim surface is `lastResponse` (the asserted, visible text) only.
|
|
18
|
+
* Thinking blocks are exploratory ("maybe the poller died"), not assertions;
|
|
19
|
+
* scanning them would flag speculation and punish hedging.
|
|
20
|
+
*/
|
|
21
|
+
/**
|
|
22
|
+
* Probe tools whose presence in the evidence window makes a self-state claim
|
|
23
|
+
* verifiable in-session. A test/build run verifies work, not delivery: that
|
|
24
|
+
* gap is exactly what the probe measured. `context_inspect` is deliberately NOT a
|
|
25
|
+
* probe here: it inspects session context state, and this claim class is
|
|
26
|
+
* channel liveness/delivery/progress, not context state.
|
|
27
|
+
*/
|
|
28
|
+
export const SELF_STATE_PROBE_TOOLS = [
|
|
29
|
+
"session_health",
|
|
30
|
+
"health_maintenance",
|
|
31
|
+
"v2raytun_status",
|
|
32
|
+
"telegram_send",
|
|
33
|
+
];
|
|
34
|
+
/**
|
|
35
|
+
* Prompt-section cap for listed claims, with an explicit suppressed-count
|
|
36
|
+
* line beyond it (same never-silent-truncation pattern as task-evidence.ts).
|
|
37
|
+
*/
|
|
38
|
+
export const MAX_SELF_STATE_CLAIMS_IN_PROMPT = 6;
|
|
39
|
+
/** Liveness/delivery/progress subject words, shared by two patterns. */
|
|
40
|
+
const LIVE_SUBJECTS = "pollers?|heartbeats?|watchdogs?|daemons?|tunnels?|vpns?|prox(?:y|ies)";
|
|
41
|
+
/**
|
|
42
|
+
* Detection patterns. Recall-biased: a false render costs a few prompt tokens
|
|
43
|
+
* (the LLM arbitrates against the probe rule); a miss leaves an ungrounded
|
|
44
|
+
* claim unflagged, which is the failure mode this detector exists to catch.
|
|
45
|
+
*/
|
|
46
|
+
export const SELF_STATE_PATTERNS = [
|
|
47
|
+
// Any mention of a channel/daemon liveness subject in a final response is
|
|
48
|
+
// in practice a state assertion about it ("the poller is running",
|
|
49
|
+
// "heartbeat keeps me alive"). `telegram_poller` needs its own alternative:
|
|
50
|
+
// \bpoller\b cannot start inside it (underscore is a word character).
|
|
51
|
+
{
|
|
52
|
+
id: "channel-liveness-subject",
|
|
53
|
+
re: new RegExp(`\\b(?:telegram[_-]?pollers?|${LIVE_SUBJECTS})\\b`, "i"),
|
|
54
|
+
},
|
|
55
|
+
// Reachability/contact claims about the agent's channels.
|
|
56
|
+
{
|
|
57
|
+
id: "reachability",
|
|
58
|
+
re: /\b(?:un)?reachable\b|\bcan\s+(?:still\s+)?reach\s+me\b|\breach(?:es|ed)?\s+me\b|\b(?:contact|ping|dm|message|text)\s+me\b|\bget\s+(?:in\s+)?touch\b/i,
|
|
59
|
+
},
|
|
60
|
+
// Delivery claims: messages sent/delivered/arrived, receipts. The word
|
|
61
|
+
// boundary after "deliver" keeps "deliverables" out of the class.
|
|
62
|
+
{
|
|
63
|
+
id: "delivery",
|
|
64
|
+
re: /\bdeliver(?:ed|ies|y)\b|\b(?:sent|arriv(?:es|ed|al|ing)|inbound|outbound|receipts?)\b/i,
|
|
65
|
+
},
|
|
66
|
+
// Health/liveness claims ("session is healthy", "up and running").
|
|
67
|
+
// Deliberately no "all checks green/pass" alternative: work-verification
|
|
68
|
+
// reporting ("all checks passed") is not self-state, and flagging it
|
|
69
|
+
// would punish normal verification evidence.
|
|
70
|
+
{
|
|
71
|
+
id: "health",
|
|
72
|
+
re: /\bhealthy\b|\bhealth\s+(?:is|looks|seems|remains)\b|\bup\s+and\s+running\b|\balive\b/i,
|
|
73
|
+
},
|
|
74
|
+
// Running/active/working with an explicit self-state subject. The subject
|
|
75
|
+
// guard keeps "running the test suite" / "tests are running" out.
|
|
76
|
+
{
|
|
77
|
+
id: "running-subject",
|
|
78
|
+
re: new RegExp(`\\b(?:${LIVE_SUBJECTS}|service|process|session|timer|scheduler|bot|agent|instance)\\s+` +
|
|
79
|
+
`(?:(?:is|are|was|were)\\s+)?(?:still\\s+|already\\s+|currently\\s+|now\\s+)?` +
|
|
80
|
+
`(?:running|active|alive|up|live|working|works)\\b`, "i"),
|
|
81
|
+
},
|
|
82
|
+
// Progress claims (brief term list: "on track").
|
|
83
|
+
{ id: "on-track", re: /\bon\s+track\b/i },
|
|
84
|
+
];
|
|
85
|
+
/**
|
|
86
|
+
* Negation/hedge tokens. A clause containing one is exempt: negative or
|
|
87
|
+
* hedged self-state ("poller not running", "reachability unverified", "may
|
|
88
|
+
* not arrive") is the honest behavior this detector must not punish.
|
|
89
|
+
* Flagging it would punish exactly the nuance the prompt-side work teaches.
|
|
90
|
+
*/
|
|
91
|
+
const NEGATION_HEDGE = /\b(?:not|no|never|neither|nor|without|cannot|can't|won't|wouldn't|couldn't|shouldn't|isn't|aren't|wasn't|weren't|doesn't|didn't|stopped|stopping|offline|unavailable|unreachable|unverified|uncertain|unconfirmed|unknown|unsure|may|might|could|possibly|probably|presumably|perhaps|unlikely|doubtful|down|dead|crashed|died|flaky)\b/i;
|
|
92
|
+
/** Probe-tool names that, named in the claim clause itself, exempt it: citing the check ("I ran session_health: healthy") is probe awareness, not an ungrounded assertion. */
|
|
93
|
+
const PROBE_NAME = /(?:session_health|health_maintenance|v2raytun_status|telegram_send|telegram_poller)/i;
|
|
94
|
+
/**
|
|
95
|
+
* Does the evidence window contain a probe call? toolsUsed matches by exact
|
|
96
|
+
* tool name; evidence/log lines match by substring (tool names render inline,
|
|
97
|
+
* e.g. `telegram_send [OK]: {...}`).
|
|
98
|
+
*/
|
|
99
|
+
export function hasSelfStateProbe(input) {
|
|
100
|
+
const probeNames = new Set(SELF_STATE_PROBE_TOOLS);
|
|
101
|
+
if (input.toolsUsed?.some((t) => probeNames.has(t)))
|
|
102
|
+
return true;
|
|
103
|
+
const needle = new RegExp(SELF_STATE_PROBE_TOOLS.join("|"), "i");
|
|
104
|
+
return (input.taskEvidence?.some((line) => needle.test(line)) === true ||
|
|
105
|
+
input.toolLog?.some((line) => needle.test(line)) === true);
|
|
106
|
+
}
|
|
107
|
+
/** Response text -> claim clauses: lines, then sentences, then comma/contrast clauses (keeps negation guards clause-local). */
|
|
108
|
+
function claimClauses(text) {
|
|
109
|
+
return text
|
|
110
|
+
.split(/\r?\n/)
|
|
111
|
+
.flatMap((line) => line.split(/(?<=[.!?])\s+/))
|
|
112
|
+
.flatMap((sentence) => sentence.split(/\s*[,;]\s*|\s+(?:but|however|although|though)\s+/i))
|
|
113
|
+
.map((clause) => clause.trim())
|
|
114
|
+
.filter((clause) => clause.length > 0);
|
|
115
|
+
}
|
|
116
|
+
/**
|
|
117
|
+
* Find self-state claim candidates in the response text. Returns ALL
|
|
118
|
+
* distinct clauses that matched a pattern and survived the guards (deduped,
|
|
119
|
+
* uncapped); the prompt renderer applies the cap.
|
|
120
|
+
*/
|
|
121
|
+
export function findSelfStateClaims(input) {
|
|
122
|
+
if (hasSelfStateProbe(input))
|
|
123
|
+
return [];
|
|
124
|
+
const text = input.responseText ?? "";
|
|
125
|
+
if (!text)
|
|
126
|
+
return [];
|
|
127
|
+
const claims = [];
|
|
128
|
+
const seen = new Set();
|
|
129
|
+
for (const clause of claimClauses(text)) {
|
|
130
|
+
if (seen.has(clause))
|
|
131
|
+
continue;
|
|
132
|
+
// Interrogatives are questions, not assertions.
|
|
133
|
+
if (clause.endsWith("?"))
|
|
134
|
+
continue;
|
|
135
|
+
// Hedged/negative clauses and clauses that name a probe tool are exempt.
|
|
136
|
+
if (NEGATION_HEDGE.test(clause) || PROBE_NAME.test(clause))
|
|
137
|
+
continue;
|
|
138
|
+
for (const { id, re } of SELF_STATE_PATTERNS) {
|
|
139
|
+
if (re.test(clause)) {
|
|
140
|
+
seen.add(clause);
|
|
141
|
+
claims.push({ claim: clause, patternId: id });
|
|
142
|
+
break;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
return claims;
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Render the SELF-STATE CLAIMS prompt section. Self-contained rule: the
|
|
150
|
+
* judge system prompt is not touched, so judge calls without candidates pay
|
|
151
|
+
* nothing.
|
|
152
|
+
*/
|
|
153
|
+
export function renderSelfStateClaimsSection(claims) {
|
|
154
|
+
const listed = claims.slice(0, MAX_SELF_STATE_CLAIMS_IN_PROMPT);
|
|
155
|
+
const lines = [
|
|
156
|
+
"## SELF-STATE CLAIMS (ungrounded liveness/delivery/progress assertions)",
|
|
157
|
+
"",
|
|
158
|
+
"The AGENT RESPONSE asserts the agent's own channel or session state:",
|
|
159
|
+
...listed.map((c) => `- "${c.claim}"`),
|
|
160
|
+
];
|
|
161
|
+
if (claims.length > listed.length) {
|
|
162
|
+
lines.push(`(${claims.length - listed.length} more matched claim(s) suppressed, cap ${MAX_SELF_STATE_CLAIMS_IN_PROMPT})`);
|
|
163
|
+
}
|
|
164
|
+
lines.push("", "These claims cannot be verified by build or test evidence: they need a decisive in-session probe call (session_health, health_maintenance, v2raytun_status, telegram_send), and the evidence window above shows none.", 'Rule: flag each listed claim as an issue (category "claim") unless TASK EVIDENCE, TOOL EXECUTION LOG, or chunk summaries above show a probe call supporting it. Hedged or negative self-state ("poller not running", "reachability unverified") is honest and must NOT be flagged.');
|
|
165
|
+
return lines.join("\n");
|
|
166
|
+
}
|
|
167
|
+
//# sourceMappingURL=self-state-claims.js.map
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Session Health State - one source of truth for "is the session healthy?".
|
|
3
|
+
*
|
|
4
|
+
* Owned by the enforcement layer. Heartbeat informs, context-manager
|
|
5
|
+
* executes, the recovery handler (Layer 3, deferred) decides what to do.
|
|
6
|
+
*
|
|
7
|
+
* State machine:
|
|
8
|
+
* healthy
|
|
9
|
+
* ├── (1+ transient) -> healthy (auto-cleared after N healthy turns)
|
|
10
|
+
* ├── (1 balance) -> balance (no auto-clear; user must act)
|
|
11
|
+
* ├── (3+ transient) -> degraded (cleared after 10 healthy turns)
|
|
12
|
+
* ├── (context_window)-> context_overflow (cleared after compaction)
|
|
13
|
+
* ├── (auth) -> auth (no auto-clear; user must act)
|
|
14
|
+
* └── (abort) -> aborted (cleared on next turn_start)
|
|
15
|
+
*
|
|
16
|
+
* The state is per-session via getExtensionState. Consumers read it via
|
|
17
|
+
* getSessionHealth(ctx); updates happen via recordLlmError / recordLlmSuccess
|
|
18
|
+
* or explicit setSessionHealthMode.
|
|
19
|
+
*
|
|
20
|
+
* Layer 2 of the session-recovery proposal. Skips the
|
|
21
|
+
* recovery handler (Layer 3) -- the state is populated, but the consumer
|
|
22
|
+
* of the state is downstream code (consolidation gate in heartbeat,
|
|
23
|
+
* the L1 environment hook, the session_health tool).
|
|
24
|
+
*/
|
|
25
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
26
|
+
import type { ClassifiedLlmError, LlmErrorCategory } from "../../lib/errors/llm-error.js";
|
|
27
|
+
export type SessionHealthMode = "healthy" | "degraded" | "balance" | "context_overflow" | "auth" | "aborted";
|
|
28
|
+
export interface SessionHealthState {
|
|
29
|
+
mode: SessionHealthMode;
|
|
30
|
+
/** Last error classification (omitted when mode is healthy). */
|
|
31
|
+
lastError?: ClassifiedLlmError;
|
|
32
|
+
consecutiveErrors: number;
|
|
33
|
+
consecutiveHealthyTurns: number;
|
|
34
|
+
/** ms timestamp of the first error in the current degraded window. */
|
|
35
|
+
firstErrorAt?: number;
|
|
36
|
+
/** ms timestamp of the current mode's entry. */
|
|
37
|
+
modeEnteredAt?: number;
|
|
38
|
+
/** Counts errors by category since session start. Diagnostic only. */
|
|
39
|
+
providerErrorsByCategory: Record<LlmErrorCategory, number>;
|
|
40
|
+
/** Counts successful LLM calls since session start. Diagnostic only. */
|
|
41
|
+
providerSuccessCount: number;
|
|
42
|
+
/**
|
|
43
|
+
* How many heartbeat consolidation candidates were skipped per health mode
|
|
44
|
+
* this session — without it, a latched auth mode runs for minutes with
|
|
45
|
+
* zero visibility. Bumped from the heartbeat agent_end consolidation gate
|
|
46
|
+
* via recordConsolidationSkip().
|
|
47
|
+
*/
|
|
48
|
+
consolidationSkipsByMode: Partial<Record<SessionHealthMode, number>>;
|
|
49
|
+
/**
|
|
50
|
+
* Terminal-class (auth/balance) LLM errors since the last completed clean
|
|
51
|
+
* turn or explicit reset. Monotonic between resets: a latch, not a window.
|
|
52
|
+
* `tickSessionHealth`'s mode auto-clear never touches it — deriving it from
|
|
53
|
+
* `mode` would close the guard during the quiet gaps of a long outage.
|
|
54
|
+
*/
|
|
55
|
+
terminalErrorsSinceHealthyTurn: number;
|
|
56
|
+
/**
|
|
57
|
+
* ms timestamp of the first time the counter reached TERMINAL_BREAKER_N in
|
|
58
|
+
* the current episode. Diagnostic; cleared together with the counter.
|
|
59
|
+
*/
|
|
60
|
+
breakerOpenedAt?: number;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Terminal-category errors (auth/balance) that must accumulate since the last
|
|
64
|
+
* clean turn before a wake fire stops starting a turn. Chosen to equal the
|
|
65
|
+
* watchdog's quotaErrors so the two guards cannot disagree about when a route
|
|
66
|
+
* is down; one terminal error is not evidence of a terminal route (a 401 was
|
|
67
|
+
* observed followed by a pass-through success, and 401/402 mix on one key).
|
|
68
|
+
*/
|
|
69
|
+
export declare const TERMINAL_BREAKER_N = 3;
|
|
70
|
+
export declare function getSessionHealth(ctx: ExtensionContext): SessionHealthState;
|
|
71
|
+
/**
|
|
72
|
+
* Would a new turn start against a route this session has already seen fail
|
|
73
|
+
* terminally? Latch state only — no provider/model/error names, so callers in
|
|
74
|
+
* generic layers (the timer wake path) cannot learn a domain fact from it.
|
|
75
|
+
*
|
|
76
|
+
* `threshold` lets a caller pass the configured bound; the default keeps the
|
|
77
|
+
* built-in N. Open-ness is derived from the monotonic counter, which only the
|
|
78
|
+
* explicit reset signals (session_start, owner recovery, route change) and a
|
|
79
|
+
* clean wake turn lower — hence "latch".
|
|
80
|
+
*/
|
|
81
|
+
export declare function isTurnStartBlocked(ctx: ExtensionContext, threshold?: number): boolean;
|
|
82
|
+
/** Clear the latch and its counter (the reset signals share this). */
|
|
83
|
+
export declare function clearTerminalBreaker(ctx: ExtensionContext): void;
|
|
84
|
+
export declare function recordLlmError(ctx: ExtensionContext, err: ClassifiedLlmError): void;
|
|
85
|
+
export declare function recordLlmSuccess(ctx: ExtensionContext): void;
|
|
86
|
+
export declare function setSessionHealthMode(ctx: ExtensionContext, mode: SessionHealthMode, reason?: string): void;
|
|
87
|
+
/**
|
|
88
|
+
* Count a skipped heartbeat consolidation by health mode (called from the
|
|
89
|
+
* heartbeat agent_end gate). Diagnostic counter.
|
|
90
|
+
*/
|
|
91
|
+
export declare function recordConsolidationSkip(ctx: ExtensionContext, mode: SessionHealthMode): void;
|
|
92
|
+
/**
|
|
93
|
+
* Periodically re-check the balance/auth-mode exit condition.
|
|
94
|
+
* The 5-minute probe window is conservative -- if no error of the latched
|
|
95
|
+
* mode has fired in 5 minutes, the provider has probably recovered. Clearing
|
|
96
|
+
* the error window re-arms the probe: the next LLM call either succeeds
|
|
97
|
+
* (recordLlmSuccess clears the mode) or fails (the same error category
|
|
98
|
+
* re-latches immediately — a genuine 401 burst still latches fast).
|
|
99
|
+
* Hooked from enforcement's session_start LLM listeners (fires per LLM
|
|
100
|
+
* outcome; the success-streak path in recordLlmSuccess covers sessions
|
|
101
|
+
* where errors have simply stopped).
|
|
102
|
+
*/
|
|
103
|
+
export declare function tickSessionHealth(ctx: ExtensionContext): void;
|
|
104
|
+
export declare function resetSessionHealth(ctx: ExtensionContext, opts?: {
|
|
105
|
+
preserveHistory?: boolean;
|
|
106
|
+
}): void;
|
|
107
|
+
//# sourceMappingURL=session-health.d.ts.map
|