pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,378 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* context_navigate - Navigate session history, tag, and inspect.
|
|
3
|
+
*
|
|
4
|
+
* Consolidates context_log (view history), context_checkout (navigate to point),
|
|
5
|
+
* and context_tag (create save point) into one tool with action param.
|
|
6
|
+
*/
|
|
7
|
+
import { Type } from "typebox";
|
|
8
|
+
import { resolveTarget, findByLabel, resolveDefaultTarget, getRecoveryFallback, getCmState, isInternal, recordNavigationAction, } from "../shared.js";
|
|
9
|
+
import { getContextUsage } from "../../../../../lib/detection/context-tiers.js";
|
|
10
|
+
import { formatTokensK } from "../../../../../lib/detection/context-usage.js";
|
|
11
|
+
export const contextNavigateSchema = Type.Object({
|
|
12
|
+
action: Type.String({
|
|
13
|
+
enum: ["log", "checkout", "tag"],
|
|
14
|
+
description: "log = view conversation history with milestones (like context_log). " +
|
|
15
|
+
"checkout = navigate to a point in history (like context_checkout). " +
|
|
16
|
+
"tag = create a named save point (like context_tag).",
|
|
17
|
+
}),
|
|
18
|
+
limit: Type.Optional(Type.Number({ description: "Max entries for log (default 50). Only used with action=log." })),
|
|
19
|
+
verbose: Type.Optional(Type.Boolean({ description: "Show all entries for log. Only used with action=log." })),
|
|
20
|
+
// checkout params
|
|
21
|
+
target: Type.Optional(Type.String({
|
|
22
|
+
description: "Tag name or entry ID to navigate to. Required for action=checkout.",
|
|
23
|
+
})),
|
|
24
|
+
message: Type.Optional(Type.String({
|
|
25
|
+
description: "Summary to carry forward. Required for action=checkout.",
|
|
26
|
+
})),
|
|
27
|
+
backupTag: Type.Optional(Type.String({
|
|
28
|
+
description: "Custom tag for current position before checkout; defaults to 'before-<target>'. action=checkout only.",
|
|
29
|
+
})),
|
|
30
|
+
// tag params
|
|
31
|
+
name: Type.Optional(Type.String({
|
|
32
|
+
description: "Tag/milestone name. Required for action=tag.",
|
|
33
|
+
})),
|
|
34
|
+
});
|
|
35
|
+
function formatLog(ctx, sm, params) {
|
|
36
|
+
const verbose = params.verbose ?? false;
|
|
37
|
+
const limit = params.limit ?? 50;
|
|
38
|
+
const branch = sm.getBranch();
|
|
39
|
+
const currentLeafId = sm.getLeafId();
|
|
40
|
+
const backboneIds = new Set(branch.map((e) => e.id));
|
|
41
|
+
const sequence = [];
|
|
42
|
+
branch.forEach((entry) => {
|
|
43
|
+
sequence.push(entry);
|
|
44
|
+
sm.getChildren(entry.id).forEach((child) => {
|
|
45
|
+
if ((child.type === "branch_summary" || child.type === "compaction") &&
|
|
46
|
+
!backboneIds.has(child.id)) {
|
|
47
|
+
sequence.push(child);
|
|
48
|
+
}
|
|
49
|
+
});
|
|
50
|
+
});
|
|
51
|
+
const isInteresting = (entry) => {
|
|
52
|
+
if (entry.id === currentLeafId)
|
|
53
|
+
return true;
|
|
54
|
+
if (branch.length > 0 && entry.id === branch[0].id)
|
|
55
|
+
return true;
|
|
56
|
+
if (sm.getLabel(entry.id))
|
|
57
|
+
return true;
|
|
58
|
+
if (entry.type === "branch_summary" || entry.type === "compaction")
|
|
59
|
+
return true;
|
|
60
|
+
if (sm.getChildren(entry.id).length > 1)
|
|
61
|
+
return true;
|
|
62
|
+
if (entry.type === "message" && entry.message.role === "user")
|
|
63
|
+
return true;
|
|
64
|
+
return false;
|
|
65
|
+
};
|
|
66
|
+
const visibleIds = new Set();
|
|
67
|
+
sequence.forEach((e) => {
|
|
68
|
+
if (verbose || isInteresting(e))
|
|
69
|
+
visibleIds.add(e.id);
|
|
70
|
+
});
|
|
71
|
+
const visibleArr = sequence.filter((e) => visibleIds.has(e.id));
|
|
72
|
+
const trimmed = visibleArr.slice(-limit);
|
|
73
|
+
const trimmedIds = new Set(trimmed.map((e) => e.id));
|
|
74
|
+
const lines = [];
|
|
75
|
+
let hiddenCount = 0;
|
|
76
|
+
sequence.forEach((entry) => {
|
|
77
|
+
if (!trimmedIds.has(entry.id)) {
|
|
78
|
+
hiddenCount++;
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
if (hiddenCount > 0) {
|
|
82
|
+
lines.push(` : ... (${hiddenCount} hidden) ...`);
|
|
83
|
+
hiddenCount = 0;
|
|
84
|
+
}
|
|
85
|
+
const isHead = entry.id === currentLeafId;
|
|
86
|
+
const label = sm.getLabel(entry.id);
|
|
87
|
+
let role = entry.type.toUpperCase();
|
|
88
|
+
let body = "";
|
|
89
|
+
if (entry.type === "message") {
|
|
90
|
+
const msg = entry.message;
|
|
91
|
+
if (msg.role === "toolResult") {
|
|
92
|
+
if (verbose || !isInternal(msg.toolName)) {
|
|
93
|
+
const details = msg.details;
|
|
94
|
+
const path = details?.path ? details.path.split("/").pop() + ": " : "";
|
|
95
|
+
const text = (msg.content?.[0]?.text ?? "").toString();
|
|
96
|
+
body = `(${msg.toolName}) ${path}${text.slice(0, 80)}`;
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
else if (msg.role === "user") {
|
|
100
|
+
const text = typeof msg.content === "string" ? msg.content : (msg.content?.[0]?.text ?? "");
|
|
101
|
+
body = text.slice(0, 80);
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
else if (entry.type === "branch_summary" || entry.type === "compaction") {
|
|
105
|
+
body = (entry.summary || "").slice(0, 80);
|
|
106
|
+
role = "SUMMARY";
|
|
107
|
+
}
|
|
108
|
+
const meta = [isHead ? "HEAD" : null, label ? `tag: ${label}` : null]
|
|
109
|
+
.filter(Boolean)
|
|
110
|
+
.join(", ");
|
|
111
|
+
const marker = isHead ? "*" : role === "USER" ? "*" : "|";
|
|
112
|
+
lines.push(`${marker} ${entry.id}${meta ? ` (${meta})` : ""} [${role}] ${body}`);
|
|
113
|
+
});
|
|
114
|
+
if (hiddenCount > 0)
|
|
115
|
+
lines.push(` : ... (${hiddenCount} hidden) ...`);
|
|
116
|
+
let usageStr = "unknown";
|
|
117
|
+
try {
|
|
118
|
+
const usage = getContextUsage(ctx);
|
|
119
|
+
if (usage) {
|
|
120
|
+
const pct = usage.percent?.toFixed(1) || "?";
|
|
121
|
+
// tokens/contextWindow are required on the tool-exec ctx per the
|
|
122
|
+
// session-manager contract; defaults never fire (preserved from the
|
|
123
|
+
// original required-typed access).
|
|
124
|
+
const tokens = usage.tokens ?? 0;
|
|
125
|
+
const contextWindow = usage.contextWindow ?? 0;
|
|
126
|
+
usageStr = `${pct}% (${formatTokensK(tokens)}/${formatTokensK(contextWindow)})`;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
// Usage line is display-only context for navigation output; omitting it
|
|
131
|
+
// beats failing the navigation itself.
|
|
132
|
+
}
|
|
133
|
+
let steps = 0;
|
|
134
|
+
let nearestTag = "none";
|
|
135
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
136
|
+
const lbl = sm.getLabel(branch[i].id);
|
|
137
|
+
if (lbl) {
|
|
138
|
+
nearestTag = lbl;
|
|
139
|
+
break;
|
|
140
|
+
}
|
|
141
|
+
steps++;
|
|
142
|
+
}
|
|
143
|
+
const hud = `[Context] Usage: ${usageStr} - Segment: ${steps} steps since '${nearestTag}'`;
|
|
144
|
+
return hud + "\n" + (lines.join("\n") || "(empty)");
|
|
145
|
+
}
|
|
146
|
+
export function registerContextNavigate(pi) {
|
|
147
|
+
pi.registerTool({
|
|
148
|
+
name: "context_navigate",
|
|
149
|
+
label: "Context Navigate",
|
|
150
|
+
promptSnippet: "View history, navigate to a point, or create a save point",
|
|
151
|
+
description: "Navigate session history. " +
|
|
152
|
+
"Pipeline: tag your position before archival — use action=tag to create a save point, " +
|
|
153
|
+
"then call context_compress(action='archive') to compress older messages. " +
|
|
154
|
+
"action=log: view conversation history with milestones (like context_log). " + // tool-ref-exempt: legacy name cited in the action description as its predecessor
|
|
155
|
+
"action=checkout: navigate to any point in history. Auto-tags the current position as 'before-<target>' and captures recent context into the branch summary. " +
|
|
156
|
+
"Provide a `message` describing what you're going to do at the target. " +
|
|
157
|
+
"action=tag: create a named save point (like context_tag). " + // tool-ref-exempt: legacy name cited in the action description as its predecessor
|
|
158
|
+
"When to use: tag before any major operation (starting complex work, before a risky edit). " +
|
|
159
|
+
"Log when you feel lost in history. Checkout to explore a leaf branch, then checkout back to resume.",
|
|
160
|
+
parameters: contextNavigateSchema,
|
|
161
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
|
|
162
|
+
const action = params.action;
|
|
163
|
+
const sm = ctx.sessionManager;
|
|
164
|
+
if (action === "log") {
|
|
165
|
+
const result = formatLog(ctx, sm, params);
|
|
166
|
+
if (typeof result === "object" && "error" in result) {
|
|
167
|
+
return {
|
|
168
|
+
content: [{ type: "text", text: result.text }],
|
|
169
|
+
details: { action, error: true },
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
// Only a real log render counts as navigation adoption (option B §8).
|
|
173
|
+
recordNavigationAction(ctx, "log");
|
|
174
|
+
return {
|
|
175
|
+
content: [{ type: "text", text: result }],
|
|
176
|
+
details: {
|
|
177
|
+
action,
|
|
178
|
+
nextStep: result.includes("(empty)")
|
|
179
|
+
? undefined
|
|
180
|
+
: {
|
|
181
|
+
tool: "context_navigate",
|
|
182
|
+
action: "checkout",
|
|
183
|
+
note: "pick a target from log output",
|
|
184
|
+
},
|
|
185
|
+
},
|
|
186
|
+
};
|
|
187
|
+
}
|
|
188
|
+
if (action === "checkout") {
|
|
189
|
+
if (!params.target || !params.message) {
|
|
190
|
+
return {
|
|
191
|
+
content: [
|
|
192
|
+
{
|
|
193
|
+
type: "text",
|
|
194
|
+
text: "target and message are required for action=checkout",
|
|
195
|
+
},
|
|
196
|
+
],
|
|
197
|
+
details: { action, error: "missing required params" },
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
const targetId = resolveTarget(ctx, params.target);
|
|
201
|
+
const currentLeaf = sm.getLeafId();
|
|
202
|
+
// When resolveTarget returns null, propose a recovery fallback
|
|
203
|
+
// instead of dead-ending: an unresolved target must leave the agent a
|
|
204
|
+
// path forward (most-recent tag or session root), not a
|
|
205
|
+
// "Could not resolve target" error and an aborted turn.
|
|
206
|
+
if (!targetId) {
|
|
207
|
+
const fallback = getRecoveryFallback(ctx, params.target);
|
|
208
|
+
if (fallback) {
|
|
209
|
+
return {
|
|
210
|
+
content: [
|
|
211
|
+
{
|
|
212
|
+
type: "text",
|
|
213
|
+
text: `Target '${params.target}' not found in this session.\n\n` +
|
|
214
|
+
`Recovery fallback available: '${fallback.label}' (${fallback.id}, ` +
|
|
215
|
+
`reason: ${fallback.reason}).\n\n` +
|
|
216
|
+
`If this is acceptable, run:\n` +
|
|
217
|
+
` context_navigate(action="checkout", target="${fallback.id}", message="...")\n\n` +
|
|
218
|
+
`If not, run context_navigate(action="log") to inspect the session tree.`,
|
|
219
|
+
},
|
|
220
|
+
],
|
|
221
|
+
details: {
|
|
222
|
+
action,
|
|
223
|
+
error: "target_not_found",
|
|
224
|
+
recovery: fallback,
|
|
225
|
+
requested: params.target,
|
|
226
|
+
},
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
// No fallback: empty session, nothing to fall back to.
|
|
230
|
+
return {
|
|
231
|
+
content: [
|
|
232
|
+
{
|
|
233
|
+
type: "text",
|
|
234
|
+
text: `Target '${params.target}' not found and the session is empty. ` +
|
|
235
|
+
`No recovery fallback available. ` +
|
|
236
|
+
`Run context_navigate(action="log") once the session has content.`,
|
|
237
|
+
},
|
|
238
|
+
],
|
|
239
|
+
details: { action, error: "target_not_found", recovery: null },
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
if (currentLeaf === targetId) {
|
|
243
|
+
return {
|
|
244
|
+
content: [{ type: "text", text: `Already at ${targetId}` }],
|
|
245
|
+
details: { action, noop: true },
|
|
246
|
+
};
|
|
247
|
+
}
|
|
248
|
+
// Auto-tag current position if no backupTag provided (ensures a return point)
|
|
249
|
+
const tagName = params.backupTag || `before-${params.target}`;
|
|
250
|
+
if (currentLeaf) {
|
|
251
|
+
// Only tag if not already tagged with this name
|
|
252
|
+
const existingTag = sm.getLabel(currentLeaf);
|
|
253
|
+
if (!existingTag) {
|
|
254
|
+
sm.appendLabelChange(currentLeaf, tagName);
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
// Smart auto-capture: select the most useful content from the current branch
|
|
258
|
+
// Priority: finalize results > last user message > last assistant message
|
|
259
|
+
const branch = sm.getBranch();
|
|
260
|
+
const messageEntries = branch.filter((e) => e.type === "message" && e.message?.role);
|
|
261
|
+
// 1. Most recent finalize tool result (highest value — summarizes what was accomplished)
|
|
262
|
+
const finalizeResult = [...messageEntries]
|
|
263
|
+
.reverse()
|
|
264
|
+
.find((e) => e.message.role === "toolResult" && e.message.toolName === "finalize");
|
|
265
|
+
const finalizeSummary = finalizeResult
|
|
266
|
+
? typeof finalizeResult.message.content === "string"
|
|
267
|
+
? finalizeResult.message.content.slice(0, 200).replace(/\n/g, " ")
|
|
268
|
+
: ""
|
|
269
|
+
: null;
|
|
270
|
+
// 2. Last user message (task context — what was being worked on)
|
|
271
|
+
const lastUserMessage = [...messageEntries]
|
|
272
|
+
.reverse()
|
|
273
|
+
.find((e) => e.message.role === "user");
|
|
274
|
+
const userSummary = lastUserMessage
|
|
275
|
+
? typeof lastUserMessage.message.content === "string"
|
|
276
|
+
? lastUserMessage.message.content.slice(0, 150).replace(/\n/g, " ")
|
|
277
|
+
: "(non-text user message)"
|
|
278
|
+
: null;
|
|
279
|
+
// 3. Last assistant message (current thinking — what was being considered)
|
|
280
|
+
const lastAssistantMessage = [...messageEntries]
|
|
281
|
+
.reverse()
|
|
282
|
+
.find((e) => e.message.role === "assistant");
|
|
283
|
+
const assistantSummary = lastAssistantMessage
|
|
284
|
+
? typeof lastAssistantMessage.message.content === "string"
|
|
285
|
+
? lastAssistantMessage.message.content.slice(0, 150).replace(/\n/g, " ")
|
|
286
|
+
: "(non-text assistant message)"
|
|
287
|
+
: null;
|
|
288
|
+
const contextParts = [];
|
|
289
|
+
if (finalizeSummary)
|
|
290
|
+
contextParts.push(`[finalize] ${finalizeSummary}`);
|
|
291
|
+
if (userSummary)
|
|
292
|
+
contextParts.push(`[task] ${userSummary}`);
|
|
293
|
+
if (assistantSummary)
|
|
294
|
+
contextParts.push(`[thinking] ${assistantSummary}`);
|
|
295
|
+
const currentLabel = currentLeaf ? sm.getLabel(currentLeaf) : undefined;
|
|
296
|
+
const origin = currentLabel ? `tag: ${currentLabel}` : currentLeaf || "unknown";
|
|
297
|
+
const enriched = [
|
|
298
|
+
`Checkout from: ${origin}`,
|
|
299
|
+
...(contextParts.length > 0 ? contextParts : ["(no recent context)"]),
|
|
300
|
+
`Follow-up: ${params.message}`,
|
|
301
|
+
].join("\n");
|
|
302
|
+
const newId = sm.branchWithSummary(targetId, enriched);
|
|
303
|
+
getCmState(ctx).checkoutParams = {
|
|
304
|
+
target: params.target,
|
|
305
|
+
newId,
|
|
306
|
+
targetId,
|
|
307
|
+
backupTag: params.backupTag,
|
|
308
|
+
};
|
|
309
|
+
// Abort only after a successful branchWithSummary: aborting on a
|
|
310
|
+
// failed checkout kills the turn and leaves the session
|
|
311
|
+
// half-checked-out (a corrupt session then fails the next LLM call).
|
|
312
|
+
ctx.abort();
|
|
313
|
+
// The checkout actually committed (branchWithSummary succeeded), so
|
|
314
|
+
// count it as navigation adoption (option B §8).
|
|
315
|
+
recordNavigationAction(ctx, "checkout");
|
|
316
|
+
return {
|
|
317
|
+
content: [{ type: "text", text: `Checking out ${params.target}...` }],
|
|
318
|
+
details: {
|
|
319
|
+
action,
|
|
320
|
+
checkout: true,
|
|
321
|
+
newId,
|
|
322
|
+
tagName,
|
|
323
|
+
origin,
|
|
324
|
+
nextStep: { tool: "context_inspect", detail: "quick" },
|
|
325
|
+
},
|
|
326
|
+
};
|
|
327
|
+
}
|
|
328
|
+
if (action === "tag") {
|
|
329
|
+
if (!params.name) {
|
|
330
|
+
return {
|
|
331
|
+
content: [{ type: "text", text: "name is required for action=tag" }],
|
|
332
|
+
details: { action, error: "missing required params" },
|
|
333
|
+
};
|
|
334
|
+
}
|
|
335
|
+
let targetId = params.target ? resolveTarget(ctx, params.target) : null;
|
|
336
|
+
if (!targetId)
|
|
337
|
+
targetId = resolveDefaultTarget(ctx);
|
|
338
|
+
if (!targetId) {
|
|
339
|
+
return {
|
|
340
|
+
content: [
|
|
341
|
+
{ type: "text", text: "No entry to tag. Conversation may be empty." },
|
|
342
|
+
],
|
|
343
|
+
details: { action },
|
|
344
|
+
};
|
|
345
|
+
}
|
|
346
|
+
const existing = findByLabel(ctx, params.name);
|
|
347
|
+
if (existing) {
|
|
348
|
+
return {
|
|
349
|
+
content: [
|
|
350
|
+
{
|
|
351
|
+
type: "text",
|
|
352
|
+
text: `Tag '${params.name}' already exists at ${existing}. Use a different name.`,
|
|
353
|
+
},
|
|
354
|
+
],
|
|
355
|
+
details: { action, error: true, existingId: existing },
|
|
356
|
+
};
|
|
357
|
+
}
|
|
358
|
+
sm.appendLabelChange(targetId, params.name);
|
|
359
|
+
// The tag was written — count it as navigation adoption (option B §8).
|
|
360
|
+
recordNavigationAction(ctx, "tag");
|
|
361
|
+
return {
|
|
362
|
+
content: [{ type: "text", text: `Created tag '${params.name}' at ${targetId}` }],
|
|
363
|
+
details: {
|
|
364
|
+
action,
|
|
365
|
+
tag: params.name,
|
|
366
|
+
targetId,
|
|
367
|
+
nextStep: { tool: "context_compress", action: "archive", beforeTag: params.name },
|
|
368
|
+
},
|
|
369
|
+
};
|
|
370
|
+
}
|
|
371
|
+
return {
|
|
372
|
+
content: [{ type: "text", text: "Unknown action. Use log, checkout, or tag." }],
|
|
373
|
+
details: { action, error: true },
|
|
374
|
+
};
|
|
375
|
+
},
|
|
376
|
+
});
|
|
377
|
+
}
|
|
378
|
+
//# sourceMappingURL=context-navigate.js.map
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Type } from "typebox";
|
|
2
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
3
|
+
export declare const offloadRecoverSchema: Type.TObject<{
|
|
4
|
+
path: Type.TString;
|
|
5
|
+
maxChars: Type.TOptional<Type.TNumber>;
|
|
6
|
+
}>;
|
|
7
|
+
/**
|
|
8
|
+
* Register offload_recover. Deferred exposure like the other context-manager
|
|
9
|
+
* tools: the stub is the discovery surface, this tool is the affordance it
|
|
10
|
+
* names.
|
|
11
|
+
*/
|
|
12
|
+
export declare function registerOffloadRecover(pi: ExtensionAPI): void;
|
|
13
|
+
//# sourceMappingURL=offload-recover.d.ts.map
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
// Offload recovery (offload_recover).
|
|
2
|
+
//
|
|
3
|
+
// The capture-time toolResult size cap flushes oversized results losslessly
|
|
4
|
+
// to disk and stubs them. For images the stub carries no pixels, and the
|
|
5
|
+
// obvious recovery — reading the image back — produces another oversized
|
|
6
|
+
// result that the same cap stubs again: a closed loop where a large render
|
|
7
|
+
// never reaches the model. This tool is the recovery seam the stub names:
|
|
8
|
+
// it reads a flush file and returns its image blocks, downscaled when needed
|
|
9
|
+
// to a budget derived from the same cap, so the recovered view passes the
|
|
10
|
+
// cap instead of looping into another stub.
|
|
11
|
+
//
|
|
12
|
+
// The budget arithmetic keeps that promise: maxBytes in pi-core's resizeImage
|
|
13
|
+
// is compared against the base64 string length (the same unit
|
|
14
|
+
// estimateMessageChars counts for image data), the per-image target shrinks
|
|
15
|
+
// with every delivered image, and the assembled result is re-measured before
|
|
16
|
+
// it is returned. If nothing fits — corrupt bytes, no image backend, a
|
|
17
|
+
// budget too small to matter — the tool says so in text instead of emitting
|
|
18
|
+
// a result that would be stubbed again. The original always stays on disk.
|
|
19
|
+
import { readFileSync } from "node:fs";
|
|
20
|
+
import { isAbsolute, resolve, sep } from "node:path";
|
|
21
|
+
import { Type } from "typebox";
|
|
22
|
+
import { resizeImage } from "@earendil-works/pi-coding-agent";
|
|
23
|
+
import { getToolResultSizeCapConfig } from "../../../../../lib/config/braid-settings.js";
|
|
24
|
+
import { offloadDir } from "../../../../../lib/config/braid-paths.js";
|
|
25
|
+
/** Chars held back from the image budget for the note block that leads the result. */
|
|
26
|
+
const NOTE_MARGIN_CHARS = 1024;
|
|
27
|
+
/** The recovery budget is this fraction of the capture cap. */
|
|
28
|
+
const RECOVERY_BUDGET_DIVISOR = 2;
|
|
29
|
+
/** Longest flush path a note quotes before truncation. */
|
|
30
|
+
const MAX_NOTE_PATH_CHARS = 300;
|
|
31
|
+
function isImageBlock(b) {
|
|
32
|
+
const block = b;
|
|
33
|
+
return (!!block && typeof block === "object" && block.type === "image" && typeof block.data === "string");
|
|
34
|
+
}
|
|
35
|
+
function clampPath(p) {
|
|
36
|
+
return p.length > MAX_NOTE_PATH_CHARS ? `${p.slice(0, MAX_NOTE_PATH_CHARS)}...` : p;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Resolve the flush path the stub named. Only files inside the offload
|
|
40
|
+
* directory are readable here: the agent supplies the path, so containment
|
|
41
|
+
* is the security boundary. The root is resolved per call (offloadDir()) so
|
|
42
|
+
* it is the same directory the flushes were written to under BRAID_HOME.
|
|
43
|
+
*/
|
|
44
|
+
function resolveRecoverablePath(requested) {
|
|
45
|
+
const root = resolve(offloadDir());
|
|
46
|
+
const p = resolve(requested);
|
|
47
|
+
if (p === root || p.startsWith(root + sep))
|
|
48
|
+
return p;
|
|
49
|
+
return undefined;
|
|
50
|
+
}
|
|
51
|
+
function textResult(text, error = false) {
|
|
52
|
+
return {
|
|
53
|
+
content: [{ type: "text", text }],
|
|
54
|
+
details: error ? { error: true } : { error: false },
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
export const offloadRecoverSchema = Type.Object({
|
|
58
|
+
path: Type.String({
|
|
59
|
+
description: "Flush file path from an [offloaded ...] stub.",
|
|
60
|
+
}),
|
|
61
|
+
maxChars: Type.Optional(Type.Number({
|
|
62
|
+
description: "Char budget override for the delivered image(s); clamped to the capture cap. Default: half the cap.",
|
|
63
|
+
})),
|
|
64
|
+
});
|
|
65
|
+
/**
|
|
66
|
+
* Register offload_recover. Deferred exposure like the other context-manager
|
|
67
|
+
* tools: the stub is the discovery surface, this tool is the affordance it
|
|
68
|
+
* names.
|
|
69
|
+
*/
|
|
70
|
+
export function registerOffloadRecover(pi) {
|
|
71
|
+
pi.registerTool({
|
|
72
|
+
name: "offload_recover",
|
|
73
|
+
exposure: "deferred",
|
|
74
|
+
label: "Offload Recover",
|
|
75
|
+
promptSnippet: "Recover an oversized result flushed to the offload directory",
|
|
76
|
+
description: "Recover a tool result that was flushed to disk by an [offloaded ...] stub. " +
|
|
77
|
+
"Returns the image blocks from the flush file; images over the context budget " +
|
|
78
|
+
"are downscaled to fit (the lossless original stays on disk). Text-only flush " +
|
|
79
|
+
"files are read with the read tool instead.",
|
|
80
|
+
parameters: offloadRecoverSchema,
|
|
81
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
|
|
82
|
+
const cfg = getToolResultSizeCapConfig();
|
|
83
|
+
const cap = cfg.maxChars;
|
|
84
|
+
const requested = typeof params?.path === "string" ? params.path : "";
|
|
85
|
+
if (!requested)
|
|
86
|
+
return textResult("offload_recover needs the flush file path from the stub.", true);
|
|
87
|
+
if (!isAbsolute(requested)) {
|
|
88
|
+
return textResult(`Refusing: ${clampPath(requested)} is not an absolute flush path.`, true);
|
|
89
|
+
}
|
|
90
|
+
const path = resolveRecoverablePath(requested);
|
|
91
|
+
if (!path) {
|
|
92
|
+
return textResult(`Refusing: ${clampPath(requested)} is outside the offload directory.`, true);
|
|
93
|
+
}
|
|
94
|
+
const override = typeof params?.maxChars === "number" &&
|
|
95
|
+
Number.isFinite(params.maxChars) &&
|
|
96
|
+
params.maxChars >= 1
|
|
97
|
+
? Math.floor(params.maxChars)
|
|
98
|
+
: undefined;
|
|
99
|
+
// An override above the cap is clamped: a recovery result must never
|
|
100
|
+
// trip the same cap it is recovering from.
|
|
101
|
+
const effectiveBudget = Math.min(override ?? Math.floor(cap / RECOVERY_BUDGET_DIVISOR), cap);
|
|
102
|
+
const target = effectiveBudget - NOTE_MARGIN_CHARS;
|
|
103
|
+
if (target < 1) {
|
|
104
|
+
return textResult(`Budget too small to carry an image (braid.context.toolResultSizeCap.maxChars=${cap}).`, true);
|
|
105
|
+
}
|
|
106
|
+
let raw;
|
|
107
|
+
try {
|
|
108
|
+
raw = readFileSync(path, "utf-8");
|
|
109
|
+
}
|
|
110
|
+
catch (err) {
|
|
111
|
+
const code = err?.code ?? "unknown";
|
|
112
|
+
return textResult(`Cannot read ${clampPath(path)} (${String(code)}).`, true);
|
|
113
|
+
}
|
|
114
|
+
let parsed;
|
|
115
|
+
try {
|
|
116
|
+
parsed = JSON.parse(raw);
|
|
117
|
+
}
|
|
118
|
+
catch {
|
|
119
|
+
return textResult(`${clampPath(path)} is not a flush file (JSON content array).`, true);
|
|
120
|
+
}
|
|
121
|
+
if (!Array.isArray(parsed)) {
|
|
122
|
+
return textResult(`${clampPath(path)} is not a flush file (JSON content array).`, true);
|
|
123
|
+
}
|
|
124
|
+
const images = parsed.filter(isImageBlock);
|
|
125
|
+
if (images.length === 0) {
|
|
126
|
+
return textResult(`No image data in ${clampPath(path)}. If it holds text content, read it with the read tool.`);
|
|
127
|
+
}
|
|
128
|
+
const notes = [];
|
|
129
|
+
const deliveredBlocks = [];
|
|
130
|
+
let used = 0;
|
|
131
|
+
for (let i = 0; i < images.length; i++) {
|
|
132
|
+
const block = images[i];
|
|
133
|
+
const mimeType = typeof block.mimeType === "string" ? block.mimeType : "image/png";
|
|
134
|
+
const remaining = target - used;
|
|
135
|
+
if (block.data.length <= remaining) {
|
|
136
|
+
deliveredBlocks.push({ type: "image", data: block.data, mimeType });
|
|
137
|
+
used += block.data.length;
|
|
138
|
+
notes.push(`image ${i + 1}: delivered as-is (${mimeType}, ${block.data.length} chars)`);
|
|
139
|
+
continue;
|
|
140
|
+
}
|
|
141
|
+
let view;
|
|
142
|
+
try {
|
|
143
|
+
view = await resizeImage(new Uint8Array(Buffer.from(block.data, "base64")), mimeType, {
|
|
144
|
+
maxBytes: remaining,
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
catch {
|
|
148
|
+
view = null;
|
|
149
|
+
}
|
|
150
|
+
if (view && view.data.length <= remaining) {
|
|
151
|
+
deliveredBlocks.push({ type: "image", data: view.data, mimeType: view.mimeType });
|
|
152
|
+
used += view.data.length;
|
|
153
|
+
notes.push(`image ${i + 1}: downscaled ${mimeType} ${view.originalWidth}x${view.originalHeight} -> ` +
|
|
154
|
+
`${view.width}x${view.height} (${block.data.length} -> ${view.data.length} chars); original stays on disk`);
|
|
155
|
+
}
|
|
156
|
+
else {
|
|
157
|
+
notes.push(`image ${i + 1}: not recoverable under the remaining budget (${remaining} chars); original stays at ${clampPath(path)}`);
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
const delivered = deliveredBlocks.length;
|
|
161
|
+
const note = (delivered > 0
|
|
162
|
+
? `Recovered ${delivered}/${images.length} image(s) from ${clampPath(path)}: `
|
|
163
|
+
: `No image in ${clampPath(path)} fit the budget (${effectiveBudget} chars): `) +
|
|
164
|
+
notes.join("; ");
|
|
165
|
+
// Never re-offload: the assembled result is measured before it leaves.
|
|
166
|
+
if (note.length + used > cap - NOTE_MARGIN_CHARS) {
|
|
167
|
+
return textResult(`Recovery would exceed the cap; refusing. Original stays at ${clampPath(path)}.`, true);
|
|
168
|
+
}
|
|
169
|
+
return {
|
|
170
|
+
content: [{ type: "text", text: note }, ...deliveredBlocks],
|
|
171
|
+
details: {
|
|
172
|
+
path,
|
|
173
|
+
delivered,
|
|
174
|
+
totalImages: images.length,
|
|
175
|
+
budgetChars: effectiveBudget,
|
|
176
|
+
},
|
|
177
|
+
};
|
|
178
|
+
},
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
//# sourceMappingURL=offload-recover.js.map
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// Decomposed from 1141L monolith into slim index + 6 handler modules
|
|
2
|
+
// + 3 sub-tools in handlers/tools/.
|
|
3
|
+
//
|
|
4
|
+
// Handlers:
|
|
5
|
+
// shared.ts - state, helpers, retry logic, navigation
|
|
6
|
+
// compaction.ts - compaction events + retry + smart instructions
|
|
7
|
+
// compaction-retry.ts - turn-end retry reset
|
|
8
|
+
// events.ts - agent_end API-error guidance, context pruning
|
|
9
|
+
// navigation.ts - tree navigation + checkout
|
|
10
|
+
// rotation.ts - session rotation + shutdown
|
|
11
|
+
// tools/ - context_compress, context_inspect, context_navigate
|
|
12
|
+
// (registered inline below)
|
|
13
|
+
import { log, getCmState } from "./handlers/shared.js";
|
|
14
|
+
import { registerContextInspect } from "./handlers/tools/context-inspect.js";
|
|
15
|
+
import { registerContextCompress } from "./handlers/tools/context-compress.js";
|
|
16
|
+
import { registerContextNavigate } from "./handlers/tools/context-navigate.js";
|
|
17
|
+
import { registerOffloadRecover } from "./handlers/tools/offload-recover.js";
|
|
18
|
+
import { registerBeforeCompactHandler, registerSessionCompactHandler, registerSessionCompactOutcomeHandler, registerSessionCompactFailedHandler, } from "./handlers/compaction.js";
|
|
19
|
+
import { registerTurnEndRetryReset } from "./handlers/compaction-retry.js";
|
|
20
|
+
import { registerAgentEndRetryHandler, registerAgentEndApiErrorHandler, } from "./handlers/events.js";
|
|
21
|
+
import { registerBeforeTreeHandler, registerTurnEndCheckoutHandler, registerAgentEndRetryHandler as registerNavAgentEndRetry, } from "./handlers/navigation.js";
|
|
22
|
+
// registerContextPruningHandler stays disabled: the `context` event fires
|
|
23
|
+
// per-streaming-message, not pre-compaction, so its return value never feeds
|
|
24
|
+
// a compaction prep. handlers/offload.ts ALSO registers a `context` handler —
|
|
25
|
+
// that is NOT a revival of this disabled path: the offloader is a setting-gated
|
|
26
|
+
// (default OFF) per-request substitution whose return value IS applied by the
|
|
27
|
+
// installed pi-core (verified against node_modules 0.82.1 runner.js emitContext
|
|
28
|
+
// + agent-loop.js transformContext).
|
|
29
|
+
import { registerRotationHandlers, registerSessionShutdownHandler } from "./handlers/rotation.js";
|
|
30
|
+
import { registerStaleToolResultOffloader } from "./handlers/offload.js";
|
|
31
|
+
import { registerContextEmergencyOffloader } from "./handlers/context-emergency.js";
|
|
32
|
+
import { registerToolResultCaptureCap } from "./handlers/toolresult-capture-cap.js";
|
|
33
|
+
export default function contextManagerExtension(pi) {
|
|
34
|
+
// Compaction reserve: owned by applyCompactionReserveTokens in the polyfill
|
|
35
|
+
// plumb hooks, which derives it from braid.context.contextLimitTokens. A
|
|
36
|
+
// fixed reserve written here would re-anchor pi-core's threshold compaction
|
|
37
|
+
// trigger to an arbitrary share of the window - do not add a second writer.
|
|
38
|
+
// Register tools (4 LLM-callable + 1 TUI command)
|
|
39
|
+
registerContextInspect(pi);
|
|
40
|
+
registerContextCompress(pi);
|
|
41
|
+
registerContextNavigate(pi);
|
|
42
|
+
registerOffloadRecover(pi);
|
|
43
|
+
pi.registerCommand("context-stats", {
|
|
44
|
+
description: "Show context pruning statistics",
|
|
45
|
+
handler: async (_args, ctx) => {
|
|
46
|
+
const stats = getCmState(ctx).pruningState.stats;
|
|
47
|
+
const rules = getCmState(ctx)
|
|
48
|
+
.pruningState.rules.filter((r) => r.enabled)
|
|
49
|
+
.map((r) => r.id);
|
|
50
|
+
ctx.ui?.notify([
|
|
51
|
+
"Context Pruning Stats:",
|
|
52
|
+
` Total pruned: ${stats.totalPruned}`,
|
|
53
|
+
` Total processed: ${stats.totalProcessed}`,
|
|
54
|
+
` Active rules: ${rules.join(", ") || "none"}`,
|
|
55
|
+
` Keep recent: ${getCmState(ctx).pruningState.keepRecentCount} messages`,
|
|
56
|
+
` Prune reasons: ${Object.entries(stats.pruneReasons)
|
|
57
|
+
.map(([k, v]) => `${k}=${v}`)
|
|
58
|
+
.join(", ") || "none"}`,
|
|
59
|
+
].join("\n"), "info");
|
|
60
|
+
},
|
|
61
|
+
});
|
|
62
|
+
registerBeforeCompactHandler(pi);
|
|
63
|
+
registerSessionCompactHandler(pi);
|
|
64
|
+
// Outcome stage is a deliberately separate session_compact handler (verify
|
|
65
|
+
// + telemetry + originals archive); the parking stage above owns the
|
|
66
|
+
// intercept lifecycle. Failure routing rides session_compact_failed.
|
|
67
|
+
registerSessionCompactOutcomeHandler(pi);
|
|
68
|
+
registerSessionCompactFailedHandler(pi);
|
|
69
|
+
registerTurnEndRetryReset(pi);
|
|
70
|
+
registerBeforeTreeHandler(pi);
|
|
71
|
+
registerTurnEndCheckoutHandler(pi);
|
|
72
|
+
registerNavAgentEndRetry(pi);
|
|
73
|
+
registerAgentEndRetryHandler(pi);
|
|
74
|
+
registerAgentEndApiErrorHandler(pi);
|
|
75
|
+
// [warn] DISABLED: causes session corruption via concurrent file writes during streaming.
|
|
76
|
+
// registerContextPruningHandler(pi); // <- "context" event return value is ignored by pi
|
|
77
|
+
registerStaleToolResultOffloader(pi); // Setting-gated (default OFF) - no-op unless opted in
|
|
78
|
+
// Emergency 413 offloader (default ON) — publishes the runner
|
|
79
|
+
// into the process-global slot and registers the per-request stub handler.
|
|
80
|
+
registerContextEmergencyOffloader(pi);
|
|
81
|
+
// Capture-time toolResult size cap (default ON) — oversized
|
|
82
|
+
// results are flushed to disk BEFORE they enter the session.
|
|
83
|
+
registerToolResultCaptureCap(pi);
|
|
84
|
+
registerRotationHandlers(pi);
|
|
85
|
+
registerSessionShutdownHandler(pi);
|
|
86
|
+
log.debug("Context-manager extension initialized");
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=index.js.map
|