pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Task Evidence — verification judge evidence index.
|
|
3
|
+
*
|
|
4
|
+
* The verification judge audits work via a tool log built from enforcement
|
|
5
|
+
* turnHistory, which is recorded only at turn_end. A turn BROKEN by a
|
|
6
|
+
* wake-retry redelivery (a failed wake fire is re-delivered with bounded
|
|
7
|
+
* backoff) therefore leaves the judge with only the redelivered tail
|
|
8
|
+
* turn's log — finalize + response text. All earlier verification evidence
|
|
9
|
+
* (bash/powershell runs with [OK]/[FAIL], telegram_send receipts, poller
|
|
10
|
+
* enables, timer/agent lifecycle calls) goes invisible and the judge
|
|
11
|
+
* false-alarms on work that WAS done (observed: WARN 62%,
|
|
12
|
+
* FAIL 82%, FAIL 92%).
|
|
13
|
+
*
|
|
14
|
+
* This module rebuilds the evidence from the authoritative source instead:
|
|
15
|
+
* the pi session store (sessionManager.getBranch()). The session store
|
|
16
|
+
* persists every message and custom message with a timestamp regardless of
|
|
17
|
+
* turn outcome, so it survives turn breaks, leaf switches, and reloads.
|
|
18
|
+
*
|
|
19
|
+
* Task boundary: the last REAL user message (type "message", role "user").
|
|
20
|
+
* Injected braid traffic (whispers, timer fires, steers) is persisted as
|
|
21
|
+
* custom_message entries and NEVER resets the boundary — it rides within
|
|
22
|
+
* the task.
|
|
23
|
+
*
|
|
24
|
+
* Output: ordered, timestamped evidence lines (oldest first). When the log
|
|
25
|
+
* outgrows TASK_EVIDENCE_CAP, summarizeTaskEvidence() keeps full-log
|
|
26
|
+
* coverage by compacting older chunks with cheap LLM sub-summary calls
|
|
27
|
+
* (the newest chunk stays raw); any sub-call failure degrades to the
|
|
28
|
+
* legacy drop-oldest cap with an explicit count line — never silent
|
|
29
|
+
* truncation.
|
|
30
|
+
*/
|
|
31
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
32
|
+
/** Cap on evidence lines fed to the judge prompt (drop-oldest). */
|
|
33
|
+
export declare const TASK_EVIDENCE_CAP = 200;
|
|
34
|
+
/**
|
|
35
|
+
* Options for collectTaskEvidence.
|
|
36
|
+
*/
|
|
37
|
+
export interface CollectTaskEvidenceOptions {
|
|
38
|
+
/**
|
|
39
|
+
* Apply the TASK_EVIDENCE_CAP drop-oldest truncation before returning.
|
|
40
|
+
* Default true. Pass false when the caller will summarize the evidence
|
|
41
|
+
* (summarizeTaskEvidence) and wants full-log coverage instead.
|
|
42
|
+
*/
|
|
43
|
+
cap?: boolean;
|
|
44
|
+
}
|
|
45
|
+
export interface TaskEvidence {
|
|
46
|
+
/** Ordered lines (oldest first), each `HH:MM:SS ...`, incl. the boundary marker. */
|
|
47
|
+
lines: string[];
|
|
48
|
+
/** Entries dropped from the FRONT by the cap (rendered as an explicit count line). */
|
|
49
|
+
truncatedCount: number;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Collect task-wide evidence from the session store: everything since the
|
|
53
|
+
* last real user message. Returns null when the session store is
|
|
54
|
+
* unavailable (stale ctx / ephemeral session) — callers fall back to the
|
|
55
|
+
* turnHistory-derived tool log.
|
|
56
|
+
*/
|
|
57
|
+
export declare function collectTaskEvidence(ctx: ExtensionContext, options?: CollectTaskEvidenceOptions): TaskEvidence | null;
|
|
58
|
+
/**
|
|
59
|
+
* Render a TaskEvidence object into prompt lines the legacy way (shared by
|
|
60
|
+
* the judge prompt builder and tests): drop-oldest truncation for logs over
|
|
61
|
+
* the cap, optional explicit truncation count line first, then the ordered
|
|
62
|
+
* evidence lines. This is also the fallback shape summarizeTaskEvidence
|
|
63
|
+
* callers render when chunk sub-summaries fail.
|
|
64
|
+
*/
|
|
65
|
+
export declare function renderTaskEvidence(evidence: TaskEvidence): string[];
|
|
66
|
+
/**
|
|
67
|
+
* Hard bound on chunk sub-summary LLM calls per render. Logs that would
|
|
68
|
+
* need more sub-calls grow the chunk size instead, so the bound holds for
|
|
69
|
+
* a log of any length.
|
|
70
|
+
*/
|
|
71
|
+
export declare const MAX_CHUNK_SUMMARIES = 6;
|
|
72
|
+
/** Seam for one chunk sub-summary call; mirrors the shared callLlm result shape. */
|
|
73
|
+
export type ChunkSummarizeLlm = (systemPrompt: string, userPrompt: string, options: {
|
|
74
|
+
signal?: AbortSignal;
|
|
75
|
+
}) => Promise<{
|
|
76
|
+
text: string;
|
|
77
|
+
} | {
|
|
78
|
+
error: string;
|
|
79
|
+
}>;
|
|
80
|
+
export interface SummarizeTaskEvidenceOptions {
|
|
81
|
+
/** Abort signal threaded into every sub-summary call (the same signal the judge itself honors). */
|
|
82
|
+
signal?: AbortSignal;
|
|
83
|
+
/**
|
|
84
|
+
* LLM seam for the sub-summaries. Defaults to the shared callLlm wrapper
|
|
85
|
+
* (utility → session model chain). Tests inject a stub here instead of
|
|
86
|
+
* mocking modules.
|
|
87
|
+
*/
|
|
88
|
+
summarizeLlm?: ChunkSummarizeLlm;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Render task evidence into the judge's final prompt lines, keeping
|
|
92
|
+
* full-log coverage when the log exceeds TASK_EVIDENCE_CAP:
|
|
93
|
+
*
|
|
94
|
+
* - At or under the cap: returns renderTaskEvidence(evidence) — no LLM
|
|
95
|
+
* calls, byte-identical to the legacy render.
|
|
96
|
+
* - Over the cap: the log is split into chunks; each older chunk is
|
|
97
|
+
* compacted by one parallel LLM sub-summary call (bounded, signal-aware)
|
|
98
|
+
* and the newest chunk stays raw. The result is one numbered summary
|
|
99
|
+
* line per older chunk (oldest first), then the raw newest chunk, then —
|
|
100
|
+
* only when the caller passed pre-truncated evidence — the explicit
|
|
101
|
+
* count line.
|
|
102
|
+
* - ANY sub-call failure (error, timeout, abort, empty output) logs and
|
|
103
|
+
* returns null: the caller falls back to renderTaskEvidence, whose
|
|
104
|
+
* drop-oldest render is the legacy behavior. Chunking never blocks or
|
|
105
|
+
* breaks the judge.
|
|
106
|
+
*/
|
|
107
|
+
export declare function summarizeTaskEvidence(ctx: ExtensionContext, evidence: TaskEvidence, options?: SummarizeTaskEvidenceOptions): Promise<string[] | null>;
|
|
108
|
+
//# sourceMappingURL=task-evidence.d.ts.map
|
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Task Evidence — verification judge evidence index.
|
|
3
|
+
*
|
|
4
|
+
* The verification judge audits work via a tool log built from enforcement
|
|
5
|
+
* turnHistory, which is recorded only at turn_end. A turn BROKEN by a
|
|
6
|
+
* wake-retry redelivery (a failed wake fire is re-delivered with bounded
|
|
7
|
+
* backoff) therefore leaves the judge with only the redelivered tail
|
|
8
|
+
* turn's log — finalize + response text. All earlier verification evidence
|
|
9
|
+
* (bash/powershell runs with [OK]/[FAIL], telegram_send receipts, poller
|
|
10
|
+
* enables, timer/agent lifecycle calls) goes invisible and the judge
|
|
11
|
+
* false-alarms on work that WAS done (observed: WARN 62%,
|
|
12
|
+
* FAIL 82%, FAIL 92%).
|
|
13
|
+
*
|
|
14
|
+
* This module rebuilds the evidence from the authoritative source instead:
|
|
15
|
+
* the pi session store (sessionManager.getBranch()). The session store
|
|
16
|
+
* persists every message and custom message with a timestamp regardless of
|
|
17
|
+
* turn outcome, so it survives turn breaks, leaf switches, and reloads.
|
|
18
|
+
*
|
|
19
|
+
* Task boundary: the last REAL user message (type "message", role "user").
|
|
20
|
+
* Injected braid traffic (whispers, timer fires, steers) is persisted as
|
|
21
|
+
* custom_message entries and NEVER resets the boundary — it rides within
|
|
22
|
+
* the task.
|
|
23
|
+
*
|
|
24
|
+
* Output: ordered, timestamped evidence lines (oldest first). When the log
|
|
25
|
+
* outgrows TASK_EVIDENCE_CAP, summarizeTaskEvidence() keeps full-log
|
|
26
|
+
* coverage by compacting older chunks with cheap LLM sub-summary calls
|
|
27
|
+
* (the newest chunk stays raw); any sub-call failure degrades to the
|
|
28
|
+
* legacy drop-oldest cap with an explicit count line — never silent
|
|
29
|
+
* truncation.
|
|
30
|
+
*/
|
|
31
|
+
import { getSessionManager } from "../../lib/state/session-manager.js";
|
|
32
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
33
|
+
import { callLlm } from "./judge-utils.js";
|
|
34
|
+
const log = createLogger("enforcement:task-evidence");
|
|
35
|
+
/** Cap on evidence lines fed to the judge prompt (drop-oldest). */
|
|
36
|
+
export const TASK_EVIDENCE_CAP = 200;
|
|
37
|
+
/** Max chars of a tool result's text kept per evidence line (matches turn-end MAX_OUTPUT_CHARS). */
|
|
38
|
+
const MAX_OUTPUT_CHARS = 300;
|
|
39
|
+
/** Max chars of a toolCall's argument summary kept per evidence line. */
|
|
40
|
+
const MAX_ARGS_CHARS = 150;
|
|
41
|
+
/** Max chars of the boundary user-message excerpt. */
|
|
42
|
+
const MAX_BOUNDARY_CHARS = 120;
|
|
43
|
+
function hhmmss(iso) {
|
|
44
|
+
if (iso) {
|
|
45
|
+
const d = new Date(iso);
|
|
46
|
+
if (!Number.isNaN(d.getTime()))
|
|
47
|
+
return d.toTimeString().slice(0, 8);
|
|
48
|
+
}
|
|
49
|
+
return "--:--:--";
|
|
50
|
+
}
|
|
51
|
+
/** Collapse whitespace and truncate with an ellipsis marker. */
|
|
52
|
+
function truncate(s, max) {
|
|
53
|
+
const flat = s.replace(/\s+/g, " ").trim();
|
|
54
|
+
return flat.length > max ? flat.slice(0, max) + "…" : flat;
|
|
55
|
+
}
|
|
56
|
+
function isRecord(v) {
|
|
57
|
+
return typeof v === "object" && v !== null && !Array.isArray(v);
|
|
58
|
+
}
|
|
59
|
+
/** Summarize toolCall arguments: full command for command runners, compact JSON otherwise. */
|
|
60
|
+
function summarizeArgs(input) {
|
|
61
|
+
if (input === undefined || input === null)
|
|
62
|
+
return "";
|
|
63
|
+
if (isRecord(input) && typeof input.command === "string") {
|
|
64
|
+
return truncate(input.command, MAX_ARGS_CHARS);
|
|
65
|
+
}
|
|
66
|
+
try {
|
|
67
|
+
return truncate(JSON.stringify(input), MAX_ARGS_CHARS);
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
return "";
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
/** Flatten a tool result content array to one bounded text snippet. */
|
|
74
|
+
function resultSnippet(content) {
|
|
75
|
+
if (!Array.isArray(content))
|
|
76
|
+
return "(no output)";
|
|
77
|
+
const text = content
|
|
78
|
+
.filter((c) => isRecord(c) && c.type === "text")
|
|
79
|
+
.map((c) => (isRecord(c) && typeof c.text === "string" ? c.text : ""))
|
|
80
|
+
.join(" ");
|
|
81
|
+
return text.trim() ? truncate(text, MAX_OUTPUT_CHARS) : "(no output)";
|
|
82
|
+
}
|
|
83
|
+
/** Flatten a user message content to one bounded text snippet. */
|
|
84
|
+
function userText(content) {
|
|
85
|
+
if (typeof content === "string")
|
|
86
|
+
return content;
|
|
87
|
+
if (!Array.isArray(content))
|
|
88
|
+
return "";
|
|
89
|
+
return content
|
|
90
|
+
.filter((c) => isRecord(c) && c.type === "text")
|
|
91
|
+
.map((c) => (isRecord(c) && typeof c.text === "string" ? c.text : ""))
|
|
92
|
+
.join(" ");
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Collect task-wide evidence from the session store: everything since the
|
|
96
|
+
* last real user message. Returns null when the session store is
|
|
97
|
+
* unavailable (stale ctx / ephemeral session) — callers fall back to the
|
|
98
|
+
* turnHistory-derived tool log.
|
|
99
|
+
*/
|
|
100
|
+
export function collectTaskEvidence(ctx, options = {}) {
|
|
101
|
+
try {
|
|
102
|
+
const branch = getSessionManager(ctx).getBranch();
|
|
103
|
+
const pending = new Map();
|
|
104
|
+
const collected = [];
|
|
105
|
+
for (const rawEntry of branch) {
|
|
106
|
+
// Narrow the pi SessionEntry union: not every member carries timestamp.
|
|
107
|
+
const entry = rawEntry;
|
|
108
|
+
if (entry.type !== "message")
|
|
109
|
+
continue; // custom_message / custom / label: skip entirely
|
|
110
|
+
const msg = entry.message;
|
|
111
|
+
if (!isRecord(msg))
|
|
112
|
+
continue;
|
|
113
|
+
const role = msg.role;
|
|
114
|
+
if (role === "user") {
|
|
115
|
+
// Task boundary: a real user message restarts the evidence window.
|
|
116
|
+
// Injected traffic never lands here (it is persisted as
|
|
117
|
+
// custom_message, which is skipped above).
|
|
118
|
+
collected.length = 0;
|
|
119
|
+
pending.clear();
|
|
120
|
+
const text = userText(msg.content);
|
|
121
|
+
collected.push(`${hhmmss(entry.timestamp)} ── task start: user ── ${truncate(text, MAX_BOUNDARY_CHARS)}`);
|
|
122
|
+
continue;
|
|
123
|
+
}
|
|
124
|
+
if (role === "assistant") {
|
|
125
|
+
const content = msg.content;
|
|
126
|
+
if (!Array.isArray(content))
|
|
127
|
+
continue;
|
|
128
|
+
for (const c of content) {
|
|
129
|
+
if (!isRecord(c) || c.type !== "toolCall")
|
|
130
|
+
continue;
|
|
131
|
+
const id = typeof c.id === "string" ? c.id : undefined;
|
|
132
|
+
if (!id)
|
|
133
|
+
continue;
|
|
134
|
+
pending.set(id, {
|
|
135
|
+
name: typeof c.name === "string" ? c.name : "tool",
|
|
136
|
+
args: summarizeArgs(c.arguments),
|
|
137
|
+
});
|
|
138
|
+
}
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
if (role === "toolResult") {
|
|
142
|
+
const id = typeof msg.toolCallId === "string" ? msg.toolCallId : undefined;
|
|
143
|
+
const call = id ? pending.get(id) : undefined;
|
|
144
|
+
if (id)
|
|
145
|
+
pending.delete(id);
|
|
146
|
+
const name = typeof msg.toolName === "string" ? msg.toolName : (call?.name ?? "tool");
|
|
147
|
+
const isError = msg.isError === true;
|
|
148
|
+
const status = isError ? "FAIL" : "OK";
|
|
149
|
+
// Command runners: the command itself is the evidence — the result
|
|
150
|
+
// snippet may only carry stdout. Everything else: result text
|
|
151
|
+
// (telegram_send messageId/ok, poller enable results, agent
|
|
152
|
+
// lifecycle lines all live in the result text).
|
|
153
|
+
const argsPart = (name === "bash" || name === "powershell") && call?.args ? ` $ ${call.args}: ` : "";
|
|
154
|
+
collected.push(`${hhmmss(entry.timestamp)} ${name} [${status}]: ${argsPart}${resultSnippet(msg.content)}`);
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
// Result-less toolCalls still in flight (the assistant message the judge
|
|
158
|
+
// is currently auditing, e.g. the finalize call itself) — emit them so
|
|
159
|
+
// the judge sees the calls of the very message under audit. Only when
|
|
160
|
+
// they belong to the branch's last assistant message; older unresolved
|
|
161
|
+
// calls (aborted turns) are stale and must not surface.
|
|
162
|
+
const last = branch[branch.length - 1];
|
|
163
|
+
const lastMsgRole = isRecord(last?.message)
|
|
164
|
+
? last.message.role
|
|
165
|
+
: undefined;
|
|
166
|
+
if (last?.type === "message" && lastMsgRole === "assistant" && pending.size > 0) {
|
|
167
|
+
for (const call of pending.values()) {
|
|
168
|
+
collected.push(`${hhmmss(undefined)} ${call.name} (in flight): ${call.args || "(no args)"}`);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
if (collected.length === 0)
|
|
172
|
+
return null;
|
|
173
|
+
// Cap with explicit truncation count — never silent. Callers that
|
|
174
|
+
// opted out of the cap hand the full log to summarizeTaskEvidence.
|
|
175
|
+
let truncatedCount = 0;
|
|
176
|
+
if ((options.cap ?? true) && collected.length > TASK_EVIDENCE_CAP) {
|
|
177
|
+
truncatedCount = collected.length - TASK_EVIDENCE_CAP;
|
|
178
|
+
collected.splice(0, truncatedCount);
|
|
179
|
+
}
|
|
180
|
+
return { lines: collected, truncatedCount };
|
|
181
|
+
}
|
|
182
|
+
catch (e) {
|
|
183
|
+
log.debug(`task evidence unavailable: ${e.message}`);
|
|
184
|
+
return null;
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
/** The explicit "N older entries truncated" count line (never silent truncation). */
|
|
188
|
+
function truncationCountLine(truncatedCount, keptLines) {
|
|
189
|
+
return `(${truncatedCount} older evidence entries truncated — showing last ${TASK_EVIDENCE_CAP} of ${truncatedCount + keptLines})`;
|
|
190
|
+
}
|
|
191
|
+
/**
|
|
192
|
+
* Render a TaskEvidence object into prompt lines the legacy way (shared by
|
|
193
|
+
* the judge prompt builder and tests): drop-oldest truncation for logs over
|
|
194
|
+
* the cap, optional explicit truncation count line first, then the ordered
|
|
195
|
+
* evidence lines. This is also the fallback shape summarizeTaskEvidence
|
|
196
|
+
* callers render when chunk sub-summaries fail.
|
|
197
|
+
*/
|
|
198
|
+
export function renderTaskEvidence(evidence) {
|
|
199
|
+
let lines = evidence.lines;
|
|
200
|
+
let truncatedCount = evidence.truncatedCount;
|
|
201
|
+
if (lines.length > TASK_EVIDENCE_CAP) {
|
|
202
|
+
truncatedCount += lines.length - TASK_EVIDENCE_CAP;
|
|
203
|
+
lines = lines.slice(lines.length - TASK_EVIDENCE_CAP);
|
|
204
|
+
}
|
|
205
|
+
if (truncatedCount > 0) {
|
|
206
|
+
return [truncationCountLine(truncatedCount, lines.length), ...lines];
|
|
207
|
+
}
|
|
208
|
+
return lines;
|
|
209
|
+
}
|
|
210
|
+
// Chunked evidence summaries (map-reduce over the session model)
|
|
211
|
+
/**
|
|
212
|
+
* Hard bound on chunk sub-summary LLM calls per render. Logs that would
|
|
213
|
+
* need more sub-calls grow the chunk size instead, so the bound holds for
|
|
214
|
+
* a log of any length.
|
|
215
|
+
*/
|
|
216
|
+
export const MAX_CHUNK_SUMMARIES = 6;
|
|
217
|
+
/** Target lines per evidence chunk (the raw newest chunk is also about this size). */
|
|
218
|
+
const CHUNK_TARGET_LINES = 150;
|
|
219
|
+
/** Wall-clock bound per sub-summary call; a miss degrades to the legacy cap render. */
|
|
220
|
+
const CHUNK_SUMMARY_TIMEOUT_MS = 15_000;
|
|
221
|
+
/** Defensive cap on one sub-summary's length (models occasionally overrun token instructions). */
|
|
222
|
+
const MAX_CHUNK_SUMMARY_CHARS = 600;
|
|
223
|
+
const CHUNK_SUMMARY_SYSTEM_PROMPT = `Compress one segment of an agent's task evidence log for a quality-audit prompt. Output plain text only, at most 60 tokens, no preamble. Preserve: per-tool counts of [OK] and [FAIL] results, key verification commands (tests, typecheck, build, git — include commit hashes when shown), sent-message receipts, and any failure text verbatim. Omit routine noise.`;
|
|
224
|
+
/**
|
|
225
|
+
* Split evidence lines into chunks: the newest chunk stays raw, every older
|
|
226
|
+
* chunk becomes one sub-summary. Chunk size targets CHUNK_TARGET_LINES but
|
|
227
|
+
* grows when that would need more than MAX_CHUNK_SUMMARIES sub-calls, so
|
|
228
|
+
* the bound holds for a log of any length.
|
|
229
|
+
*/
|
|
230
|
+
function splitEvidenceChunks(lines) {
|
|
231
|
+
const summaryCount = Math.max(1, Math.min(MAX_CHUNK_SUMMARIES, Math.ceil(lines.length / CHUNK_TARGET_LINES) - 1));
|
|
232
|
+
const chunkSize = Math.ceil(lines.length / (summaryCount + 1));
|
|
233
|
+
const chunks = [];
|
|
234
|
+
for (let i = 0; i < lines.length; i += chunkSize) {
|
|
235
|
+
chunks.push(lines.slice(i, i + chunkSize));
|
|
236
|
+
}
|
|
237
|
+
return chunks;
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Bound a sub-summary promise by a hard wall-clock timeout so a hung seam
|
|
241
|
+
* can never stall the judge; rejects on timeout, otherwise resolves with
|
|
242
|
+
* the seam's own { text } / { error } result.
|
|
243
|
+
*/
|
|
244
|
+
function withSubCallTimeout(call, label) {
|
|
245
|
+
return new Promise((resolve, reject) => {
|
|
246
|
+
const timer = setTimeout(() => reject(new Error(`${label} timed out`)), CHUNK_SUMMARY_TIMEOUT_MS);
|
|
247
|
+
call.then((result) => {
|
|
248
|
+
clearTimeout(timer);
|
|
249
|
+
resolve(result);
|
|
250
|
+
}, (err) => {
|
|
251
|
+
clearTimeout(timer);
|
|
252
|
+
reject(err instanceof Error ? err : new Error(String(err)));
|
|
253
|
+
});
|
|
254
|
+
});
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Render task evidence into the judge's final prompt lines, keeping
|
|
258
|
+
* full-log coverage when the log exceeds TASK_EVIDENCE_CAP:
|
|
259
|
+
*
|
|
260
|
+
* - At or under the cap: returns renderTaskEvidence(evidence) — no LLM
|
|
261
|
+
* calls, byte-identical to the legacy render.
|
|
262
|
+
* - Over the cap: the log is split into chunks; each older chunk is
|
|
263
|
+
* compacted by one parallel LLM sub-summary call (bounded, signal-aware)
|
|
264
|
+
* and the newest chunk stays raw. The result is one numbered summary
|
|
265
|
+
* line per older chunk (oldest first), then the raw newest chunk, then —
|
|
266
|
+
* only when the caller passed pre-truncated evidence — the explicit
|
|
267
|
+
* count line.
|
|
268
|
+
* - ANY sub-call failure (error, timeout, abort, empty output) logs and
|
|
269
|
+
* returns null: the caller falls back to renderTaskEvidence, whose
|
|
270
|
+
* drop-oldest render is the legacy behavior. Chunking never blocks or
|
|
271
|
+
* breaks the judge.
|
|
272
|
+
*/
|
|
273
|
+
export async function summarizeTaskEvidence(ctx, evidence, options = {}) {
|
|
274
|
+
if (evidence.lines.length <= TASK_EVIDENCE_CAP) {
|
|
275
|
+
return renderTaskEvidence(evidence);
|
|
276
|
+
}
|
|
277
|
+
const chunks = splitEvidenceChunks(evidence.lines);
|
|
278
|
+
const summarize = options.summarizeLlm ??
|
|
279
|
+
((systemPrompt, userPrompt, subOptions) => callLlm(ctx, systemPrompt, userPrompt, {
|
|
280
|
+
timeoutMs: CHUNK_SUMMARY_TIMEOUT_MS,
|
|
281
|
+
maxRetries: 0, // best-effort sub-calls: fail fast into the fallback instead of retrying
|
|
282
|
+
...(subOptions.signal ? { signal: subOptions.signal } : {}),
|
|
283
|
+
}));
|
|
284
|
+
// Line range (1-based) each chunk covers, for the sub-summary prompts.
|
|
285
|
+
const ranges = [];
|
|
286
|
+
let offset = 0;
|
|
287
|
+
for (const chunk of chunks) {
|
|
288
|
+
ranges.push(`${offset + 1}-${offset + chunk.length}`);
|
|
289
|
+
offset += chunk.length;
|
|
290
|
+
}
|
|
291
|
+
try {
|
|
292
|
+
// Map: one sub-summary per older chunk, all in parallel; each bounded
|
|
293
|
+
// by the hard timeout so a slow model cannot outlive the judge budget.
|
|
294
|
+
const summaries = await Promise.all(chunks.slice(0, -1).map((chunk, i) => withSubCallTimeout(summarize(CHUNK_SUMMARY_SYSTEM_PROMPT, `Evidence lines ${ranges[i]} of ${evidence.lines.length} (oldest first):\n${chunk.join("\n")}`, { signal: options.signal }), `evidence chunk ${i + 1}/${chunks.length - 1} summary`).then((result) => {
|
|
295
|
+
if ("error" in result) {
|
|
296
|
+
throw new Error(`chunk ${i + 1} summary failed: ${result.error}`);
|
|
297
|
+
}
|
|
298
|
+
const text = result.text.trim();
|
|
299
|
+
if (!text) {
|
|
300
|
+
throw new Error(`chunk ${i + 1} summary was empty`);
|
|
301
|
+
}
|
|
302
|
+
return text.length > MAX_CHUNK_SUMMARY_CHARS
|
|
303
|
+
? text.slice(0, MAX_CHUNK_SUMMARY_CHARS) + "…"
|
|
304
|
+
: text;
|
|
305
|
+
})));
|
|
306
|
+
// Reduce: numbered summaries oldest-first, then the raw newest chunk.
|
|
307
|
+
const rendered = [];
|
|
308
|
+
chunks.forEach((chunk, i) => {
|
|
309
|
+
if (i < chunks.length - 1) {
|
|
310
|
+
rendered.push(`(chunk ${i + 1}/${chunks.length} summary) ${summaries[i]}`);
|
|
311
|
+
}
|
|
312
|
+
else {
|
|
313
|
+
rendered.push(...chunk);
|
|
314
|
+
}
|
|
315
|
+
});
|
|
316
|
+
// Pre-truncated evidence (entries the summarizer never saw) keeps the
|
|
317
|
+
// explicit count line; the wired call site collects uncapped, so this
|
|
318
|
+
// is a defensive branch only.
|
|
319
|
+
if (evidence.truncatedCount > 0) {
|
|
320
|
+
rendered.push(truncationCountLine(evidence.truncatedCount, evidence.lines.length));
|
|
321
|
+
}
|
|
322
|
+
return rendered;
|
|
323
|
+
}
|
|
324
|
+
catch (e) {
|
|
325
|
+
const message = e.message;
|
|
326
|
+
if (/abort/i.test(message)) {
|
|
327
|
+
log.debug(`task evidence chunk summaries aborted (${message}); using drop-oldest truncation`);
|
|
328
|
+
}
|
|
329
|
+
else {
|
|
330
|
+
log.warn(`task evidence chunk summaries failed (${message}); using drop-oldest truncation`);
|
|
331
|
+
}
|
|
332
|
+
return null;
|
|
333
|
+
}
|
|
334
|
+
}
|
|
335
|
+
//# sourceMappingURL=task-evidence.js.map
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Enforcement types - Shared interfaces and type definitions
|
|
3
|
+
*/
|
|
4
|
+
export interface TurnState {
|
|
5
|
+
turnIndex: number;
|
|
6
|
+
plannedTools: string[];
|
|
7
|
+
actualTools: string[];
|
|
8
|
+
/** Truncated output summaries for verification-relevant tools (bash, verify, edit/write).
|
|
9
|
+
* Each entry: "toolName: <first ~300 chars of output>".
|
|
10
|
+
* Used by the verification judge at MESSAGE_END to see actual tool results. */
|
|
11
|
+
toolOutputs: string[];
|
|
12
|
+
scratchpadUpdated: boolean;
|
|
13
|
+
memoryUpdated: boolean;
|
|
14
|
+
sequenceRepetitionCount: number;
|
|
15
|
+
thinkCalledBeforeEdit: boolean;
|
|
16
|
+
planCalledForBugFix: boolean;
|
|
17
|
+
}
|
|
18
|
+
export interface ValidationResult {
|
|
19
|
+
passed: boolean;
|
|
20
|
+
issues: string[];
|
|
21
|
+
nudge: string | null;
|
|
22
|
+
severity: "info" | "warning" | "critical";
|
|
23
|
+
}
|
|
24
|
+
export interface ToolSequencePattern {
|
|
25
|
+
sequence: string[];
|
|
26
|
+
count: number;
|
|
27
|
+
lastSeen: number;
|
|
28
|
+
}
|
|
29
|
+
export interface ToolChainState {
|
|
30
|
+
lastThinkCall: number;
|
|
31
|
+
lastPlanCall: number;
|
|
32
|
+
recentEditWithoutThink: number[];
|
|
33
|
+
recentEditWithoutPlan: number[];
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Validation Logic
|
|
3
|
+
*
|
|
4
|
+
* Validates turns and tool usage patterns with smart detection that avoids
|
|
5
|
+
* false positives for legitimate workflows (e.g. reading different files).
|
|
6
|
+
*/
|
|
7
|
+
import type { TurnState, ValidationResult } from "./types.js";
|
|
8
|
+
/**
|
|
9
|
+
* Validate a turn's tool usage
|
|
10
|
+
*/
|
|
11
|
+
export declare function validateTurn(_previousState: TurnState | undefined, currentState: TurnState, ctx: any, erroredTools?: Set<string>, isInfrastructureError?: boolean): ValidationResult;
|
|
12
|
+
//# sourceMappingURL=validation.d.ts.map
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Validation Logic
|
|
3
|
+
*
|
|
4
|
+
* Validates turns and tool usage patterns with smart detection that avoids
|
|
5
|
+
* false positives for legitimate workflows (e.g. reading different files).
|
|
6
|
+
*/
|
|
7
|
+
import { ENFORCEMENT_PARAMS, getState } from "./state.js";
|
|
8
|
+
import { PROGRESS_TOOLS } from "./substate/tool-tracking-state.js";
|
|
9
|
+
// Tools that are cheap to repeat legitimately (different files/targets)
|
|
10
|
+
const LEGIT_REPEATABLE = new Set(["read", "grep", "find"]);
|
|
11
|
+
/**
|
|
12
|
+
* Check if a tool sequence is semantically repetitive.
|
|
13
|
+
* "read,read" on different files is fine. "read,read" on same file is wasteful.
|
|
14
|
+
*
|
|
15
|
+
* Returns:
|
|
16
|
+
* - null : not a repetition problem
|
|
17
|
+
* - string: the issue message
|
|
18
|
+
*/
|
|
19
|
+
function checkSemanticRepetition(currentTools, prevSeqs, warnThreshold) {
|
|
20
|
+
// Single-tool repetition: "read,read", "bash,bash"
|
|
21
|
+
// These are NOT flagged as issues since read can hit different files,
|
|
22
|
+
// bash can run different commands. Only flag if same PATH is targeted
|
|
23
|
+
// (detected elsewhere via file path tracking).
|
|
24
|
+
if (currentTools.length === 1 ||
|
|
25
|
+
(currentTools.length === 2 && currentTools[0] === currentTools[1])) {
|
|
26
|
+
return null;
|
|
27
|
+
}
|
|
28
|
+
const currentSeq = currentTools.join(",");
|
|
29
|
+
const repetitions = prevSeqs.filter((s) => s.join(",") === currentSeq).length;
|
|
30
|
+
if (repetitions >= warnThreshold) {
|
|
31
|
+
// Build a contextual message instead of raw tool names
|
|
32
|
+
const tools = currentTools.join(" -> ");
|
|
33
|
+
// If the sequence contains only cheap/repeatable tools, be softer
|
|
34
|
+
const allRepeatable = currentTools.every((t) => LEGIT_REPEATABLE.has(t));
|
|
35
|
+
if (allRepeatable) {
|
|
36
|
+
return (`Exploration sequence "${tools}" repeated ${repetitions + 1} times without progress. ` +
|
|
37
|
+
`Consider: editing files, running commands, or using think() to plan next steps.`);
|
|
38
|
+
}
|
|
39
|
+
return `Tool sequence "${tools}" repeated ${repetitions + 1} times. Consider a different approach.`;
|
|
40
|
+
}
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Detect wasteful re-reads: same file read without intervening progress.
|
|
45
|
+
* This is the real problem behind "read,read" false positives.
|
|
46
|
+
*
|
|
47
|
+
* `reReadPaths` comes from the recentlyReadFiles map: recordToolInput stores
|
|
48
|
+
* each read under its tool-call position and flags a path at read time when
|
|
49
|
+
* the prior read has no progress tool after it. The list is per-turn and is
|
|
50
|
+
* consumed by the caller.
|
|
51
|
+
*/
|
|
52
|
+
function checkReReadWaste(currentTools, prevTools, reReadPaths) {
|
|
53
|
+
// Only relevant for read-heavy turns
|
|
54
|
+
const readCount = currentTools.filter((t) => t === "read").length;
|
|
55
|
+
if (readCount < 2)
|
|
56
|
+
return null;
|
|
57
|
+
if (reReadPaths.length > 0) {
|
|
58
|
+
const shown = reReadPaths.slice(0, 3).join(", ");
|
|
59
|
+
const rest = reReadPaths.length > 3 ? ` (+${reReadPaths.length - 3} more)` : "";
|
|
60
|
+
return (`Re-read ${reReadPaths.length} file(s) already in context with no edit or command since: ` +
|
|
61
|
+
`${shown}${rest}. Work from the earlier read output instead of re-reading.`);
|
|
62
|
+
}
|
|
63
|
+
// Check if we've seen a read-only streak recently (no progress tools in between)
|
|
64
|
+
let streak = 0;
|
|
65
|
+
for (let i = prevTools.length - 1; i >= 0; i--) {
|
|
66
|
+
const tools = prevTools[i];
|
|
67
|
+
if (tools.length === 1 && tools[0] === "read") {
|
|
68
|
+
streak++;
|
|
69
|
+
}
|
|
70
|
+
else if (tools.some((t) => PROGRESS_TOOLS.has(t))) {
|
|
71
|
+
break;
|
|
72
|
+
}
|
|
73
|
+
else {
|
|
74
|
+
streak++;
|
|
75
|
+
if (streak > 3)
|
|
76
|
+
break;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
if (streak >= 8 && readCount >= 5) {
|
|
80
|
+
return (`You've spent ${streak + 1} turns mostly reading. Store what you've learned: ` +
|
|
81
|
+
`memory_store(content="...", tags=["pattern", "codebase"]) and update scratchpad before continuing.`);
|
|
82
|
+
}
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
/**
|
|
86
|
+
* Validate a turn's tool usage
|
|
87
|
+
*/
|
|
88
|
+
export function validateTurn(_previousState, currentState, ctx, erroredTools = new Set(), isInfrastructureError = false) {
|
|
89
|
+
const s = getState(ctx);
|
|
90
|
+
const issues = [];
|
|
91
|
+
const hadErrors = erroredTools.size > 0;
|
|
92
|
+
// Consume the per-turn re-read list here, even on turns that skip the
|
|
93
|
+
// checks below, so it cannot leak into the next turn's report.
|
|
94
|
+
const reReadWastePaths = s.turnReReadWastePaths;
|
|
95
|
+
s.turnReReadWastePaths = [];
|
|
96
|
+
// Skip if infrastructure error (API timeout, rate-limit, etc.) - the agent tried to work but couldn't
|
|
97
|
+
if (isInfrastructureError) {
|
|
98
|
+
// Don't penalize the agent for infrastructure failures
|
|
99
|
+
s.silentTurns = 0;
|
|
100
|
+
}
|
|
101
|
+
else if (currentState.actualTools.length === 0) {
|
|
102
|
+
s.silentTurns++;
|
|
103
|
+
if (s.silentTurns >= ENFORCEMENT_PARAMS.maxSilentTurns) {
|
|
104
|
+
issues.push(`${s.silentTurns} turns without tool calls. You work through tools - reach for read, bash, edit, write to make progress.`);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
else {
|
|
108
|
+
s.silentTurns = 0;
|
|
109
|
+
}
|
|
110
|
+
// Check for tool sequence repetition - smart detection avoids false positives
|
|
111
|
+
if (!hadErrors && currentState.actualTools.length > 0) {
|
|
112
|
+
const prevSeqs = s.recentToolSequences.slice(-ENFORCEMENT_PARAMS.warnOnToolSequenceRepetition);
|
|
113
|
+
// Semantic repetition check (handles read,read etc. properly)
|
|
114
|
+
const seqIssue = checkSemanticRepetition(currentState.actualTools, prevSeqs, ENFORCEMENT_PARAMS.warnOnToolSequenceRepetition);
|
|
115
|
+
if (seqIssue) {
|
|
116
|
+
issues.push(seqIssue);
|
|
117
|
+
}
|
|
118
|
+
// Re-read waste detection
|
|
119
|
+
const readWasteIssue = checkReReadWaste(currentState.actualTools, prevSeqs, reReadWastePaths);
|
|
120
|
+
if (readWasteIssue) {
|
|
121
|
+
issues.push(readWasteIssue);
|
|
122
|
+
}
|
|
123
|
+
// Track sequence (always, for next-turn analysis)
|
|
124
|
+
s.recentToolSequences.push([...currentState.actualTools]);
|
|
125
|
+
if (s.recentToolSequences.length > 20) {
|
|
126
|
+
s.recentToolSequences.shift();
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
// Generate nudge message
|
|
130
|
+
let nudge = null;
|
|
131
|
+
let severity = "info";
|
|
132
|
+
if (issues.length > 0) {
|
|
133
|
+
if (!hadErrors) {
|
|
134
|
+
s.validationFailures++;
|
|
135
|
+
}
|
|
136
|
+
severity =
|
|
137
|
+
s.validationFailures > 3 ? "critical" : s.validationFailures > 1 ? "warning" : "info";
|
|
138
|
+
nudge = `
|
|
139
|
+
## Turn Validation Failed
|
|
140
|
+
|
|
141
|
+
${issues.map((i) => `- ${i}`).join("\n")}
|
|
142
|
+
`;
|
|
143
|
+
}
|
|
144
|
+
return {
|
|
145
|
+
passed: issues.length === 0,
|
|
146
|
+
issues,
|
|
147
|
+
nudge,
|
|
148
|
+
severity,
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
//# sourceMappingURL=validation.js.map
|