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,163 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Turn Outcome Classification - Repetitive Loop Detection (triple-critic)
|
|
3
|
+
*
|
|
4
|
+
* Detects when the agent is stuck in a repetitive loop using classify() with
|
|
5
|
+
* CRITICS.toolLoopDetected. Three-tier fallback:
|
|
6
|
+
* Tier 1: toolLoopFallback (heuristic token/error repetition)
|
|
7
|
+
* Tier 2: utility model (if configured)
|
|
8
|
+
* Tier 3: session model (always available)
|
|
9
|
+
*
|
|
10
|
+
* When a loop is confirmed, sends a strategic steer suggesting a different
|
|
11
|
+
* approach or re-plan. Only fires once per loop type per detection window.
|
|
12
|
+
*
|
|
13
|
+
* Replaces the previous implementation with three separate heuristic
|
|
14
|
+
* functions (detectToolRepetition, detectErrorEcho, detectFileChurn)
|
|
15
|
+
* - now consolidated into a single classify() call with structured history.
|
|
16
|
+
*/
|
|
17
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
18
|
+
import { getExtensionState } from "../../../lib/state/extension-state.js";
|
|
19
|
+
import { classifyWithOffline } from "../../../lib/reasoning/classifier-offline.js";
|
|
20
|
+
import { CRITICS } from "../../../lib/ai/critic-registry.js";
|
|
21
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
22
|
+
import { onEvent } from "../../../lib/events/event-types.js";
|
|
23
|
+
import { TURN_END } from "../../../lib/core/event-names.js";
|
|
24
|
+
import { toolLoopFallback } from "../../../lib/ai/critic-fallbacks.js";
|
|
25
|
+
const log = createLogger("turn-outcome");
|
|
26
|
+
const WINDOW_SIZE = 12; // Rolling window of recent turns
|
|
27
|
+
const LOOP_COOLDOWN_TURNS = 8; // Don't fire again for same loop within N turns
|
|
28
|
+
const STATE_KEY = "turn-outcome";
|
|
29
|
+
function getState(ctx) {
|
|
30
|
+
return getExtensionState(ctx, STATE_KEY, () => ({
|
|
31
|
+
history: [],
|
|
32
|
+
lastFired: {},
|
|
33
|
+
}));
|
|
34
|
+
}
|
|
35
|
+
// Detection Logic (single classify call)
|
|
36
|
+
/**
|
|
37
|
+
* Detect if the agent is in a repetitive loop using triple-critic classification.
|
|
38
|
+
*
|
|
39
|
+
* Formats the recent turn history as a structured tool-sequence description
|
|
40
|
+
* and passes it to classify() with CRITICS.toolLoopDetected.
|
|
41
|
+
* The heuristic fallback (toolLoopFallback) handles the LLM-unavailable case.
|
|
42
|
+
*/
|
|
43
|
+
/**
|
|
44
|
+
* Sentinel return value when the loop detector is offline (the LLM
|
|
45
|
+
* classify() call failed at all tiers). Distinct from the null
|
|
46
|
+
* "not in a loop" return so the consumer can branch on it.
|
|
47
|
+
*
|
|
48
|
+
* Same anti-pattern as topic-drift and sycophancy: when the classifier is
|
|
49
|
+
* down, never silently default to "no problem."
|
|
50
|
+
*/
|
|
51
|
+
export const LOOP_DETECTOR_OFFLINE = "__loop_detector_offline__";
|
|
52
|
+
async function detectLoop(state, ctx) {
|
|
53
|
+
if (state.history.length < 4)
|
|
54
|
+
return null;
|
|
55
|
+
const recent = state.history.slice(-7); // Last 7 turns
|
|
56
|
+
const toolSequences = recent
|
|
57
|
+
.map((t, i) => {
|
|
58
|
+
const toolsStr = t.tools.map((name) => `\`${name}\``).join(", ");
|
|
59
|
+
const errorsStr = t.errored.length > 0 ? ` [errors: ${t.errored.join(", ")}]` : "";
|
|
60
|
+
return `Turn ${state.history.length - recent.length + i + 1}: ${toolsStr}${errorsStr}`;
|
|
61
|
+
})
|
|
62
|
+
.join("\n");
|
|
63
|
+
let result;
|
|
64
|
+
try {
|
|
65
|
+
// B-class: toolLoopFallback returns "no" by default (safe but
|
|
66
|
+
// uninformative). tierPolicy: fallback-only downweights the
|
|
67
|
+
// heuristic to 0.5 confidence so consumers can tell it's degraded.
|
|
68
|
+
result = await classifyWithOffline(ctx, CRITICS.toolLoopDetected.criteria, { toolSequences: toolSequences.slice(0, 2000) }, {
|
|
69
|
+
timeoutMs: 60_000,
|
|
70
|
+
label: CRITICS.toolLoopDetected.label,
|
|
71
|
+
fallback: () => toolLoopFallback(toolSequences),
|
|
72
|
+
tierPolicy: "fallback-only",
|
|
73
|
+
});
|
|
74
|
+
if (result.value === "yes") {
|
|
75
|
+
const lastTurnTools = recent[recent.length - 1]?.tools ?? [];
|
|
76
|
+
return lastTurnTools.join(", ") || "unknown tools";
|
|
77
|
+
}
|
|
78
|
+
// Detect the "classifier failed" case. The LLM could not produce a
|
|
79
|
+
// usable answer; the agent might be in a loop and we just can't
|
|
80
|
+
// see it. Return the LOOP_DETECTOR_OFFLINE sentinel so the consumer
|
|
81
|
+
// can emit a "detector offline" steer instead of the usual
|
|
82
|
+
// "no loop detected" silent return.
|
|
83
|
+
if (result.classifierDown) {
|
|
84
|
+
log.warn(`[turn-outcome] Loop detector classifier unavailable ` +
|
|
85
|
+
`(tier=failed, latency=${result.latencyMs}ms). Run /logs level info for details.`);
|
|
86
|
+
return LOOP_DETECTOR_OFFLINE;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
catch {
|
|
90
|
+
// classifyWithOffline() handles errors internally
|
|
91
|
+
}
|
|
92
|
+
return null;
|
|
93
|
+
}
|
|
94
|
+
export default function turnOutcomeExtension(pi) {
|
|
95
|
+
onEvent(pi, TURN_END, async (event, ctx) => {
|
|
96
|
+
const state = getState(ctx);
|
|
97
|
+
const results = event?.toolResults ?? [];
|
|
98
|
+
const tools = results.map((r) => r.toolName).filter(Boolean);
|
|
99
|
+
const errored = results
|
|
100
|
+
.filter((r) => r.isError)
|
|
101
|
+
.map((r) => r.toolName)
|
|
102
|
+
.filter(Boolean);
|
|
103
|
+
const outcome = { tools, errored };
|
|
104
|
+
state.history.push(outcome);
|
|
105
|
+
if (state.history.length > WINDOW_SIZE) {
|
|
106
|
+
state.history.shift();
|
|
107
|
+
}
|
|
108
|
+
const details = await detectLoop(state, ctx);
|
|
109
|
+
if (!details)
|
|
110
|
+
return;
|
|
111
|
+
// Handle the "loop detector offline" case. When the LLM classify()
|
|
112
|
+
// call failed at all tiers, the agent might be in a loop but the
|
|
113
|
+
// detector can't see it. Emit a softer "detector offline" steer
|
|
114
|
+
// (no specific tool names, just the warning) so the agent knows
|
|
115
|
+
// to be cautious. Cooldown still applies so we don't spam.
|
|
116
|
+
if (details === LOOP_DETECTOR_OFFLINE) {
|
|
117
|
+
const lastFiredOffline = state.lastFired["loop-detector-offline"] ?? 0;
|
|
118
|
+
const currentTurnOffline = state.history.length;
|
|
119
|
+
if (currentTurnOffline - lastFiredOffline < LOOP_COOLDOWN_TURNS)
|
|
120
|
+
return;
|
|
121
|
+
state.lastFired["loop-detector-offline"] = currentTurnOffline;
|
|
122
|
+
log.info(`[turn-outcome] Loop detector offline; sending soft-warning steer`);
|
|
123
|
+
const offlineMessage = `## Loop Detector Offline\n\n` +
|
|
124
|
+
`The loop-detection classifier is unavailable this turn, so this check could not run normally. ` +
|
|
125
|
+
`If you are in a repetitive loop, this extension cannot detect it. ` +
|
|
126
|
+
`Please self-monitor: if you notice yourself calling the same tools with the same results ` +
|
|
127
|
+
`for several turns, use \`think()\` to re-evaluate your approach, or consider \`context_compress(action="archive")\` ` +
|
|
128
|
+
`to checkpoint your work.`;
|
|
129
|
+
try {
|
|
130
|
+
sendTrackedMessage(pi, {
|
|
131
|
+
customType: "turn-outcome",
|
|
132
|
+
content: [{ type: "text", text: offlineMessage }],
|
|
133
|
+
display: true,
|
|
134
|
+
}, { delivery: "live", deliverAs: "steer" }, { type: "enforcement", source: "turn-outcome/loop-detector-offline" });
|
|
135
|
+
}
|
|
136
|
+
catch {
|
|
137
|
+
/* non-fatal */
|
|
138
|
+
}
|
|
139
|
+
return;
|
|
140
|
+
}
|
|
141
|
+
const lastFired = state.lastFired["tool-loop"] ?? 0;
|
|
142
|
+
const currentTurn = state.history.length;
|
|
143
|
+
if (currentTurn - lastFired < LOOP_COOLDOWN_TURNS)
|
|
144
|
+
return;
|
|
145
|
+
state.lastFired["tool-loop"] = currentTurn;
|
|
146
|
+
// loop-detected whisper FOLDED
|
|
147
|
+
// The enforcement tool-loop detector (lib/detection/tool-loop-detector.ts)
|
|
148
|
+
// is the ONE authoritative loop/addiction whisper emitter. This
|
|
149
|
+
// "Repetitive Loop Detected" steer was a second emitter for the same
|
|
150
|
+
// stuck-loop signal class — the benchmark measured 73 deliveries,
|
|
151
|
+
// and it used triggerTurn:true (it WOKE the agent on a loop, violating
|
|
152
|
+
// the advisory no-wake rule). It is folded: the triple-critic detection
|
|
153
|
+
// above still runs (history + classification), but no loop whisper is
|
|
154
|
+
// delivered. Per-episode single delivery is guaranteed by the surviving
|
|
155
|
+
// detector's cooldown/dedupe (markLoopFired + TOOL_LOOP_COOLDOWN_TURNS),
|
|
156
|
+
// and the surviving emission is triggerTurn:false. Deliberately NOT
|
|
157
|
+
// claiming the shared "loop" tryClaim category here: claiming would still
|
|
158
|
+
// suppress the dreamer's independent advisory.
|
|
159
|
+
log.info(`[turn-outcome] Loop detected but folded into enforcement tool-loop detector (no whisper): ${details}`);
|
|
160
|
+
});
|
|
161
|
+
log.info("[turn-outcome] loaded: loop detection on turn_end (triple-critic)");
|
|
162
|
+
}
|
|
163
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Management Extension — Tool Profile Switching.
|
|
3
|
+
*
|
|
4
|
+
* A profile is a named narrowing of the active tool set, taken through
|
|
5
|
+
* `pi.setActiveTools()` when the session asks for one.
|
|
6
|
+
*
|
|
7
|
+
* Profiles:
|
|
8
|
+
* lean — general-purpose coding & reasoning (~12 tools)
|
|
9
|
+
* research — information gathering: search, web fetch, memory
|
|
10
|
+
* debugging — bug finding & fixing: hypothesize, explore_paths, conflict_qa
|
|
11
|
+
* browser — web browsing & UI testing: browser automation, describe_image
|
|
12
|
+
* deep — deep code analysis: codebase, file_diff, full workspace tools
|
|
13
|
+
*
|
|
14
|
+
* Usage:
|
|
15
|
+
* The agent calls `set_tool_profile` to narrow the set at runtime; the
|
|
16
|
+
* chosen profile is re-asserted before a run if the active set drifted from
|
|
17
|
+
* it.
|
|
18
|
+
*
|
|
19
|
+
* This extension holds the other end of the active set too: braid registers
|
|
20
|
+
* some of its tools deferred, and a session without `tool_search` cannot reach
|
|
21
|
+
* them at all. `ensureDiscoveryTool` adds it at session start (see the
|
|
22
|
+
* Discovery Guard section).
|
|
23
|
+
*
|
|
24
|
+
* A session is born with pi-core's default tool selection plus every tool the
|
|
25
|
+
* extensions register; this extension narrows the set only when the session
|
|
26
|
+
* asks. A list applied at session start guesses what the session was started
|
|
27
|
+
* to do, and a wrong guess is a silent loss: a curated dozen cannot hold the
|
|
28
|
+
* families a dispatch session needs (orchestration, Telegram), which then
|
|
29
|
+
* cannot follow its own boot contract. Nothing readable at session start
|
|
30
|
+
* separates the sessions a narrowing suits from the ones it breaks (same
|
|
31
|
+
* registry, same install, same settings), so narrowing stays a request, made
|
|
32
|
+
* by the layer that knows the session's role.
|
|
33
|
+
*
|
|
34
|
+
* The tool name is `set_tool_profile` (not `tool_profile` or `profile`) to
|
|
35
|
+
* keep it discoverable and unambiguous in the active tool list.
|
|
36
|
+
*/
|
|
37
|
+
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
38
|
+
/**
|
|
39
|
+
* Each profile is a named set of tool names.
|
|
40
|
+
* Tools not in the set are deactivated until the profile is switched.
|
|
41
|
+
*
|
|
42
|
+
* Design principle: each profile includes ~12 tools that are essential for
|
|
43
|
+
* the task category. Tools outside the profile are still registered but
|
|
44
|
+
* hidden from the agent's system prompt until re-enabled.
|
|
45
|
+
*/
|
|
46
|
+
declare const PROFILES: Record<string, string[]>;
|
|
47
|
+
declare const PROFILE_NAMES: string[];
|
|
48
|
+
/**
|
|
49
|
+
* The profile this session asked for, or null while it has asked for none.
|
|
50
|
+
*
|
|
51
|
+
* null is the born state, not a profile: the active set is left as pi-core,
|
|
52
|
+
* the operator's `/tools` list and the other extensions built it. Only
|
|
53
|
+
* `set_tool_profile` moves this off null.
|
|
54
|
+
*/
|
|
55
|
+
declare let _currentProfile: string | null;
|
|
56
|
+
/**
|
|
57
|
+
* Apply a tool profile by calling pi.setActiveTools().
|
|
58
|
+
* Returns the list of tools that were activated.
|
|
59
|
+
*/
|
|
60
|
+
declare function applyProfile(pi: ExtensionAPI, profileName: string): string[];
|
|
61
|
+
/**
|
|
62
|
+
* Activate the discovery tool when the session does not hold it.
|
|
63
|
+
*
|
|
64
|
+
* Additive by construction: the current set is the input, so whatever a
|
|
65
|
+
* profile, the operator's `--tools`/`/tools` list or a sibling extension
|
|
66
|
+
* activated stays active, and pi drops pending tools only when a set removes a
|
|
67
|
+
* name - which this never does. Returns the names it added.
|
|
68
|
+
*
|
|
69
|
+
* Nothing is written when the registry does not hold the tool (an install with
|
|
70
|
+
* the built-in tool-search extension disabled has nothing to activate) or when
|
|
71
|
+
* the active set is unreadable: treating `getActiveTools()` returning nothing
|
|
72
|
+
* as an empty set would replace the whole set with this one tool.
|
|
73
|
+
*/
|
|
74
|
+
declare function ensureDiscoveryTool(pi: ExtensionAPI): string[];
|
|
75
|
+
export default function contextManagementExtension(pi: ExtensionAPI): void;
|
|
76
|
+
export { PROFILES, PROFILE_NAMES, applyProfile, ensureDiscoveryTool, _currentProfile };
|
|
77
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,339 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Management Extension — Tool Profile Switching.
|
|
3
|
+
*
|
|
4
|
+
* A profile is a named narrowing of the active tool set, taken through
|
|
5
|
+
* `pi.setActiveTools()` when the session asks for one.
|
|
6
|
+
*
|
|
7
|
+
* Profiles:
|
|
8
|
+
* lean — general-purpose coding & reasoning (~12 tools)
|
|
9
|
+
* research — information gathering: search, web fetch, memory
|
|
10
|
+
* debugging — bug finding & fixing: hypothesize, explore_paths, conflict_qa
|
|
11
|
+
* browser — web browsing & UI testing: browser automation, describe_image
|
|
12
|
+
* deep — deep code analysis: codebase, file_diff, full workspace tools
|
|
13
|
+
*
|
|
14
|
+
* Usage:
|
|
15
|
+
* The agent calls `set_tool_profile` to narrow the set at runtime; the
|
|
16
|
+
* chosen profile is re-asserted before a run if the active set drifted from
|
|
17
|
+
* it.
|
|
18
|
+
*
|
|
19
|
+
* This extension holds the other end of the active set too: braid registers
|
|
20
|
+
* some of its tools deferred, and a session without `tool_search` cannot reach
|
|
21
|
+
* them at all. `ensureDiscoveryTool` adds it at session start (see the
|
|
22
|
+
* Discovery Guard section).
|
|
23
|
+
*
|
|
24
|
+
* A session is born with pi-core's default tool selection plus every tool the
|
|
25
|
+
* extensions register; this extension narrows the set only when the session
|
|
26
|
+
* asks. A list applied at session start guesses what the session was started
|
|
27
|
+
* to do, and a wrong guess is a silent loss: a curated dozen cannot hold the
|
|
28
|
+
* families a dispatch session needs (orchestration, Telegram), which then
|
|
29
|
+
* cannot follow its own boot contract. Nothing readable at session start
|
|
30
|
+
* separates the sessions a narrowing suits from the ones it breaks (same
|
|
31
|
+
* registry, same install, same settings), so narrowing stays a request, made
|
|
32
|
+
* by the layer that knows the session's role.
|
|
33
|
+
*
|
|
34
|
+
* The tool name is `set_tool_profile` (not `tool_profile` or `profile`) to
|
|
35
|
+
* keep it discoverable and unambiguous in the active tool list.
|
|
36
|
+
*/
|
|
37
|
+
import { Type } from "typebox";
|
|
38
|
+
import { createLogger } from "../../lib/core/logger.js";
|
|
39
|
+
import { registerSessionStartHandler, SessionPhase } from "../../lib/state/session-start-queue.js";
|
|
40
|
+
import { readGlobalEnabledTools } from "../../lib/config/per-tool-settings.js";
|
|
41
|
+
const log = createLogger("context-management");
|
|
42
|
+
/**
|
|
43
|
+
* Each profile is a named set of tool names.
|
|
44
|
+
* Tools not in the set are deactivated until the profile is switched.
|
|
45
|
+
*
|
|
46
|
+
* Design principle: each profile includes ~12 tools that are essential for
|
|
47
|
+
* the task category. Tools outside the profile are still registered but
|
|
48
|
+
* hidden from the agent's system prompt until re-enabled.
|
|
49
|
+
*/
|
|
50
|
+
const PROFILES = {
|
|
51
|
+
/**
|
|
52
|
+
* lean — general-purpose coding with reasoning support.
|
|
53
|
+
* Covers file ops, search, shell, reasoning, verification, and memory.
|
|
54
|
+
*/
|
|
55
|
+
lean: [
|
|
56
|
+
// Must be in every profile: the switch itself (a profile without it locks
|
|
57
|
+
// the agent out of switching) and the discovery tool the deferred tools
|
|
58
|
+
// are unreachable without.
|
|
59
|
+
"set_tool_profile",
|
|
60
|
+
"tool_search",
|
|
61
|
+
// file ops
|
|
62
|
+
"read",
|
|
63
|
+
"edit",
|
|
64
|
+
"write",
|
|
65
|
+
// search & shell
|
|
66
|
+
"bash",
|
|
67
|
+
"grep",
|
|
68
|
+
"find",
|
|
69
|
+
"ls",
|
|
70
|
+
// reasoning & verification
|
|
71
|
+
"think",
|
|
72
|
+
"verify",
|
|
73
|
+
"finalize",
|
|
74
|
+
// session state
|
|
75
|
+
"scratchpad",
|
|
76
|
+
"memory",
|
|
77
|
+
],
|
|
78
|
+
/**
|
|
79
|
+
* research — information gathering and exploration.
|
|
80
|
+
* Adds web fetch, batch fetch, and memory retrieval while keeping
|
|
81
|
+
* file search and reasoning core.
|
|
82
|
+
*/
|
|
83
|
+
research: [
|
|
84
|
+
// Must be in every profile: the switch itself (a profile without it locks
|
|
85
|
+
// the agent out of switching) and the discovery tool the deferred tools
|
|
86
|
+
// are unreachable without.
|
|
87
|
+
"set_tool_profile",
|
|
88
|
+
"tool_search",
|
|
89
|
+
"read",
|
|
90
|
+
"fetch_content",
|
|
91
|
+
"grep",
|
|
92
|
+
"find",
|
|
93
|
+
"ls",
|
|
94
|
+
"bash",
|
|
95
|
+
"think",
|
|
96
|
+
"memory",
|
|
97
|
+
"scratchpad",
|
|
98
|
+
"verify",
|
|
99
|
+
],
|
|
100
|
+
/**
|
|
101
|
+
* debugging — finding and fixing bugs.
|
|
102
|
+
* Adds hypothesize, explore_paths, conflict_qa for diagnostic workflows.
|
|
103
|
+
* Keeps write/edit for fixes.
|
|
104
|
+
*/
|
|
105
|
+
debugging: [
|
|
106
|
+
// Must be in every profile: the switch itself (a profile without it locks
|
|
107
|
+
// the agent out of switching) and the discovery tool the deferred tools
|
|
108
|
+
// are unreachable without.
|
|
109
|
+
"set_tool_profile",
|
|
110
|
+
"tool_search",
|
|
111
|
+
"read",
|
|
112
|
+
"edit",
|
|
113
|
+
"write",
|
|
114
|
+
"bash",
|
|
115
|
+
"grep",
|
|
116
|
+
"find",
|
|
117
|
+
"ls",
|
|
118
|
+
"think",
|
|
119
|
+
"hypothesize",
|
|
120
|
+
"explore_paths",
|
|
121
|
+
"verify",
|
|
122
|
+
"conflict_qa",
|
|
123
|
+
],
|
|
124
|
+
/**
|
|
125
|
+
* browser — web browsing and UI testing.
|
|
126
|
+
* Includes browser automation tools, describe_image for screenshots,
|
|
127
|
+
* and fetch_content for page source inspection.
|
|
128
|
+
*/
|
|
129
|
+
browser: [
|
|
130
|
+
// Must be in every profile: the switch itself (a profile without it locks
|
|
131
|
+
// the agent out of switching) and the discovery tool the deferred tools
|
|
132
|
+
// are unreachable without.
|
|
133
|
+
"set_tool_profile",
|
|
134
|
+
"tool_search",
|
|
135
|
+
"browser_navigate",
|
|
136
|
+
"browser_snapshot",
|
|
137
|
+
"browser_eval",
|
|
138
|
+
"browser_screenshot",
|
|
139
|
+
"read",
|
|
140
|
+
"bash",
|
|
141
|
+
"think",
|
|
142
|
+
"describe_image",
|
|
143
|
+
"fetch_content",
|
|
144
|
+
"verify",
|
|
145
|
+
],
|
|
146
|
+
/**
|
|
147
|
+
* deep — deep code analysis and modification.
|
|
148
|
+
* Adds codebase (dependency graph), file_diff (comparison),
|
|
149
|
+
* and workspace_snapshot for working with complex code changes.
|
|
150
|
+
*/
|
|
151
|
+
deep: [
|
|
152
|
+
// Must be in every profile: the switch itself (a profile without it locks
|
|
153
|
+
// the agent out of switching) and the discovery tool the deferred tools
|
|
154
|
+
// are unreachable without.
|
|
155
|
+
"set_tool_profile",
|
|
156
|
+
"tool_search",
|
|
157
|
+
"read",
|
|
158
|
+
"edit",
|
|
159
|
+
"write",
|
|
160
|
+
"bash",
|
|
161
|
+
"grep",
|
|
162
|
+
"find",
|
|
163
|
+
"ls",
|
|
164
|
+
"think",
|
|
165
|
+
"verify",
|
|
166
|
+
"codebase",
|
|
167
|
+
"file_diff",
|
|
168
|
+
"scratchpad",
|
|
169
|
+
],
|
|
170
|
+
};
|
|
171
|
+
const PROFILE_NAMES = Object.keys(PROFILES);
|
|
172
|
+
/**
|
|
173
|
+
* The profile this session asked for, or null while it has asked for none.
|
|
174
|
+
*
|
|
175
|
+
* null is the born state, not a profile: the active set is left as pi-core,
|
|
176
|
+
* the operator's `/tools` list and the other extensions built it. Only
|
|
177
|
+
* `set_tool_profile` moves this off null.
|
|
178
|
+
*/
|
|
179
|
+
let _currentProfile = null;
|
|
180
|
+
/**
|
|
181
|
+
* The tools of `profileName` that the registry currently holds.
|
|
182
|
+
*
|
|
183
|
+
* A profile may name a tool whose extension is not loaded in this install;
|
|
184
|
+
* pi-core drops unknown names from setActiveTools() silently, so resolving
|
|
185
|
+
* here keeps the applied set and the reported set the same thing.
|
|
186
|
+
*/
|
|
187
|
+
function resolveProfile(pi, profileName) {
|
|
188
|
+
const tools = PROFILES[profileName];
|
|
189
|
+
if (!tools) {
|
|
190
|
+
throw new Error(`Unknown tool profile: "${profileName}". Available: ${PROFILE_NAMES.join(", ")}`);
|
|
191
|
+
}
|
|
192
|
+
const registered = new Set(pi.getAllTools().map((t) => t.name));
|
|
193
|
+
return tools.filter((name) => registered.has(name));
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Apply a tool profile by calling pi.setActiveTools().
|
|
197
|
+
* Returns the list of tools that were activated.
|
|
198
|
+
*/
|
|
199
|
+
function applyProfile(pi, profileName) {
|
|
200
|
+
const tools = resolveProfile(pi, profileName);
|
|
201
|
+
pi.setActiveTools(tools);
|
|
202
|
+
_currentProfile = profileName;
|
|
203
|
+
log.info(`[context-management] switched to profile "${profileName}" (${tools.length} tools)`);
|
|
204
|
+
log.debug(`[context-management] active tools: ${tools.join(", ")}`);
|
|
205
|
+
return tools;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Whether the operator picked the tool set by hand (/tools persists an
|
|
209
|
+
* explicit list). That choice outranks a profile asserted in the background:
|
|
210
|
+
* this extension owns the narrowing requests, not the operator's
|
|
211
|
+
* configuration. A live `set_tool_profile` call still applies - the agent is
|
|
212
|
+
* the one asking.
|
|
213
|
+
*/
|
|
214
|
+
function operatorChoseTools() {
|
|
215
|
+
return Array.isArray(readGlobalEnabledTools());
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
* Put the active set back on the profile this session asked for, when it has
|
|
219
|
+
* drifted.
|
|
220
|
+
*
|
|
221
|
+
* Nothing is asserted while no profile was asked for: with none, the active
|
|
222
|
+
* set belongs to pi-core, to the operator's `--tools`/`/tools` choice and to
|
|
223
|
+
* the sibling extensions, and this extension has no claim on it. Restoration
|
|
224
|
+
* exists for the narrowed case - pi-core's runtime build and sibling
|
|
225
|
+
* extensions rewrite the active set (a /reload re-activates the whole
|
|
226
|
+
* registry), and the agent's own narrowing has to survive that.
|
|
227
|
+
*
|
|
228
|
+
* The profile cannot be applied from the factory: pi-core binds the extension
|
|
229
|
+
* runtime after the factory returns, so setActiveTools() there throws
|
|
230
|
+
* "Extension runtime not initialized" and the call is lost. Asserting it
|
|
231
|
+
* here, where the active set is readable, is cheap in the steady state: a
|
|
232
|
+
* name comparison only, no write, unless something actually widened the set.
|
|
233
|
+
*/
|
|
234
|
+
function assertProfile(pi, reason) {
|
|
235
|
+
if (_currentProfile === null)
|
|
236
|
+
return;
|
|
237
|
+
const profileName = _currentProfile;
|
|
238
|
+
const wanted = resolveProfile(pi, profileName);
|
|
239
|
+
const active = pi.getActiveTools() ?? [];
|
|
240
|
+
const activeSet = new Set(active);
|
|
241
|
+
if (active.length === wanted.length && wanted.every((name) => activeSet.has(name)))
|
|
242
|
+
return;
|
|
243
|
+
if (operatorChoseTools())
|
|
244
|
+
return;
|
|
245
|
+
log.info(`[context-management] active set drifted from "${profileName}" (${reason}) - restoring`);
|
|
246
|
+
applyProfile(pi, profileName);
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* The tool that finds the tools braid does not declare.
|
|
250
|
+
*
|
|
251
|
+
* braid registers its cold tools with `exposure: "deferred"`: pi declares one
|
|
252
|
+
* to the model only once something activates it, and `tool_search` is the only
|
|
253
|
+
* thing that can (it is a pi built-in extension that registers the tool
|
|
254
|
+
* inactive). The deferral is braid's decision, so keeping the discovery path
|
|
255
|
+
* open is braid's job - not a setting the operator has to remember.
|
|
256
|
+
*/
|
|
257
|
+
const DISCOVERY_TOOL = "tool_search";
|
|
258
|
+
/**
|
|
259
|
+
* Activate the discovery tool when the session does not hold it.
|
|
260
|
+
*
|
|
261
|
+
* Additive by construction: the current set is the input, so whatever a
|
|
262
|
+
* profile, the operator's `--tools`/`/tools` list or a sibling extension
|
|
263
|
+
* activated stays active, and pi drops pending tools only when a set removes a
|
|
264
|
+
* name - which this never does. Returns the names it added.
|
|
265
|
+
*
|
|
266
|
+
* Nothing is written when the registry does not hold the tool (an install with
|
|
267
|
+
* the built-in tool-search extension disabled has nothing to activate) or when
|
|
268
|
+
* the active set is unreadable: treating `getActiveTools()` returning nothing
|
|
269
|
+
* as an empty set would replace the whole set with this one tool.
|
|
270
|
+
*/
|
|
271
|
+
function ensureDiscoveryTool(pi) {
|
|
272
|
+
const active = pi.getActiveTools();
|
|
273
|
+
if (!active || active.includes(DISCOVERY_TOOL))
|
|
274
|
+
return [];
|
|
275
|
+
if (!pi.getAllTools().some((t) => t.name === DISCOVERY_TOOL))
|
|
276
|
+
return [];
|
|
277
|
+
pi.setActiveTools([...active, DISCOVERY_TOOL]);
|
|
278
|
+
log.info(`[context-management] activated "${DISCOVERY_TOOL}" (deferred tools need it)`);
|
|
279
|
+
return [DISCOVERY_TOOL];
|
|
280
|
+
}
|
|
281
|
+
function createSetToolProfileTool(pi) {
|
|
282
|
+
return {
|
|
283
|
+
name: "set_tool_profile",
|
|
284
|
+
label: "Set Tool Profile",
|
|
285
|
+
promptSnippet: "Switch tool profiles: lean, research, debugging, browser, deep",
|
|
286
|
+
description: "Switch between curated tool profiles that cut the active tool set to ~12; takes effect immediately, prompt rebuilt.",
|
|
287
|
+
parameters: Type.Object({
|
|
288
|
+
profile: Type.Union([
|
|
289
|
+
Type.Literal("lean"),
|
|
290
|
+
Type.Literal("research"),
|
|
291
|
+
Type.Literal("debugging"),
|
|
292
|
+
Type.Literal("browser"),
|
|
293
|
+
Type.Literal("deep"),
|
|
294
|
+
], {
|
|
295
|
+
description: "Tool profile to activate",
|
|
296
|
+
}),
|
|
297
|
+
}),
|
|
298
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => {
|
|
299
|
+
const profile = params.profile;
|
|
300
|
+
const tools = applyProfile(pi, profile);
|
|
301
|
+
return {
|
|
302
|
+
content: [
|
|
303
|
+
{
|
|
304
|
+
type: "text",
|
|
305
|
+
text: JSON.stringify({
|
|
306
|
+
profile,
|
|
307
|
+
activeTools: tools.length,
|
|
308
|
+
tools,
|
|
309
|
+
}, null, 2),
|
|
310
|
+
},
|
|
311
|
+
],
|
|
312
|
+
details: { profile, activeTools: tools.length },
|
|
313
|
+
};
|
|
314
|
+
},
|
|
315
|
+
};
|
|
316
|
+
}
|
|
317
|
+
export default function contextManagementExtension(pi) {
|
|
318
|
+
// Register the profile-switching tool (pi is captured in closure for execute handler)
|
|
319
|
+
pi.registerTool(createSetToolProfileTool(pi));
|
|
320
|
+
log.info("[context-management] registered set_tool_profile tool");
|
|
321
|
+
// A fresh session is born un-narrowed and keeps the profile it later asks
|
|
322
|
+
// for; resume/fork/reload continue with that profile. The factory itself
|
|
323
|
+
// cannot apply one: see assertProfile.
|
|
324
|
+
registerSessionStartHandler(pi, SessionPhase.CoreInit, async (event) => {
|
|
325
|
+
if (event?.reason === "startup" || event?.reason === "new")
|
|
326
|
+
_currentProfile = null;
|
|
327
|
+
assertProfile(pi, `session_start:${event?.reason ?? "unknown"}`);
|
|
328
|
+
// After the profile assertion, so the discovery tool survives whatever
|
|
329
|
+
// profile was applied. The tool-config restore runs in a later handler
|
|
330
|
+
// and unions the tool into its own applies (it replaces the set).
|
|
331
|
+
ensureDiscoveryTool(pi);
|
|
332
|
+
}, "tool-profile");
|
|
333
|
+
pi.on("before_agent_start", async () => {
|
|
334
|
+
assertProfile(pi, "before_agent_start");
|
|
335
|
+
});
|
|
336
|
+
}
|
|
337
|
+
// Exports (for testing / programmatic access)
|
|
338
|
+
export { PROFILES, PROFILE_NAMES, applyProfile, ensureDiscoveryTool, _currentProfile };
|
|
339
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
2
|
+
export interface AgentEnvironmentState {
|
|
3
|
+
sessionStart: number;
|
|
4
|
+
lastEventTime: number;
|
|
5
|
+
turnCount: number;
|
|
6
|
+
toolCallStarts: Map<string, number>;
|
|
7
|
+
metrics: {
|
|
8
|
+
totalToolCalls: number;
|
|
9
|
+
totalToolTime: number;
|
|
10
|
+
userMessageCount: number;
|
|
11
|
+
assistantMessageCount: number;
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
export interface L1EnvironmentData {
|
|
15
|
+
pid: number;
|
|
16
|
+
sessionElapsedMs: number;
|
|
17
|
+
/** ISO timestamp when the pi session/instance started (wall clock). */
|
|
18
|
+
sessionStartedAt: string;
|
|
19
|
+
turnCount: number;
|
|
20
|
+
sinceLastEventMs: number;
|
|
21
|
+
avgToolTimeMs: number;
|
|
22
|
+
machine: {
|
|
23
|
+
platform: string;
|
|
24
|
+
type: string;
|
|
25
|
+
hostname: string;
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
export declare function gatherL1Environment(_pi: ExtensionAPI, ctx: ExtensionContext): L1EnvironmentData;
|
|
29
|
+
export default function agentEnvironmentExtension(pi: ExtensionAPI): void;
|
|
30
|
+
//# sourceMappingURL=index.d.ts.map
|