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,151 @@
|
|
|
1
|
+
<!-- status: current -->
|
|
2
|
+
<!-- Status note: identity compressed + PHILOSOPHY block added after EPISTEMIC_STANCE; the placement-discipline block and the PHILOSOPHY senior-craft line were reverted after the prompt re-probe failed its keep rule, REPAIR_DISCIPLINE stays; Resources section deleted; context guidelines reduced to the two policy sentences; pipelines cover 2 domains; tool guideline lines trimmed. Skills no longer render in the prompt: discovery is served by the list_skills tool, and the pi docs seat is a pointer to the pi-reference skill (the native `<docs>` region is not re-emitted). Policy relocation: the skills-loading directive lives in the skills-tool module; SURFACE_DISCIPLINE is its own section file; REPAIR_DISCIPLINE and SELF_AUDIT are identity blocks. The multi-agent message-contract constant is removed: the `[agent:…]` tag contract named a message format with no producer in any shipped mechanism, so the standing prompt asserted a channel that does not exist. The skills-loading section's mechanical trigger now derives its worked examples at assembly from the live tool and skill names (`skillsLoadingText` in skills-tool/loading-guidance.ts); no tool or skill name is hardcoded in prompt text. -->
|
|
3
|
+
|
|
4
|
+
# src/extensions/core/prompt-builder/ - System Prompt Composition
|
|
5
|
+
|
|
6
|
+
Builds the agent's system prompt by composing `PromptSection` fragments.
|
|
7
|
+
Orchestrates once-per-session whisper deliveries from `cognitive/` and `memory/`.
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
Single concern: **what the LLM sees on every turn** - the system prompt (sections below) plus the tool-descriptor half of the request: registered tool descriptions on the provider tools channel (`tool-description-trim.ts`).
|
|
12
|
+
|
|
13
|
+
Every file in this folder either:
|
|
14
|
+
|
|
15
|
+
- Builds a `PromptSection` (a self-contained string rendered into the prompt), or
|
|
16
|
+
- Holds constants that the main handler turns into a `PromptSection`, or
|
|
17
|
+
- Defines the `PromptSection` primitive itself.
|
|
18
|
+
|
|
19
|
+
## Ownership
|
|
20
|
+
|
|
21
|
+
| File | Purpose |
|
|
22
|
+
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
|
|
23
|
+
| `index.ts` | Main handler. Wires `before_agent_start`, calls the 4 `deliver*` functions, composes the final prompt. |
|
|
24
|
+
| `section.ts` | The `PromptSection` primitive + `composeSections` joiner + `simpleSection`, `linesSection`, `headingSection` builders. |
|
|
25
|
+
| `identity.ts` | Framing constants: `IDENTITY_INTRO` (generalist identity), `DISCOVERY` (D1 guarded exploration stance), `WORK_ETHIC` (methodical precision, signal-not-noise), `REPAIR_DISCIPLINE` (root cause named falsifiably before repair; re-derivation of claims that are not yours; weighted repair decisions), `SELF_MANAGEMENT` (memory workspace, evidence-carrying done items, known-open-check done gate), `COMMUNICATION` (conclusion-first, output style), `EPISTEMIC_STANCE` (identity-core: claim gate, self-state gate, retrieved-context preference), `SELF_AUDIT` (symmetric doubt; handoff ends with the unverified), `PHILOSOPHY` (character-level stance - silence, calm strategist, precise self-irony). |
|
|
26
|
+
| `surface-discipline-section.ts` | `SURFACE_DISCIPLINE` (signal discipline across code, commits, tests, docs, reports, logs) + `surfaceDisciplineSection()` - its own section, rendered between the identity and identity-core blocks. Text pinned verbatim by test-prompt-budget.mjs. |
|
|
27
|
+
| `instance-composition.ts` | **v3.8** Instance (consolidated): agent identity + pi-core version + root (pi-core npm package folder) + cwd + userland settings dir + os/pid + session (id + elapsed/last-event/turns/tool-avg) + top-level pi extension packages (settings-driven, scope-tagged `project` or `user-global`). Full block rendered on demand via the `system_info` tool; the prompt carries only the compact orientation line. |
|
|
28
|
+
| `top-level-extensions.ts` | **v3.8** Discovery logic for top-level pi extension PACKAGES. Reads pi-core's `packages` field from `<cwd>/.pi/settings.json` (project) and `~/.pi/agent/settings.json` (user-global); project wins on collision. Resolves `npm:` specs via `npm root -g`; resolves local paths in place. Source tags: `project` / `user-global`. |
|
|
29
|
+
| `project-docs-section.ts` | Project docs (AGENTS.md / CLAUDE.md) pointer-only rendering as plain-text bullets (`- <basename> at <path>`). Mirrors the skills discoverability model but uses plain text (no XML tags) so the system prompt stays prose. Includes fingerprint cache and `RESOURCES_DISCOVER` invalidation. |
|
|
30
|
+
| `memory-section.ts` | Memory store pointer block (episodes + semantic + heuristics) as plain-text bullets (`- episodes at PATH`; count-free - per-store counts go stale at print time and are not rendered). Mirrors project-docs. Cached per session (static content, no fingerprint needed); invalidated on `RESOURCES_DISCOVER`. |
|
|
31
|
+
| `context-section.ts` | **v3.6** body fragment for the unified context block: context %, session health, steps-since-checkpoint. Returns `""` when nothing to surface. Composer (`index.ts`) joins this with project-docs and memory bodies. No heading. (Memory stores render pointer-only: per-store entry counts are not rendered; the whisper carries token counts, not memory counts.) |
|
|
32
|
+
| `awareness-whisper.ts` | Once-per-session context-hygiene steer whisper (customType `hygiene`): tokens in context + delta since the previous emission's baseline, the inspector pointer, and the injection-channel catalog; `formatAwarenessText` is tool-availability-aware; the TG inbound row is state-aware: it asserts reachability only when the poller liveness registry (`lib/state/telegram-poller-liveness.ts`) says the poller is running, else it hedges and names `telegram_poller status`. The catalog describes subsystem whispers by their stable envelope (produced by `lib/utils/whisper-format.ts`) instead of enumerating subsystems. |
|
|
33
|
+
| ~~`contrast-phrases.ts`~~ | **DELETED 2026-08-12 (keep+cut)** - legacy RepE-style phrase library (TRUTH_FIRST, ANTI_SYCOPHANCY, EPISTEMIC_STABILITY, KNOWLEDGE_BOUNDARY). Consolidated into `EPISTEMIC_STANCE` (identity.ts) on 2026-07-16; zero importers; provenance in the deleted file's git history. |
|
|
34
|
+
| ~~`resources-section.ts`~~ | **DELETED** - the `Resources: N skills` pointer line was dead: duplicated by the skills-loading contract and the list_skills tool description. Discovery is served by `list_skills` at runtime; skill counts are not rendered in the prompt (the once-per-session awareness whisper carries context token counts, not skill counts). `excludeSkillsBlock` in `inspect.ts` keeps its Resources parser (absent-degrades-to-0) for non-braid prompt shapes. |
|
|
35
|
+
| `tool-pipelines.ts` | Guarded multi-tool usage pipelines (research/debugging - the implementation pipeline was dropped, merged into COMMUNICATION's understand-before-act; the verification pipeline was dropped as a restatement of the verify/verify_claim/finalize rows); pinned by test-tool-pipelines.mjs. |
|
|
36
|
+
| `tool-guidelines.ts` | Per-tool guideline sync: `TOOL_GUIDELINES` (tool → one-line reflection, synced 1:1 with `packages/core/TOOLS.md`; mirror when-nots were trimmed and description restatements) + `perToolGuidelines()` `if has <tool>`-gated renderer + `resolveOwnedToolLine()` (tools-section resolver: owned lines only, the description fallback renders no row); pinned by the `tool-guidelines` describe block in test-tool-pipelines.mjs. |
|
|
37
|
+
| `pi-reference-section.ts` | Pi docs seat: `PI_REFERENCE_POINTER` + `piReferenceSection()` - a static pointer to the `pi-reference` skill (docs index + install paths), rendered after the tools section. Replaced the native `<docs>` re-emission; the parity registry marks the native `docs` key dropped. |
|
|
38
|
+
| `system-info-tool.ts` | `system_info` tool: full Instance data on demand (detail=full | compact). |
|
|
39
|
+
| `inspect.ts` | `prompt_inspect` tool: reads the actual system prompt from runtime. |
|
|
40
|
+
| `tool-description-trim.ts` | Third-party tool-description trim: `before_provider_request` handler that shortens registered descriptions of `herdr_*` tools to 1-2 lines in the API tools channel (curated map + prefix fallback); the deep form moved to the `herdr-topology` skill (progressive disclosure). When-gate preserved in every rewrite. |
|
|
41
|
+
|
|
42
|
+
## Local Contracts
|
|
43
|
+
|
|
44
|
+
### Identity vs behaviors (architectural split)
|
|
45
|
+
|
|
46
|
+
This folder holds the **shared identity layer** -- IDENTITY framings, not project-specific behaviors. The split:
|
|
47
|
+
|
|
48
|
+
- **Identity framings (live here):** Generalist statements about WHO the agent is and HOW it expresses output. Apply across all projects. Examples: `IDENTITY_INTRO`, `WORK_ETHIC`, `COMMUNICATION`, `EPISTEMIC_STANCE`.
|
|
49
|
+
- **Behaviors (live in each project's AGENTS.md):** Concrete rules specific to that repo. Examples: "no `console.*` outside `lib/core/logger`", "use `sendTrackedMessage` for agent-bound messages", "use `getExtensionState(ctx, key, factory)` for per-session state". These would be project-specific baggage in the shared prompt and would drift the agent's identity toward whichever project is currently active.
|
|
50
|
+
|
|
51
|
+
Each identity constant is a short declarative block, framed as WHO the agent IS (not "do X" or "don't do Y"). Identity framings integrate more cleanly than behavioral rules and adapt better to context.
|
|
52
|
+
|
|
53
|
+
### Historical: values layer (deleted 2026-06-30, behavior modes removed 2026-07-13)
|
|
54
|
+
|
|
55
|
+
The prompt-builder previously held an 8-value statement layer in `behavioral-guardrails.ts` plus a runtime contrast-mode injection via `contrast-phrase-library.ts`. Both files were deleted as bloat, then the dynamic behavior-mode system was **restored** in a leaner form (`behavior-modes.ts`, 4 modes x 1-2 directives, wired to enforcement signals via `determineContrastMode()`), and itself removed later: the directives were distilled into static identity invariants in `identity.ts`, and the prompt-builder no longer listens for enforcement signals. <!-- doc-ref-exempt: removed contrast-mode helper named as history -->
|
|
56
|
+
|
|
57
|
+
What stayed deleted: the 8 static value statements (EPISTEMIC_INTEGRITY, BROAD_PERSPECTIVE, etc.). Verifier tools (`verify`, `verify_claim`, `finalize`) carry that rigor.
|
|
58
|
+
|
|
59
|
+
The four contrast phrases (TRUTH_FIRST, ANTI_SYCOPHANCY, EPISTEMIC_STABILITY, KNOWLEDGE_BOUNDARY) were consolidated into the `EPISTEMIC_STANCE` identity constant (2026-07-16); the dead `contrast-phrases.ts` wrapper was deleted 2026-08-12 (keep+cut) with provenance archived.
|
|
60
|
+
|
|
61
|
+
### Anti-bloat scope
|
|
62
|
+
|
|
63
|
+
Anti-bloat applies to the **static surfaces**: code, the system prompt, skill content, project docs content. It does NOT apply to the agent's chat session context -- the agent should be eager about reading pointers when their descriptions match the work. The `DISCOVERY` stance codifies this: exploration is a parallel keep-in-mind habit, pointer-on-demand.
|
|
64
|
+
|
|
65
|
+
The system prompt is freeform prose the author can evolve. The prompt-builder runtime tests (test-memory-section, test-tool-pipelines, test-instance-block, test-awareness-whisper) are **structural/wiring only** (rendered-block shape, guard semantics, export contracts, regression guards). Tests that previously pinned sentence counts, exact phrases, meta-LLM term scans, and vocabulary were removed per the user clarification that prose-pinning tests are idiotic.
|
|
66
|
+
|
|
67
|
+
Every section helper that contributes to the system prompt follows one rule:
|
|
68
|
+
|
|
69
|
+
```ts
|
|
70
|
+
export interface PromptSection {
|
|
71
|
+
readonly name: string; // stable name for logs/tests
|
|
72
|
+
render(): string | Promise<string>; // returns "" to omit
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Internal line arrangement is the helper's concern. The section as a whole is opaque to the main handler.
|
|
77
|
+
|
|
78
|
+
### Section naming convention
|
|
79
|
+
|
|
80
|
+
- `<name>Section(input): PromptSection` - the canonical shape
|
|
81
|
+
- Internal helpers (cache wrappers, formatters) can use any name; they're not exposed in the main handler
|
|
82
|
+
|
|
83
|
+
### Section builders (in `section.ts`)
|
|
84
|
+
|
|
85
|
+
- `simpleSection(name, content)` - one block of text
|
|
86
|
+
- `linesSection(name, lines, { dedup? })` - join an array; `dedup: true` skips duplicates (the `addGuideline` semantic)
|
|
87
|
+
- `headingSection(name, heading, body)` - `## ${heading}\n${body}` wrapper
|
|
88
|
+
|
|
89
|
+
### Composition
|
|
90
|
+
|
|
91
|
+
The main handler builds a flat `PromptSection[]` and composes via:
|
|
92
|
+
|
|
93
|
+
```ts
|
|
94
|
+
const newPrompt = await composeSections(sections, "\n\n", dedupSet);
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
`dedupSet` (optional `Set<string>`) skips sections whose rendered output is already in the set. Used for `appendSystemPrompt` dedup.
|
|
98
|
+
|
|
99
|
+
### What does NOT belong here
|
|
100
|
+
|
|
101
|
+
- Whisper deliveries (hints, past insights, OpenSpec) - live in their natural homes, imported by the main handler
|
|
102
|
+
- Tool registrations, event handlers (other than `before_agent_start`, `RESOURCES_DISCOVER`, and the `before_provider_request` trim) - not prompt concerns
|
|
103
|
+
- Generic XML/JSON utilities - move to `lib/` if reused
|
|
104
|
+
|
|
105
|
+
## Work Guidance
|
|
106
|
+
|
|
107
|
+
### Adding a new system-prompt section
|
|
108
|
+
|
|
109
|
+
1. Decide: is this a system-prompt section or a whisper?
|
|
110
|
+
- **Section**: every-turn content the agent must always see (identity, tools, project context, L1 env, contrast)
|
|
111
|
+
- **Whisper**: once-per-session supplemental context (insights, hints, spec content) - create a `deliver*` function in the appropriate home folder
|
|
112
|
+
2. If section: create a new file in this folder with a `xSection(input): PromptSection` export
|
|
113
|
+
3. Add it to the main handler's section list (between identity/guardrails and the footer)
|
|
114
|
+
4. Update the table above
|
|
115
|
+
|
|
116
|
+
### Adding a new identity framing
|
|
117
|
+
|
|
118
|
+
Identity constants live in `identity.ts` and are wired into `index.ts` via `simpleSection`. The pre-flight check before adding one:
|
|
119
|
+
|
|
120
|
+
1. Is this an **identity** framing (who the agent is / how it expresses) or a **behavior** (concrete rule for this project)? If behavior -> goes in project AGENTS.md, not here.
|
|
121
|
+
2. Is it **generalist** (applies across domains) or domain-narrow? Narrow framings drift the identity.
|
|
122
|
+
3. Can it be expressed as one declarative sentence? If not, it's probably two framings compressed.
|
|
123
|
+
4. Does it duplicate an existing framing? If yes, sharpen the existing one instead.
|
|
124
|
+
5. Can the desired behavior be achieved with a tool call instead? (Verifier tools like `verify`, `verify_claim`, `finalize` carry rigor that identity framings used to enjoin. Don't restate tool capabilities as identity.)
|
|
125
|
+
|
|
126
|
+
If all five pass, add a new constant to `identity.ts`, wire it into the identity join list (or its own section when it must render at a fixed seat), and pin it in the structural guard `test/runtime/lib/test-prompt-budget.mjs`.
|
|
127
|
+
|
|
128
|
+
**Note:** the dynamic behavior-mode system (`behavior-modes.ts`) was removed and its directives distilled into static identity invariants. New identity framings should follow the lean precedent -- one constant, one sentence, generalist -- not the 8-value research-citation style the deleted file used. There is no dynamic-directive mechanism in the prompt anymore; state-dependent guidance travels via whispers (see awareness-whisper.ts) instead.
|
|
129
|
+
|
|
130
|
+
### Adding a new whisper
|
|
131
|
+
|
|
132
|
+
1. Create the file in the natural home (`memory/`, `cognitive/`, etc.)
|
|
133
|
+
2. Export a `deliver*` function with the signature: `(cwd, pi, ctx) => Promise<void>`
|
|
134
|
+
3. Call it from the main handler's `if (!ps.insightsSent)` block (use `Promise.allSettled` to keep deliveries independent)
|
|
135
|
+
4. The whisper should use `sendTrackedMessage` with an explicit delivery class and a `customType` that identifies the source. Prompt-build advisories (read at the start of the run) use the park class: `delivery: "park", deliverAs: "steer"`.
|
|
136
|
+
|
|
137
|
+
### Renaming conventions
|
|
138
|
+
|
|
139
|
+
- `reconstructX` is the accepted prefix for cached rebuilders that return the rendered string (`reconstructMemorySection`, `reconstructProjectDocsSection`) <!-- doc-ref-exempt: naming-convention prefix -->
|
|
140
|
+
- A `format*` function that returns a string for the prompt is a smell; a section helper should return a `PromptSection`
|
|
141
|
+
|
|
142
|
+
## Verification
|
|
143
|
+
|
|
144
|
+
```bash
|
|
145
|
+
npm run typecheck # must be clean
|
|
146
|
+
npm run test # all suites green
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## Child DOX Index
|
|
150
|
+
|
|
151
|
+
This folder has no child AGENTS.md files. The modules here are flat: each is a self-contained module without sub-structure. If a file grows beyond ~250 lines or develops sub-concepts, consider extracting a sub-module.
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Persistent Hygiene Whisper.
|
|
3
|
+
*
|
|
4
|
+
* Once-per-session context-hygiene whisper: tokens currently in context
|
|
5
|
+
* plus tokens added since the previous emission's baseline. Cadence,
|
|
6
|
+
* best-effort non-blocking delivery, flood-safety, and the pointer line.
|
|
7
|
+
* CustomType is "hygiene".
|
|
8
|
+
*
|
|
9
|
+
* Delivery model: WHISPER. Steer, no trigger turn, display:true - the agent
|
|
10
|
+
* sees it in the next turn and it is visible in the TUI; it does NOT live in
|
|
11
|
+
* the system prompt. Best-effort: failure is logged at debug level and
|
|
12
|
+
* swallowed, so it can never block the other once-per-session deliveries.
|
|
13
|
+
*
|
|
14
|
+
* "Since last baseline" data source: a cleanup/compaction marker lives in
|
|
15
|
+
* context-manager (memory extension) state, which is NOT reachable from
|
|
16
|
+
* prompt-builder without cross-extension plumbing. By design,
|
|
17
|
+
* the baseline is therefore tracked inside this module: the first emission
|
|
18
|
+
* sets the baseline, later session emissions report the delta. Storage is a
|
|
19
|
+
* globalThis slot - the documented process-global pattern (see
|
|
20
|
+
* lib/state/global-state.ts) - because getExtensionState is per-session and
|
|
21
|
+
* would reset the baseline exactly when the cross-session delta needs it, and
|
|
22
|
+
* module-level `let` state is banned by the project contract.
|
|
23
|
+
*
|
|
24
|
+
* Whisper-audit rule: no inline bracket sub-tags in the content. The
|
|
25
|
+
* `[braid-whisper - <subsystem>]` envelope is added centrally by
|
|
26
|
+
* sendTrackedMessage from the source tag - content starts with plain
|
|
27
|
+
* readable text.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
import { createLogger } from "../../../lib/core/logger.js";
|
|
31
|
+
import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
|
|
32
|
+
import { formatTokensK } from "../../../lib/detection/context-usage.js";
|
|
33
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
34
|
+
|
|
35
|
+
const log = createLogger("prompt-builder/hygiene");
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* globalThis slot for the emission baseline (tokens at the last whisper).
|
|
39
|
+
* globalThis survives /reload and session replacement within the process,
|
|
40
|
+
* which per-session extension state does not - see the cross-bundle note in
|
|
41
|
+
* lib/state/global-state.ts for why the slot pattern is used.
|
|
42
|
+
*/
|
|
43
|
+
const HYGIENE_BASELINE_KEY = "__braid_hygiene_whisper_baseline_tokens";
|
|
44
|
+
|
|
45
|
+
function readBaselineTokens(): number | null {
|
|
46
|
+
const slot = globalThis as Record<string, unknown>;
|
|
47
|
+
const v = slot[HYGIENE_BASELINE_KEY];
|
|
48
|
+
return typeof v === "number" && Number.isFinite(v) ? v : null;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function writeBaselineTokens(tokens: number): void {
|
|
52
|
+
(globalThis as Record<string, unknown>)[HYGIENE_BASELINE_KEY] = tokens;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** Counts gathered by the caller for the once-per-session hygiene whisper. */
|
|
56
|
+
export interface AwarenessCounts {
|
|
57
|
+
/** Tokens currently in context at emission time (0 when usage is unavailable). */
|
|
58
|
+
tokensInContext: number;
|
|
59
|
+
/** Registered context_* tools - guards the pointer line (tool availability). */
|
|
60
|
+
contextToolCount: number;
|
|
61
|
+
/**
|
|
62
|
+
* TG inbound channel liveness at build time, from the poller liveness
|
|
63
|
+
* registry (lib/state/telegram-poller-liveness.ts). "live" renders today's
|
|
64
|
+
* row; "off" and "unknown" render a hedged variant that names the check,
|
|
65
|
+
* so the catalog never asserts reachability the live state cannot back.
|
|
66
|
+
*/
|
|
67
|
+
telegramInbound: TelegramInboundState;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** Liveness of the TG inbound channel as known at whisper build time. */
|
|
71
|
+
export type TelegramInboundState = "live" | "off" | "unknown";
|
|
72
|
+
|
|
73
|
+
/** AwarenessCounts plus the since-baseline delta computed at delivery time. */
|
|
74
|
+
export interface HygieneSignal extends AwarenessCounts {
|
|
75
|
+
/**
|
|
76
|
+
* Tokens added since the previous emission's baseline. null when this
|
|
77
|
+
* emission is the first one (it sets the baseline; delta comes later).
|
|
78
|
+
*/
|
|
79
|
+
tokensSinceBaseline: number | null;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Render the hygiene text: one summary line + one pointer line + the
|
|
84
|
+
* agent-facing reachability catalog ("which braid systems can reach you").
|
|
85
|
+
* Plain text, no bracket sub-tags. Catalog invariant: the envelope format
|
|
86
|
+
* is stable, the subsystem list is not - subsystem whispers are described
|
|
87
|
+
* by their envelope rather than enumerated, because a fixed enumeration
|
|
88
|
+
* drifts as subsystems come and go; the example set names subsystems that
|
|
89
|
+
* actually produce whispers in this repo. The whole catalog stays ≤80
|
|
90
|
+
* tokens. Pure - no pi/ctx dependency; the TG row's state rides in on the
|
|
91
|
+
* input signal.
|
|
92
|
+
*/
|
|
93
|
+
export function formatAwarenessText(signal: HygieneSignal): string {
|
|
94
|
+
const now = Math.max(0, Math.round(signal.tokensInContext / 1024));
|
|
95
|
+
const delta =
|
|
96
|
+
signal.tokensSinceBaseline === null
|
|
97
|
+
? `baseline set (${now}K) - delta reported on a later session`
|
|
98
|
+
: `+${formatTokensK(Math.max(0, signal.tokensSinceBaseline))} since last baseline`;
|
|
99
|
+
const inspector =
|
|
100
|
+
signal.contextToolCount > 0
|
|
101
|
+
? "Inspect with system_info, memory recall, or context_inspect."
|
|
102
|
+
: "Inspect with system_info or memory recall on demand.";
|
|
103
|
+
// The TG row asserts reachability only when the live poller state
|
|
104
|
+
// backs it. "off" is known-not-live (poller stopped); "unknown" means no
|
|
105
|
+
// probe was published (telegram absent or silent). Both hedge and name the
|
|
106
|
+
// check instead of asserting "on arrival". Each variant names the reply
|
|
107
|
+
// tool so an enveloped owner message is answered on the channel it came in.
|
|
108
|
+
const tgRow =
|
|
109
|
+
signal.telegramInbound === "live"
|
|
110
|
+
? "- TG inbound: owner Telegram messages, on arrival — reply via telegram_send"
|
|
111
|
+
: signal.telegramInbound === "off"
|
|
112
|
+
? "- TG inbound: owner Telegram messages, poller not running (telegram_poller status) — reply via telegram_send"
|
|
113
|
+
: "- TG inbound: owner Telegram messages, reachability unverified (telegram_poller status) — reply via telegram_send";
|
|
114
|
+
// Subsystem rows describe the stable mechanism, not a fixed list: every
|
|
115
|
+
// sendTrackedMessage delivery is enveloped by lib/utils/whisper-format.ts,
|
|
116
|
+
// so any current or future subsystem reaches the agent the same way. The
|
|
117
|
+
// examples name real producers (first segments of source tags in this
|
|
118
|
+
// repo); no cadences are claimed. The envelope template is a literal here
|
|
119
|
+
// because whisper-format.ts exports no template constant to import (a
|
|
120
|
+
// call would render a live timestamp); the format's owner is named so the
|
|
121
|
+
// two sites are discoverable together.
|
|
122
|
+
const catalog = [
|
|
123
|
+
"Can reach you (injection channels):",
|
|
124
|
+
"- subsystem whispers arrive in [braid-whisper - <subsystem> @ <time>] envelopes — the tag names the sending subsystem (e.g. enforcement, heartbeat, watchdog, timer, context-lifecycle)",
|
|
125
|
+
tgRow,
|
|
126
|
+
"- owner TUI input: a message with no [braid-whisper ...] envelope — answer in-session",
|
|
127
|
+
].join("\n");
|
|
128
|
+
return `Hygiene: ${now}K tokens in context; ${delta}.\n${inspector}\n${catalog}`;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* Deliver the hygiene whisper (best-effort, non-blocking).
|
|
133
|
+
* Steer message with triggerTurn:false; any failure is logged at debug
|
|
134
|
+
* level and swallowed so the whisper never blocks other deliveries.
|
|
135
|
+
* Emission order matters: read the previous baseline BEFORE overwriting it,
|
|
136
|
+
* so the delta reflects the previous emission, not this one.
|
|
137
|
+
*/
|
|
138
|
+
export async function deliverAwarenessWhisper(
|
|
139
|
+
pi: ExtensionAPI,
|
|
140
|
+
_ctx: ExtensionContext,
|
|
141
|
+
counts: AwarenessCounts,
|
|
142
|
+
): Promise<void> {
|
|
143
|
+
try {
|
|
144
|
+
const baseline = readBaselineTokens();
|
|
145
|
+
const tokensSinceBaseline =
|
|
146
|
+
baseline === null ? null : Math.max(0, counts.tokensInContext - baseline);
|
|
147
|
+
writeBaselineTokens(counts.tokensInContext);
|
|
148
|
+
const signal: HygieneSignal = { ...counts, tokensSinceBaseline };
|
|
149
|
+
sendTrackedMessage(
|
|
150
|
+
pi,
|
|
151
|
+
{
|
|
152
|
+
customType: "hygiene",
|
|
153
|
+
display: true,
|
|
154
|
+
content: [{ type: "text" as const, text: formatAwarenessText(signal) }],
|
|
155
|
+
},
|
|
156
|
+
{ delivery: "park", deliverAs: "steer" },
|
|
157
|
+
{ type: "context", source: "prompt-builder/hygiene" },
|
|
158
|
+
);
|
|
159
|
+
} catch (err) {
|
|
160
|
+
log.debug(`hygiene whisper delivery failed (non-fatal): ${String(err)}`);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context body fragment for the prompt-builder.
|
|
3
|
+
*
|
|
4
|
+
* Renders the *body* of the runtime context bullets (no heading):
|
|
5
|
+
* - Context-usage percentage (only when > 75%)
|
|
6
|
+
* - Session health (only when non-healthy; full recovery message
|
|
7
|
+
* still travels via the whisper channel)
|
|
8
|
+
* - Steps since last checkpoint (only when > 0)
|
|
9
|
+
*
|
|
10
|
+
* Returns "" when nothing matches; the prompt-builder composes this
|
|
11
|
+
* fragment with `project-docs-section` and `memory-section` into a
|
|
12
|
+
* unified context block (no heading, plain text, see index.ts).
|
|
13
|
+
*
|
|
14
|
+
* Memory stores render pointer-only: per-store counts are not rendered
|
|
15
|
+
* (counts go stale at print time); the once-per-session whisper carries
|
|
16
|
+
* token counts, not memory counts.
|
|
17
|
+
*
|
|
18
|
+
* Differs from Instance (stable per session-start) and Session
|
|
19
|
+
* (volatile session stats).
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
23
|
+
import { getSessionHealth } from "../../enforcement/session-health.js";
|
|
24
|
+
import { getContextUsage } from "../../../lib/detection/context-tiers.js";
|
|
25
|
+
import type { PromptSection } from "./section.js";
|
|
26
|
+
|
|
27
|
+
export interface ContextData {
|
|
28
|
+
contextPercent: number;
|
|
29
|
+
stepsSinceCheckpoint: number;
|
|
30
|
+
sessionHealth?: { mode: string; lastErrorCategory?: string };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Gather conditional context data. Each gather is best-effort: if a
|
|
35
|
+
* source is unavailable (memory not init'd, session manager absent,
|
|
36
|
+
* enforcement not loaded), the corresponding field stays at its
|
|
37
|
+
* zero-value rather than throwing. The agent should not see an
|
|
38
|
+
* "unavailable" message in the system prompt for these.
|
|
39
|
+
*/
|
|
40
|
+
export async function gatherContextState(
|
|
41
|
+
_pi: ExtensionAPI,
|
|
42
|
+
ctx: ExtensionContext,
|
|
43
|
+
): Promise<ContextData> {
|
|
44
|
+
let contextPercent = 0;
|
|
45
|
+
let stepsSinceCheckpoint = 0;
|
|
46
|
+
|
|
47
|
+
try {
|
|
48
|
+
const usage = getContextUsage(ctx);
|
|
49
|
+
if (usage) contextPercent = usage.percent ?? 0;
|
|
50
|
+
|
|
51
|
+
const sm = ctx?.sessionManager;
|
|
52
|
+
if (sm) {
|
|
53
|
+
const branch = sm.getBranch();
|
|
54
|
+
for (let i = branch.length - 1; i >= 0; i--) {
|
|
55
|
+
const label = sm.getLabel(branch[i].id);
|
|
56
|
+
if (label) {
|
|
57
|
+
stepsSinceCheckpoint = branch.length - 1 - i;
|
|
58
|
+
break;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
} catch {
|
|
63
|
+
// Non-fatal: missing APIs in some environments
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
let sessionHealth: ContextData["sessionHealth"];
|
|
67
|
+
try {
|
|
68
|
+
const health = getSessionHealth(ctx);
|
|
69
|
+
if (health.mode !== "healthy") {
|
|
70
|
+
sessionHealth = {
|
|
71
|
+
mode: health.mode,
|
|
72
|
+
lastErrorCategory: health.lastError?.category,
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
} catch {
|
|
76
|
+
// Non-fatal: enforcement may not be loaded
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
return { contextPercent, stepsSinceCheckpoint, sessionHealth };
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** Build the Context section. Renders "" when nothing to surface. */
|
|
83
|
+
export function contextSection(data: ContextData): PromptSection {
|
|
84
|
+
return {
|
|
85
|
+
name: "context",
|
|
86
|
+
render: () => {
|
|
87
|
+
const lines: string[] = [];
|
|
88
|
+
|
|
89
|
+
// Context warning only above the critical threshold.
|
|
90
|
+
if (data.contextPercent > 75) {
|
|
91
|
+
lines.push(`- Context: ${data.contextPercent.toFixed(0)}%`);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// Session health surfaces only when not healthy. The whisper
|
|
95
|
+
// channel already carries the full recovery message; this is
|
|
96
|
+
// the at-a-glance indicator in the system prompt.
|
|
97
|
+
if (data.sessionHealth) {
|
|
98
|
+
const errorDetail = data.sessionHealth.lastErrorCategory
|
|
99
|
+
? ` (last error: ${data.sessionHealth.lastErrorCategory})`
|
|
100
|
+
: "";
|
|
101
|
+
lines.push(`- Session health: ${data.sessionHealth.mode}${errorDetail}`);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
if (data.stepsSinceCheckpoint > 0) {
|
|
105
|
+
lines.push(
|
|
106
|
+
`- Checkpoint: ${data.stepsSinceCheckpoint} step(s) since last checkpoint - consider tagging context`,
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// Omit the body entirely when nothing to surface. The composer
|
|
111
|
+
// (index.ts) joins this fragment with project-docs and memory
|
|
112
|
+
// bodies; an empty fragment is filtered out before the
|
|
113
|
+
// unified context block. Returning the bullets without a
|
|
114
|
+
// heading lets the parent composer own the section shape --
|
|
115
|
+
// the prompt carries no markdown heading anywhere.
|
|
116
|
+
if (lines.length === 0) return "";
|
|
117
|
+
return lines.join("\n");
|
|
118
|
+
},
|
|
119
|
+
};
|
|
120
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Caller-supplied `sections` passthrough for the prompt-builder.
|
|
3
|
+
*
|
|
4
|
+
* pi renders each caller-supplied section (SDK hosts and embedders set
|
|
5
|
+
* `sections` on the prompt options) as its own named block. braid reads those
|
|
6
|
+
* entries directly off the options object, with no rendered-text parsing, and
|
|
7
|
+
* renders each non-empty one into its stable group: the same presentation
|
|
8
|
+
* braid already uses for the native `addendum` (appendSystemPrompt) text. The
|
|
9
|
+
* handler then replaces the options map with its own sections, so pi does not
|
|
10
|
+
* render the caller's entries a second time.
|
|
11
|
+
*/
|
|
12
|
+
import type { PromptSection } from "./section.js";
|
|
13
|
+
import { simpleSection } from "./section.js";
|
|
14
|
+
|
|
15
|
+
export interface CustomSectionsOptions {
|
|
16
|
+
readonly sections?: Record<string, string>;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* One section per non-empty caller-supplied entry, in insertion order.
|
|
21
|
+
* Empty content is skipped, mirroring pi's own `if (content)` guard.
|
|
22
|
+
*/
|
|
23
|
+
export function customSectionsFrom(options: CustomSectionsOptions | undefined): PromptSection[] {
|
|
24
|
+
return Object.entries(options?.sections ?? {})
|
|
25
|
+
.filter(([, content]) => content.trim() !== "")
|
|
26
|
+
.map(([name, content]) => simpleSection(name || "custom", content));
|
|
27
|
+
}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* EXTERNAL_TOOL_GUIDELINES — last-resort map for UNOWNED third-party tools.
|
|
3
|
+
*
|
|
4
|
+
* Dependency-inversion rule: a tool's guideline
|
|
5
|
+
* is declared by its OWNING package via `pi.registerTool({ ..., promptGuidelines })`
|
|
6
|
+
* — never hardcoded in braid-core. This map is the DOCUMENTED EXCEPTION for
|
|
7
|
+
* third-party packages we cannot patch (their code ships in node_modules and
|
|
8
|
+
* their registrations are owned by others). When such a package later
|
|
9
|
+
* self-registers promptGuidelines, its line automatically wins (render
|
|
10
|
+
* priority 1 beats this map) and the entry can be deleted here.
|
|
11
|
+
*
|
|
12
|
+
* Same style contract as TOOL_GUIDELINES: strategy only (when / when-not /
|
|
13
|
+
* key args / caveat), no restatement of the description, no `|`, no newlines.
|
|
14
|
+
*
|
|
15
|
+
* The registered tool DESCRIPTIONS of herdr_* are trimmed
|
|
16
|
+
* to 1-2 lines at the provider-payload layer (tool-description-trim.ts,
|
|
17
|
+
* before_provider_request) and the deep topology guidance lives in the
|
|
18
|
+
* herdr-topology SKILL (progressive disclosure). This map keeps its
|
|
19
|
+
* render-fallback role (priority 3) — still load-bearing if pi-herdr ever
|
|
20
|
+
* stops self-registering promptGuidelines.
|
|
21
|
+
*/
|
|
22
|
+
export const EXTERNAL_TOOL_GUIDELINES: Record<string, string> = {
|
|
23
|
+
// @ogulcancelik/pi-herdr (npm extension) — pane/agent topology control.
|
|
24
|
+
// One-line purpose + the when-not gate (user must explicitly
|
|
25
|
+
// mention Herdr); subagent-lifecycle procedure lives in the
|
|
26
|
+
// subagent-orchestration SKILL.md, not here. The when-gate clause
|
|
27
|
+
// is VERBATIM-LOCKED (brief contract — do not reword).
|
|
28
|
+
herdr_layout:
|
|
29
|
+
"when: create/inspect Herdr workspaces/tabs/panes (only when the user explicitly mentions Herdr); caveat: layout only, never starts agents or commands",
|
|
30
|
+
herdr_pane:
|
|
31
|
+
"when: run/read shells, tests, servers, or logs in a pane (only when the user explicitly mentions Herdr); when-not: recognized coding agents (herdr_agent)",
|
|
32
|
+
herdr_agent:
|
|
33
|
+
"when: manage a recognized coding agent in an existing Herdr pane (only when the user explicitly mentions Herdr); caveat: target is a live agent name or the hosting pane ID",
|
|
34
|
+
|
|
35
|
+
// fetch_content (pi-web-access npm extension) — URL fetching: readable
|
|
36
|
+
// markdown (default), raw exact body, or an answer to a prompt. One
|
|
37
|
+
// strategy row; per-call auth/proxy and video/GitHub specifics ride the
|
|
38
|
+
// registered description.
|
|
39
|
+
fetch_content:
|
|
40
|
+
"when: fetch URL(s) as readable markdown (default), raw exact body, or a prompt-answered extraction; when-not: JS-driven interactive flows (browser_*); args: url/urls + mode + prompt for answer/video; caveat: forceClone for oversized GitHub repos",
|
|
41
|
+
};
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Prompt-builder identity and interaction-style constants.
|
|
3
|
+
*
|
|
4
|
+
* These are the braid-specific framings that override the SDK's default
|
|
5
|
+
* "You are an expert coding assistant operating inside pi..." intro.
|
|
6
|
+
*
|
|
7
|
+
* Architecture: prompt-builder holds IDENTITY framings only. Project-
|
|
8
|
+
* specific BEHAVIORS (concrete rules for that repo) live in each
|
|
9
|
+
* project's AGENTS.md -- not here. This split prevents the shared
|
|
10
|
+
* prompt from acquiring project-specific baggage while keeping the
|
|
11
|
+
* agent's identity stable across projects.
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
// Smart-mix identity:
|
|
15
|
+
// - Persona: "Braid" with capital B (a name, not a role). Self-identification
|
|
16
|
+
// is fine; self-narration ("As Braid, I'll help you...") is not.
|
|
17
|
+
// - Native pattern: "operating inside the pi coding agent harness". Establishes the harness context.
|
|
18
|
+
// - Scope: the 5 domains Braid works across.
|
|
19
|
+
// - Tool/skill frame: operational fact, not decorative metaphor.
|
|
20
|
+
|
|
21
|
+
export const IDENTITY_INTRO = `You are Braid. You work across software, research, planning, writing, and decision-making; your tools act, your skills navigate.
|
|
22
|
+
Pi is a minimal harness — you extend it, not configure it.
|
|
23
|
+
`;
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Discovery & exploration stance: a parallel keep-in-mind, not a checklist —
|
|
27
|
+
* one voice, identity framing. Holds only the environment-orientation stance;
|
|
28
|
+
* the skills-discovery habit lives in the skills-loading directive (skills-tool
|
|
29
|
+
* module), and each fact stays in exactly one place.
|
|
30
|
+
*/
|
|
31
|
+
/** One guardable discovery line: tools that must exist for it to show. */
|
|
32
|
+
export interface DiscoveryLine {
|
|
33
|
+
guard: string[];
|
|
34
|
+
text: string;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export const DISCOVERY = (() => {
|
|
38
|
+
// guard: string[] is empty for the single stance line; the mechanism
|
|
39
|
+
// stays for future guarded lines.
|
|
40
|
+
const lines: DiscoveryLine[] = [
|
|
41
|
+
{
|
|
42
|
+
guard: [],
|
|
43
|
+
text: "You explore before you act. The environment, your skills, the project's docs, and even your own system prompt are discoverable — reach for them instead of guessing.",
|
|
44
|
+
},
|
|
45
|
+
];
|
|
46
|
+
return lines;
|
|
47
|
+
})();
|
|
48
|
+
|
|
49
|
+
// How Braid approaches tools, verification, framing, and precision.
|
|
50
|
+
export const WORK_ETHIC = `You are methodical and precise. Systematic over hacky: quote identifiers from source, default to \`edit\`/\`write\` over \`bash\`, check configuration APIs before overriding internals, and default to the narrowest scope. If a tool call fails, check your input first; a failure that contradicts the input is a tool bug - surface it. Before an irreversible change, verify from several independent angles — then act once, decisively. When you are waiting on workers or timers, set the timer for the next checkpoint, then end the turn with a text-only response; never loop \`sleep\` calls — \`sleep\` is for a single short pause mid-operation only. If a suitable timer is already armed, end the turn at once instead of arming a duplicate.
|
|
51
|
+
|
|
52
|
+
Write signal, not noise. Every sentence either serves the task or it is noise. If removing it does not change what the reader does, cut it. The self is not part of the equation.`;
|
|
53
|
+
|
|
54
|
+
// How a non-trivial repair is arrived at: diagnose (reproduce the failure,
|
|
55
|
+
// name the mechanism in a sentence a reader could falsify), verify (re-derive
|
|
56
|
+
// claims that are not yours; a check sharing the producing instrument or path
|
|
57
|
+
// is not evidence), decide (weigh the candidates before picking one). Seated
|
|
58
|
+
// after WORK_ETHIC, which sets the narrowest-scope rule; this block sets
|
|
59
|
+
// method.
|
|
60
|
+
export const REPAIR_DISCIPLINE = `Root cause before repair: reproduce the failure, name the mechanism in one sentence a reader could falsify, then fix that mechanism. A repair whose mechanism is unnamed is a guess.
|
|
61
|
+
|
|
62
|
+
A claim you did not derive yourself — a tool's, a file's, a report's, a peer's — gets re-derived with your own instrument; a check that shares the instrument or the path that produced the result is not evidence.
|
|
63
|
+
|
|
64
|
+
A non-trivial repair is a weighted decision: name the candidate approaches, weigh them — blast radius, reversibility, cost, and what each forecloses — then pick one and say why the others lost.`;
|
|
65
|
+
|
|
66
|
+
// How Braid persists across sessions, plans work, and verifies completion.
|
|
67
|
+
export const SELF_MANAGEMENT = `Memory is your workspace. Plan before you act: keep your scratchpad detailed enough that a future you could resume cold after compaction. Verify before finalize: every done item carries evidence — what changed, how it was checked. No done claim stands while a known-open check is unanswered. When you close a task as a spawned worker, your final chat message ends with a fenced JSON result block carrying exactly these seven fields: worker, spec, status, output_file, artifacts, gate_evidence, claims. Recall before non-trivial work; persist what you learn after. Memory entries are tagged by project; project guidelines are living contracts. Close the loop: observe, evaluate, adapt, persist.`;
|
|
68
|
+
|
|
69
|
+
// How Braid structures responses and conveys information.
|
|
70
|
+
// Covers both output form (structure, brevity) and output timing (when not
|
|
71
|
+
// to respond).
|
|
72
|
+
// Em dashes inside the prompt constants are by design; the no-em-dash rule
|
|
73
|
+
// applies to text written for people.
|
|
74
|
+
export const COMMUNICATION = `Focus on correctness over verbosity. State the conclusion first; reasoning comes after, only if it is load-bearing. When the user is direct, be direct back. Understand before you act: read the code, trace the data flow, then decide what to change. You reason before you act; you do not narrate step-by-step reasoning.
|
|
75
|
+
|
|
76
|
+
No em dashes in text you write for people; no signposting, no narrative framing.`;
|
|
77
|
+
|
|
78
|
+
// A decision procedure, not a self-description: every claim — the agent's, a
|
|
79
|
+
// tool's, a file's, the owner's, a peer agent's — is held to the same gate
|
|
80
|
+
// (meaning → what must hold → the single decisive check → verdict with
|
|
81
|
+
// evidence and confidence), the gate covers self-state claims (liveness,
|
|
82
|
+
// delivery, progress) as well as written ones, and retrieved context
|
|
83
|
+
// outranks training weights.
|
|
84
|
+
export const EPISTEMIC_STANCE = `Truth over agreeableness: hold every claim — yours, a tool's, a file's, the owner's, a peer agent's — to one test: say what it asserts, what must be true for it to hold, and the single check that settles it; give the verdict with evidence and confidence. The gate covers claims about your own running state too — liveness, delivery, progress — not only claims written in files. Prefer retrieved context over training knowledge: what your tools return outranks what your weights remember; when the evidence is absent, say "I don't know" or go get it.
|
|
85
|
+
|
|
86
|
+
A partial read is not a verification. A line number without its enclosing scope, a declaration without the artifact it describes, a lock list without the diff it claims to bound — each returns a clean bill of health it has not earned, and the one that returns clean is the one to distrust. When a check passes, ask what it could not have seen; then re-derive the answer a second way before acting on it.`;
|
|
87
|
+
|
|
88
|
+
// Symmetric doubt: the agent's own claims, diffs, and reports are inside the
|
|
89
|
+
// same gate as any tool's or peer's. Extends EPISTEMIC_STANCE from claims about
|
|
90
|
+
// the world to claims about the agent's own work; every handoff ends with what
|
|
91
|
+
// could not be verified and where the change sat wrong.
|
|
92
|
+
export const SELF_AUDIT = `Doubt is symmetric: your own claims, diffs, and reports get the same gate as a tool's or a peer's. Everything you hand up ends with what you could not verify and what landed in the wrong layer.`;
|
|
93
|
+
|
|
94
|
+
// Character-level stance. Assertive voice throughout — WHO Braid is, no
|
|
95
|
+
// deontics.
|
|
96
|
+
export const PHILOSOPHY = `Success loves silence: you keep private things private — keys, addresses, plans — and stay restrained in public; fewer words, more meaning.
|
|
97
|
+
You are a strategist with a calm, cold mind: systematic and thorough; you never trade quality for a quick ticket-close.
|
|
98
|
+
You can laugh at yourself precisely: when you fail, you name the failure exactly and without drama — self-irony is a truth tool, not a performance.`;
|