pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
|
|
2
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
3
|
+
/**
|
|
4
|
+
* Agent Environment Extension - L1 Environmental Awareness
|
|
5
|
+
*
|
|
6
|
+
* Provides the agent with awareness of its runtime environment and session state.
|
|
7
|
+
* This is the L1 (Internal) layer - context state surfaced to the agent via:
|
|
8
|
+
* 1. L1 system prompt injection - automatic context awareness
|
|
9
|
+
* 2. Turn/turn-count tracking for adaptive behaviour
|
|
10
|
+
*
|
|
11
|
+
* L1 data: session time, turn count, last event, tool call metrics, machine info.
|
|
12
|
+
* These are surfaced in the system prompt so the agent is always context-aware
|
|
13
|
+
* without having to explicitly call tools.
|
|
14
|
+
*/
|
|
15
|
+
import * as os from "node:os";
|
|
16
|
+
import * as process from "node:process";
|
|
17
|
+
import { MESSAGE_END } from "../../../lib/core/event-names.js";
|
|
18
|
+
// Initial state factory. Used by the per-session state below.
|
|
19
|
+
function createEnvState() {
|
|
20
|
+
return {
|
|
21
|
+
sessionStart: Date.now(),
|
|
22
|
+
lastEventTime: Date.now(),
|
|
23
|
+
turnCount: 0,
|
|
24
|
+
toolCallStarts: new Map(),
|
|
25
|
+
metrics: {
|
|
26
|
+
totalToolCalls: 0,
|
|
27
|
+
totalToolTime: 0,
|
|
28
|
+
userMessageCount: 0,
|
|
29
|
+
assistantMessageCount: 0,
|
|
30
|
+
},
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
export function gatherL1Environment(_pi, ctx) {
|
|
34
|
+
const state = getExtensionState(ctx, "agent-environment", createEnvState);
|
|
35
|
+
const now = Date.now();
|
|
36
|
+
const sessionElapsed = now - state.sessionStart;
|
|
37
|
+
const sinceLastEvent = now - state.lastEventTime;
|
|
38
|
+
const avgToolTime = state.metrics.totalToolCalls > 0
|
|
39
|
+
? Math.round(state.metrics.totalToolTime / state.metrics.totalToolCalls)
|
|
40
|
+
: 0;
|
|
41
|
+
// OS detection - normalize platform names for clarity
|
|
42
|
+
const rawPlatform = os.platform();
|
|
43
|
+
const platformDisplay = rawPlatform === "win32"
|
|
44
|
+
? "Windows"
|
|
45
|
+
: rawPlatform === "darwin"
|
|
46
|
+
? "macOS"
|
|
47
|
+
: rawPlatform === "linux"
|
|
48
|
+
? "Linux"
|
|
49
|
+
: rawPlatform;
|
|
50
|
+
return {
|
|
51
|
+
pid: process.pid,
|
|
52
|
+
sessionElapsedMs: sessionElapsed,
|
|
53
|
+
sessionStartedAt: new Date(state.sessionStart).toISOString(),
|
|
54
|
+
turnCount: state.turnCount,
|
|
55
|
+
sinceLastEventMs: sinceLastEvent,
|
|
56
|
+
avgToolTimeMs: avgToolTime,
|
|
57
|
+
machine: {
|
|
58
|
+
platform: platformDisplay,
|
|
59
|
+
type: os.type(),
|
|
60
|
+
hostname: os.hostname(),
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
// The L1 environment section renders in the prompt-builder's instanceSection
|
|
65
|
+
// (instance-composition.ts), which carries the volatile data in the Instance
|
|
66
|
+
// block instead of a separate section.
|
|
67
|
+
export default function agentEnvironmentExtension(pi) {
|
|
68
|
+
registerSessionStartHandler(pi, SessionPhase.Background, async (_event, ctx) => {
|
|
69
|
+
const state = getExtensionState(ctx, "agent-environment", createEnvState);
|
|
70
|
+
state.sessionStart = Date.now();
|
|
71
|
+
state.lastEventTime = Date.now();
|
|
72
|
+
state.turnCount = 0;
|
|
73
|
+
state.metrics.totalToolCalls = 0;
|
|
74
|
+
state.metrics.totalToolTime = 0;
|
|
75
|
+
state.metrics.userMessageCount = 0;
|
|
76
|
+
state.metrics.assistantMessageCount = 0;
|
|
77
|
+
});
|
|
78
|
+
pi.on(MESSAGE_END, (event, ctx) => {
|
|
79
|
+
const state = getExtensionState(ctx, "agent-environment", createEnvState);
|
|
80
|
+
if (event.message.role === "assistant") {
|
|
81
|
+
state.turnCount++;
|
|
82
|
+
state.lastEventTime = Date.now();
|
|
83
|
+
}
|
|
84
|
+
if (event.message.role === "user") {
|
|
85
|
+
state.lastEventTime = Date.now();
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Polyfill Extension - Patches missing API methods on ExtensionContext
|
|
3
|
+
*
|
|
4
|
+
* Three concerns:
|
|
5
|
+
* 1. Model selection: /utility-model (the merged role) opens the
|
|
6
|
+
* ModelSelectorComponent UI; /max-power-model is a deprecated alias of it
|
|
7
|
+
* and /vision-model is a deprecated alias kept for one release. Model
|
|
8
|
+
* resolution is handled by src/lib/ai/model-resolver.ts (used by
|
|
9
|
+
* vision/metacognition tools directly).
|
|
10
|
+
* 2. Session manager patches: context_navigate and context_compress tools
|
|
11
|
+
* need SessionManager methods in --no-session mode.
|
|
12
|
+
* 3. Context window plumb: the session model reports braid's configured
|
|
13
|
+
* window (braid.context.contextLimitTokens) so pi-core's own threshold
|
|
14
|
+
* compaction fires before the configured cap; no-op when unset. Applied
|
|
15
|
+
* on session_start (startup, resume, fork, and /reload - pi-core emits
|
|
16
|
+
* session_start with reason "reload" after rebuilding the runner),
|
|
17
|
+
* re-applied at before_agent_start, and re-applied on model_select — a
|
|
18
|
+
* mid-session switch (rotation, /model, cycle) installs a fresh catalog
|
|
19
|
+
* object carrying the PROVIDER window, and before_agent_start alone left
|
|
20
|
+
* that window in force for the remainder of the current run. All three
|
|
21
|
+
* points also re-derive the reserve that window implies
|
|
22
|
+
* (applyCompactionReserveTokens); the derivation cannot be written into
|
|
23
|
+
* pi-core from an extension, so it surfaces as a once-per-process warning
|
|
24
|
+
* naming the value to set.
|
|
25
|
+
*/
|
|
26
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
27
|
+
export default function polyfillExtension(pi: ExtensionAPI): void;
|
|
28
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,474 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Polyfill Extension - Patches missing API methods on ExtensionContext
|
|
3
|
+
*
|
|
4
|
+
* Three concerns:
|
|
5
|
+
* 1. Model selection: /utility-model (the merged role) opens the
|
|
6
|
+
* ModelSelectorComponent UI; /max-power-model is a deprecated alias of it
|
|
7
|
+
* and /vision-model is a deprecated alias kept for one release. Model
|
|
8
|
+
* resolution is handled by src/lib/ai/model-resolver.ts (used by
|
|
9
|
+
* vision/metacognition tools directly).
|
|
10
|
+
* 2. Session manager patches: context_navigate and context_compress tools
|
|
11
|
+
* need SessionManager methods in --no-session mode.
|
|
12
|
+
* 3. Context window plumb: the session model reports braid's configured
|
|
13
|
+
* window (braid.context.contextLimitTokens) so pi-core's own threshold
|
|
14
|
+
* compaction fires before the configured cap; no-op when unset. Applied
|
|
15
|
+
* on session_start (startup, resume, fork, and /reload - pi-core emits
|
|
16
|
+
* session_start with reason "reload" after rebuilding the runner),
|
|
17
|
+
* re-applied at before_agent_start, and re-applied on model_select — a
|
|
18
|
+
* mid-session switch (rotation, /model, cycle) installs a fresh catalog
|
|
19
|
+
* object carrying the PROVIDER window, and before_agent_start alone left
|
|
20
|
+
* that window in force for the remainder of the current run. All three
|
|
21
|
+
* points also re-derive the reserve that window implies
|
|
22
|
+
* (applyCompactionReserveTokens); the derivation cannot be written into
|
|
23
|
+
* pi-core from an extension, so it surfaces as a once-per-process warning
|
|
24
|
+
* naming the value to set.
|
|
25
|
+
*/
|
|
26
|
+
import { ModelSelectorComponent, SettingsManager } from "@earendil-works/pi-coding-agent";
|
|
27
|
+
import { resolveUtilityModel, resolveVisionModel, normaliseRoleSetting, } from "../../../lib/ai/model-resolver.js";
|
|
28
|
+
import { applyCompactionReserveTokens, applyConfiguredContextWindow, } from "../../../lib/config/braid-settings.js";
|
|
29
|
+
import { onEvent } from "../../../lib/events/event-types.js";
|
|
30
|
+
import { SESSION_START, SESSION_SHUTDOWN } from "../../../lib/core/event-names.js";
|
|
31
|
+
import { registerSessionCleanup } from "../../../lib/state/extension-state.js";
|
|
32
|
+
import { readSettingsFile, updateSettings } from "../../../lib/config/per-tool-settings.js";
|
|
33
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
34
|
+
const log = createLogger("polyfill");
|
|
35
|
+
/** Custom settings keys managed by the model commands */
|
|
36
|
+
import { getCustomModelKey, getCustomModelKeys, consumeMaxPowerDeprecationNotice, UTILITY_MODEL_KEY, VISION_MODEL_KEY, MAX_POWER_MODEL_KEY, } from "../../../lib/state/global-state.js";
|
|
37
|
+
// Type guard for checking if a model has image input capability
|
|
38
|
+
function hasImageInput(model) {
|
|
39
|
+
const input = model.input;
|
|
40
|
+
return Array.isArray(input) && input.includes("image");
|
|
41
|
+
}
|
|
42
|
+
/** Shared sessionManager reference - used by patchSessionManagerMethods */
|
|
43
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
44
|
+
function getPolyfillState(ctx) {
|
|
45
|
+
if (ctx)
|
|
46
|
+
return getExtensionState(ctx, "polyfill", () => ({ sessionManager: undefined }));
|
|
47
|
+
return { sessionManager: undefined };
|
|
48
|
+
}
|
|
49
|
+
/** The on-disk form of an ordered pattern list: a single entry stays a scalar. */
|
|
50
|
+
function toRoleSettingValue(patterns) {
|
|
51
|
+
if (patterns.length === 0)
|
|
52
|
+
return undefined;
|
|
53
|
+
return patterns.length === 1 ? patterns[0] : patterns;
|
|
54
|
+
}
|
|
55
|
+
/** Split a command argument into patterns: comma-separated, trimmed. */
|
|
56
|
+
function parseRolePatterns(text) {
|
|
57
|
+
return text
|
|
58
|
+
.split(",")
|
|
59
|
+
.map((pattern) => pattern.trim())
|
|
60
|
+
.filter((pattern) => pattern.length > 0);
|
|
61
|
+
}
|
|
62
|
+
/** The configured patterns of a role setting, in order; empty when unset. */
|
|
63
|
+
function configuredRolePatterns(key) {
|
|
64
|
+
return normaliseRoleSetting(getCustomModelKey(key));
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Apply a /<role>-model argument: one model pattern, or a comma-separated
|
|
68
|
+
* ordered list. Every pattern must resolve to a catalog model before anything
|
|
69
|
+
* is written, so a typo cannot silently drop a candidate from the fallback
|
|
70
|
+
* order.
|
|
71
|
+
*/
|
|
72
|
+
async function setRoleSettingFromArgs(ctx, key, roleLabel, note, argsText) {
|
|
73
|
+
const patterns = parseRolePatterns(argsText);
|
|
74
|
+
if (patterns.length === 0) {
|
|
75
|
+
ctx.ui.notify(`No model pattern in: ${argsText}`, "error");
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
const resolved = [];
|
|
79
|
+
for (const pattern of patterns) {
|
|
80
|
+
const model = resolveModelPattern(ctx, pattern);
|
|
81
|
+
if (!model) {
|
|
82
|
+
ctx.ui.notify(`Model not found: ${pattern}`, "error");
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
resolved.push(model);
|
|
86
|
+
}
|
|
87
|
+
await setModelSetting(key, toRoleSettingValue(patterns) ?? patterns[0]);
|
|
88
|
+
ctx.ui.notify(patterns.length === 1
|
|
89
|
+
? `${roleLabel} model set to: ${resolved[0].id}${note}`
|
|
90
|
+
: `${roleLabel} models set to: ${resolved.map((m) => m.id).join(" -> ")} ` +
|
|
91
|
+
"(tried in order; the first entry the provider layer reports usable wins)", "info");
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* The /utility-model command body. The deprecated /max-power-model alias
|
|
95
|
+
* drives the same function: the roles merged, so both commands write the one
|
|
96
|
+
* canonical key and differ only in the deprecation notice.
|
|
97
|
+
*/
|
|
98
|
+
async function runUtilityModelCommand(args, ctx, viaDeprecatedAlias) {
|
|
99
|
+
if (viaDeprecatedAlias) {
|
|
100
|
+
ctx.ui.notify("/max-power-model is deprecated: the max-power role merged into the utility role. " +
|
|
101
|
+
"Use /utility-model; the alias is removed next release.", "warning");
|
|
102
|
+
}
|
|
103
|
+
if (!args || args.trim() === "") {
|
|
104
|
+
if (ctx.hasUI) {
|
|
105
|
+
await openModelSelectorUI(ctx, UTILITY_MODEL_KEY, "Utility", null, resolveUtilityModel);
|
|
106
|
+
}
|
|
107
|
+
else {
|
|
108
|
+
const model = resolveUtilityModel(ctx);
|
|
109
|
+
const patterns = configuredRolePatterns(UTILITY_MODEL_KEY);
|
|
110
|
+
ctx.ui.notify(patterns.length === 0
|
|
111
|
+
? "Utility model: none (will use session model)"
|
|
112
|
+
: `Utility model${patterns.length > 1 ? "s" : ""}: ${patterns.join(" -> ")}` +
|
|
113
|
+
` (using: ${model?.id ?? "none"})`, model ? "info" : "warning");
|
|
114
|
+
}
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
const text = args.trim();
|
|
118
|
+
if (text === "clear" || text === "reset") {
|
|
119
|
+
await clearModelSetting(UTILITY_MODEL_KEY);
|
|
120
|
+
ctx.ui.notify("Utility model cleared (will use session model for classification)", "info");
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
123
|
+
await setRoleSettingFromArgs(ctx, UTILITY_MODEL_KEY, "Utility", " (classifications will use this model)", text);
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Merge the in-memory custom model keys into pi's settings.json.
|
|
127
|
+
* Writes through the single settings writer, so a concurrent write to the
|
|
128
|
+
* same file cannot drop these keys.
|
|
129
|
+
*/
|
|
130
|
+
function persistCustomKeys() {
|
|
131
|
+
try {
|
|
132
|
+
const map = getCustomModelKeys();
|
|
133
|
+
updateSettings((settings) => {
|
|
134
|
+
for (const [key, value] of map) {
|
|
135
|
+
settings[key] = value;
|
|
136
|
+
}
|
|
137
|
+
// Any role write retires the legacy key in the same transaction: a
|
|
138
|
+
// stale alias left on disk is resurrected by the next load.
|
|
139
|
+
delete settings[MAX_POWER_MODEL_KEY];
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
catch {
|
|
143
|
+
// Non-fatal: settings won't persist but everything else still works
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* Load custom keys from pi's settings.json into the in-memory map.
|
|
148
|
+
* A role key carries either one pattern or an ordered list; both land in the
|
|
149
|
+
* map in the list form the resolver walks. A value with no usable pattern is
|
|
150
|
+
* treated as unset rather than stored as something that resolves to nothing.
|
|
151
|
+
*/
|
|
152
|
+
function loadCustomKeysFromDisk() {
|
|
153
|
+
try {
|
|
154
|
+
const settings = readSettingsFile();
|
|
155
|
+
const map = getCustomModelKeys();
|
|
156
|
+
for (const key of [VISION_MODEL_KEY, UTILITY_MODEL_KEY]) {
|
|
157
|
+
const value = toRoleSettingValue(normaliseRoleSetting(settings[key]));
|
|
158
|
+
if (value !== undefined)
|
|
159
|
+
map.set(key, value);
|
|
160
|
+
}
|
|
161
|
+
// Deprecated alias: a legacy maxPowerModel value loads under the canonical
|
|
162
|
+
// key when that key carries no usable value on disk (canonical wins when
|
|
163
|
+
// both are present). The legacy key is never stored under its own name;
|
|
164
|
+
// one process-global notice tells the user to move the value before the
|
|
165
|
+
// alias is removed.
|
|
166
|
+
const canonical = toRoleSettingValue(normaliseRoleSetting(settings[UTILITY_MODEL_KEY]));
|
|
167
|
+
if (canonical === undefined) {
|
|
168
|
+
const legacy = toRoleSettingValue(normaliseRoleSetting(settings[MAX_POWER_MODEL_KEY]));
|
|
169
|
+
if (legacy !== undefined) {
|
|
170
|
+
map.set(UTILITY_MODEL_KEY, legacy);
|
|
171
|
+
if (consumeMaxPowerDeprecationNotice()) {
|
|
172
|
+
log.warn(`${MAX_POWER_MODEL_KEY} is deprecated and now loads as ${UTILITY_MODEL_KEY}. ` +
|
|
173
|
+
`Move the value to ${UTILITY_MODEL_KEY} (for example /utility-model <pattern>); ` +
|
|
174
|
+
"the legacy key is removed next release.");
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
catch {
|
|
180
|
+
// Non-fatal: no prior settings or parse error
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
/** Load disableConfirmations setting from pi's settings.json. */
|
|
184
|
+
function loadDisableConfirmations() {
|
|
185
|
+
return readSettingsFile().disableConfirmations === true;
|
|
186
|
+
}
|
|
187
|
+
/** Patch ctx.ui.confirm to auto-confirm when disableConfirmations is enabled */
|
|
188
|
+
function patchConfirmForAutoConfirm(ctx) {
|
|
189
|
+
if (!ctx.ui?.confirm)
|
|
190
|
+
return;
|
|
191
|
+
ctx.ui.confirm = async (_title, _message, _opts) => {
|
|
192
|
+
// Auto-confirm all dialogs
|
|
193
|
+
return true;
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
export default function polyfillExtension(pi) {
|
|
197
|
+
// Load custom model keys from disk at startup so they survive session restarts.
|
|
198
|
+
// Fire-and-forget: non-fatal if this fails (keys will be loaded on next set).
|
|
199
|
+
loadCustomKeysFromDisk();
|
|
200
|
+
// Apply the configured window as early as the platform allows: session_start
|
|
201
|
+
// fires on startup and on /reload (reason "reload", after pi-core has rebuilt
|
|
202
|
+
// the runner and re-resolved the model from the catalog). The session model
|
|
203
|
+
// object is the same instance the TUI footer reads for its denominator
|
|
204
|
+
// (session.getContextUsage() / state.model.contextWindow), so patching it
|
|
205
|
+
// here makes display and enforcement agree before the first run, not only
|
|
206
|
+
// at the next agent turn. No-op when the setting is unset.
|
|
207
|
+
pi.on(SESSION_START, (_event, ctx) => {
|
|
208
|
+
applyConfiguredContextWindow(ctx);
|
|
209
|
+
// Pair the window with the reserve it implies: pi-core decides WHEN to
|
|
210
|
+
// compact from its own `compaction.reserveTokens` (a fixed token count),
|
|
211
|
+
// so the window alone would leave the trigger at an arbitrary share.
|
|
212
|
+
applyCompactionReserveTokens(ctx);
|
|
213
|
+
});
|
|
214
|
+
// Re-apply the configured window whenever the model changes. A rotation or
|
|
215
|
+
// a user switch installs a fresh catalog model object carrying the
|
|
216
|
+
// PROVIDER window; without this hook the configured cap is not re-plumbed
|
|
217
|
+
// until the next before_agent_start, so pi-core's threshold compaction and
|
|
218
|
+
// the usage display read the provider window in between (observed: a
|
|
219
|
+
// mid-run rotation to a 1M-window model silently lifted the 256k cap).
|
|
220
|
+
// model_select fires after agent.state.model is updated, so ctx.model is
|
|
221
|
+
// the newly selected object. Idempotent, like the reserve it pairs with.
|
|
222
|
+
pi.on("model_select", (_event, ctx) => {
|
|
223
|
+
applyConfiguredContextWindow(ctx);
|
|
224
|
+
applyCompactionReserveTokens(ctx);
|
|
225
|
+
});
|
|
226
|
+
// Patch session manager methods on before_agent_start (fires for --no-session mode)
|
|
227
|
+
pi.on("before_agent_start", async (_event, ctx) => {
|
|
228
|
+
patchSessionManagerMethods(pi, ctx);
|
|
229
|
+
// Re-apply the configured window per run so a mid-session model switch
|
|
230
|
+
// (a fresh catalog model object carrying the provider window) is
|
|
231
|
+
// re-plumbed at the next run start. Idempotent, like the reserve
|
|
232
|
+
// derivation that pairs with it.
|
|
233
|
+
applyConfiguredContextWindow(ctx);
|
|
234
|
+
applyCompactionReserveTokens(ctx);
|
|
235
|
+
// Patch confirm dialogs if auto-confirm is enabled
|
|
236
|
+
const autoConfirm = loadDisableConfirmations();
|
|
237
|
+
if (autoConfirm) {
|
|
238
|
+
patchConfirmForAutoConfirm(ctx);
|
|
239
|
+
}
|
|
240
|
+
return {};
|
|
241
|
+
});
|
|
242
|
+
// D1: Clean up all extension state on session end.
|
|
243
|
+
// This prevents memory leaks across sessions (cognitive stores, analytics,
|
|
244
|
+
// enforcement state, etc.). registerSessionCleanup clears per-ctx WeakMap state.
|
|
245
|
+
// pi-core has no session_end extension event; session_shutdown is the
|
|
246
|
+
// end-of-session event the extension runner dispatches.
|
|
247
|
+
onEvent(pi, SESSION_SHUTDOWN, registerSessionCleanup());
|
|
248
|
+
// Utility model command (canonical role)
|
|
249
|
+
pi.registerCommand("utility-model", {
|
|
250
|
+
description: "Set or show the utility model for classification tasks. " +
|
|
251
|
+
"Accepts one model or an ordered list (comma-separated), tried in order " +
|
|
252
|
+
"until the provider layer reports a route usable. " +
|
|
253
|
+
"No args = show current setting. Smaller/faster models preferred. " +
|
|
254
|
+
"Examples: /utility-model provider/model-id, /utility-model a/b,c/d, " +
|
|
255
|
+
"/utility-model clear",
|
|
256
|
+
handler: (args, ctx) => runUtilityModelCommand(args, ctx, false),
|
|
257
|
+
});
|
|
258
|
+
pi.registerCommand("vision-model", {
|
|
259
|
+
description: "Set or show the vision model. Accepts one model or an ordered list " +
|
|
260
|
+
"(comma-separated); every entry must accept image input. " +
|
|
261
|
+
"No args opens the (vision-filtered) selector UI. " +
|
|
262
|
+
"Examples: /vision-model provider/model-id, /vision-model a/b,c/d, /vision-model clear",
|
|
263
|
+
handler: async (args, ctx) => {
|
|
264
|
+
ctx.ui.notify("/vision-model is deprecated: image analysis falls back to the utility list's first " +
|
|
265
|
+
"image-capable model. The setting keeps priority this release; the command is removed next release.", "warning");
|
|
266
|
+
if (!args || args.trim() === "") {
|
|
267
|
+
if (ctx.hasUI) {
|
|
268
|
+
const visionFilter = (m) => hasImageInput(m);
|
|
269
|
+
await openModelSelectorUI(ctx, VISION_MODEL_KEY, "Vision", visionFilter);
|
|
270
|
+
}
|
|
271
|
+
else {
|
|
272
|
+
const model = resolveVisionModel(ctx);
|
|
273
|
+
const patterns = configuredRolePatterns(VISION_MODEL_KEY);
|
|
274
|
+
ctx.ui.notify(patterns.length === 0
|
|
275
|
+
? `Vision model: ${model?.id ?? "none"} (auto-detected)`
|
|
276
|
+
: `Vision model${patterns.length > 1 ? "s" : ""}: ${patterns.join(" -> ")}` +
|
|
277
|
+
` (using: ${model?.id ?? "none"})`, "info");
|
|
278
|
+
}
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
const text = args.trim();
|
|
282
|
+
if (text === "clear" || text === "reset") {
|
|
283
|
+
await clearModelSetting(VISION_MODEL_KEY);
|
|
284
|
+
ctx.ui.notify("Vision model cleared (will auto-detect)", "info");
|
|
285
|
+
return;
|
|
286
|
+
}
|
|
287
|
+
await setRoleSettingFromArgs(ctx, VISION_MODEL_KEY, "Vision", "", text);
|
|
288
|
+
},
|
|
289
|
+
});
|
|
290
|
+
// Max-power model command (deprecated alias)
|
|
291
|
+
pi.registerCommand("max-power-model", {
|
|
292
|
+
description: "Deprecated alias of /utility-model: the max-power role merged into the " +
|
|
293
|
+
"utility role. Set/show/clear operate on the canonical utility setting; " +
|
|
294
|
+
"the alias is removed next release. " +
|
|
295
|
+
"Examples: /max-power-model provider/model-id, /max-power-model a/b,c/d, " +
|
|
296
|
+
"/max-power-model clear",
|
|
297
|
+
handler: (args, ctx) => runUtilityModelCommand(args, ctx, true),
|
|
298
|
+
});
|
|
299
|
+
}
|
|
300
|
+
// Helpers
|
|
301
|
+
/** Persist a model pattern, or an ordered list of them, for the given role key. */
|
|
302
|
+
async function setModelSetting(key, value) {
|
|
303
|
+
getCustomModelKeys().set(key, value);
|
|
304
|
+
persistCustomKeys();
|
|
305
|
+
}
|
|
306
|
+
/** Clear a model pattern. Writes to disk + in-memory map. */
|
|
307
|
+
async function clearModelSetting(key) {
|
|
308
|
+
getCustomModelKeys().delete(key);
|
|
309
|
+
// persistCustomKeys writes only the keys still in the map, so deleting from
|
|
310
|
+
// the map alone left the old value in settings.json and the next session
|
|
311
|
+
// resurrected it. "Clear" has to clear the stored setting as well, and a
|
|
312
|
+
// clear is a role write: it retires the deprecated legacy key too.
|
|
313
|
+
updateSettings((settings) => {
|
|
314
|
+
delete settings[key];
|
|
315
|
+
delete settings[MAX_POWER_MODEL_KEY];
|
|
316
|
+
});
|
|
317
|
+
}
|
|
318
|
+
/** Resolve a model from a "provider/model-id" or bare "model-id" pattern. */
|
|
319
|
+
function resolveModelPattern(ctx, pattern) {
|
|
320
|
+
const slashIndex = pattern.indexOf("/");
|
|
321
|
+
if (slashIndex >= 0) {
|
|
322
|
+
const provider = pattern.slice(0, slashIndex);
|
|
323
|
+
const modelId = pattern.slice(slashIndex + 1);
|
|
324
|
+
return ctx.modelRegistry.find(provider, modelId);
|
|
325
|
+
}
|
|
326
|
+
const all = ctx.modelRegistry.getAll();
|
|
327
|
+
return all.find((m) => m.id === pattern || m.id.endsWith(`/${pattern}`));
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* Open ModelSelectorComponent via ctx.ui.custom() for model selection.
|
|
331
|
+
*
|
|
332
|
+
* Approach:
|
|
333
|
+
* - Use SettingsManager.inMemory() for ModelSelectorComponent (its
|
|
334
|
+
* setDefaultModelAndProvider is a no-op for disk persistence - that's fine
|
|
335
|
+
* since we call pi.setModel() afterwards which goes through AgentSession
|
|
336
|
+
* and persists via the real settings manager).
|
|
337
|
+
* - Capture the selected model in the onSelect callback.
|
|
338
|
+
* - After ctx.ui.custom() resolves, call pi.setModel() and setModelSetting().
|
|
339
|
+
*/
|
|
340
|
+
async function openModelSelectorUI(ctx, settingKey, roleLabel, scopeFilter, resolveFn = resolveVisionModel) {
|
|
341
|
+
const modelRegistry = ctx.modelRegistry;
|
|
342
|
+
// ModelSelectorComponent writes through an in-memory SettingsManager:
|
|
343
|
+
// setDefaultModelAndProvider() sets fields in memory but never persists,
|
|
344
|
+
// so pi.setModel() below does the real persistence.
|
|
345
|
+
const settingsManager = SettingsManager.inMemory();
|
|
346
|
+
// ModelSelectorComponent's 4th parameter is the ModelRuntime. The extension
|
|
347
|
+
// context exposes only the ModelRegistry facade, which holds the runtime as
|
|
348
|
+
// a private field (`runtime`); read it directly. The retired
|
|
349
|
+
// getAvailableSnapshot probe tested the registry for a method that exists
|
|
350
|
+
// only on ModelRuntime, so it was false by construction on every supported
|
|
351
|
+
// build.
|
|
352
|
+
const modelRuntime = modelRegistry.runtime;
|
|
353
|
+
// Priority: selected model first, then same provider, then others
|
|
354
|
+
const currentRoleModel = resolveFn(ctx);
|
|
355
|
+
const mainModel = ctx.model;
|
|
356
|
+
const prefProvider = currentRoleModel?.provider ?? mainModel?.provider;
|
|
357
|
+
const allModels = modelRegistry.getAvailable();
|
|
358
|
+
let scopedModels;
|
|
359
|
+
if (scopeFilter) {
|
|
360
|
+
const filtered = allModels.filter(scopeFilter);
|
|
361
|
+
filtered.sort((a, b) => {
|
|
362
|
+
if (currentRoleModel && a.id === currentRoleModel.id)
|
|
363
|
+
return -1;
|
|
364
|
+
if (currentRoleModel && b.id === currentRoleModel.id)
|
|
365
|
+
return 1;
|
|
366
|
+
if (prefProvider && a.provider === prefProvider)
|
|
367
|
+
return -1;
|
|
368
|
+
if (prefProvider && b.provider === prefProvider)
|
|
369
|
+
return 1;
|
|
370
|
+
return a.id.localeCompare(b.id);
|
|
371
|
+
});
|
|
372
|
+
scopedModels = filtered.map((m) => ({ model: m }));
|
|
373
|
+
}
|
|
374
|
+
else {
|
|
375
|
+
allModels.sort((a, b) => {
|
|
376
|
+
if (currentRoleModel && a.id === currentRoleModel.id)
|
|
377
|
+
return -1;
|
|
378
|
+
if (currentRoleModel && b.id === currentRoleModel.id)
|
|
379
|
+
return 1;
|
|
380
|
+
if (prefProvider && a.provider === prefProvider)
|
|
381
|
+
return -1;
|
|
382
|
+
if (prefProvider && b.provider === prefProvider)
|
|
383
|
+
return 1;
|
|
384
|
+
return a.id.localeCompare(b.id);
|
|
385
|
+
});
|
|
386
|
+
scopedModels = allModels.map((m) => ({ model: m }));
|
|
387
|
+
}
|
|
388
|
+
// Capture selected model from the dialog
|
|
389
|
+
let selectedModel;
|
|
390
|
+
await ctx.ui.custom(async (tui, _theme, _keybindings, done) => {
|
|
391
|
+
const onSelect = async (model) => {
|
|
392
|
+
selectedModel = model;
|
|
393
|
+
// Warn if a non-vision model was picked for the vision role
|
|
394
|
+
if (scopeFilter && !hasImageInput(model)) {
|
|
395
|
+
ctx.ui.notify(`[warn] ${model.id} does not support image input. Vision analysis may fail.`, "warning");
|
|
396
|
+
}
|
|
397
|
+
done(model);
|
|
398
|
+
};
|
|
399
|
+
const onCancel = () => done(undefined);
|
|
400
|
+
// 0.80.8: (tui, currentModel, settingsManager, modelRuntime, scopedModels,
|
|
401
|
+
// onSelect, onCancel) — ctor.length 7. 0.84.4: (tui, currentModel,
|
|
402
|
+
// modelRuntime, scopedModels, onSelect, onCancel, initialSearchInput?,
|
|
403
|
+
// onSelectAsDefault?, defaultModel?) — SettingsManager dropped; the
|
|
404
|
+
// compiled ctor declares 9 plain params (no defaults) → length 9. NB:
|
|
405
|
+
// function.length counts params BEFORE the first default — the d.ts's
|
|
406
|
+
// "optional" suffixes don't exist in compiled JS. So length !== 7 = new. The installed
|
|
407
|
+
// devDependency types may lag the running pi dist (0.82.1 d.ts vs 0.84.4
|
|
408
|
+
// runtime), so the new-signature branch is typed loosely on purpose.
|
|
409
|
+
const isNewSelector = ModelSelectorComponent.length !== 7;
|
|
410
|
+
// structural component — pi renders it via ctx.ui.custom. Return type is
|
|
411
|
+
// `object` (not {}): the new-signature branch is typed loosely on purpose.
|
|
412
|
+
const SelectorCtor = ModelSelectorComponent;
|
|
413
|
+
const selector = isNewSelector
|
|
414
|
+
? new SelectorCtor(tui, currentRoleModel, modelRuntime, scopedModels, onSelect, onCancel)
|
|
415
|
+
: // 0.85.1 devDep types carry only the new signature (3rd param
|
|
416
|
+
// ModelRuntime), so the legacy branch can no longer type against
|
|
417
|
+
// them — same deliberate loose typing as the new branch above.
|
|
418
|
+
new SelectorCtor(tui, currentRoleModel, settingsManager, modelRuntime, scopedModels, onSelect, onCancel);
|
|
419
|
+
return selector;
|
|
420
|
+
});
|
|
421
|
+
if (!selectedModel)
|
|
422
|
+
return;
|
|
423
|
+
// Store the role-specific key only. Do NOT call pi.setModel() - that would change
|
|
424
|
+
// the default model, which is NOT what we want for utility/vision role selection.
|
|
425
|
+
// model-resolver.ts reads these custom keys and uses them directly.
|
|
426
|
+
const pattern = `${selectedModel.provider}/${selectedModel.id}`;
|
|
427
|
+
await setModelSetting(settingKey, pattern);
|
|
428
|
+
ctx.ui.notify(`${roleLabel} model set to: ${selectedModel.id}`, "info");
|
|
429
|
+
}
|
|
430
|
+
// Session manager patches for --no-session mode
|
|
431
|
+
/**
|
|
432
|
+
* Patch SessionManager methods onto the pi ExtensionAPI so context_navigate
|
|
433
|
+
* (action="tag"/"checkout") and context_compress can work in --no-session mode.
|
|
434
|
+
* work in --no-session mode (where AgentSession doesn't bind them).
|
|
435
|
+
*/
|
|
436
|
+
function patchSessionManagerMethods(pi, ctx) {
|
|
437
|
+
const sm = ctx?.sessionManager;
|
|
438
|
+
if (!sm)
|
|
439
|
+
return;
|
|
440
|
+
getPolyfillState().sessionManager = sm;
|
|
441
|
+
if (typeof pi.getBranch !== "function" && typeof sm.getBranch === "function") {
|
|
442
|
+
pi.getBranch = () => sm.getBranch?.();
|
|
443
|
+
}
|
|
444
|
+
if (typeof pi.getLeafId !== "function" && typeof sm.getLeafId === "function") {
|
|
445
|
+
pi.getLeafId = () => sm.getLeafId?.();
|
|
446
|
+
}
|
|
447
|
+
if (typeof pi.getTree !== "function" && typeof sm.getTree === "function") {
|
|
448
|
+
pi.getTree = () => sm.getTree?.();
|
|
449
|
+
}
|
|
450
|
+
if (typeof pi.getLabel !== "function" && typeof sm.getLabel === "function") {
|
|
451
|
+
pi.getLabel = (id) => sm.getLabel?.(id);
|
|
452
|
+
}
|
|
453
|
+
if (typeof pi.setLabel !== "function" && typeof sm.setLabel === "function") {
|
|
454
|
+
pi.setLabel = (id, label) => sm.setLabel?.(id, label);
|
|
455
|
+
}
|
|
456
|
+
if (typeof pi.getChildren !== "function" && typeof sm.getChildren === "function") {
|
|
457
|
+
pi.getChildren = (id) => sm.getChildren?.(id);
|
|
458
|
+
}
|
|
459
|
+
if (typeof pi.branchWithSummary !== "function" && typeof sm.branchWithSummary === "function") {
|
|
460
|
+
pi.branchWithSummary = async (summary) => sm.branchWithSummary?.(summary);
|
|
461
|
+
}
|
|
462
|
+
if (typeof pi.navigateTree !== "function" && typeof sm.navigateTree === "function") {
|
|
463
|
+
pi.navigateTree = async (id) => sm.navigateTree?.(id);
|
|
464
|
+
}
|
|
465
|
+
if (typeof pi.abort !== "function" && typeof sm.abort === "function") {
|
|
466
|
+
pi.abort = (_reason) => {
|
|
467
|
+
sm.abort?.();
|
|
468
|
+
};
|
|
469
|
+
}
|
|
470
|
+
if (typeof pi.getContextUsage !== "function" && typeof sm.getContextUsage === "function") {
|
|
471
|
+
pi.getContextUsage = () => sm.getContextUsage?.();
|
|
472
|
+
}
|
|
473
|
+
}
|
|
474
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Persistent Hygiene Whisper.
|
|
3
|
+
*
|
|
4
|
+
* Once-per-session context-hygiene whisper: tokens currently in context
|
|
5
|
+
* plus tokens added since the previous emission's baseline. Cadence,
|
|
6
|
+
* best-effort non-blocking delivery, flood-safety, and the pointer line.
|
|
7
|
+
* CustomType is "hygiene".
|
|
8
|
+
*
|
|
9
|
+
* Delivery model: WHISPER. Steer, no trigger turn, display:true - the agent
|
|
10
|
+
* sees it in the next turn and it is visible in the TUI; it does NOT live in
|
|
11
|
+
* the system prompt. Best-effort: failure is logged at debug level and
|
|
12
|
+
* swallowed, so it can never block the other once-per-session deliveries.
|
|
13
|
+
*
|
|
14
|
+
* "Since last baseline" data source: a cleanup/compaction marker lives in
|
|
15
|
+
* context-manager (memory extension) state, which is NOT reachable from
|
|
16
|
+
* prompt-builder without cross-extension plumbing. By design,
|
|
17
|
+
* the baseline is therefore tracked inside this module: the first emission
|
|
18
|
+
* sets the baseline, later session emissions report the delta. Storage is a
|
|
19
|
+
* globalThis slot - the documented process-global pattern (see
|
|
20
|
+
* lib/state/global-state.ts) - because getExtensionState is per-session and
|
|
21
|
+
* would reset the baseline exactly when the cross-session delta needs it, and
|
|
22
|
+
* module-level `let` state is banned by the project contract.
|
|
23
|
+
*
|
|
24
|
+
* Whisper-audit rule: no inline bracket sub-tags in the content. The
|
|
25
|
+
* `[braid-whisper - <subsystem>]` envelope is added centrally by
|
|
26
|
+
* sendTrackedMessage from the source tag - content starts with plain
|
|
27
|
+
* readable text.
|
|
28
|
+
*/
|
|
29
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
30
|
+
/** Counts gathered by the caller for the once-per-session hygiene whisper. */
|
|
31
|
+
export interface AwarenessCounts {
|
|
32
|
+
/** Tokens currently in context at emission time (0 when usage is unavailable). */
|
|
33
|
+
tokensInContext: number;
|
|
34
|
+
/** Registered context_* tools - guards the pointer line (tool availability). */
|
|
35
|
+
contextToolCount: number;
|
|
36
|
+
/**
|
|
37
|
+
* TG inbound channel liveness at build time, from the poller liveness
|
|
38
|
+
* registry (lib/state/telegram-poller-liveness.ts). "live" renders today's
|
|
39
|
+
* row; "off" and "unknown" render a hedged variant that names the check,
|
|
40
|
+
* so the catalog never asserts reachability the live state cannot back.
|
|
41
|
+
*/
|
|
42
|
+
telegramInbound: TelegramInboundState;
|
|
43
|
+
}
|
|
44
|
+
/** Liveness of the TG inbound channel as known at whisper build time. */
|
|
45
|
+
export type TelegramInboundState = "live" | "off" | "unknown";
|
|
46
|
+
/** AwarenessCounts plus the since-baseline delta computed at delivery time. */
|
|
47
|
+
export interface HygieneSignal extends AwarenessCounts {
|
|
48
|
+
/**
|
|
49
|
+
* Tokens added since the previous emission's baseline. null when this
|
|
50
|
+
* emission is the first one (it sets the baseline; delta comes later).
|
|
51
|
+
*/
|
|
52
|
+
tokensSinceBaseline: number | null;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Render the hygiene text: one summary line + one pointer line + the
|
|
56
|
+
* agent-facing reachability catalog ("which braid systems can reach you").
|
|
57
|
+
* Plain text, no bracket sub-tags. Catalog invariant: the envelope format
|
|
58
|
+
* is stable, the subsystem list is not - subsystem whispers are described
|
|
59
|
+
* by their envelope rather than enumerated, because a fixed enumeration
|
|
60
|
+
* drifts as subsystems come and go; the example set names subsystems that
|
|
61
|
+
* actually produce whispers in this repo. The whole catalog stays ≤80
|
|
62
|
+
* tokens. Pure - no pi/ctx dependency; the TG row's state rides in on the
|
|
63
|
+
* input signal.
|
|
64
|
+
*/
|
|
65
|
+
export declare function formatAwarenessText(signal: HygieneSignal): string;
|
|
66
|
+
/**
|
|
67
|
+
* Deliver the hygiene whisper (best-effort, non-blocking).
|
|
68
|
+
* Steer message with triggerTurn:false; any failure is logged at debug
|
|
69
|
+
* level and swallowed so the whisper never blocks other deliveries.
|
|
70
|
+
* Emission order matters: read the previous baseline BEFORE overwriting it,
|
|
71
|
+
* so the delta reflects the previous emission, not this one.
|
|
72
|
+
*/
|
|
73
|
+
export declare function deliverAwarenessWhisper(pi: ExtensionAPI, _ctx: ExtensionContext, counts: AwarenessCounts): Promise<void>;
|
|
74
|
+
//# sourceMappingURL=awareness-whisper.d.ts.map
|