pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Silicon Mirror - Anti-Sycophancy Detector
|
|
3
|
+
*
|
|
4
|
+
* MVI: Detects validation-before-correction (VbC) patterns in agent responses.
|
|
5
|
+
* Fires whisper correction + emits signal on detection.
|
|
6
|
+
*
|
|
7
|
+
* Research base: arxiv:2604.00478 "The Silicon Mirror" (K&W 2026)
|
|
8
|
+
* arxiv:2604.19117 "LLMs know they're wrong" (Pandey 2026)
|
|
9
|
+
*
|
|
10
|
+
* Key constraint: pi-braid has no pre-response hook. Detection fires
|
|
11
|
+
* post-message_end; the VbC response is already sent. Whisper corrects
|
|
12
|
+
* future behavior, not the past response.
|
|
13
|
+
*/
|
|
14
|
+
import { sendEnforcementWhisper } from "../../enforcement/whisper.js";
|
|
15
|
+
import { emitSignal } from "../../../lib/reasoning/belief-policy-engine.js";
|
|
16
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
17
|
+
import { getExtensionState, getSessionIdSafe, safeSessionManagerTyped, } from "../../../lib/state/extension-state.js";
|
|
18
|
+
import { setAcceptanceSignal } from "../../../lib/state/global-state.js";
|
|
19
|
+
import { classifyWithOffline } from "../../../lib/reasoning/classifier-offline.js";
|
|
20
|
+
import { CRITICS } from "../../../lib/ai/critic-registry.js";
|
|
21
|
+
import { MESSAGE_END } from "../../../lib/core/event-names.js";
|
|
22
|
+
import { MIN_TEXT_LENGTH_FOR_CLASSIFY } from "../../../lib/constants/session-thresholds.js";
|
|
23
|
+
const log = createLogger("sycophancy-detector");
|
|
24
|
+
const RISK_THRESHOLD = 0.5;
|
|
25
|
+
const MAX_WHISPERS_PER_SESSION = 10;
|
|
26
|
+
const COOLDOWN_TURNS = 3;
|
|
27
|
+
function createState() {
|
|
28
|
+
return { detectionCount: 0, whisperCount: 0, lastWhisperTurn: -COOLDOWN_TURNS, turnCount: 0 };
|
|
29
|
+
}
|
|
30
|
+
function getState(ctx) {
|
|
31
|
+
return getExtensionState(ctx, "sycophancy-detector", createState);
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Compute sycophancy risk from user input.
|
|
35
|
+
* Uses utility model classification (fallback: heuristic patterns).
|
|
36
|
+
*/
|
|
37
|
+
async function computeRisk(text, ctx) {
|
|
38
|
+
// Heuristic sycophancy detection misses novel forms, so this always uses
|
|
39
|
+
// the LLM. classifyWithOffline() captures the offline state so the
|
|
40
|
+
// consumer can emit a "sycophancy monitor offline" whisper.
|
|
41
|
+
const result = await classifyWithOffline(ctx, CRITICS.sycophancyTactics.criteria, { text }, {
|
|
42
|
+
...CRITICS.sycophancyTactics.options,
|
|
43
|
+
tierPolicy: "always-llm",
|
|
44
|
+
label: CRITICS.sycophancyTactics.label,
|
|
45
|
+
fallback: () => "no",
|
|
46
|
+
});
|
|
47
|
+
if (result.value === "yes") {
|
|
48
|
+
return {
|
|
49
|
+
score: 0.6,
|
|
50
|
+
tactics: [`classify(${result.tier})`],
|
|
51
|
+
severity: "medium",
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
return {
|
|
55
|
+
score: 0,
|
|
56
|
+
tactics: [],
|
|
57
|
+
severity: "low",
|
|
58
|
+
classifierDown: result.classifierDown,
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Detect validation-before-correction (VbC) in assistant responses.
|
|
63
|
+
* Uses utility model classification (fallback: heuristic patterns).
|
|
64
|
+
* Replaces the 30s LLM auditor - this runs in ~50ms via the utility model.
|
|
65
|
+
*/
|
|
66
|
+
async function detectVbC(responseText, ctx) {
|
|
67
|
+
if (responseText.length < 100) {
|
|
68
|
+
return { detected: false, severity: "low", score: 0, correction_hint: "" };
|
|
69
|
+
}
|
|
70
|
+
// Truncate long responses to keep prompt tokens reasonable
|
|
71
|
+
const truncated = responseText.length > 2000 ? responseText.slice(0, 2000) + "..." : responseText;
|
|
72
|
+
const result = await classifyWithOffline(ctx, CRITICS.vbCDetection.criteria, { text: truncated }, {
|
|
73
|
+
...CRITICS.vbCDetection.options,
|
|
74
|
+
// Regex on "You're right...however" misses nuance. Always use LLM.
|
|
75
|
+
tierPolicy: "always-llm",
|
|
76
|
+
label: CRITICS.vbCDetection.label,
|
|
77
|
+
fallback: () => "no",
|
|
78
|
+
});
|
|
79
|
+
if (result.value === "yes") {
|
|
80
|
+
return {
|
|
81
|
+
detected: true,
|
|
82
|
+
severity: "medium",
|
|
83
|
+
score: 0.6,
|
|
84
|
+
correction_hint: "Avoid validation-before-correction. State the correction directly " +
|
|
85
|
+
"without first agreeing with the user's incorrect premise.",
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
// classifierDown is intentionally not surfaced on VbC: VbC is a
|
|
89
|
+
// pattern-match detector and the heuristic fallback is sufficient.
|
|
90
|
+
// computeRisk() surfaces classifierDown; detectVbC() does not.
|
|
91
|
+
return { detected: false, severity: "low", score: 0, correction_hint: "" };
|
|
92
|
+
}
|
|
93
|
+
// VbC detection is the heuristic detectVbC(), not an LLM auditor call: a
|
|
94
|
+
// per-response LLM audit costs ~30s latency and ~$0.002/call on paid models,
|
|
95
|
+
// and the heuristic achieves comparable detection for VbC patterns.
|
|
96
|
+
async function handleSycophancy(pi, ctx, state) {
|
|
97
|
+
state.turnCount++;
|
|
98
|
+
// Get session history - use getBranch(), getCurrentSession() does not exist on SessionManager
|
|
99
|
+
// Use safeSessionManagerTyped to avoid assertActive() crash on stale ctx
|
|
100
|
+
const sm = safeSessionManagerTyped(ctx);
|
|
101
|
+
const entries = sm?.getBranch?.() ?? [];
|
|
102
|
+
const messages = entries
|
|
103
|
+
.filter((e) => e.type === "message")
|
|
104
|
+
.map((e) => e.message);
|
|
105
|
+
const userMessages = messages.filter((m) => m.role === "user");
|
|
106
|
+
const lastUserMsg = userMessages[userMessages.length - 1];
|
|
107
|
+
const userText = typeof lastUserMsg?.content === "string"
|
|
108
|
+
? lastUserMsg.content
|
|
109
|
+
: Array.isArray(lastUserMsg?.content)
|
|
110
|
+
? lastUserMsg.content
|
|
111
|
+
.filter((c) => c.type === "text")
|
|
112
|
+
.map((c) => c.text)
|
|
113
|
+
.join("\n")
|
|
114
|
+
: "";
|
|
115
|
+
if (userText.length < 30)
|
|
116
|
+
return; // Skip short messages
|
|
117
|
+
const risk = await computeRisk(userText, ctx);
|
|
118
|
+
// Note: We don't gate on risk.score here - VbC can occur even with neutral user input.
|
|
119
|
+
// User risk is used as an additional signal for severity reporting below.
|
|
120
|
+
log.info(`User sycophancy risk: ${risk.score.toFixed(2)} (${risk.tactics.join(", ") || "none"})`);
|
|
121
|
+
const assistantMessages = messages.filter((m) => m.role === "assistant");
|
|
122
|
+
const lastAssistantMsg = assistantMessages[assistantMessages.length - 1];
|
|
123
|
+
const responseText = typeof lastAssistantMsg?.content === "string"
|
|
124
|
+
? lastAssistantMsg.content
|
|
125
|
+
: Array.isArray(lastAssistantMsg?.content)
|
|
126
|
+
? lastAssistantMsg.content
|
|
127
|
+
.filter((c) => c.type === "text")
|
|
128
|
+
.map((c) => c.text)
|
|
129
|
+
.join("\n")
|
|
130
|
+
: "";
|
|
131
|
+
if (responseText.length < MIN_TEXT_LENGTH_FOR_CLASSIFY)
|
|
132
|
+
return;
|
|
133
|
+
// Replaces expensive 30s LLM auditor call with fast pattern matching
|
|
134
|
+
const vbcResult = await detectVbC(responseText, ctx);
|
|
135
|
+
if (!vbcResult.detected)
|
|
136
|
+
return; // No VbC found - no correction needed
|
|
137
|
+
log.info(`VbC detected: severity=${vbcResult.severity}, score=${vbcResult.score}`);
|
|
138
|
+
state.detectionCount++;
|
|
139
|
+
// Publish the already-computed acceptance verdict for the over-correction
|
|
140
|
+
// gate (handlers/over-correction-gate.ts): the gate reads this seam at
|
|
141
|
+
// tool-call time and treats a signal older than its recency window (or
|
|
142
|
+
// from another session) as cold. Additive only — detection is unchanged.
|
|
143
|
+
setAcceptanceSignal({
|
|
144
|
+
atMs: Date.now(),
|
|
145
|
+
score: vbcResult.score,
|
|
146
|
+
sessionId: getSessionIdSafe(ctx),
|
|
147
|
+
});
|
|
148
|
+
const turnSinceLastWhisper = state.turnCount - state.lastWhisperTurn;
|
|
149
|
+
if (turnSinceLastWhisper >= COOLDOWN_TURNS && state.whisperCount < MAX_WHISPERS_PER_SESSION) {
|
|
150
|
+
sendEnforcementWhisper(pi, ctx, `VbC correction: ${vbcResult.correction_hint}`);
|
|
151
|
+
state.whisperCount++;
|
|
152
|
+
state.lastWhisperTurn = state.turnCount;
|
|
153
|
+
}
|
|
154
|
+
const combinedSeverity = risk.score >= RISK_THRESHOLD
|
|
155
|
+
? risk.severity === "high" || vbcResult.severity === "high"
|
|
156
|
+
? "warn"
|
|
157
|
+
: "info"
|
|
158
|
+
: vbcResult.severity === "high"
|
|
159
|
+
? "warn"
|
|
160
|
+
: "info";
|
|
161
|
+
emitSignal(ctx, "sycophancy", "detected", combinedSeverity, false, {
|
|
162
|
+
userRisk: risk.score,
|
|
163
|
+
userTactics: risk.tactics,
|
|
164
|
+
vbcScore: vbcResult.score,
|
|
165
|
+
vbcSeverity: vbcResult.severity,
|
|
166
|
+
// Surface classifier-down state so downstream consumers (analytics,
|
|
167
|
+
// logging) can see when the sycophancy monitor was offline. Same
|
|
168
|
+
// anti-pattern fix as topic-drift.
|
|
169
|
+
userRiskClassifierDown: risk.classifierDown ?? false,
|
|
170
|
+
});
|
|
171
|
+
// If the user-risk classifier is down, emit a separate signal so the
|
|
172
|
+
// operator knows the monitor is offline. Don't pretend the absence
|
|
173
|
+
// of "yes" votes means there's no sycophancy.
|
|
174
|
+
if (risk.classifierDown) {
|
|
175
|
+
emitSignal(ctx, "sycophancy", "user_risk_classifier_down", "warn", false, {
|
|
176
|
+
reason: "sycophancy-tactics classifier unavailable",
|
|
177
|
+
});
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
export default function sycophancyDetector() {
|
|
181
|
+
return function register(pi) {
|
|
182
|
+
pi.on(MESSAGE_END, async (event, ctx) => {
|
|
183
|
+
try {
|
|
184
|
+
if (event.message?.role !== "assistant")
|
|
185
|
+
return;
|
|
186
|
+
// Skip short responses (tool call results, etc.)
|
|
187
|
+
const textContent = (event.message.content ?? [])
|
|
188
|
+
.filter((c) => c.type === "text")
|
|
189
|
+
.map((c) => c.text)
|
|
190
|
+
.join("\n");
|
|
191
|
+
if (textContent.length < MIN_TEXT_LENGTH_FOR_CLASSIFY)
|
|
192
|
+
return;
|
|
193
|
+
const state = getState(ctx);
|
|
194
|
+
await handleSycophancy(pi, ctx, state);
|
|
195
|
+
}
|
|
196
|
+
catch (err) {
|
|
197
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
198
|
+
log.error(`[sycophancy] message_end handler error: ${msg}`);
|
|
199
|
+
}
|
|
200
|
+
});
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Topic Drift Detector.
|
|
3
|
+
*
|
|
4
|
+
* Detects when agent output diverges from the original user request.
|
|
5
|
+
* Uses consolidated single-LLM-call critique returning coverage,
|
|
6
|
+
* divergence, and completeness in one structured JSON response.
|
|
7
|
+
*
|
|
8
|
+
* Model tier strategy (in consolidatedTopicCritique):
|
|
9
|
+
* session -> utility -> max-power -> conservative defaults.
|
|
10
|
+
*
|
|
11
|
+
* No separate parallel fallback: the consolidated call covers the same
|
|
12
|
+
* model tiers and produces equivalent defaults when all tiers are down.
|
|
13
|
+
*/
|
|
14
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
15
|
+
interface DriftState {
|
|
16
|
+
/** The original request text (used by critics directly - no token extraction needed). */
|
|
17
|
+
originalRequest: string;
|
|
18
|
+
/** History of drift checks for observability. */
|
|
19
|
+
driftHistory: DriftRecord[];
|
|
20
|
+
/** Turns since last anchor reset. */
|
|
21
|
+
turnsSinceAnchor: number;
|
|
22
|
+
}
|
|
23
|
+
interface DriftRecord {
|
|
24
|
+
turn: number;
|
|
25
|
+
similarity: number;
|
|
26
|
+
drifted: boolean;
|
|
27
|
+
missingCount: number;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Legacy synchronous detectTopicDrift signature.
|
|
31
|
+
*
|
|
32
|
+
* Preserved for backward compatibility - uses heuristic defaults when
|
|
33
|
+
* called without an ExtensionContext. Prefer the async critic-based
|
|
34
|
+
* detection in event handlers where ctx is available.
|
|
35
|
+
*
|
|
36
|
+
* @deprecated Use the async variant with ExtensionContext when available.
|
|
37
|
+
*/
|
|
38
|
+
export declare function detectTopicDrift(_sessionId: string, output: string, state: DriftState, threshold?: number): {
|
|
39
|
+
drifted: boolean;
|
|
40
|
+
similarity: number;
|
|
41
|
+
missingAnchors: string[];
|
|
42
|
+
shouldReset: boolean;
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* Reset drift state with a new request.
|
|
46
|
+
* Stores the raw request text (no token extraction - critics use it directly).
|
|
47
|
+
*/
|
|
48
|
+
export declare function resetAnchors(state: DriftState, newRequest: string): void;
|
|
49
|
+
export default function topicDriftExtension(pi: ExtensionAPI): void;
|
|
50
|
+
export {};
|
|
51
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,346 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Topic Drift Detector.
|
|
3
|
+
*
|
|
4
|
+
* Detects when agent output diverges from the original user request.
|
|
5
|
+
* Uses consolidated single-LLM-call critique returning coverage,
|
|
6
|
+
* divergence, and completeness in one structured JSON response.
|
|
7
|
+
*
|
|
8
|
+
* Model tier strategy (in consolidatedTopicCritique):
|
|
9
|
+
* session -> utility -> max-power -> conservative defaults.
|
|
10
|
+
*
|
|
11
|
+
* No separate parallel fallback: the consolidated call covers the same
|
|
12
|
+
* model tiers and produces equivalent defaults when all tiers are down.
|
|
13
|
+
*/
|
|
14
|
+
import { INPUT } from "../../../lib/core/event-names.js";
|
|
15
|
+
import { Type } from "typebox";
|
|
16
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
17
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
18
|
+
import { onEvent } from "../../../lib/events/event-types.js";
|
|
19
|
+
import { ANCHOR_TURNS_BEFORE_RESET } from "../../../lib/constants/session-thresholds.js";
|
|
20
|
+
import { consolidatedTopicCritique } from "../../../lib/detection/consolidated-topic-critic.js";
|
|
21
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
22
|
+
import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
|
|
23
|
+
const log = createLogger("topic-drift");
|
|
24
|
+
const DRIFT_THRESHOLD = 0.5;
|
|
25
|
+
// ANCHOR_TURNS_BEFORE_RESET comes from lib/constants/session-thresholds.ts —
|
|
26
|
+
// the single source of truth.
|
|
27
|
+
// Core logic (consolidated critic)
|
|
28
|
+
/**
|
|
29
|
+
* Detect topic drift using consolidated single-LLM-call critique.
|
|
30
|
+
*
|
|
31
|
+
* Uses a single LLM call returning structured JSON with all three
|
|
32
|
+
* verdicts (coverage, divergence, completeness). No 3-parallel
|
|
33
|
+
* fallback needed because the consolidated call already tries all
|
|
34
|
+
* available model tiers (session, utility, max-power) before
|
|
35
|
+
* falling back to conservative defaults. The one edge case — a
|
|
36
|
+
* transient error on the consolidated call itself — is handled by
|
|
37
|
+
* the call's own tier retry; no information is lost.
|
|
38
|
+
*
|
|
39
|
+
* Consensus: 2/3 negative signals -> drift confirmed.
|
|
40
|
+
*
|
|
41
|
+
* @param ctx - Extension context (for classify() LLM calls)
|
|
42
|
+
* @param original - The original user request
|
|
43
|
+
* @param output - The agent's response text
|
|
44
|
+
* @returns drift verdict with similarity and missing topics
|
|
45
|
+
*/
|
|
46
|
+
async function detectDriftWithCritics(ctx, original, output) {
|
|
47
|
+
// Truncate long texts to keep prompt tokens reasonable
|
|
48
|
+
const truncOriginal = original.length > 2000 ? original.slice(0, 2000) + "..." : original;
|
|
49
|
+
const truncOutput = output.length > 2000 ? output.slice(0, 2000) + "..." : output;
|
|
50
|
+
if (truncOutput.length < 30) {
|
|
51
|
+
return { drifted: false, similarity: 1.0, missingAnchors: [] };
|
|
52
|
+
}
|
|
53
|
+
try {
|
|
54
|
+
const consolidated = await consolidatedTopicCritique(truncOriginal, truncOutput, ctx);
|
|
55
|
+
// Derive verdicts regardless of classifierDown state — the
|
|
56
|
+
// consolidated call returns reasonable defaults even when down.
|
|
57
|
+
const coverageBad = !consolidated.coverage;
|
|
58
|
+
const diverged = consolidated.divergence;
|
|
59
|
+
const incomplete = !consolidated.completeness;
|
|
60
|
+
const negativeVotes = [coverageBad, diverged, incomplete].filter(Boolean).length;
|
|
61
|
+
const drifted = negativeVotes >= 2;
|
|
62
|
+
const similarity = drifted ? 0.3 : 0.8;
|
|
63
|
+
const missingAnchors = [];
|
|
64
|
+
if (drifted) {
|
|
65
|
+
const clues = [];
|
|
66
|
+
if (coverageBad)
|
|
67
|
+
clues.push("coverage");
|
|
68
|
+
if (diverged)
|
|
69
|
+
clues.push("divergence");
|
|
70
|
+
if (incomplete)
|
|
71
|
+
clues.push("incomplete");
|
|
72
|
+
missingAnchors.push(...clues);
|
|
73
|
+
}
|
|
74
|
+
log.debug(`[topic-drift] Consolidated: coverage=${consolidated.coverage}, ` +
|
|
75
|
+
`divergence=${consolidated.divergence}, completeness=${consolidated.completeness} ` +
|
|
76
|
+
`-> drifted=${drifted} classifierDown=${consolidated.classifierDown}`);
|
|
77
|
+
return {
|
|
78
|
+
drifted,
|
|
79
|
+
similarity,
|
|
80
|
+
missingAnchors,
|
|
81
|
+
classifierDown: consolidated.classifierDown,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
catch (err) {
|
|
85
|
+
log.warn(`[topic-drift] Consolidated call failed: ${err}`);
|
|
86
|
+
return { drifted: false, similarity: 1.0, missingAnchors: [], classifierDown: true };
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
// Synchronous detectTopicDrift (backward-compat wrapper)
|
|
90
|
+
// Callers that pass a DriftState with originalRequest get a best-effort sync
|
|
91
|
+
// result. For full accuracy, use the async detectDriftWithCritics above.
|
|
92
|
+
/**
|
|
93
|
+
* Legacy synchronous detectTopicDrift signature.
|
|
94
|
+
*
|
|
95
|
+
* Preserved for backward compatibility - uses heuristic defaults when
|
|
96
|
+
* called without an ExtensionContext. Prefer the async critic-based
|
|
97
|
+
* detection in event handlers where ctx is available.
|
|
98
|
+
*
|
|
99
|
+
* @deprecated Use the async variant with ExtensionContext when available.
|
|
100
|
+
*/
|
|
101
|
+
export function detectTopicDrift(_sessionId, output, state, threshold = DRIFT_THRESHOLD) {
|
|
102
|
+
const outputLen = output.length;
|
|
103
|
+
// Conservative heuristic: long output is probably on-topic, short output might not be
|
|
104
|
+
const similarity = outputLen > 200 ? 0.8 : outputLen > 50 ? 0.6 : 0.4;
|
|
105
|
+
const drifted = similarity < threshold;
|
|
106
|
+
const missingAnchors = drifted ? ["topic mismatch"] : [];
|
|
107
|
+
// Only reset when we've had a long session with no meaningful output
|
|
108
|
+
const shouldReset = state.turnsSinceAnchor >= ANCHOR_TURNS_BEFORE_RESET && outputLen < 100;
|
|
109
|
+
state.driftHistory.push({
|
|
110
|
+
turn: state.turnsSinceAnchor,
|
|
111
|
+
similarity,
|
|
112
|
+
drifted,
|
|
113
|
+
missingCount: missingAnchors.length,
|
|
114
|
+
});
|
|
115
|
+
if (state.driftHistory.length > 10) {
|
|
116
|
+
state.driftHistory = state.driftHistory.slice(-10);
|
|
117
|
+
}
|
|
118
|
+
state.turnsSinceAnchor++;
|
|
119
|
+
return { drifted, similarity, missingAnchors, shouldReset };
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Reset drift state with a new request.
|
|
123
|
+
* Stores the raw request text (no token extraction - critics use it directly).
|
|
124
|
+
*/
|
|
125
|
+
export function resetAnchors(state, newRequest) {
|
|
126
|
+
state.originalRequest = newRequest;
|
|
127
|
+
state.turnsSinceAnchor = 0;
|
|
128
|
+
state.driftHistory = [];
|
|
129
|
+
log.info(`[topic-drift] Anchors reset: "${newRequest.slice(0, 60)}..."`);
|
|
130
|
+
}
|
|
131
|
+
function createDriftState() {
|
|
132
|
+
return { originalRequest: "", driftHistory: [], turnsSinceAnchor: 0 };
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Flatten a `tool_result` event to its text. The event carries
|
|
136
|
+
* `content: (TextContent | ImageContent)[]`; a result with no text part
|
|
137
|
+
* (image, binary, structured data) returns "" so callers skip drift
|
|
138
|
+
* detection via the `output.length < 50` early-exit instead of feeding a
|
|
139
|
+
* stringified blob to the LLM classifiers as "the agent's response".
|
|
140
|
+
*/
|
|
141
|
+
function extractOutputText(event) {
|
|
142
|
+
const content = event?.content;
|
|
143
|
+
if (!Array.isArray(content))
|
|
144
|
+
return "";
|
|
145
|
+
const parts = [];
|
|
146
|
+
for (const part of content) {
|
|
147
|
+
if (part?.type === "text" && typeof part.text === "string") {
|
|
148
|
+
parts.push(part.text);
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
return parts.join("\n");
|
|
152
|
+
}
|
|
153
|
+
// topic_drift schema: one tool, one schema — action=check tests whether the
|
|
154
|
+
// output matches the original request; action=reset re-anchors to a new
|
|
155
|
+
// request or the current context.
|
|
156
|
+
const topicDriftSchema = Type.Object({
|
|
157
|
+
action: Type.Union([Type.Literal("check"), Type.Literal("reset")], {
|
|
158
|
+
description: "Action: check | reset",
|
|
159
|
+
}),
|
|
160
|
+
output: Type.Optional(Type.String({ description: "Output text to check (action=check)" })),
|
|
161
|
+
newRequest: Type.Optional(Type.String({ description: "New request to extract anchors from (action=reset)" })),
|
|
162
|
+
});
|
|
163
|
+
export default function topicDriftExtension(pi) {
|
|
164
|
+
log.info("Topic drift detector registering (consolidated critic)");
|
|
165
|
+
// Anchor seeding: pi-core has no user_message extension event; the user's
|
|
166
|
+
// typed text arrives on `input` ({ text }) which fires for both idle
|
|
167
|
+
// submits and queued prompts (the runner's emitInput).
|
|
168
|
+
onEvent(pi, INPUT, (event, ctx) => {
|
|
169
|
+
try {
|
|
170
|
+
const state = getExtensionState(ctx, "topic-drift", createDriftState);
|
|
171
|
+
const message = typeof event?.text === "string" ? event.text : "";
|
|
172
|
+
if (message.length > 20) {
|
|
173
|
+
resetAnchors(state, message);
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
catch (err) {
|
|
177
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
178
|
+
log.error(`[topic-drift] input handler error: ${msg}`);
|
|
179
|
+
}
|
|
180
|
+
});
|
|
181
|
+
onEvent(pi, "tool_result", async (event, ctx) => {
|
|
182
|
+
try {
|
|
183
|
+
const state = getExtensionState(ctx, "topic-drift", createDriftState);
|
|
184
|
+
if (!state.originalRequest)
|
|
185
|
+
return;
|
|
186
|
+
const output = extractOutputText(event);
|
|
187
|
+
if (output.length < 50)
|
|
188
|
+
return;
|
|
189
|
+
const result = await detectDriftWithCritics(ctx, state.originalRequest, output);
|
|
190
|
+
// Surface the "drift detector offline" case as a soft whisper
|
|
191
|
+
// so the agent knows the monitor is degraded. Same pattern as
|
|
192
|
+
// the lib version.
|
|
193
|
+
if (result.classifierDown) {
|
|
194
|
+
// sendTrackedMessage, not ctx.whisper: the latter bypasses the
|
|
195
|
+
// per-source flood cap and injection tracking. The text + customType
|
|
196
|
+
// are identical so downstream consumers (e.g. the TUI) see the same
|
|
197
|
+
// format.
|
|
198
|
+
try {
|
|
199
|
+
sendTrackedMessage(pi, {
|
|
200
|
+
customType: "topic-drift",
|
|
201
|
+
content: [
|
|
202
|
+
{
|
|
203
|
+
type: "text",
|
|
204
|
+
text: `Topic drift monitor is offline (classifier unavailable this turn). ` +
|
|
205
|
+
`If you suspect you're drifting, self-check against the original request: ` +
|
|
206
|
+
`"${state.originalRequest.substring(0, 80)}..."`,
|
|
207
|
+
},
|
|
208
|
+
],
|
|
209
|
+
display: true,
|
|
210
|
+
details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "topic-drift/offline" },
|
|
211
|
+
}, { delivery: "live", deliverAs: "steer" }, { type: "context", source: "topic-drift/offline" });
|
|
212
|
+
}
|
|
213
|
+
catch (err) {
|
|
214
|
+
log.warn(`[topic-drift] offline whisper failed: ${err}`);
|
|
215
|
+
}
|
|
216
|
+
return;
|
|
217
|
+
}
|
|
218
|
+
if (result.drifted && state.driftHistory.length > 1) {
|
|
219
|
+
const recent = state.driftHistory.slice(-3);
|
|
220
|
+
const allRecentDrifted = recent.every((r) => r.drifted);
|
|
221
|
+
if (allRecentDrifted && result.similarity < 0.5) {
|
|
222
|
+
const missing = result.missingAnchors.slice(0, 5).join(", ");
|
|
223
|
+
try {
|
|
224
|
+
sendTrackedMessage(pi, {
|
|
225
|
+
customType: "topic-drift",
|
|
226
|
+
content: [
|
|
227
|
+
{
|
|
228
|
+
type: "text",
|
|
229
|
+
text: `Your response seems to cover different ground than the original request. ` +
|
|
230
|
+
`Signal: ${missing || "topic mismatch"}. ` +
|
|
231
|
+
`Original request: "${state.originalRequest.substring(0, 80)}..."`,
|
|
232
|
+
},
|
|
233
|
+
],
|
|
234
|
+
display: true,
|
|
235
|
+
details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "topic-drift/drift-detected" },
|
|
236
|
+
}, { delivery: "live", deliverAs: "steer" }, { type: "context", source: "topic-drift/drift-detected" });
|
|
237
|
+
}
|
|
238
|
+
catch (err) {
|
|
239
|
+
log.warn(`[topic-drift] drift whisper failed: ${err}`);
|
|
240
|
+
}
|
|
241
|
+
log.info(`[topic-drift] Drift: similarity=${result.similarity.toFixed(2)}, ` +
|
|
242
|
+
`missing=${result.missingAnchors.length}`);
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
catch (err) {
|
|
247
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
248
|
+
log.error(`[topic-drift] tool_result handler error: ${msg}`);
|
|
249
|
+
}
|
|
250
|
+
});
|
|
251
|
+
function createTopicDriftTool() {
|
|
252
|
+
return {
|
|
253
|
+
name: "topic_drift",
|
|
254
|
+
exposure: "deferred",
|
|
255
|
+
label: "Topic Drift",
|
|
256
|
+
promptSnippet: "Check output for topic drift or reset anchors",
|
|
257
|
+
description: "Check if output matches the original user request, or reset the topic anchors. " +
|
|
258
|
+
"Use action=check with output before responding to prevent drift. " +
|
|
259
|
+
"Use action=reset with newRequest (or no params) to re-anchor to a new task.",
|
|
260
|
+
parameters: topicDriftSchema,
|
|
261
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
|
|
262
|
+
try {
|
|
263
|
+
switch (params?.action) {
|
|
264
|
+
case "check": {
|
|
265
|
+
const state = getExtensionState(ctx, "topic-drift", createDriftState);
|
|
266
|
+
const output = params.output ?? "";
|
|
267
|
+
let drifted = false;
|
|
268
|
+
let similarity = 1.0;
|
|
269
|
+
let missingAnchors = [];
|
|
270
|
+
let classifierDown = false;
|
|
271
|
+
if (ctx && state.originalRequest) {
|
|
272
|
+
const critResult = await detectDriftWithCritics(ctx, state.originalRequest, output);
|
|
273
|
+
drifted = critResult.drifted;
|
|
274
|
+
similarity = critResult.similarity;
|
|
275
|
+
missingAnchors = critResult.missingAnchors;
|
|
276
|
+
classifierDown = critResult.classifierDown ?? false;
|
|
277
|
+
}
|
|
278
|
+
else {
|
|
279
|
+
const syncResult = detectTopicDrift("check", output, state);
|
|
280
|
+
drifted = syncResult.drifted;
|
|
281
|
+
similarity = syncResult.similarity;
|
|
282
|
+
missingAnchors = syncResult.missingAnchors;
|
|
283
|
+
}
|
|
284
|
+
const details = {
|
|
285
|
+
drifted,
|
|
286
|
+
similarity: Math.round(similarity * 100) / 100,
|
|
287
|
+
missingAnchors,
|
|
288
|
+
originalRequest: state.originalRequest,
|
|
289
|
+
driftHistory: state.driftHistory.slice(-5),
|
|
290
|
+
classifierDown,
|
|
291
|
+
recommendations: drifted
|
|
292
|
+
? [
|
|
293
|
+
`Response may have drifted from: "${state.originalRequest.slice(0, 60)}..."`,
|
|
294
|
+
"Verify your response addresses the core request.",
|
|
295
|
+
]
|
|
296
|
+
: classifierDown
|
|
297
|
+
? [
|
|
298
|
+
"Topic drift check is offline (classifier unavailable this turn).",
|
|
299
|
+
"Manually verify your response addresses the original request.",
|
|
300
|
+
]
|
|
301
|
+
: [],
|
|
302
|
+
};
|
|
303
|
+
// Surface the "drift detector offline" case in the text so
|
|
304
|
+
// the agent doesn't read 'No topic drift' and think the
|
|
305
|
+
// check ran normally. Same anti-pattern fix as the lib
|
|
306
|
+
// version.
|
|
307
|
+
const text = classifierDown
|
|
308
|
+
? `Topic drift check unavailable this turn (classifier offline). Run /logs level info for the underlying error.`
|
|
309
|
+
: drifted
|
|
310
|
+
? `Topic drift detected (similarity: ${details.similarity}). Signals: ${missingAnchors.slice(0, 5).join(", ") || "topic mismatch"}.`
|
|
311
|
+
: `No topic drift (similarity: ${details.similarity}).`;
|
|
312
|
+
return { content: [{ type: "text", text }], details };
|
|
313
|
+
}
|
|
314
|
+
case "reset": {
|
|
315
|
+
const state = getExtensionState(ctx, "topic-drift", createDriftState);
|
|
316
|
+
const request = params.newRequest ?? state.originalRequest;
|
|
317
|
+
resetAnchors(state, request);
|
|
318
|
+
return {
|
|
319
|
+
content: [
|
|
320
|
+
{
|
|
321
|
+
type: "text",
|
|
322
|
+
text: `Topic anchors reset to: "${request.slice(0, 60)}..."`,
|
|
323
|
+
},
|
|
324
|
+
],
|
|
325
|
+
details: { success: true, originalRequest: state.originalRequest },
|
|
326
|
+
};
|
|
327
|
+
}
|
|
328
|
+
default:
|
|
329
|
+
throw new Error(`Unknown topic_drift action: ${params?.action}. Use: check, reset.`);
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
catch (err) {
|
|
333
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
334
|
+
log.error(`topic_drift failed: ${msg}`);
|
|
335
|
+
return {
|
|
336
|
+
content: [{ type: "text", text: `Error: ${msg}` }],
|
|
337
|
+
details: { error: msg, action: params?.action },
|
|
338
|
+
};
|
|
339
|
+
}
|
|
340
|
+
},
|
|
341
|
+
};
|
|
342
|
+
}
|
|
343
|
+
pi.registerTool(createTopicDriftTool());
|
|
344
|
+
log.info("Topic drift detector registered: topic_drift (check + reset actions)");
|
|
345
|
+
}
|
|
346
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn Outcome Classification - Repetitive Loop Detection (triple-critic)
|
|
3
|
+
*
|
|
4
|
+
* Detects when the agent is stuck in a repetitive loop using classify() with
|
|
5
|
+
* CRITICS.toolLoopDetected. Three-tier fallback:
|
|
6
|
+
* Tier 1: toolLoopFallback (heuristic token/error repetition)
|
|
7
|
+
* Tier 2: utility model (if configured)
|
|
8
|
+
* Tier 3: session model (always available)
|
|
9
|
+
*
|
|
10
|
+
* When a loop is confirmed, sends a strategic steer suggesting a different
|
|
11
|
+
* approach or re-plan. Only fires once per loop type per detection window.
|
|
12
|
+
*
|
|
13
|
+
* Replaces the previous implementation with three separate heuristic
|
|
14
|
+
* functions (detectToolRepetition, detectErrorEcho, detectFileChurn)
|
|
15
|
+
* - now consolidated into a single classify() call with structured history.
|
|
16
|
+
*/
|
|
17
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
18
|
+
/**
|
|
19
|
+
* Detect if the agent is in a repetitive loop using triple-critic classification.
|
|
20
|
+
*
|
|
21
|
+
* Formats the recent turn history as a structured tool-sequence description
|
|
22
|
+
* and passes it to classify() with CRITICS.toolLoopDetected.
|
|
23
|
+
* The heuristic fallback (toolLoopFallback) handles the LLM-unavailable case.
|
|
24
|
+
*/
|
|
25
|
+
/**
|
|
26
|
+
* Sentinel return value when the loop detector is offline (the LLM
|
|
27
|
+
* classify() call failed at all tiers). Distinct from the null
|
|
28
|
+
* "not in a loop" return so the consumer can branch on it.
|
|
29
|
+
*
|
|
30
|
+
* Same anti-pattern as topic-drift and sycophancy: when the classifier is
|
|
31
|
+
* down, never silently default to "no problem."
|
|
32
|
+
*/
|
|
33
|
+
export declare const LOOP_DETECTOR_OFFLINE: "__loop_detector_offline__";
|
|
34
|
+
export default function turnOutcomeExtension(pi: ExtensionAPI): void;
|
|
35
|
+
//# sourceMappingURL=index.d.ts.map
|