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,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Centralized event name constants.
|
|
3
|
+
*
|
|
4
|
+
* Every pi.on("event_name") call in the codebase should use these constants
|
|
5
|
+
* instead of raw strings to prevent drift. The single-ownership enforcer
|
|
6
|
+
* (test/runtime/test-single-ownership.mjs) verifies compliance.
|
|
7
|
+
*/
|
|
8
|
+
export declare const SESSION_START: "session_start";
|
|
9
|
+
export declare const SESSION_BEFORE_COMPACT: "session_before_compact";
|
|
10
|
+
export declare const SESSION_COMPACT: "session_compact";
|
|
11
|
+
export declare const SESSION_COMPACT_FAILED: "session_compact_failed";
|
|
12
|
+
export declare const SESSION_SHUTDOWN: "session_shutdown";
|
|
13
|
+
export declare const TURN_END: "turn_end";
|
|
14
|
+
export declare const AGENT_END: "agent_end";
|
|
15
|
+
export declare const TOOL_CALL: "tool_call";
|
|
16
|
+
export declare const MESSAGE_START: "message_start";
|
|
17
|
+
export declare const MESSAGE_END: "message_end";
|
|
18
|
+
export declare const TOOL_EXECUTION_START: "tool_execution_start";
|
|
19
|
+
export declare const TOOL_EXECUTION_END: "tool_execution_end";
|
|
20
|
+
export declare const AGENT_SETTLED: "agent_settled";
|
|
21
|
+
export declare const INPUT: "input";
|
|
22
|
+
export declare const RESOURCES_DISCOVER: "resources_discover";
|
|
23
|
+
//# sourceMappingURL=event-names.d.ts.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Centralized event name constants.
|
|
3
|
+
*
|
|
4
|
+
* Every pi.on("event_name") call in the codebase should use these constants
|
|
5
|
+
* instead of raw strings to prevent drift. The single-ownership enforcer
|
|
6
|
+
* (test/runtime/test-single-ownership.mjs) verifies compliance.
|
|
7
|
+
*/
|
|
8
|
+
// ── Session Lifecycle ───────────────────────────────────────────────────────
|
|
9
|
+
export const SESSION_START = "session_start";
|
|
10
|
+
export const SESSION_BEFORE_COMPACT = "session_before_compact";
|
|
11
|
+
export const SESSION_COMPACT = "session_compact";
|
|
12
|
+
export const SESSION_COMPACT_FAILED = "session_compact_failed";
|
|
13
|
+
export const SESSION_SHUTDOWN = "session_shutdown";
|
|
14
|
+
// ── Turn & Message Lifecycle ───────────────────────────────────────────────
|
|
15
|
+
export const TURN_END = "turn_end";
|
|
16
|
+
export const AGENT_END = "agent_end";
|
|
17
|
+
export const TOOL_CALL = "tool_call";
|
|
18
|
+
export const MESSAGE_START = "message_start";
|
|
19
|
+
export const MESSAGE_END = "message_end";
|
|
20
|
+
export const TOOL_EXECUTION_START = "tool_execution_start";
|
|
21
|
+
export const TOOL_EXECUTION_END = "tool_execution_end";
|
|
22
|
+
export const AGENT_SETTLED = "agent_settled";
|
|
23
|
+
// ── Extension Communication ─────────────────────────────────────────────────
|
|
24
|
+
export const INPUT = "input";
|
|
25
|
+
export const RESOURCES_DISCOVER = "resources_discover";
|
|
26
|
+
//# sourceMappingURL=event-names.js.map
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Logger - Unified logging for pi-braid extensions
|
|
3
|
+
*
|
|
4
|
+
* Respects the pi Extension API:
|
|
5
|
+
* - No ctx bound (load time, lib code) -> in-memory buffer only by default
|
|
6
|
+
* (console writes are suppressed to protect TUI rendering)
|
|
7
|
+
* - ctx bound via setLoggerContext() -> log lines route to ctx.ui.notify
|
|
8
|
+
* so the user sees them as TUI notifications, not stdout pollution
|
|
9
|
+
* - The in-memory buffer is ALWAYS populated regardless of ctx binding
|
|
10
|
+
* (retrieve via /logs slash command or formatLogBuffer())
|
|
11
|
+
*
|
|
12
|
+
* Usage:
|
|
13
|
+
* const log = createLogger("my-extension");
|
|
14
|
+
* log.warn("Something unexpected");
|
|
15
|
+
* log.info("Progress update");
|
|
16
|
+
*
|
|
17
|
+
* Routing logic when ctx is bound:
|
|
18
|
+
* log.error -> ctx.ui.notify(msg, "error")
|
|
19
|
+
* log.warn -> ctx.ui.notify(msg, "warning")
|
|
20
|
+
* log.info -> ctx.ui.notify(msg, "info")
|
|
21
|
+
* log.debug -> ctx.ui.notify(msg, "info") // debug is informational when visible
|
|
22
|
+
*
|
|
23
|
+
* The /logs slash command and the in-memory buffer remain available
|
|
24
|
+
* even when ctx is bound, for debugging sessions.
|
|
25
|
+
*
|
|
26
|
+
* LIMITATION: setLoggerContext binds a single global ctx. Pi runs one
|
|
27
|
+
* session per process, so this is fine in practice. If you need
|
|
28
|
+
* per-session isolation, the buffer is the safe channel.
|
|
29
|
+
*/
|
|
30
|
+
export type LogLevel = "debug" | "info" | "warn" | "error";
|
|
31
|
+
/** Sentinel: "no level writes to console." The in-memory buffer is still populated. */
|
|
32
|
+
export type ConsoleLogLevel = LogLevel | "none";
|
|
33
|
+
/** Minimal context shape needed for log routing. Compatible with ExtensionContext. */
|
|
34
|
+
export interface LoggerContext {
|
|
35
|
+
ui?: {
|
|
36
|
+
notify?: (message: string, notifyType?: "info" | "warning" | "error") => void;
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
interface LogEntry {
|
|
40
|
+
timestamp: number;
|
|
41
|
+
level: LogLevel;
|
|
42
|
+
source: string;
|
|
43
|
+
message: string;
|
|
44
|
+
data?: unknown;
|
|
45
|
+
}
|
|
46
|
+
export interface Logger {
|
|
47
|
+
debug(message: string, data?: unknown): void;
|
|
48
|
+
info(message: string, data?: unknown): void;
|
|
49
|
+
warn(message: string, data?: unknown): void;
|
|
50
|
+
error(message: string, data?: unknown): void;
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Create (or retrieve) a named logger.
|
|
54
|
+
*
|
|
55
|
+
* Loggers are cached by name - calling createLogger("foo") twice returns the
|
|
56
|
+
* same instance. This lets lib/ code and extension code share a logger.
|
|
57
|
+
*/
|
|
58
|
+
export declare function createLogger(source: string): Logger;
|
|
59
|
+
/**
|
|
60
|
+
* Bind a context for log routing. When bound, log lines route to
|
|
61
|
+
* ctx.ui.notify instead of console (TUI-safe). Pass null to unbind
|
|
62
|
+
* (e.g., on session_shutdown).
|
|
63
|
+
*
|
|
64
|
+
* USAGE: call from a `session_start` handler with the received ctx.
|
|
65
|
+
* The braid's main extension does this once per process:
|
|
66
|
+
*
|
|
67
|
+
* pi.on("session_start", (_event, ctx) => {
|
|
68
|
+
* setLoggerContext(ctx);
|
|
69
|
+
* });
|
|
70
|
+
* pi.on("session_shutdown", (_event, _ctx) => {
|
|
71
|
+
* setLoggerContext(null);
|
|
72
|
+
* });
|
|
73
|
+
*
|
|
74
|
+
* LIMITATION: this is a global binding. Pi runs one session per process,
|
|
75
|
+
* so this is fine in practice. If two sessions ran in the same process,
|
|
76
|
+
* they would share the same ctx binding.
|
|
77
|
+
*/
|
|
78
|
+
export declare function setLoggerContext(ctx: LoggerContext | null): void;
|
|
79
|
+
/** Suppress a specific source (e.g. during tests). */
|
|
80
|
+
export declare function suppressLogger(source: string): void;
|
|
81
|
+
/** Unsuppress a previously suppressed source. */
|
|
82
|
+
export declare function unsuppressLogger(source: string): void;
|
|
83
|
+
/** Get all active logger source names. */
|
|
84
|
+
export declare function getActiveLoggerSources(): string[];
|
|
85
|
+
/** Get the in-memory log buffer (for debugging / crash reports). */
|
|
86
|
+
export declare function getLogBuffer(): readonly LogEntry[];
|
|
87
|
+
/** Clear the in-memory log buffer. */
|
|
88
|
+
export declare function clearLogBuffer(): void;
|
|
89
|
+
/** Get formatted log buffer as string (for crash reports). */
|
|
90
|
+
export declare function formatLogBuffer(): string;
|
|
91
|
+
/** Set the minimum log level globally (gates which entries are emitted at all). */
|
|
92
|
+
export declare function setGlobalLogLevel(level: LogLevel): void;
|
|
93
|
+
/** Set the minimum level that writes to the process console.
|
|
94
|
+
* Default is "none" (nothing writes to console; the TUI is never
|
|
95
|
+
* corrupted by stderr pollution from extensions). Lower to "warn" /
|
|
96
|
+
* "info" / "debug" for verbose tracing during a debugging session
|
|
97
|
+
* (be aware this will corrupt the TUI rendering while active).
|
|
98
|
+
* The in-memory buffer is always populated regardless of this setting
|
|
99
|
+
* - retrieve it via the /logs slash command or formatLogBuffer(). */
|
|
100
|
+
export declare function setConsoleLogLevel(level: ConsoleLogLevel): void;
|
|
101
|
+
export {};
|
|
102
|
+
//# sourceMappingURL=logger.d.ts.map
|
|
@@ -0,0 +1,274 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Logger - Unified logging for pi-braid extensions
|
|
3
|
+
*
|
|
4
|
+
* Respects the pi Extension API:
|
|
5
|
+
* - No ctx bound (load time, lib code) -> in-memory buffer only by default
|
|
6
|
+
* (console writes are suppressed to protect TUI rendering)
|
|
7
|
+
* - ctx bound via setLoggerContext() -> log lines route to ctx.ui.notify
|
|
8
|
+
* so the user sees them as TUI notifications, not stdout pollution
|
|
9
|
+
* - The in-memory buffer is ALWAYS populated regardless of ctx binding
|
|
10
|
+
* (retrieve via /logs slash command or formatLogBuffer())
|
|
11
|
+
*
|
|
12
|
+
* Usage:
|
|
13
|
+
* const log = createLogger("my-extension");
|
|
14
|
+
* log.warn("Something unexpected");
|
|
15
|
+
* log.info("Progress update");
|
|
16
|
+
*
|
|
17
|
+
* Routing logic when ctx is bound:
|
|
18
|
+
* log.error -> ctx.ui.notify(msg, "error")
|
|
19
|
+
* log.warn -> ctx.ui.notify(msg, "warning")
|
|
20
|
+
* log.info -> ctx.ui.notify(msg, "info")
|
|
21
|
+
* log.debug -> ctx.ui.notify(msg, "info") // debug is informational when visible
|
|
22
|
+
*
|
|
23
|
+
* The /logs slash command and the in-memory buffer remain available
|
|
24
|
+
* even when ctx is bound, for debugging sessions.
|
|
25
|
+
*
|
|
26
|
+
* LIMITATION: setLoggerContext binds a single global ctx. Pi runs one
|
|
27
|
+
* session per process, so this is fine in practice. If you need
|
|
28
|
+
* per-session isolation, the buffer is the safe channel.
|
|
29
|
+
*/
|
|
30
|
+
// ── Module state ───────────────────────────────────────────────────────────
|
|
31
|
+
const _LEVEL_PRIORITY = {
|
|
32
|
+
debug: 0,
|
|
33
|
+
info: 1,
|
|
34
|
+
warn: 2,
|
|
35
|
+
error: 3,
|
|
36
|
+
};
|
|
37
|
+
/** Currently bound logger context (set via setLoggerContext). When set,
|
|
38
|
+
* log lines route to ctx.ui.notify instead of console (TUI-safe). */
|
|
39
|
+
let _boundContext = null;
|
|
40
|
+
/** Priority for "none" - higher than any real level so nothing writes. */
|
|
41
|
+
const _NONE_PRIORITY = 4;
|
|
42
|
+
const _suppressedSources = new Set();
|
|
43
|
+
let _globalMinLevel = "info";
|
|
44
|
+
const _globallySuppressed = false;
|
|
45
|
+
/** Minimum level that writes to the process console.
|
|
46
|
+
* Default is "none" (nothing writes to console). pi is a TUI process:
|
|
47
|
+
* writing to stdout/stderr from an extension handler corrupts the
|
|
48
|
+
* TUI's cursor positioning. The native pi docs use console.error in
|
|
49
|
+
* error paths, but for third-party extensions, the correct pattern is
|
|
50
|
+
* to use ctx.ui.notify for user-facing messages and keep all
|
|
51
|
+
* diagnostics in the in-memory buffer (retrievable via /logs).
|
|
52
|
+
*
|
|
53
|
+
* Callers can lower this to "info" or "debug" for verbose tracing
|
|
54
|
+
* (e.g., during a debugging session) - but be aware that doing so
|
|
55
|
+
* will corrupt the TUI rendering for that session.
|
|
56
|
+
*
|
|
57
|
+
* Use "none" (the default) for normal operation. The buffer is
|
|
58
|
+
* always populated regardless of this setting. */
|
|
59
|
+
let _consoleMinLevel = "none";
|
|
60
|
+
/** In-memory log buffer for the current session (last 200 entries) */
|
|
61
|
+
const _logBuffer = [];
|
|
62
|
+
const MAX_BUFFER_SIZE = 200;
|
|
63
|
+
// ── Format helpers ─────────────────────────────────────────────────────────
|
|
64
|
+
function formatLevel(level) {
|
|
65
|
+
return level.toUpperCase().padEnd(5);
|
|
66
|
+
}
|
|
67
|
+
function formatTimestamp(ts) {
|
|
68
|
+
const d = new Date(ts);
|
|
69
|
+
return d.toISOString().slice(11, 23); // HH:mm:ss.mmm
|
|
70
|
+
}
|
|
71
|
+
function formatData(data) {
|
|
72
|
+
if (data === undefined || data === null)
|
|
73
|
+
return "";
|
|
74
|
+
if (data instanceof Error) {
|
|
75
|
+
let s = ` ${data.message}`;
|
|
76
|
+
if (data.stack)
|
|
77
|
+
s += ` | ${data.stack.split("\n").slice(1, 3).join(" | ")}`;
|
|
78
|
+
return s;
|
|
79
|
+
}
|
|
80
|
+
if (typeof data === "object") {
|
|
81
|
+
try {
|
|
82
|
+
const json = JSON.stringify(data);
|
|
83
|
+
return json.length > 200 ? ` ${json.slice(0, 197)}...` : ` ${json}`;
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
return " [unstringifiable]";
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
return ` ${String(data)}`;
|
|
90
|
+
}
|
|
91
|
+
function formatConsole(entry) {
|
|
92
|
+
const ts = formatTimestamp(entry.timestamp);
|
|
93
|
+
return `${ts} ${formatLevel(entry.level)} [${entry.source}] ${entry.message}${formatData(entry.data)}`;
|
|
94
|
+
}
|
|
95
|
+
// formatNotify removed - only used by the removed writeToUI function.
|
|
96
|
+
// ── Core sink ──────────────────────────────────────────────────────────────
|
|
97
|
+
/** Map log level to the severity used by ctx.ui.notify. */
|
|
98
|
+
function notifySeverityForLevel(level) {
|
|
99
|
+
if (level === "error")
|
|
100
|
+
return "error";
|
|
101
|
+
if (level === "warn")
|
|
102
|
+
return "warning";
|
|
103
|
+
return "info"; // debug + info both surface as info
|
|
104
|
+
}
|
|
105
|
+
function writeToConsole(entry) {
|
|
106
|
+
// When a logger context is bound, route through ctx.ui.notify so the
|
|
107
|
+
// user sees the message as a TUI notification (NOT as stdout pollution
|
|
108
|
+
// that would break TUI cursor positioning). Console writes are skipped
|
|
109
|
+
// entirely in this mode.
|
|
110
|
+
if (_boundContext?.ui?.notify) {
|
|
111
|
+
try {
|
|
112
|
+
_boundContext.ui.notify(formatConsole(entry), notifySeverityForLevel(entry.level));
|
|
113
|
+
}
|
|
114
|
+
catch {
|
|
115
|
+
// If notify throws (no UI in RPC/print mode), fall through to the
|
|
116
|
+
// buffer-only path below. The entry is already in the buffer.
|
|
117
|
+
}
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
// No ctx bound: fall back to console. By default _consoleMinLevel is
|
|
121
|
+
// 'none' so nothing is written (TUI-safe). For explicit debug sessions
|
|
122
|
+
// the user can call setConsoleLogLevel("info") via /logs level.
|
|
123
|
+
if (_consoleMinLevel === "none")
|
|
124
|
+
return;
|
|
125
|
+
if (_LEVEL_PRIORITY[entry.level] < _LEVEL_PRIORITY[_consoleMinLevel]) {
|
|
126
|
+
return; // below threshold
|
|
127
|
+
}
|
|
128
|
+
const line = formatConsole(entry);
|
|
129
|
+
switch (entry.level) {
|
|
130
|
+
case "error":
|
|
131
|
+
console.error(line);
|
|
132
|
+
break;
|
|
133
|
+
case "warn":
|
|
134
|
+
console.warn(line);
|
|
135
|
+
break;
|
|
136
|
+
case "info":
|
|
137
|
+
// This file owns the console sink; the no-console rule targets extension
|
|
138
|
+
// authors, not the logger abstraction that routes console output.
|
|
139
|
+
// eslint-disable-next-line no-console
|
|
140
|
+
console.info(line);
|
|
141
|
+
break;
|
|
142
|
+
case "debug":
|
|
143
|
+
// eslint-disable-next-line no-console -- same reason as the info case
|
|
144
|
+
console.debug(line);
|
|
145
|
+
break;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
// writeToUI removed - no longer needed after removing the context stack.
|
|
149
|
+
// All output routes through console + in-memory buffer.
|
|
150
|
+
function addToBuffer(entry) {
|
|
151
|
+
_logBuffer.push(entry);
|
|
152
|
+
if (_logBuffer.length > MAX_BUFFER_SIZE) {
|
|
153
|
+
_logBuffer.shift();
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
// ── Logger factory ─────────────────────────────────────────────────────────
|
|
157
|
+
class LoggerImpl {
|
|
158
|
+
_source;
|
|
159
|
+
constructor(source) {
|
|
160
|
+
this._source = source;
|
|
161
|
+
}
|
|
162
|
+
_shouldLog(level) {
|
|
163
|
+
if (_globallySuppressed)
|
|
164
|
+
return false;
|
|
165
|
+
if (_suppressedSources.has(this._source))
|
|
166
|
+
return false;
|
|
167
|
+
if (_LEVEL_PRIORITY[level] < _LEVEL_PRIORITY[_globalMinLevel])
|
|
168
|
+
return false;
|
|
169
|
+
return true;
|
|
170
|
+
}
|
|
171
|
+
_emit(level, message, data) {
|
|
172
|
+
if (!this._shouldLog(level))
|
|
173
|
+
return;
|
|
174
|
+
const entry = {
|
|
175
|
+
timestamp: Date.now(),
|
|
176
|
+
level,
|
|
177
|
+
source: this._source,
|
|
178
|
+
message,
|
|
179
|
+
data,
|
|
180
|
+
};
|
|
181
|
+
addToBuffer(entry);
|
|
182
|
+
writeToConsole(entry);
|
|
183
|
+
}
|
|
184
|
+
debug(message, data) {
|
|
185
|
+
this._emit("debug", message, data);
|
|
186
|
+
}
|
|
187
|
+
info(message, data) {
|
|
188
|
+
this._emit("info", message, data);
|
|
189
|
+
}
|
|
190
|
+
warn(message, data) {
|
|
191
|
+
this._emit("warn", message, data);
|
|
192
|
+
}
|
|
193
|
+
error(message, data) {
|
|
194
|
+
this._emit("error", message, data);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
// ── Public API ─────────────────────────────────────────────────────────────
|
|
198
|
+
const _loggers = new Map();
|
|
199
|
+
/**
|
|
200
|
+
* Create (or retrieve) a named logger.
|
|
201
|
+
*
|
|
202
|
+
* Loggers are cached by name - calling createLogger("foo") twice returns the
|
|
203
|
+
* same instance. This lets lib/ code and extension code share a logger.
|
|
204
|
+
*/
|
|
205
|
+
export function createLogger(source) {
|
|
206
|
+
if (!_loggers.has(source)) {
|
|
207
|
+
_loggers.set(source, new LoggerImpl(source));
|
|
208
|
+
}
|
|
209
|
+
return _loggers.get(source);
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* Bind a context for log routing. When bound, log lines route to
|
|
213
|
+
* ctx.ui.notify instead of console (TUI-safe). Pass null to unbind
|
|
214
|
+
* (e.g., on session_shutdown).
|
|
215
|
+
*
|
|
216
|
+
* USAGE: call from a `session_start` handler with the received ctx.
|
|
217
|
+
* The braid's main extension does this once per process:
|
|
218
|
+
*
|
|
219
|
+
* pi.on("session_start", (_event, ctx) => {
|
|
220
|
+
* setLoggerContext(ctx);
|
|
221
|
+
* });
|
|
222
|
+
* pi.on("session_shutdown", (_event, _ctx) => {
|
|
223
|
+
* setLoggerContext(null);
|
|
224
|
+
* });
|
|
225
|
+
*
|
|
226
|
+
* LIMITATION: this is a global binding. Pi runs one session per process,
|
|
227
|
+
* so this is fine in practice. If two sessions ran in the same process,
|
|
228
|
+
* they would share the same ctx binding.
|
|
229
|
+
*/
|
|
230
|
+
export function setLoggerContext(ctx) {
|
|
231
|
+
_boundContext = ctx;
|
|
232
|
+
}
|
|
233
|
+
/** Suppress a specific source (e.g. during tests). */
|
|
234
|
+
export function suppressLogger(source) {
|
|
235
|
+
_suppressedSources.add(source);
|
|
236
|
+
}
|
|
237
|
+
/** Unsuppress a previously suppressed source. */
|
|
238
|
+
export function unsuppressLogger(source) {
|
|
239
|
+
_suppressedSources.delete(source);
|
|
240
|
+
}
|
|
241
|
+
/** Get all active logger source names. */
|
|
242
|
+
export function getActiveLoggerSources() {
|
|
243
|
+
return Array.from(_loggers.keys());
|
|
244
|
+
}
|
|
245
|
+
/** Get the in-memory log buffer (for debugging / crash reports). */
|
|
246
|
+
export function getLogBuffer() {
|
|
247
|
+
return _logBuffer;
|
|
248
|
+
}
|
|
249
|
+
/** Clear the in-memory log buffer. */
|
|
250
|
+
export function clearLogBuffer() {
|
|
251
|
+
_logBuffer.length = 0;
|
|
252
|
+
}
|
|
253
|
+
/** Get formatted log buffer as string (for crash reports). */
|
|
254
|
+
export function formatLogBuffer() {
|
|
255
|
+
return _logBuffer.map(formatConsole).join("\n");
|
|
256
|
+
}
|
|
257
|
+
/** Set the minimum log level globally (gates which entries are emitted at all). */
|
|
258
|
+
export function setGlobalLogLevel(level) {
|
|
259
|
+
_globalMinLevel = level;
|
|
260
|
+
}
|
|
261
|
+
/** Set the minimum level that writes to the process console.
|
|
262
|
+
* Default is "none" (nothing writes to console; the TUI is never
|
|
263
|
+
* corrupted by stderr pollution from extensions). Lower to "warn" /
|
|
264
|
+
* "info" / "debug" for verbose tracing during a debugging session
|
|
265
|
+
* (be aware this will corrupt the TUI rendering while active).
|
|
266
|
+
* The in-memory buffer is always populated regardless of this setting
|
|
267
|
+
* - retrieve it via the /logs slash command or formatLogBuffer(). */
|
|
268
|
+
export function setConsoleLogLevel(level) {
|
|
269
|
+
_consoleMinLevel = level;
|
|
270
|
+
}
|
|
271
|
+
// ── Backwards compatibility ────────────────────────────────────────────────
|
|
272
|
+
// taggedConsole was a quick-and-dirty console wrapper. Removed in favor of
|
|
273
|
+
// const log = createLogger("source");
|
|
274
|
+
//# sourceMappingURL=logger.js.map
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Adaptive Compression Strategy (2604.15877) - Experience Compression Spectrum
|
|
3
|
+
* Different temporal scales require different compression strategies.
|
|
4
|
+
*
|
|
5
|
+
* Levels:
|
|
6
|
+
* short-term - pruning: remove noise, collapse repetitions (BCR)
|
|
7
|
+
* medium-term - reasoning summarization: chains -> conclusions
|
|
8
|
+
* long-term - episodic: extract patterns to memory
|
|
9
|
+
*
|
|
10
|
+
* Compression level determination uses an LLM judge via classify() with
|
|
11
|
+
* the compressionUrgency critic. Falls back to static thresholds when
|
|
12
|
+
* LLM is unavailable (compressionUrgencyFallback in critic-registry.ts).
|
|
13
|
+
*/
|
|
14
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
15
|
+
export type CompressionLevel = "short-term" | "medium-term" | "long-term";
|
|
16
|
+
export type CompressionTrigger = "bcr" | "reasoning" | "episodic" | "density";
|
|
17
|
+
export interface CompressionDecision {
|
|
18
|
+
level: CompressionLevel;
|
|
19
|
+
trigger: CompressionTrigger;
|
|
20
|
+
turnsSinceCompression: number;
|
|
21
|
+
reason: string;
|
|
22
|
+
estimatedSavings: number;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Determine the appropriate compression level using an LLM judge.
|
|
26
|
+
*
|
|
27
|
+
* Uses classify() with the compressionUrgency critic to get a semantic
|
|
28
|
+
* assessment of compression need. Falls back to the static
|
|
29
|
+
* threshold logic when LLM is unavailable.
|
|
30
|
+
*/
|
|
31
|
+
export declare function determineCompressionLevel(ctx: ExtensionContext, opts?: {
|
|
32
|
+
turnCount: number;
|
|
33
|
+
turnsSinceCompression: number;
|
|
34
|
+
consecutiveFailures: number;
|
|
35
|
+
reasoningChainDepth: number;
|
|
36
|
+
messageCount: number;
|
|
37
|
+
}): Promise<CompressionDecision>;
|
|
38
|
+
//# sourceMappingURL=compression-strategy.d.ts.map
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Adaptive Compression Strategy (2604.15877) - Experience Compression Spectrum
|
|
3
|
+
* Different temporal scales require different compression strategies.
|
|
4
|
+
*
|
|
5
|
+
* Levels:
|
|
6
|
+
* short-term - pruning: remove noise, collapse repetitions (BCR)
|
|
7
|
+
* medium-term - reasoning summarization: chains -> conclusions
|
|
8
|
+
* long-term - episodic: extract patterns to memory
|
|
9
|
+
*
|
|
10
|
+
* Compression level determination uses an LLM judge via classify() with
|
|
11
|
+
* the compressionUrgency critic. Falls back to static thresholds when
|
|
12
|
+
* LLM is unavailable (compressionUrgencyFallback in critic-registry.ts).
|
|
13
|
+
*/
|
|
14
|
+
import { classify } from "../ai/text-classifier.js";
|
|
15
|
+
import { CRITICS } from "../ai/critic-registry.js";
|
|
16
|
+
import { evaluateContextDensity } from "../detection/context-density.js";
|
|
17
|
+
import { compressionUrgencyFallback } from "../ai/critic-fallbacks.js";
|
|
18
|
+
/**
|
|
19
|
+
* Determine the appropriate compression level using an LLM judge.
|
|
20
|
+
*
|
|
21
|
+
* Uses classify() with the compressionUrgency critic to get a semantic
|
|
22
|
+
* assessment of compression need. Falls back to the static
|
|
23
|
+
* threshold logic when LLM is unavailable.
|
|
24
|
+
*/
|
|
25
|
+
export async function determineCompressionLevel(ctx, opts = {
|
|
26
|
+
turnCount: 0,
|
|
27
|
+
turnsSinceCompression: Infinity,
|
|
28
|
+
consecutiveFailures: 0,
|
|
29
|
+
reasoningChainDepth: 0,
|
|
30
|
+
messageCount: 0,
|
|
31
|
+
}) {
|
|
32
|
+
const density = evaluateContextDensity(ctx);
|
|
33
|
+
try {
|
|
34
|
+
const result = await classify(ctx, CRITICS.compressionUrgency.criteria, {
|
|
35
|
+
turnsSinceCompression: String(opts.turnsSinceCompression),
|
|
36
|
+
totalTurns: String(opts.turnCount),
|
|
37
|
+
consecutiveFailures: String(opts.consecutiveFailures),
|
|
38
|
+
reasoningDepth: String(opts.reasoningChainDepth),
|
|
39
|
+
messageCount: String(opts.messageCount),
|
|
40
|
+
}, {
|
|
41
|
+
timeoutMs: 60_000,
|
|
42
|
+
label: CRITICS.compressionUrgency.label,
|
|
43
|
+
// B-class: compressionUrgencyFallback has 4-way classification
|
|
44
|
+
// (AGGRESSIVE/SEMANTIC/CONSERVATIVE/NONE) from threshold-based
|
|
45
|
+
// heuristic. tierPolicy: fallback-only downweights to 0.5.
|
|
46
|
+
fallback: () => compressionUrgencyFallback({
|
|
47
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
48
|
+
totalTurns: opts.turnCount,
|
|
49
|
+
consecutiveFailures: opts.consecutiveFailures,
|
|
50
|
+
reasoningDepth: opts.reasoningChainDepth,
|
|
51
|
+
messageCount: opts.messageCount,
|
|
52
|
+
}),
|
|
53
|
+
modelPreference: "quality",
|
|
54
|
+
tierPolicy: "fallback-only",
|
|
55
|
+
});
|
|
56
|
+
const label = result.label.toUpperCase();
|
|
57
|
+
if (label === "AGGRESSIVE") {
|
|
58
|
+
return {
|
|
59
|
+
level: "long-term",
|
|
60
|
+
trigger: opts.consecutiveFailures >= 3 ? "bcr" : density.density >= 0.7 ? "density" : "episodic",
|
|
61
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
62
|
+
reason: `LLM judge: aggressive compression needed (${result.tier})`,
|
|
63
|
+
estimatedSavings: 0.65,
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
if (label === "SEMANTIC") {
|
|
67
|
+
return {
|
|
68
|
+
level: "medium-term",
|
|
69
|
+
trigger: "reasoning",
|
|
70
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
71
|
+
reason: `LLM judge: semantic compression suitable (${result.tier})`,
|
|
72
|
+
estimatedSavings: 0.55,
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
if (label === "CONSERVATIVE") {
|
|
76
|
+
return {
|
|
77
|
+
level: "short-term",
|
|
78
|
+
trigger: "density",
|
|
79
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
80
|
+
reason: `LLM judge: conservative prune only (${result.tier})`,
|
|
81
|
+
estimatedSavings: 0.35,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
// NONE
|
|
85
|
+
return {
|
|
86
|
+
level: "short-term",
|
|
87
|
+
trigger: "bcr",
|
|
88
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
89
|
+
reason: "LLM judge: no compression needed",
|
|
90
|
+
estimatedSavings: 0,
|
|
91
|
+
};
|
|
92
|
+
}
|
|
93
|
+
catch {
|
|
94
|
+
// LLM unavailable - fall through to heuristic below
|
|
95
|
+
}
|
|
96
|
+
// Fallback: detect consecutive failures (always compress)
|
|
97
|
+
if (opts.consecutiveFailures >= 3) {
|
|
98
|
+
return {
|
|
99
|
+
level: "short-term",
|
|
100
|
+
trigger: "bcr",
|
|
101
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
102
|
+
reason: `${opts.consecutiveFailures}x consecutive failures - collapse error pattern.`,
|
|
103
|
+
estimatedSavings: 0.4,
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
// Fallback: late session / high density -> compress
|
|
107
|
+
if (opts.turnCount >= 80 || density.density >= 0.7) {
|
|
108
|
+
return {
|
|
109
|
+
level: "long-term",
|
|
110
|
+
trigger: "episodic",
|
|
111
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
112
|
+
reason: opts.turnCount >= 80
|
|
113
|
+
? "Late session (>=80 turns) - extract to episodic memory."
|
|
114
|
+
: `High density (${Math.round(density.density * 100)}%) - aggressive compression.`,
|
|
115
|
+
estimatedSavings: 0.65,
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
// Fallback: mid-session with deep reasoning
|
|
119
|
+
if (opts.turnCount >= 30 && opts.reasoningChainDepth > 3) {
|
|
120
|
+
return {
|
|
121
|
+
level: "medium-term",
|
|
122
|
+
trigger: "reasoning",
|
|
123
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
124
|
+
reason: `Deep reasoning chain (${opts.reasoningChainDepth} steps) - medium-term compression opportunity.`,
|
|
125
|
+
estimatedSavings: 0.55,
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
// Fallback: long since last compression
|
|
129
|
+
if (opts.turnCount >= 30 && opts.turnsSinceCompression > 40) {
|
|
130
|
+
return {
|
|
131
|
+
level: "medium-term",
|
|
132
|
+
trigger: "density",
|
|
133
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
134
|
+
reason: "40+ turns since compression - prevent bloat.",
|
|
135
|
+
estimatedSavings: 0.35,
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
// Default: no compression needed
|
|
139
|
+
return {
|
|
140
|
+
level: "short-term",
|
|
141
|
+
trigger: "bcr",
|
|
142
|
+
turnsSinceCompression: opts.turnsSinceCompression,
|
|
143
|
+
reason: "Session healthy.",
|
|
144
|
+
estimatedSavings: 0,
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
//# sourceMappingURL=compression-strategy.js.map
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Consolidated Topic Critic -- single LLM call for all 3 topic-drift checks.
|
|
3
|
+
*
|
|
4
|
+
* Replaces 3 parallel classify() calls (topicCoverage, topicDivergence,
|
|
5
|
+
* topicCompleteness) with one structured-output LLM call that returns all
|
|
6
|
+
* three verdicts as JSON. Falls back to conservative heuristic fallbacks
|
|
7
|
+
* (topicDriftFallback -> "no" for all dimensions) on failure.
|
|
8
|
+
*
|
|
9
|
+
* Benefits:
|
|
10
|
+
* - 3x fewer LLM calls -> ~66% latency reduction at turn_end
|
|
11
|
+
* - Single system prompt shared across all three dimensions
|
|
12
|
+
* - Model can cross-reference dimensions (e.g., divergence vs coverage)
|
|
13
|
+
* - Same return interface -- drop-in replacement for both call sites
|
|
14
|
+
* (lib/detection/topic-drift-detector.ts and the extension handler)
|
|
15
|
+
*
|
|
16
|
+
* Output budget: the answer is ~40 tokens of JSON, but thinking tokens count
|
|
17
|
+
* against max_tokens on every reasoning model braid routes to, and the channel
|
|
18
|
+
* cannot be switched off for a model whose thinkingLevelMap declares no "off"
|
|
19
|
+
* level (pi-ai clamps "off" to the lowest declared level). So a small explicit
|
|
20
|
+
* ceiling is a ceiling on thinking and the JSON body never gets written. The
|
|
21
|
+
* mechanism that answers this - first completion with no maxTokens, one
|
|
22
|
+
* enlarged-budget retry when a completion ends at its ceiling without a
|
|
23
|
+
* verdict - lives in lib/ai/judge-budget.ts and is shared with the other two
|
|
24
|
+
* consolidated judges.
|
|
25
|
+
*/
|
|
26
|
+
import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
27
|
+
export interface ConsolidatedTopicVerdict {
|
|
28
|
+
/** true = still addresses the original request (coverage was "yes") */
|
|
29
|
+
coversTopic: boolean;
|
|
30
|
+
/** true = has shifted to a different topic (divergence was "yes") */
|
|
31
|
+
hasDiverged: boolean;
|
|
32
|
+
/** true = covers all key topics (completeness was "yes") */
|
|
33
|
+
isComplete: boolean;
|
|
34
|
+
}
|
|
35
|
+
export interface ConsolidatedTopicResult {
|
|
36
|
+
coverage: boolean;
|
|
37
|
+
divergence: boolean;
|
|
38
|
+
completeness: boolean;
|
|
39
|
+
classifierDown: boolean;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Consolidated topic critique -- single LLM call for all 3 drift dimensions.
|
|
43
|
+
*
|
|
44
|
+
* Model tier strategy (modelPreference: "quality"):
|
|
45
|
+
* 1. Try session model (cheap, may already be powerful)
|
|
46
|
+
* 2. If session fails, try utility model
|
|
47
|
+
* 3. If both fail, try max-power model (accuracy-critical safety net)
|
|
48
|
+
* 4. If all fail, use conservative defaults (no drift detected)
|
|
49
|
+
*/
|
|
50
|
+
export declare function consolidatedTopicCritique(original: string, response: string, ctx: ExtensionContext): Promise<ConsolidatedTopicResult>;
|
|
51
|
+
//# sourceMappingURL=consolidated-topic-critic.d.ts.map
|