pi-braid 0.0.0-stage → 0.40.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +266 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +166 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +502 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,602 @@
|
|
|
1
|
+
import { deliverPastInsights } from "../../../lib/memory/past-insights.js";
|
|
2
|
+
import { getCognitiveMemory } from "../../../lib/memory/index.js";
|
|
3
|
+
import {
|
|
4
|
+
registerSessionStartHandler,
|
|
5
|
+
SessionPhase,
|
|
6
|
+
} from "../../../lib/state/session-start-queue.js";
|
|
7
|
+
import { getAgentDir, loadProjectContextFiles } from "@earendil-works/pi-coding-agent";
|
|
8
|
+
|
|
9
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
10
|
+
import { RESOURCES_DISCOVER, AGENT_SETTLED } from "../../../lib/core/event-names.js";
|
|
11
|
+
import { gatherContextState, contextSection } from "./context-section.js";
|
|
12
|
+
import { deliverActiveSpecs } from "../../../lib/cognitive/openspec.js";
|
|
13
|
+
import { deliverRelevantHints } from "../../../lib/cognitive/hints.js";
|
|
14
|
+
import { deliverAwarenessWhisper, type AwarenessCounts } from "./awareness-whisper.js";
|
|
15
|
+
import { getContextUsage } from "../../../lib/detection/context-tiers.js";
|
|
16
|
+
import { readTelegramPollerLiveness } from "../../../lib/state/telegram-poller-liveness.js";
|
|
17
|
+
import type { PromptSection } from "./section.js";
|
|
18
|
+
import { linesSection, simpleSection, composeSections, composeSectionMap } from "./section.js";
|
|
19
|
+
import { piReferenceSection } from "./pi-reference-section.js";
|
|
20
|
+
import { customSectionsFrom } from "./custom-sections.js";
|
|
21
|
+
import { publishPromptSections } from "./section-publish.js";
|
|
22
|
+
import { toolPipelineLines } from "./tool-pipelines.js";
|
|
23
|
+
import { TOOL_GUIDELINES, resolveOwnedToolLine } from "./tool-guidelines.js";
|
|
24
|
+
import {
|
|
25
|
+
IDENTITY_INTRO,
|
|
26
|
+
DISCOVERY,
|
|
27
|
+
WORK_ETHIC,
|
|
28
|
+
REPAIR_DISCIPLINE,
|
|
29
|
+
SELF_MANAGEMENT,
|
|
30
|
+
COMMUNICATION,
|
|
31
|
+
EPISTEMIC_STANCE,
|
|
32
|
+
SELF_AUDIT,
|
|
33
|
+
PHILOSOPHY,
|
|
34
|
+
} from "./identity.js";
|
|
35
|
+
import { surfaceDisciplineSection } from "./surface-discipline-section.js";
|
|
36
|
+
import { skillsLoadingText } from "../skills-tool/loading-guidance.js";
|
|
37
|
+
import {
|
|
38
|
+
reconstructProjectDocsSection,
|
|
39
|
+
resetProjectDocsSectionCache,
|
|
40
|
+
} from "./project-docs-section.js";
|
|
41
|
+
import { setCachedSkills, getCachedVisibleSkillNames } from "../skills-tool/index.js";
|
|
42
|
+
import { reconstructMemorySection, resetMemorySectionCache } from "./memory-section.js";
|
|
43
|
+
import { gatherInstanceData } from "./instance-composition.js";
|
|
44
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
45
|
+
import { formatLocalTime } from "../../../lib/utils/local-time.js";
|
|
46
|
+
import { flushRecoveredFires } from "../../../extensions/scheduling/timer/wake-retry.js";
|
|
47
|
+
// Persisted-timer recovery lives in the timer module: the owning-session
|
|
48
|
+
// invariant is the shared store's, not this caller's. This file only wires
|
|
49
|
+
// the sweep into the turn start and re-exports the surface for the tests.
|
|
50
|
+
import {
|
|
51
|
+
recoverPersistedTimers,
|
|
52
|
+
dedupPersistedTimers,
|
|
53
|
+
hasLiveEquivalent,
|
|
54
|
+
} from "../../../extensions/scheduling/timer/recovery.js";
|
|
55
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
56
|
+
|
|
57
|
+
const log = createLogger("prompt-builder/timer");
|
|
58
|
+
|
|
59
|
+
/** Datetime drift-guard window: re-anchor the agent's clock after 30 minutes. */
|
|
60
|
+
export const DATETIME_REFRESH_INTERVAL_MS = 30 * 60 * 1000;
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Datetime drift-guard decision (pure; exported for the fixture test).
|
|
64
|
+
*
|
|
65
|
+
* anchorAt === 0 -> session start not observed yet: the system prompt's
|
|
66
|
+
* own datetime stamp IS the first anchor (no whisper).
|
|
67
|
+
* age >= 30 min -> inject + re-anchor (the re-anchor IS the rate limit:
|
|
68
|
+
* exactly one refresh per 30-min window).
|
|
69
|
+
* age < 30 min -> skip.
|
|
70
|
+
*
|
|
71
|
+
* Returns the new anchor (0 means "set anchor silently, no whisper").
|
|
72
|
+
*/
|
|
73
|
+
export function datetimeRefreshDecision(
|
|
74
|
+
anchorAt: number,
|
|
75
|
+
nowMs: number,
|
|
76
|
+
): { inject: boolean; newAnchor: number } {
|
|
77
|
+
if (anchorAt === 0) return { inject: false, newAnchor: nowMs };
|
|
78
|
+
if (nowMs - anchorAt >= DATETIME_REFRESH_INTERVAL_MS) {
|
|
79
|
+
return { inject: true, newAnchor: nowMs };
|
|
80
|
+
}
|
|
81
|
+
return { inject: false, newAnchor: anchorAt };
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Prompt Builder - Reconstruction from Structured Data
|
|
86
|
+
*
|
|
87
|
+
* No fragile string extraction. Everything built from APIs and fixed templates.
|
|
88
|
+
* Only pi-braid additions (identity framings, discovery stance, tool
|
|
89
|
+
* pipelines, guidelines) are custom.
|
|
90
|
+
*
|
|
91
|
+
* Sections built from structured data:
|
|
92
|
+
* - Tools: pi.getAllTools() (with promptSnippet)
|
|
93
|
+
* - Skills: counts + base dirs from event.systemPromptOptions.skills (the
|
|
94
|
+
* fully resolved list pi built via its package manager -- includes user,
|
|
95
|
+
* project, AND package skills). The catalog itself is not rendered in the
|
|
96
|
+
* prompt: the list_skills tool serves it on demand (setCachedSkills).
|
|
97
|
+
* The once-per-session awareness whisper carries context token counts,
|
|
98
|
+
* not skill counts.
|
|
99
|
+
* Canonical pattern from pi's own docs: extensions should not re-discover
|
|
100
|
+
* skills; they should reformat what pi already loaded.
|
|
101
|
+
* - Project docs: reconstructProjectDocsSection() renders AGENTS.md /
|
|
102
|
+
* CLAUDE.md files from loadProjectContextFiles() as plain-text pointer
|
|
103
|
+
* lines (`- <basename> at <path>`, no XML wrapper -- pointer-only, agent
|
|
104
|
+
* reads full content on demand). Mirrors the skills model. Prevents
|
|
105
|
+
* pattern-matching against stale doc references.
|
|
106
|
+
* - pi docs pointer: a static pointer to the pi-reference skill
|
|
107
|
+
* (pi-reference-section.ts); the skill owns pi's docs index, so the prompt
|
|
108
|
+
* does not re-send the path list.
|
|
109
|
+
* - Guidelines: fixed template based on tool availability
|
|
110
|
+
* - Instance line: version, cwd, session — computed directly
|
|
111
|
+
*
|
|
112
|
+
* Sections re-implemented locally:
|
|
113
|
+
* - Identity: Braid agent identity (smart-mix: persona + native pattern +
|
|
114
|
+
* generalist; the framings exported by identity.ts: identity blocks,
|
|
115
|
+
* skills-loading directive, discovery stance)
|
|
116
|
+
* - L1 environmental state (session stats, context usage, session health)
|
|
117
|
+
*
|
|
118
|
+
* Design stance: identity framing beats explicit directives; no
|
|
119
|
+
* latent-behavior activation in the prompt (latent activation runs at
|
|
120
|
+
* runtime via `latent-activator`).
|
|
121
|
+
*
|
|
122
|
+
* Publication: the stable group is published as `customPrompt` (pi renders it
|
|
123
|
+
* as the untagged preamble and suppresses its native preamble, tools, rules,
|
|
124
|
+
* and docs) and the turn-to-turn text as named `sections` entries that pi diffs
|
|
125
|
+
* against the transcript individually. See section-publish.ts.
|
|
126
|
+
*/
|
|
127
|
+
|
|
128
|
+
import { getExtensionState, getSessionIdSafe } from "../../../lib/state/extension-state.js";
|
|
129
|
+
|
|
130
|
+
interface PromptBuilderState {
|
|
131
|
+
insightsSent: boolean;
|
|
132
|
+
/**
|
|
133
|
+
* Fresh clock: epoch ms of the last
|
|
134
|
+
* datetime anchor the agent saw. 0 = session start not yet observed (the
|
|
135
|
+
* system prompt stamps the datetime once at session start — that stamp is
|
|
136
|
+
* the first anchor). The drift guard injects a one-line datetime whisper
|
|
137
|
+
* when >30 min have passed since the last anchor (rate-limited to
|
|
138
|
+
* once/30min by construction — each injection re-anchors).
|
|
139
|
+
*/
|
|
140
|
+
lastDatetimeAnchorAt: number;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
function getPromptState(ctx: ExtensionContext): PromptBuilderState {
|
|
144
|
+
return getExtensionState(ctx, "prompt-builder", () => ({
|
|
145
|
+
insightsSent: false,
|
|
146
|
+
lastDatetimeAnchorAt: 0,
|
|
147
|
+
}));
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Extract the first sentence of a description for the tool listing.
|
|
151
|
+
*
|
|
152
|
+
* Used only for tools WITHOUT a TOOL_GUIDELINES reflection (contrib / npm
|
|
153
|
+
* tools). Documented tools render their reflection directly in the tools
|
|
154
|
+
* section.
|
|
155
|
+
*
|
|
156
|
+
* Tool descriptions should be written so the first sentence contains both
|
|
157
|
+
* "what it does" and "when to use" — this extracts that first sentence cleanly.
|
|
158
|
+
*/
|
|
159
|
+
// Guidelines render before tools (pi-core native pattern): Identity →
|
|
160
|
+
// Guidelines → Discovery/Pipelines → Tools → Context → Instance.
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* File tool guidelines: bash/grep/find/ls usage (pi-core native pattern).
|
|
164
|
+
* Conditional on tool availability — only shows if bash is present.
|
|
165
|
+
*/
|
|
166
|
+
function fileToolGuidelines(toolNames: string[]): string[] {
|
|
167
|
+
const lines: string[] = [];
|
|
168
|
+
const hasBash = toolNames.includes("bash");
|
|
169
|
+
const hasGrep = toolNames.includes("grep");
|
|
170
|
+
const hasFind = toolNames.includes("find");
|
|
171
|
+
const hasLs = toolNames.includes("ls");
|
|
172
|
+
if (hasBash && !hasGrep && !hasFind && !hasLs) {
|
|
173
|
+
lines.push("Use bash for file operations like ls, rg, find");
|
|
174
|
+
} else if (hasBash && (hasGrep || hasFind || hasLs)) {
|
|
175
|
+
lines.push(
|
|
176
|
+
"Prefer grep/find/ls tools over bash for file exploration (faster, respects .gitignore)",
|
|
177
|
+
);
|
|
178
|
+
}
|
|
179
|
+
return lines;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Communication guidelines: pi-native directives, guarded by tool availability.
|
|
184
|
+
*
|
|
185
|
+
* "Show file paths" is guarded by read/bash presence — no point telling the
|
|
186
|
+
* agent to show file paths if it can't access files to begin with.
|
|
187
|
+
*
|
|
188
|
+
* Research backing: Bakhshi (2026) arXiv:2604.19768 - LLMs exhibit systematic
|
|
189
|
+
* epistemic-rhetorical patterns at ~2x human rate
|
|
190
|
+
*/
|
|
191
|
+
function communicationGuidelines(toolNames: string[]): string[] {
|
|
192
|
+
const lines: string[] = [
|
|
193
|
+
"Write text that reads naturally, as if written by a human, not generated by a machine",
|
|
194
|
+
];
|
|
195
|
+
const hasRead = toolNames.includes("read");
|
|
196
|
+
const hasBash = toolNames.includes("bash");
|
|
197
|
+
if (hasRead || hasBash) {
|
|
198
|
+
lines.push("Show file paths clearly when working with files");
|
|
199
|
+
}
|
|
200
|
+
return lines;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Context navigation pipeline guidelines (tool-availability-guarded).
|
|
205
|
+
*
|
|
206
|
+
* Teaches the agent the session-tree mental model and the archival stance —
|
|
207
|
+
* the two policy sentences. Tool mechanics stay in tool descriptions (dedup
|
|
208
|
+
* with the tools channel).
|
|
209
|
+
*
|
|
210
|
+
* Concise: no markdown headings, no excessive structure.
|
|
211
|
+
*/
|
|
212
|
+
function contextNavigationGuidelines(toolNames: string[]): string[] {
|
|
213
|
+
const lines: string[] = [];
|
|
214
|
+
const hasContextNavigate = toolNames.includes("context_navigate");
|
|
215
|
+
const hasContextCompress = toolNames.includes("context_compress");
|
|
216
|
+
|
|
217
|
+
if (!hasContextNavigate && !hasContextCompress) {
|
|
218
|
+
return lines;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
lines.push("");
|
|
222
|
+
|
|
223
|
+
if (hasContextNavigate) {
|
|
224
|
+
lines.push(
|
|
225
|
+
"The session is a branching tree \u2014 tag positions, log to see history, checkout to jump to a leaf with its context summarized. Use backupTag to save your spot before jumping.",
|
|
226
|
+
);
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
if (hasContextCompress) {
|
|
230
|
+
// Generic pipeline stance: thresholds live
|
|
231
|
+
// in one place only — the extension ladder (context-thresholds.ts,
|
|
232
|
+
// enforced by context-lifecycle advisories). The prompt carries the
|
|
233
|
+
// stance, not a second copy of the numbers.
|
|
234
|
+
lines.push(
|
|
235
|
+
"Context is finite: tag positions before archival, archive old ranges deliberately, inspect health often; obey context-lifecycle advisories.",
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
return lines;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* Assemble all guidelines into a single section, placed before tools.
|
|
244
|
+
* Order: file tools → communication → context navigation.
|
|
245
|
+
* Each family is a clear sub-structure for easy maintainability.
|
|
246
|
+
*
|
|
247
|
+
* Per-tool instructions render once, in the TOOLS section, from
|
|
248
|
+
* TOOL_GUIDELINES (synced with TOOLS.md). This section keeps only
|
|
249
|
+
* cross-tool habits.
|
|
250
|
+
*/
|
|
251
|
+
function guidelinesSection(toolNames: string[]): PromptSection {
|
|
252
|
+
const allLines = [
|
|
253
|
+
...fileToolGuidelines(toolNames),
|
|
254
|
+
...communicationGuidelines(toolNames),
|
|
255
|
+
...contextNavigationGuidelines(toolNames),
|
|
256
|
+
];
|
|
257
|
+
return linesSection("guidelines", allLines, { dedup: true });
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
function toolsSection(tools: ReturnType<ExtensionAPI["getAllTools"]>): PromptSection {
|
|
261
|
+
// One line per tool — single rendering. Per-tool line priority
|
|
262
|
+
// (ownership inversion): the tool's OWNING package declares its
|
|
263
|
+
// guideline via `promptGuidelines` in its own registration (native seam:
|
|
264
|
+
// registerTool stores the raw definition, getAllTools exposes it) → else
|
|
265
|
+
// TOOL_GUIDELINES (braid-owned + pi builtins, synced 1:1 with TOOLS.md) →
|
|
266
|
+
// else EXTERNAL_TOOL_GUIDELINES (last-resort map for unpatched third-party
|
|
267
|
+
// packages) → else NO ROW. Exception: the five pinned builtins
|
|
268
|
+
// (read/bash/edit/write/powershell) render TOOL_GUIDELINES over their
|
|
269
|
+
// owners' thinner self-registered lines — see PINNED_BUILTIN_OVERRIDES in
|
|
270
|
+
// tool-guidelines.ts. Descriptions live in the API tools channel; the
|
|
271
|
+
// guideline never restates them.
|
|
272
|
+
const visibleTools = tools
|
|
273
|
+
.filter((t) => t.name && (t.description || TOOL_GUIDELINES[t.name]))
|
|
274
|
+
.map((t) => {
|
|
275
|
+
// The runtime exposes promptGuidelines on tool objects though the
|
|
276
|
+
// shipped pi-ai type omits it — widen locally.
|
|
277
|
+
const line = resolveOwnedToolLine(
|
|
278
|
+
t.name,
|
|
279
|
+
(t as { promptGuidelines?: unknown }).promptGuidelines as string[] | undefined,
|
|
280
|
+
);
|
|
281
|
+
return line ? `- ${t.name}: ${line}` : null;
|
|
282
|
+
})
|
|
283
|
+
.filter((line): line is string => line !== null)
|
|
284
|
+
.join("\n");
|
|
285
|
+
|
|
286
|
+
return {
|
|
287
|
+
name: "tools",
|
|
288
|
+
render: () => {
|
|
289
|
+
return `Available tools:\n${visibleTools || "(none)"}\n\nOther custom tools may exist depending on the project.`;
|
|
290
|
+
},
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/**
|
|
295
|
+
* The identity seat join, exported as a pure function: the handler's REAL
|
|
296
|
+
* section list for the main identity block. The structural pin test imports
|
|
297
|
+
* this from the built handler, so its seat/verbatim assertions exercise the
|
|
298
|
+
* production composition instead of a hand-mirror. No behavior change: the
|
|
299
|
+
* handler below builds the identical simpleSection through this function.
|
|
300
|
+
*/
|
|
301
|
+
export function identitySection(): PromptSection {
|
|
302
|
+
return simpleSection(
|
|
303
|
+
"identity",
|
|
304
|
+
[IDENTITY_INTRO, WORK_ETHIC, REPAIR_DISCIPLINE, SELF_MANAGEMENT, COMMUNICATION].join("\n\n"),
|
|
305
|
+
);
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
async function projectContextSection(cwd: string, ctx: ExtensionContext): Promise<PromptSection> {
|
|
309
|
+
// Uses pi-core's exported `loadProjectContextFiles` — the canonical
|
|
310
|
+
// resolution order: agent-dir global context, then cwd-ancestors
|
|
311
|
+
// (most-root last), deduped by path.
|
|
312
|
+
//
|
|
313
|
+
// Pointer-only model: we DO NOT inject AGENTS.md / CLAUDE.md content
|
|
314
|
+
// into the system prompt. Instead we render plain-text pointer lines
|
|
315
|
+
// (`- <basename> at <path>`) listing the files, and let the agent `read`
|
|
316
|
+
// the full content on demand. This mirrors the skills model and prevents
|
|
317
|
+
// the agent from pattern-matching against stale doc references when
|
|
318
|
+
// parsing ambiguous external output.
|
|
319
|
+
|
|
320
|
+
// loadProjectContextFiles is sync, so wrap the call in a microtask
|
|
321
|
+
// so the function remains `async` (matches PromptSection contract).
|
|
322
|
+
const contextFiles = await Promise.resolve().then(() =>
|
|
323
|
+
loadProjectContextFiles({ cwd, agentDir: getAgentDir() }),
|
|
324
|
+
);
|
|
325
|
+
|
|
326
|
+
return {
|
|
327
|
+
name: "project-docs",
|
|
328
|
+
render: async () => reconstructProjectDocsSection(contextFiles, ctx),
|
|
329
|
+
};
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
import { createPromptInspectTool } from "./inspect.js";
|
|
333
|
+
import { createSystemInfoTool } from "./system-info-tool.js";
|
|
334
|
+
import { trimProviderTools } from "./tool-description-trim.js";
|
|
335
|
+
|
|
336
|
+
export default function promptBuilderExtension(pi: ExtensionAPI) {
|
|
337
|
+
pi.registerTool(createPromptInspectTool());
|
|
338
|
+
pi.registerTool(createSystemInfoTool(pi));
|
|
339
|
+
// Fallback flush for recovered persisted fires. The timer extension's
|
|
340
|
+
// agent_settled handler is the primary flush point; this listener keeps the
|
|
341
|
+
// deferral correct even if the timer extension is disabled. Both are safe
|
|
342
|
+
// to run twice: takeRecoveredFires() drains (second call sees an empty
|
|
343
|
+
// queue) and onAgentSettled() is idempotent.
|
|
344
|
+
pi.on(AGENT_SETTLED, () => flushRecoveredFires(pi));
|
|
345
|
+
// Third-party tool-description trim: the
|
|
346
|
+
// provider payload tools channel — the only official interception point
|
|
347
|
+
// for registered descriptions (mechanism note in tool-description-trim.ts).
|
|
348
|
+
// Returns undefined when nothing changed (runner keeps the payload).
|
|
349
|
+
pi.on("before_provider_request", (event) => trimProviderTools(event.payload));
|
|
350
|
+
|
|
351
|
+
// Context: tools, skills, memories, runtime extensions, project docs, memory
|
|
352
|
+
// Fetched once per session, cached afterwards (session-scoped state).
|
|
353
|
+
// Uses registerSessionStartHandler so the state is available before the
|
|
354
|
+
// first prompt is built.
|
|
355
|
+
registerSessionStartHandler(pi, SessionPhase.MemoryState, async (_event, ctx) => {
|
|
356
|
+
// getPromptState() lazily initializes the state entry; the result is
|
|
357
|
+
// intentionally unused here (no enforcement_signals listener).
|
|
358
|
+
const _ps = getPromptState(ctx);
|
|
359
|
+
});
|
|
360
|
+
|
|
361
|
+
// resources_discover: invalidate skills, project-docs, memory caches
|
|
362
|
+
// When resources are re-discovered (e.g. /reload, or session replacement),
|
|
363
|
+
// pi re-resolves skills and project context. We invalidate our format
|
|
364
|
+
// caches so the next before_agent_start renders with the new sets. The
|
|
365
|
+
// memory section also invalidates so a freshly-written episode surfaces
|
|
366
|
+
// in the next turn's pointer block.
|
|
367
|
+
pi.on(RESOURCES_DISCOVER, async (_event, ctx) => {
|
|
368
|
+
resetProjectDocsSectionCache(ctx);
|
|
369
|
+
resetMemorySectionCache(ctx);
|
|
370
|
+
});
|
|
371
|
+
|
|
372
|
+
pi.on("before_agent_start", async (event, ctx) => {
|
|
373
|
+
// Fire any persisted timers that expired during a process gap (e.g. /reload).
|
|
374
|
+
// Owning-session scoped: the store is shared per project CWD, so recovery
|
|
375
|
+
// must never deliver another session's records into this process.
|
|
376
|
+
recoverPersistedTimers(pi, getSessionIdSafe(ctx));
|
|
377
|
+
|
|
378
|
+
const ps = getPromptState(ctx);
|
|
379
|
+
const cwd = ctx.cwd;
|
|
380
|
+
const allTools = pi.getAllTools();
|
|
381
|
+
const activeToolNames = pi.getActiveTools() ?? allTools.map((t) => t.name);
|
|
382
|
+
const tools =
|
|
383
|
+
activeToolNames.length > 0
|
|
384
|
+
? allTools.filter((t) => activeToolNames.includes(t.name))
|
|
385
|
+
: allTools;
|
|
386
|
+
const toolNames = tools.map((t) => t.name);
|
|
387
|
+
const hasRead = toolNames.includes("read");
|
|
388
|
+
const hasListSkills = toolNames.includes("list_skills");
|
|
389
|
+
|
|
390
|
+
// Fresh clock: 30-min datetime drift guard. The system prompt stamps
|
|
391
|
+
// the datetime once at session start; long sessions run on a stale
|
|
392
|
+
// clock. See datetimeRefreshDecision() for the exact contract.
|
|
393
|
+
const nowMs = Date.now();
|
|
394
|
+
const refresh = datetimeRefreshDecision(ps.lastDatetimeAnchorAt, nowMs);
|
|
395
|
+
ps.lastDatetimeAnchorAt = refresh.newAnchor;
|
|
396
|
+
if (refresh.inject) {
|
|
397
|
+
try {
|
|
398
|
+
sendTrackedMessage(
|
|
399
|
+
pi,
|
|
400
|
+
{
|
|
401
|
+
customType: "datetime-refresh",
|
|
402
|
+
display: true,
|
|
403
|
+
content: [
|
|
404
|
+
{
|
|
405
|
+
type: "text" as const,
|
|
406
|
+
text: `Datetime refresh: ${formatLocalTime(new Date(), true)} — mid-session clock anchor (last anchor >30 min ago).`,
|
|
407
|
+
},
|
|
408
|
+
],
|
|
409
|
+
},
|
|
410
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
411
|
+
{ type: "context", source: "prompt-builder/datetime" },
|
|
412
|
+
);
|
|
413
|
+
} catch (err) {
|
|
414
|
+
log.debug(`datetime drift-guard whisper failed (non-fatal): ${String(err)}`);
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
const contextData = await gatherContextState(pi, ctx);
|
|
419
|
+
const context = contextSection(contextData);
|
|
420
|
+
|
|
421
|
+
// Live resource counts (skills / memories), computed once so the
|
|
422
|
+
// instance line reports the same values.
|
|
423
|
+
const skills = event.systemPromptOptions?.skills ?? [];
|
|
424
|
+
// Cache skills for the list_skills tool (on-demand discovery).
|
|
425
|
+
setCachedSkills(skills);
|
|
426
|
+
// Extract unique base directories from loaded skill file paths so the
|
|
427
|
+
// Instance block can show where skills are loaded from (not just the count).
|
|
428
|
+
const skillDirs = [...new Set(skills.map((s) => s.baseDir).filter(Boolean))];
|
|
429
|
+
let memoryCount = 0;
|
|
430
|
+
try {
|
|
431
|
+
const memory = getCognitiveMemory();
|
|
432
|
+
try {
|
|
433
|
+
await memory.init();
|
|
434
|
+
} catch {
|
|
435
|
+
/* already init'd or non-fatal */
|
|
436
|
+
}
|
|
437
|
+
memoryCount = memory.getAll(3).length;
|
|
438
|
+
} catch {
|
|
439
|
+
/* memory unavailable - non-fatal */
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
// 5. Supplemental context (past insights, hints, OpenSpec specs,
|
|
443
|
+
// awareness) -> offloaded to steer whispers (once per session).
|
|
444
|
+
// Avoids per-turn disk I/O and system prompt bloat for context the
|
|
445
|
+
// agent can re-load via `read` if needed.
|
|
446
|
+
if (!ps.insightsSent) {
|
|
447
|
+
// Claim the slot synchronously, before the first await below: two prompt
|
|
448
|
+
// builds that overlap would otherwise both read the flag unset while the
|
|
449
|
+
// deliveries are in flight, and every once-per-session whisper goes out
|
|
450
|
+
// twice. The claim is one read-and-write with no await between, so a
|
|
451
|
+
// second build either sees the claim or arrives after the deliveries
|
|
452
|
+
// settled - the window is closed, not narrowed.
|
|
453
|
+
ps.insightsSent = true;
|
|
454
|
+
// Once-per-session context-hygiene whisper: the awareness catalog's
|
|
455
|
+
// live token-delta signal — tokens in context + tokens added since
|
|
456
|
+
// the previous emission's baseline. Usage comes from the same
|
|
457
|
+
// duck-typed accessor context-section.ts uses (getContextUsage); the
|
|
458
|
+
// since-baseline delta is tracked inside the whisper module. The TG
|
|
459
|
+
// row is gated by the poller liveness registry
|
|
460
|
+
// (lib/state/telegram-poller-liveness.ts): running → live,
|
|
461
|
+
// stopped/absent-probe → hedged row.
|
|
462
|
+
const usage = getContextUsage(ctx);
|
|
463
|
+
const pollerLiveness = readTelegramPollerLiveness();
|
|
464
|
+
const awarenessCounts: AwarenessCounts = {
|
|
465
|
+
tokensInContext: usage?.tokens ?? 0,
|
|
466
|
+
contextToolCount: pi.getAllTools().filter((t) => t.name.startsWith("context_")).length,
|
|
467
|
+
telegramInbound:
|
|
468
|
+
pollerLiveness === "running" ? "live" : pollerLiveness === "stopped" ? "off" : "unknown",
|
|
469
|
+
};
|
|
470
|
+
// Run in parallel - each delivery is independent and best-effort.
|
|
471
|
+
// allSettled ensures one failure doesn't block the others.
|
|
472
|
+
await Promise.allSettled([
|
|
473
|
+
deliverPastInsights(cwd, pi, ctx),
|
|
474
|
+
deliverRelevantHints(cwd, pi, ctx),
|
|
475
|
+
deliverActiveSpecs(cwd, pi, ctx),
|
|
476
|
+
deliverAwarenessWhisper(pi, ctx, awarenessCounts),
|
|
477
|
+
]);
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
// Build the prompt as a flat list of sections. Every section is a
|
|
481
|
+
// `PromptSection`; the top-level handler never touches raw strings
|
|
482
|
+
// or arrays of strings.
|
|
483
|
+
// Instance: compact 1-line orientation (version/cwd/session at a
|
|
484
|
+
// glance); full data via the system_info tool. The agent should not
|
|
485
|
+
// need a tool call to discover its own version/cwd/session.
|
|
486
|
+
const instanceData = await gatherInstanceData(pi, ctx, {
|
|
487
|
+
skillCount: skills.length,
|
|
488
|
+
skillDirs,
|
|
489
|
+
skills: skills.map((s) => ({
|
|
490
|
+
name: s.name,
|
|
491
|
+
filePath: s.filePath,
|
|
492
|
+
baseDir: s.baseDir,
|
|
493
|
+
})),
|
|
494
|
+
memoryCount,
|
|
495
|
+
});
|
|
496
|
+
const sessionId = ctx.sessionManager?.getSessionId() ?? "";
|
|
497
|
+
const compactInstanceLine = `Agent: Braid v${instanceData.braidVersion} (over pi-core v${instanceData.pi.version}) | Cwd: ${instanceData.cwd} | Session: ${sessionId}`;
|
|
498
|
+
// Discovery & exploration stance. Guarded by tool availability: each
|
|
499
|
+
// line only appears when its tools exist; the stance paragraph is
|
|
500
|
+
// unconditional. Placed after guidelines, before tools — a stance, not
|
|
501
|
+
// a tool inventory.
|
|
502
|
+
const discoveryLines = DISCOVERY.filter(
|
|
503
|
+
(line) => line.guard.length === 0 || line.guard.some((t) => toolNames.includes(t)),
|
|
504
|
+
).map((line) => line.text);
|
|
505
|
+
|
|
506
|
+
// Tool-usage pipelines. Guarded multi-tool sequences per task domain;
|
|
507
|
+
// every pipeline renders only when all its guard tools are active (tool
|
|
508
|
+
// profiles can reduce the active set). Section skipped entirely when
|
|
509
|
+
// nothing qualifies.
|
|
510
|
+
const pipelineLines = toolPipelineLines(toolNames);
|
|
511
|
+
|
|
512
|
+
const stableSections: PromptSection[] = [
|
|
513
|
+
// 1. Identity: three seats — the main block, the surface-discipline
|
|
514
|
+
// block (its own section file), and the identity-core block.
|
|
515
|
+
// Rendered order: COMMUNICATION → SURFACE_DISCIPLINE →
|
|
516
|
+
// EPISTEMIC_STANCE.
|
|
517
|
+
identitySection(),
|
|
518
|
+
surfaceDisciplineSection(),
|
|
519
|
+
simpleSection("identity-core", [EPISTEMIC_STANCE, SELF_AUDIT, PHILOSOPHY].join("\n\n")),
|
|
520
|
+
|
|
521
|
+
// 2. Skills-loading directive (before guidelines, before tools).
|
|
522
|
+
// Owned by the skills-tool module (loading-guidance.ts) and rendered
|
|
523
|
+
// here. Guarded by read AND list_skills availability — the directive
|
|
524
|
+
// instructs list_skills discovery + full-file read, so both tools
|
|
525
|
+
// must be present. The trigger's worked examples are derived here
|
|
526
|
+
// from the active tool names and the visible skill catalog (the
|
|
527
|
+
// cache setCachedSkills populated above is the catalog's source of
|
|
528
|
+
// truth); the text itself never hardcodes a tool or skill name.
|
|
529
|
+
...(hasRead && hasListSkills
|
|
530
|
+
? [
|
|
531
|
+
simpleSection(
|
|
532
|
+
"skills-loading",
|
|
533
|
+
skillsLoadingText(toolNames, getCachedVisibleSkillNames()),
|
|
534
|
+
),
|
|
535
|
+
]
|
|
536
|
+
: []),
|
|
537
|
+
|
|
538
|
+
// 3. Guidelines (before tools, pi-core native pattern).
|
|
539
|
+
// Order: file tools → communication → context navigation.
|
|
540
|
+
guidelinesSection(toolNames),
|
|
541
|
+
|
|
542
|
+
// 4. Discovery & exploration stance (after guidelines, before tools).
|
|
543
|
+
...(discoveryLines.length > 0
|
|
544
|
+
? [simpleSection("discovery", discoveryLines.join("\n\n"))]
|
|
545
|
+
: []),
|
|
546
|
+
|
|
547
|
+
// 5. Tool-usage pipelines (after discovery, before resources/tools).
|
|
548
|
+
// Per-domain sequences: when to use, the order, the closing outcome.
|
|
549
|
+
// Context management is intentionally absent — already covered by
|
|
550
|
+
// contextNavigationGuidelines above (dedup contract).
|
|
551
|
+
...(pipelineLines.length > 0 ? [simpleSection("pipelines", pipelineLines.join("\n\n"))] : []),
|
|
552
|
+
];
|
|
553
|
+
|
|
554
|
+
// Available tools, then the pi docs pointer (the pi-reference skill
|
|
555
|
+
// owns pi's docs index; see pi-reference-section.ts).
|
|
556
|
+
stableSections.push(toolsSection(tools));
|
|
557
|
+
stableSections.push(piReferenceSection());
|
|
558
|
+
|
|
559
|
+
// Unified context block (project-docs + memory + runtime context).
|
|
560
|
+
// No heading — plain text, like the rest of the prompt.
|
|
561
|
+
const contextFragments = [
|
|
562
|
+
...(hasRead ? [await (await projectContextSection(cwd, ctx)).render()] : []),
|
|
563
|
+
...(hasRead ? [await reconstructMemorySection(ctx)] : []),
|
|
564
|
+
await context.render(),
|
|
565
|
+
].filter((s) => s && s.trim() !== "");
|
|
566
|
+
const contextBlock = contextFragments.join("\n\n");
|
|
567
|
+
|
|
568
|
+
// Instance last: environment orientation is final — the agent reads
|
|
569
|
+
// top-down, and the top region carries identity and guidance. Full
|
|
570
|
+
// environment data remains in the system_info tool. Both this and the
|
|
571
|
+
// context block are published as named sections, so a changed line
|
|
572
|
+
// re-sends that section instead of the whole prompt.
|
|
573
|
+
|
|
574
|
+
// Caller-supplied sections (SDK hosts) and appendSystemPrompt from
|
|
575
|
+
// pi-native. Both preserve outside content; both ride the dedup set,
|
|
576
|
+
// so content matching a section above is silently dropped. Read here,
|
|
577
|
+
// before publishPromptSections replaces the options map with braid's
|
|
578
|
+
// own sections.
|
|
579
|
+
stableSections.push(...customSectionsFrom(event.systemPromptOptions));
|
|
580
|
+
const appendPrompt = event.systemPromptOptions?.appendSystemPrompt;
|
|
581
|
+
if (appendPrompt) {
|
|
582
|
+
stableSections.push(simpleSection("append", appendPrompt));
|
|
583
|
+
}
|
|
584
|
+
|
|
585
|
+
const dedupSet = new Set<string>();
|
|
586
|
+
const stablePrompt = await composeSections(stableSections, "\n\n", dedupSet);
|
|
587
|
+
const volatileSections = await composeSectionMap(
|
|
588
|
+
[simpleSection("context", contextBlock), simpleSection("instance", compactInstanceLine)],
|
|
589
|
+
dedupSet,
|
|
590
|
+
);
|
|
591
|
+
// Persist through pi's section seam so the session file (and /export)
|
|
592
|
+
// carries the actual prompt text, section by section, and the provider
|
|
593
|
+
// cache only loses the sections that changed.
|
|
594
|
+
publishPromptSections(event.systemPromptOptions, stablePrompt, volatileSections);
|
|
595
|
+
});
|
|
596
|
+
}
|
|
597
|
+
|
|
598
|
+
export { gatherContextState, contextSection };
|
|
599
|
+
// Timer recovery re-export: test-timer-recovery.mjs and
|
|
600
|
+
// test-timer-wake-retry.mjs import through this path; owning-session
|
|
601
|
+
// scoping is the shared store's invariant (scheduling/timer/recovery.ts).
|
|
602
|
+
export { recoverPersistedTimers, dedupPersistedTimers, hasLiveEquivalent };
|