pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raw-payload hygiene for the internal LLM-call path.
|
|
3
|
+
*
|
|
4
|
+
* callLlm() hands provider error text back to every caller, and callers print
|
|
5
|
+
* or store it (text-classifier's tier-failure warn, verification-judge,
|
|
6
|
+
* llm-call's own logs). When the provider's edge answers with
|
|
7
|
+
* an HTML block page — the Cloudflare-style "Blocked" family, a full document
|
|
8
|
+
* with base64 font assets — that text becomes a ~12KB dump: observed
|
|
9
|
+
* One 403 produced a raw `<!DOCTYPE html>…` warning line per retry
|
|
10
|
+
* attempt, and pi-core stores returned error text where it rides into later
|
|
11
|
+
* request bodies.
|
|
12
|
+
*
|
|
13
|
+
* sanitizeLlmErrorForLog() is the single sanitizer for that boundary. It never
|
|
14
|
+
* touches classification inputs: callLlm classifies, and feeds the key ring
|
|
15
|
+
* with, the RAW text; only the log/return copy is collapsed here.
|
|
16
|
+
*
|
|
17
|
+
* sanitizeLlmRequestText() is the outbound twin: internal call bodies are
|
|
18
|
+
* redacted before they reach the provider. Same class of payloads — a page
|
|
19
|
+
* fragment dumped into a prompt can trigger the same edge/WAF block the
|
|
20
|
+
* response sanitizer exists to absorb ("no huge file dumps, no raw
|
|
21
|
+
* payloads").
|
|
22
|
+
*
|
|
23
|
+
* Why the logic is duplicated from providers rather than shared: providers is
|
|
24
|
+
* a standalone package with no import path into core (and core must not grow
|
|
25
|
+
* a dependency on a provider package), so there is no module seam. The
|
|
26
|
+
* duplicated part is the minimal edge-marker list, page-span detection and the
|
|
27
|
+
* edge filter's request trigger; the two sides serve different boundaries
|
|
28
|
+
* (providers classifies RESPONSES and rewrites the main loop's payloads, core
|
|
29
|
+
* sanitizes REQUESTS and its own logs).
|
|
30
|
+
*
|
|
31
|
+
* Invariants:
|
|
32
|
+
* - An embedded HTML page collapses to ONE line: status + first prose
|
|
33
|
+
* excerpt (≤120 chars; tag, style, script and comment contents stripped)
|
|
34
|
+
* + content type + size — e.g. `403 Blocked (text/html, ~12KB)`.
|
|
35
|
+
* - Base64-class runs are replaced with a length-only marker.
|
|
36
|
+
* - The edge filter's request trigger (a dot, the `execSync` identifier, an
|
|
37
|
+
* open paren) gains a space before the paren: neutralized wherever it
|
|
38
|
+
* sits, never deleted, so the text stays readable and valid.
|
|
39
|
+
* - Everything else passes through untouched, capped at LOG_MAX_CHARS so no
|
|
40
|
+
* single log line can carry an oversized body.
|
|
41
|
+
*
|
|
42
|
+
* Coverage boundary: this file covers the LLM request path (outbound body
|
|
43
|
+
* redaction) and the main-loop error display (inbound error collapse). It
|
|
44
|
+
* does NOT cover compaction summarization or branch summarization — those
|
|
45
|
+
* paths call the LLM directly via core's summarization pipeline, which has
|
|
46
|
+
* its own response handling and does not route through callLlm's
|
|
47
|
+
* error-sanitization path.
|
|
48
|
+
*/
|
|
49
|
+
/** A page open: the marker that turns the rest of the text into a body. */
|
|
50
|
+
const HTML_START_PATTERN = /<!doctype\s+html|<html[\s>]/i;
|
|
51
|
+
/** Status code at the head of a provider error ("403 …", "HTTP 502 …"). */
|
|
52
|
+
const HTTP_STATUS_PATTERN = /\b([45]\d{2})\b/;
|
|
53
|
+
/** Markup whose CONTENT is never prose: stripped together with the tags. */
|
|
54
|
+
const CONTENT_BLOCK_PATTERN = /<(script|style)\b[^>]*>[\s\S]*?<\/\1>/gi;
|
|
55
|
+
/** Same blocks left unclosed by a truncated dump: strip to the end. */
|
|
56
|
+
const UNCLOSED_CONTENT_BLOCK_PATTERN = /<(script|style)\b[^>]*>[\s\S]*$/gi;
|
|
57
|
+
const COMMENT_PATTERN = /<!--[\s\S]*?-->/g;
|
|
58
|
+
const TAG_PATTERN = /<[^>]*>/g;
|
|
59
|
+
/**
|
|
60
|
+
* A base64-class run: ≥1024 chars from the base64 alphabet with no spaces.
|
|
61
|
+
* Prose cannot produce a run this long, so any match is an encoded asset or
|
|
62
|
+
* data URL — exactly what must not reach the log.
|
|
63
|
+
*/
|
|
64
|
+
const BASE64_RUN_PATTERN = /[A-Za-z0-9+/]{1024,}={0,2}/g;
|
|
65
|
+
/** Excerpt cap (matches the log contract: status + ~120 chars stripped). */
|
|
66
|
+
const EXCERPT_MAX_CHARS = 120;
|
|
67
|
+
/** Hard cap for any single sanitized log line. */
|
|
68
|
+
const LOG_MAX_CHARS = 2000;
|
|
69
|
+
/** One-line size label from a character count (~12KB for a 12KB body). */
|
|
70
|
+
function humanSize(chars) {
|
|
71
|
+
if (chars >= 1024)
|
|
72
|
+
return `~${Math.round(chars / 1024)}KB`;
|
|
73
|
+
return `~${chars}B`;
|
|
74
|
+
}
|
|
75
|
+
/** Replace base64-class runs with a length-only marker. */
|
|
76
|
+
function redactBase64Runs(text) {
|
|
77
|
+
return text.replace(BASE64_RUN_PATTERN, (run) => `[base64 redacted, ${run.length} chars]`);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* First readable prose from an HTML body: script/style/comment contents and
|
|
81
|
+
* all tags removed, whitespace collapsed, base64 redacted, capped. Empty when
|
|
82
|
+
* the page carries no prose (markup + assets only) — callers then omit the
|
|
83
|
+
* excerpt rather than emit an empty slot.
|
|
84
|
+
*/
|
|
85
|
+
function excerptFromHtml(body) {
|
|
86
|
+
const stripped = body
|
|
87
|
+
.replace(CONTENT_BLOCK_PATTERN, " ")
|
|
88
|
+
.replace(UNCLOSED_CONTENT_BLOCK_PATTERN, " ")
|
|
89
|
+
.replace(COMMENT_PATTERN, " ")
|
|
90
|
+
.replace(TAG_PATTERN, " ")
|
|
91
|
+
.replace(/ /gi, " ")
|
|
92
|
+
.replace(/&/gi, "&")
|
|
93
|
+
.replace(/\s+/g, " ")
|
|
94
|
+
.trim();
|
|
95
|
+
const redacted = redactBase64Runs(stripped);
|
|
96
|
+
if (redacted.length <= EXCERPT_MAX_CHARS)
|
|
97
|
+
return redacted;
|
|
98
|
+
return `${redacted.slice(0, EXCERPT_MAX_CHARS).trimEnd()}…`;
|
|
99
|
+
}
|
|
100
|
+
/** Cap a sanitized line at LOG_MAX_CHARS with a visible truncation marker. */
|
|
101
|
+
function capForLog(text) {
|
|
102
|
+
if (text.length <= LOG_MAX_CHARS)
|
|
103
|
+
return text;
|
|
104
|
+
return `${text.slice(0, LOG_MAX_CHARS)} …[+${text.length - LOG_MAX_CHARS} chars]`;
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Collapse raw HTTP/page payloads in error text into a single safe log line.
|
|
108
|
+
* Pure; safe for any input. Identity for error text that carries no payload
|
|
109
|
+
* (the common case) apart from the LOG_MAX_CHARS cap.
|
|
110
|
+
*/
|
|
111
|
+
export function sanitizeLlmErrorForLog(raw) {
|
|
112
|
+
const text = String(raw ?? "");
|
|
113
|
+
if (!text)
|
|
114
|
+
return "";
|
|
115
|
+
const htmlAt = text.search(HTML_START_PATTERN);
|
|
116
|
+
if (htmlAt >= 0) {
|
|
117
|
+
const status = text.slice(0, htmlAt).match(HTTP_STATUS_PATTERN)?.[1];
|
|
118
|
+
const body = text.slice(htmlAt);
|
|
119
|
+
const excerpt = excerptFromHtml(body);
|
|
120
|
+
const head = [status, excerpt].filter(Boolean).join(" ");
|
|
121
|
+
// The body size is measured on the payload itself — the leading status
|
|
122
|
+
// token is not part of the page.
|
|
123
|
+
return `${head ? `${head} ` : ""}(text/html, ${humanSize(body.length)})`;
|
|
124
|
+
}
|
|
125
|
+
return capForLog(redactBase64Runs(text));
|
|
126
|
+
}
|
|
127
|
+
// ── Request-body hygiene ──────────────────────────────────────────
|
|
128
|
+
//
|
|
129
|
+
// The outbound copy of the same job. An internal call (classify, judge,
|
|
130
|
+
// summarize, polish) builds its prompt from session-derived text; when that
|
|
131
|
+
// text carries a previously dumped edge page or a raw asset, the request
|
|
132
|
+
// re-sends the exact payload class the edge/WAF block rejects — and pi-core
|
|
133
|
+
// stores the failed body, so the dump circulates. Redacting at the call seam
|
|
134
|
+
// is the one place every internal caller passes through.
|
|
135
|
+
/**
|
|
136
|
+
* Request-side asset threshold: 4KB. Larger than the log-side 1KB because a
|
|
137
|
+
* request body may legitimately carry short encoded snippets, while a 4KB
|
|
138
|
+
* run is always an asset dump an internal call cannot use.
|
|
139
|
+
*/
|
|
140
|
+
const REQUEST_BASE64_RUN_SOURCE = "[A-Za-z0-9+/]{4096,}={0,2}";
|
|
141
|
+
const REQUEST_BASE64_RUN_PATTERN = new RegExp(REQUEST_BASE64_RUN_SOURCE);
|
|
142
|
+
const REQUEST_BASE64_RUN_GLOBAL = new RegExp(REQUEST_BASE64_RUN_SOURCE, "g");
|
|
143
|
+
/**
|
|
144
|
+
* Discriminator subset of providers/ring-lifecycle.ts WAF_BLOCK_MARKERS — the
|
|
145
|
+
* structural markers ("<html", "text/html") are omitted because here they
|
|
146
|
+
* describe the page span itself, not the block. A page span is redacted when
|
|
147
|
+
* it carries one of these OR an asset-sized base64 run.
|
|
148
|
+
*/
|
|
149
|
+
const REQUEST_EDGE_MARKERS = [
|
|
150
|
+
"cf-ray",
|
|
151
|
+
"__cf",
|
|
152
|
+
"cloudflare",
|
|
153
|
+
"just a moment",
|
|
154
|
+
"challenge-platform",
|
|
155
|
+
"tetris challenge",
|
|
156
|
+
"attention required",
|
|
157
|
+
"request blocked",
|
|
158
|
+
"blocked by waf",
|
|
159
|
+
];
|
|
160
|
+
/**
|
|
161
|
+
* Single-string size above which a request payload is a file dump, not a
|
|
162
|
+
* prompt (mirrors providers/presend-guard.ts SHRINK_MIN_CHARS). The kept head
|
|
163
|
+
* preserves the opening context; the marker states the trim.
|
|
164
|
+
*/
|
|
165
|
+
const REQUEST_DUMP_MAX_CHARS = 262_144;
|
|
166
|
+
const REQUEST_DUMP_HEAD_CHARS = 2000;
|
|
167
|
+
/** First page span (`<!doctype html`/`<html` … `</html>` or EOF), if any. */
|
|
168
|
+
function findPageSpan(text) {
|
|
169
|
+
const start = text.search(HTML_START_PATTERN);
|
|
170
|
+
if (start < 0)
|
|
171
|
+
return null;
|
|
172
|
+
const closeAt = text.toLowerCase().lastIndexOf("</html>");
|
|
173
|
+
return { start, end: closeAt >= start ? closeAt + "</html>".length : text.length };
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Request-side edge-filter trigger: the gateway host rejects a body that
|
|
177
|
+
* carries a dot, the identifier below and an open paren; probed live, the block
|
|
178
|
+
* is not limited to a presumed inspection window, so the rewrite is
|
|
179
|
+
* offset-independent. The prompt text an internal call builds comes from the
|
|
180
|
+
* session, so one stored message is enough to block the call. The rewrite
|
|
181
|
+
* inserts a space before the paren: the line stays valid and readable, and the
|
|
182
|
+
* edge accepts it. Written as a character class so this file's own source does
|
|
183
|
+
* not carry the sequence.
|
|
184
|
+
*/
|
|
185
|
+
const REQUEST_EDGE_TRIGGER_PATTERN = /[.]execSync[(]/g;
|
|
186
|
+
const REQUEST_EDGE_TRIGGER_REPLACEMENT = ".execSync (";
|
|
187
|
+
/**
|
|
188
|
+
* Redact raw payloads from an internal-call request body before it is sent.
|
|
189
|
+
* Four rules, mirroring the outbound guard's stance ("no huge file dumps, no
|
|
190
|
+
* raw payloads"):
|
|
191
|
+
* 1. the edge filter's request trigger is neutralized in place (rewritten
|
|
192
|
+
* with a space, not removed) wherever it appears;
|
|
193
|
+
* 2. an edge/WAF page span (markers or an asset-sized base64 run inside it)
|
|
194
|
+
* becomes a length-only marker;
|
|
195
|
+
* 3. remaining asset-sized base64 runs become length-only markers;
|
|
196
|
+
* 4. a single string at/above 256KB keeps only its leading 2000 chars.
|
|
197
|
+
* Identity elsewhere — a benign HTML snippet is left alone.
|
|
198
|
+
*/
|
|
199
|
+
export function sanitizeLlmRequestText(text) {
|
|
200
|
+
if (!text)
|
|
201
|
+
return { text, redactions: 0 };
|
|
202
|
+
let out = text;
|
|
203
|
+
let redactions = 0;
|
|
204
|
+
// 1) The edge filter's own trigger. Offset-independent on purpose: a live
|
|
205
|
+
// probe drew the same block with the sequence at 96KB and at 128KB, so no
|
|
206
|
+
// offset can be treated as safe.
|
|
207
|
+
out = out.replace(REQUEST_EDGE_TRIGGER_PATTERN, () => {
|
|
208
|
+
redactions++;
|
|
209
|
+
return REQUEST_EDGE_TRIGGER_REPLACEMENT;
|
|
210
|
+
});
|
|
211
|
+
// 2) Page dumps. Loop so multiple pages in one prompt are all covered;
|
|
212
|
+
// a page without edge evidence stops the scan (conservative).
|
|
213
|
+
for (;;) {
|
|
214
|
+
const span = findPageSpan(out);
|
|
215
|
+
if (!span)
|
|
216
|
+
break;
|
|
217
|
+
const page = out.slice(span.start, span.end);
|
|
218
|
+
const lower = page.toLowerCase();
|
|
219
|
+
const hasEdgeMarker = REQUEST_EDGE_MARKERS.some((marker) => lower.includes(marker));
|
|
220
|
+
const hasAsset = REQUEST_BASE64_RUN_PATTERN.test(page);
|
|
221
|
+
if (!hasEdgeMarker && !hasAsset)
|
|
222
|
+
break;
|
|
223
|
+
const marker = `[redacted edge/WAF page fragment: ${page.length} chars]`;
|
|
224
|
+
out = `${out.slice(0, span.start)}${marker}${out.slice(span.end)}`;
|
|
225
|
+
redactions++;
|
|
226
|
+
}
|
|
227
|
+
// 3) Remaining asset-sized runs.
|
|
228
|
+
out = out.replace(REQUEST_BASE64_RUN_GLOBAL, (run) => {
|
|
229
|
+
redactions++;
|
|
230
|
+
return `[base64 redacted: ${run.length} chars]`;
|
|
231
|
+
});
|
|
232
|
+
// 4) Oversized single strings.
|
|
233
|
+
if (out.length >= REQUEST_DUMP_MAX_CHARS) {
|
|
234
|
+
const kept = out.slice(0, REQUEST_DUMP_HEAD_CHARS);
|
|
235
|
+
out = `${kept}\n[internal-call payload trimmed: kept first ${REQUEST_DUMP_HEAD_CHARS} of ${out.length} chars]`;
|
|
236
|
+
redactions++;
|
|
237
|
+
}
|
|
238
|
+
return { text: out, redactions };
|
|
239
|
+
}
|
|
240
|
+
//# sourceMappingURL=payload-hygiene.js.map
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Post-Loop Classifier - bundles the 4 post-loop LLM-call guarantees so a
|
|
3
|
+
* post-loop call site (session summary, end-of-turn reflection, dreamer
|
|
4
|
+
* analysis, etc.) cannot get them wrong by hand-rolling them:
|
|
5
|
+
*
|
|
6
|
+
* 1. ESC / session-shutdown abort propagation
|
|
7
|
+
* - Inherited from classify() -> tryModelCall -> callLlm which
|
|
8
|
+
* already threads ctx.signal. No work needed here.
|
|
9
|
+
* 2. Abort demotion in callLlm
|
|
10
|
+
* - Inherited from llm-call.ts. No work needed here.
|
|
11
|
+
* 3. Tier-failure fallback
|
|
12
|
+
* - classify() returns { tier: "failed", label: "unknown" }
|
|
13
|
+
* when ALL tiers fail. Without an explicit check, "unknown"
|
|
14
|
+
* would be embedded in the strategic SOP. This wrapper
|
|
15
|
+
* checks tier and invokes `onFailure` to give the caller a
|
|
16
|
+
* safe default. THIS IS THE PRIMARY ADDED VALUE.
|
|
17
|
+
* 4. 30s timeout
|
|
18
|
+
* - Post-loop work runs when the session model is busy with
|
|
19
|
+
* finalization; 30s is the default. Total worst-case when
|
|
20
|
+
* both tiers run is 60s, at the upper end of the "a minute
|
|
21
|
+
* or more" budget post-loop work may take.
|
|
22
|
+
*
|
|
23
|
+
* Usage:
|
|
24
|
+
* const result = await postLoopClassify(ctx, criteria, subs, {
|
|
25
|
+
* onFailure: () => detectPattern(tools), // heuristic fallback
|
|
26
|
+
* label: "trajectoryPattern", // for critic-stats analytics
|
|
27
|
+
* // timeoutMs defaults to 30000
|
|
28
|
+
* });
|
|
29
|
+
* // result.label is always defined (either LLM label or fallback).
|
|
30
|
+
* // result.tier is "failed" iff onFailure was invoked.
|
|
31
|
+
*
|
|
32
|
+
* @see test/runtime/lib/test-post-loop-classify.mjs for contract pins.
|
|
33
|
+
*/
|
|
34
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
35
|
+
import { type ClassificationResult } from "./text-classifier.js";
|
|
36
|
+
/**
|
|
37
|
+
* Resolve the effective post-loop timeout: explicit caller override
|
|
38
|
+
* wins, otherwise the process-global default from
|
|
39
|
+
* `getPostLoopTimeoutMs()`. The default is 30s and is tunable at
|
|
40
|
+
* runtime via `setPostLoopTimeoutMs()` so the value can be changed
|
|
41
|
+
* without code changes (e.g. from a /command or startup config).
|
|
42
|
+
*
|
|
43
|
+
* The 30s default gives full headroom for worst-case post-loop paths;
|
|
44
|
+
* total worst-case latency when both tiers run is 60s. Post-loop work
|
|
45
|
+
* is best-effort by definition; waiting longer is the right tradeoff
|
|
46
|
+
* against false-failure ERROR noise at turn end.
|
|
47
|
+
*
|
|
48
|
+
* If 60s turns out to be too long in practice, drop to 15-20s via
|
|
49
|
+
* `setPostLoopTimeoutMs(20_000)`. Run `npm test` to verify any
|
|
50
|
+
* change doesn't break the behavioral timeout tests.
|
|
51
|
+
*/
|
|
52
|
+
export interface PostLoopClassifyOptions<T extends string = string> {
|
|
53
|
+
/**
|
|
54
|
+
* Invoked when ALL LLM tiers fail (heuristic + utility + session all
|
|
55
|
+
* unavailable, timed out, or aborted). The result of this function
|
|
56
|
+
* becomes the returned label. Should return a value that's safe to
|
|
57
|
+
* embed in downstream artifacts (e.g. a heuristic pattern name, an
|
|
58
|
+
* empty string, a "skipped" marker).
|
|
59
|
+
*
|
|
60
|
+
* The reason parameter is for diagnostics; production callers can
|
|
61
|
+
* ignore it. It contains the failure reason and latency in ms.
|
|
62
|
+
*
|
|
63
|
+
* This callback is the ONLY added-value of postLoopClassify over
|
|
64
|
+
* raw classify(). Everything else (signal thread, abort demotion,
|
|
65
|
+
* timeout) is inherited from existing layers.
|
|
66
|
+
*/
|
|
67
|
+
onFailure: (reason: {
|
|
68
|
+
latencyMs: number;
|
|
69
|
+
}) => T;
|
|
70
|
+
/**
|
|
71
|
+
* Per-LLM-tier timeout in ms. Defaults to the value returned by
|
|
72
|
+
* `getPostLoopTimeoutMs()` (currently 30_000, tunable via
|
|
73
|
+
* `setPostLoopTimeoutMs()`). Total budget when both utility and
|
|
74
|
+
* session are tried: 2x = 60s by default. For best-effort
|
|
75
|
+
* post-loop work this is acceptable - we want to bound total
|
|
76
|
+
* time but not so tight that slow models always fail.
|
|
77
|
+
*/
|
|
78
|
+
timeoutMs?: number;
|
|
79
|
+
/**
|
|
80
|
+
* Whitelist of valid labels. Multi-class path: any label in this set
|
|
81
|
+
* is accepted verbatim. Without it, the binary yes/no path is used.
|
|
82
|
+
*/
|
|
83
|
+
validLabels?: string[];
|
|
84
|
+
/**
|
|
85
|
+
* Analytics label for critic-stats tracking. Required for cost
|
|
86
|
+
* attribution. The classifier routes this to recordCriticCall().
|
|
87
|
+
*/
|
|
88
|
+
label?: string;
|
|
89
|
+
/**
|
|
90
|
+
* When true, suppress the post-failure debug log. Use for callers
|
|
91
|
+
* that already log their own diagnostics on the failure path
|
|
92
|
+
* (avoids duplicate log lines).
|
|
93
|
+
*
|
|
94
|
+
* Default: false (log debug line on failure for diagnostic value).
|
|
95
|
+
*/
|
|
96
|
+
silent?: boolean;
|
|
97
|
+
}
|
|
98
|
+
export interface PostLoopClassifyResult<T extends string> {
|
|
99
|
+
/**
|
|
100
|
+
* The label - either the LLM's verdict OR the onFailure callback's
|
|
101
|
+
* return value. Always defined; never null/undefined.
|
|
102
|
+
*/
|
|
103
|
+
label: T;
|
|
104
|
+
/**
|
|
105
|
+
* Which tier produced this result. "failed" means onFailure was
|
|
106
|
+
* invoked (the LLM tiers all failed). "heuristic"/"utility"/"session"/
|
|
107
|
+
* "cache" means the LLM (or a prior cache hit) produced the label.
|
|
108
|
+
*/
|
|
109
|
+
tier: ClassificationResult["tier"];
|
|
110
|
+
/** Latency of the underlying classify() call. 0 if tier === "failed" was instant. */
|
|
111
|
+
latencyMs: number;
|
|
112
|
+
/** Raw model output (empty string if tier === "failed"). */
|
|
113
|
+
raw: string;
|
|
114
|
+
/** Confidence: utility=0.9, session=0.6, heuristic=0.7, failed=0. */
|
|
115
|
+
confidence: number;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Run classify() with the four post-loop guarantees pre-applied.
|
|
119
|
+
*
|
|
120
|
+
* See the BACKGROUND section at the top of this file for why this
|
|
121
|
+
* exists. The contract is verified by
|
|
122
|
+
* `test/runtime/lib/test-post-loop-classify.mjs`.
|
|
123
|
+
*/
|
|
124
|
+
export declare function postLoopClassify<T extends string = string>(ctx: ExtensionContext, criteria: {
|
|
125
|
+
systemPrompt: string;
|
|
126
|
+
userPrompt: string;
|
|
127
|
+
}, substitutions: Record<string, string>, options: PostLoopClassifyOptions<T>): Promise<PostLoopClassifyResult<T>>;
|
|
128
|
+
//# sourceMappingURL=post-loop-classify.d.ts.map
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Post-Loop Classifier - bundles the 4 post-loop LLM-call guarantees so a
|
|
3
|
+
* post-loop call site (session summary, end-of-turn reflection, dreamer
|
|
4
|
+
* analysis, etc.) cannot get them wrong by hand-rolling them:
|
|
5
|
+
*
|
|
6
|
+
* 1. ESC / session-shutdown abort propagation
|
|
7
|
+
* - Inherited from classify() -> tryModelCall -> callLlm which
|
|
8
|
+
* already threads ctx.signal. No work needed here.
|
|
9
|
+
* 2. Abort demotion in callLlm
|
|
10
|
+
* - Inherited from llm-call.ts. No work needed here.
|
|
11
|
+
* 3. Tier-failure fallback
|
|
12
|
+
* - classify() returns { tier: "failed", label: "unknown" }
|
|
13
|
+
* when ALL tiers fail. Without an explicit check, "unknown"
|
|
14
|
+
* would be embedded in the strategic SOP. This wrapper
|
|
15
|
+
* checks tier and invokes `onFailure` to give the caller a
|
|
16
|
+
* safe default. THIS IS THE PRIMARY ADDED VALUE.
|
|
17
|
+
* 4. 30s timeout
|
|
18
|
+
* - Post-loop work runs when the session model is busy with
|
|
19
|
+
* finalization; 30s is the default. Total worst-case when
|
|
20
|
+
* both tiers run is 60s, at the upper end of the "a minute
|
|
21
|
+
* or more" budget post-loop work may take.
|
|
22
|
+
*
|
|
23
|
+
* Usage:
|
|
24
|
+
* const result = await postLoopClassify(ctx, criteria, subs, {
|
|
25
|
+
* onFailure: () => detectPattern(tools), // heuristic fallback
|
|
26
|
+
* label: "trajectoryPattern", // for critic-stats analytics
|
|
27
|
+
* // timeoutMs defaults to 30000
|
|
28
|
+
* });
|
|
29
|
+
* // result.label is always defined (either LLM label or fallback).
|
|
30
|
+
* // result.tier is "failed" iff onFailure was invoked.
|
|
31
|
+
*
|
|
32
|
+
* @see test/runtime/lib/test-post-loop-classify.mjs for contract pins.
|
|
33
|
+
*/
|
|
34
|
+
import { classify } from "./text-classifier.js";
|
|
35
|
+
import { createLogger } from "../core/logger.js";
|
|
36
|
+
import { getPostLoopTimeoutMs } from "../state/global-state.js";
|
|
37
|
+
const log = createLogger("post-loop-classify");
|
|
38
|
+
/**
|
|
39
|
+
* Run classify() with the four post-loop guarantees pre-applied.
|
|
40
|
+
*
|
|
41
|
+
* See the BACKGROUND section at the top of this file for why this
|
|
42
|
+
* exists. The contract is verified by
|
|
43
|
+
* `test/runtime/lib/test-post-loop-classify.mjs`.
|
|
44
|
+
*/
|
|
45
|
+
export async function postLoopClassify(ctx, criteria, substitutions, options) {
|
|
46
|
+
const result = await classify(ctx, criteria, substitutions, {
|
|
47
|
+
// Inherited guarantees - DO NOT override these in callers:
|
|
48
|
+
bestEffort: true, // demote TIER failure warns to debug
|
|
49
|
+
// The TIER 1 fallback below is a no-op: we want the LLM to run.
|
|
50
|
+
// The real fallback is the onFailure callback below, consulted
|
|
51
|
+
// when ALL LLM tiers fail. We use `() => ""` because:
|
|
52
|
+
// - "" is not in any validLabels whitelist
|
|
53
|
+
// - "" is not "yes"/"no"
|
|
54
|
+
// - so classify() skips TIER 1 (it requires a valid short label
|
|
55
|
+
// OR an empty-but-trustworthy heuristic, and we don't have one)
|
|
56
|
+
// - and proceeds to TIER 2 (utility) and TIER 3 (session).
|
|
57
|
+
fallback: () => "",
|
|
58
|
+
// Pass through caller options:
|
|
59
|
+
timeoutMs: options.timeoutMs ?? getPostLoopTimeoutMs(),
|
|
60
|
+
validLabels: options.validLabels,
|
|
61
|
+
label: options.label,
|
|
62
|
+
});
|
|
63
|
+
if (result.tier === "failed") {
|
|
64
|
+
const fallbackLabel = options.onFailure({
|
|
65
|
+
latencyMs: result.latencyMs,
|
|
66
|
+
});
|
|
67
|
+
if (!options.silent) {
|
|
68
|
+
log.debug(`[post-loop-classify] LLM tiers failed (label="${options.label ?? "?"}", ` +
|
|
69
|
+
`latencyMs=${result.latencyMs}), using onFailure -> "${fallbackLabel}"`);
|
|
70
|
+
}
|
|
71
|
+
return {
|
|
72
|
+
label: fallbackLabel,
|
|
73
|
+
tier: "failed",
|
|
74
|
+
latencyMs: result.latencyMs,
|
|
75
|
+
raw: result.raw,
|
|
76
|
+
confidence: 0,
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
return {
|
|
80
|
+
label: result.label,
|
|
81
|
+
tier: result.tier,
|
|
82
|
+
latencyMs: result.latencyMs,
|
|
83
|
+
raw: result.raw,
|
|
84
|
+
confidence: result.confidence,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=post-loop-classify.js.map
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Text Classifier - lightweight classification with a configurable role model.
|
|
3
|
+
*
|
|
4
|
+
* Four-tier fallback (logit-probe first):
|
|
5
|
+
* Tier 0 (binary gate): Ultra-cheap yes/no pre-check via maxTokens=1, temperature=0.
|
|
6
|
+
* Cost: 1 output token. Returns the model's argmax prediction for yes/no.
|
|
7
|
+
* Falls through on any non-yes/no response. Enabled via binaryGate: true.
|
|
8
|
+
* Tier 1: Heuristic fallback callback (caller-provided). Fast, free.
|
|
9
|
+
* If it returns a clear "yes"/"no", use it with 0.7 confidence.
|
|
10
|
+
* Tier 2: Merged role model (utilityModel, via /utility-model or settings.json)
|
|
11
|
+
* Tier 3: Session model (ctx.model)
|
|
12
|
+
*
|
|
13
|
+
* The merged role is the one auxiliary role: "quality" puts the session model
|
|
14
|
+
* first, every other preference puts the role first, and a model configured
|
|
15
|
+
* once can no longer appear as two tiers.
|
|
16
|
+
*
|
|
17
|
+
* The heuristic tier is preferred over LLM because it's instant and costs nothing.
|
|
18
|
+
* The binary gate is preferred over heuristic because it costs 1 token and gives
|
|
19
|
+
* a calibrated LLM judgment (not a fragile regex).
|
|
20
|
+
*/
|
|
21
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
22
|
+
export interface ClassifierCriteria {
|
|
23
|
+
/** System prompt: role description for the classifier model. */
|
|
24
|
+
systemPrompt: string;
|
|
25
|
+
/** User prompt with {{key}} placeholders for substitution. */
|
|
26
|
+
userPrompt: string;
|
|
27
|
+
}
|
|
28
|
+
export interface ClassificationResult {
|
|
29
|
+
/** Parsed label - "yes" | "no" | fallback value. */
|
|
30
|
+
label: string;
|
|
31
|
+
/** Confidence estimate: utility=0.9, session=0.6, heuristic=0.7, failed=0. */
|
|
32
|
+
confidence: number;
|
|
33
|
+
/** Raw model output text. */
|
|
34
|
+
raw: string;
|
|
35
|
+
/** Which tier produced this result. */
|
|
36
|
+
tier: "utility" | "session" | "heuristic" | "failed" | "cache" | "gate";
|
|
37
|
+
/** Latency in milliseconds. */
|
|
38
|
+
latencyMs: number;
|
|
39
|
+
}
|
|
40
|
+
export interface ClassifierOptions {
|
|
41
|
+
maxTokens?: number;
|
|
42
|
+
timeoutMs?: number;
|
|
43
|
+
/** Heuristic fallback function - called first. If it returns a clear yes/no, skip LLM. */
|
|
44
|
+
fallback?: () => Promise<string> | string;
|
|
45
|
+
/**
|
|
46
|
+
* Tier policy controls when the heuristic is consulted.
|
|
47
|
+
* - "prefer-heuristic" (default): try heuristic first, fall through to LLM on ambiguity.
|
|
48
|
+
* - "fallback-only": heuristic is best-effort and its label is treated as low-confidence
|
|
49
|
+
* (0.5). Used when the heuristic is known-fragile but still useful.
|
|
50
|
+
* - "always-llm": skip heuristic entirely. Required for accuracy-critical classifiers
|
|
51
|
+
* where a wrong heuristic answer is worse than an LLM cost.
|
|
52
|
+
*/
|
|
53
|
+
tierPolicy?: "prefer-heuristic" | "fallback-only" | "always-llm";
|
|
54
|
+
/**
|
|
55
|
+
* Enable Tier 0 binary gate: ultra-cheap yes/no pre-check via maxTokens=1, temperature=0.
|
|
56
|
+
* Cost: 1 output token per call (vs ~30-50 for full cascade). Returns the model's argmax
|
|
57
|
+
* prediction on the first forward pass. Falls through to the existing cascade on any
|
|
58
|
+
* non-yes/no response. Only effective for binary (yes/no) classifiers.
|
|
59
|
+
*
|
|
60
|
+
* Based on research: logit-probing / logprob-based classification (arXiv 2407.01122,
|
|
61
|
+
* arcturus-labs.com 2025). For binary decisions, the model's first-token logits encode
|
|
62
|
+
* the full classification — no need to generate 30+ tokens of structured output.
|
|
63
|
+
*/
|
|
64
|
+
binaryGate?: boolean;
|
|
65
|
+
/**
|
|
66
|
+
* Optional whitelist of valid labels. If set and the heuristic returns a label
|
|
67
|
+
* NOT in this set, fall through to the LLM. Useful for multi-class classifiers
|
|
68
|
+
* where the heuristic might guess a wrong category.
|
|
69
|
+
*/
|
|
70
|
+
validLabels?: string[];
|
|
71
|
+
/** Optional human-readable label for runtime observability (critic-stats tracking). */
|
|
72
|
+
label?: string;
|
|
73
|
+
/**
|
|
74
|
+
* Model preference selects the tier ORDERING strategy.
|
|
75
|
+
* Each strategy defines which LLM tiers to try and in what order.
|
|
76
|
+
* All strategies start with heuristic (tier 1) if applicable.
|
|
77
|
+
*
|
|
78
|
+
* "balanced" (default): role -> session
|
|
79
|
+
* Good default: the merged role first, session as backup.
|
|
80
|
+
*
|
|
81
|
+
* "quality": session -> role
|
|
82
|
+
* Try the session (conversation) model first since it may already be
|
|
83
|
+
* powerful; the merged role is the fallback.
|
|
84
|
+
*
|
|
85
|
+
* "speed" / "max": role -> session
|
|
86
|
+
* The values stay accepted for callers; both mean the same order as
|
|
87
|
+
* "balanced" (there is no separate max-power tier).
|
|
88
|
+
*/
|
|
89
|
+
modelPreference?: "balanced" | "quality" | "speed" | "max";
|
|
90
|
+
/**
|
|
91
|
+
* Best-effort mode: shorter timeout, demote failure warns to debug.
|
|
92
|
+
* Use for post-loop / session-end analysis where the result is nice-to-have
|
|
93
|
+
* and aborts are expected (the session signal cascades to in-flight calls
|
|
94
|
+
* when the agent's main turn ends). The classifier still returns a result
|
|
95
|
+
* (label: "unknown" on failure), but the logs stay clean.
|
|
96
|
+
*
|
|
97
|
+
* Default: false (use 8s timeout + warn on failure).
|
|
98
|
+
*/
|
|
99
|
+
bestEffort?: boolean;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Classify text using the four-tier fallback system (heuristic-first).
|
|
103
|
+
*
|
|
104
|
+
* Tier 1 (heuristic) runs first - it's fast and free. Only if the heuristic
|
|
105
|
+
* returns something ambiguous or isn't provided do we consult LLM tiers.
|
|
106
|
+
*
|
|
107
|
+
* Tier flow by modelPreference (see ClassifierOptions for details):
|
|
108
|
+
* "balanced" (default): heuristic -> role -> session
|
|
109
|
+
* "quality": heuristic -> session -> role
|
|
110
|
+
* "speed" / "max": heuristic -> role -> session (same as balanced)
|
|
111
|
+
*
|
|
112
|
+
* @param ctx - Extension context for model resolution + API keys.
|
|
113
|
+
* @param criteria - Prompt templates (system + user with {{key}} placeholders).
|
|
114
|
+
* @param substitutions - Key-value pairs to replace `{{key}}` in prompts.
|
|
115
|
+
* @param options - Optional: maxTokens, timeoutMs, heuristic fallback, modelPreference.
|
|
116
|
+
* @returns ClassificationResult with label, confidence, tier, and latency.
|
|
117
|
+
*/
|
|
118
|
+
export declare function classify(ctx: ExtensionContext, criteria: ClassifierCriteria, substitutions: Record<string, string>, options?: ClassifierOptions): Promise<ClassificationResult>;
|
|
119
|
+
/**
|
|
120
|
+
* Normalize a model response to a valid label.
|
|
121
|
+
*
|
|
122
|
+
* - If `validLabels` is provided, accept any label in that set
|
|
123
|
+
* (case-insensitive exact match). This is the multi-class path used by
|
|
124
|
+
* critics like `trajectoryPattern` that return hyphenated pattern names
|
|
125
|
+
* like "Read-Edit-Bash" instead of yes/no.
|
|
126
|
+
* - Otherwise fall back to binary yes/no (the default for ~30 critics).
|
|
127
|
+
*
|
|
128
|
+
* Returns null if the response doesn't match. The classifier then falls
|
|
129
|
+
* through to the next tier, rather than silently defaulting to "no" which
|
|
130
|
+
* would mask the underlying prompt/model issue.
|
|
131
|
+
*
|
|
132
|
+
* Exported for testing.
|
|
133
|
+
*/
|
|
134
|
+
export declare function normalizeLabel(raw: string, validLabels?: string[]): string | null;
|
|
135
|
+
/**
|
|
136
|
+
* Replace `{{key}}` placeholders with values from the substitutions map.
|
|
137
|
+
* Uses single-pass regex to prevent cross-key injection:
|
|
138
|
+
* if a substitution value contains `{{otherKey}}`, it won't be re-processed.
|
|
139
|
+
* Exported for testing.
|
|
140
|
+
*/
|
|
141
|
+
export declare function replacePlaceholders(template: string, substitutions: Record<string, string>): string;
|
|
142
|
+
//# sourceMappingURL=text-classifier.d.ts.map
|