pi-braid 0.0.0-stage → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +195 -0
- package/CONTRIBUTING.md +302 -0
- package/LICENSE +21 -0
- package/README.md +260 -2
- package/TOOLS.md +147 -0
- package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
- package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
- package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
- package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
- package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
- package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
- package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
- package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
- package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
- package/dist/extensions/cognitive/metacognition/index.js +90 -0
- package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
- package/dist/extensions/cognitive/reasoning/index.js +99 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
- package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
- package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
- package/dist/extensions/cognitive/topic-drift/index.js +346 -0
- package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
- package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
- package/dist/extensions/context-management/index.d.ts +77 -0
- package/dist/extensions/context-management/index.js +339 -0
- package/dist/extensions/core/agent-environment/index.d.ts +30 -0
- package/dist/extensions/core/agent-environment/index.js +89 -0
- package/dist/extensions/core/polyfill/index.d.ts +28 -0
- package/dist/extensions/core/polyfill/index.js +474 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
- package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
- package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
- package/dist/extensions/core/prompt-builder/context-section.js +101 -0
- package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
- package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
- package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
- package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/identity.js +77 -0
- package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
- package/dist/extensions/core/prompt-builder/index.js +496 -0
- package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
- package/dist/extensions/core/prompt-builder/inspect.js +182 -0
- package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
- package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
- package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
- package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
- package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
- package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
- package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
- package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
- package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
- package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
- package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
- package/dist/extensions/core/prompt-builder/section.js +127 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
- package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
- package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
- package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
- package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
- package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
- package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
- package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
- package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
- package/dist/extensions/core/skills-tool/index.d.ts +56 -0
- package/dist/extensions/core/skills-tool/index.js +200 -0
- package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
- package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
- package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
- package/dist/extensions/core/skills-tool/session-records.js +268 -0
- package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
- package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
- package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
- package/dist/extensions/enforcement/detection/malformed.js +30 -0
- package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
- package/dist/extensions/enforcement/detection/verification.js +34 -0
- package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
- package/dist/extensions/enforcement/enforcement-types.js +24 -0
- package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
- package/dist/extensions/enforcement/handler-registry.js +196 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
- package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/blocking.js +33 -0
- package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
- package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
- package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
- package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
- package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
- package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
- package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
- package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
- package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
- package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
- package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
- package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
- package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
- package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
- package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
- package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
- package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
- package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
- package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
- package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
- package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
- package/dist/extensions/enforcement/index.d.ts +15 -0
- package/dist/extensions/enforcement/index.js +22 -0
- package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
- package/dist/extensions/enforcement/judge-utils.js +83 -0
- package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
- package/dist/extensions/enforcement/nudge-manager.js +203 -0
- package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
- package/dist/extensions/enforcement/self-state-claims.js +167 -0
- package/dist/extensions/enforcement/session-health.d.ts +107 -0
- package/dist/extensions/enforcement/session-health.js +251 -0
- package/dist/extensions/enforcement/signals.d.ts +54 -0
- package/dist/extensions/enforcement/signals.js +47 -0
- package/dist/extensions/enforcement/similarity.d.ts +16 -0
- package/dist/extensions/enforcement/similarity.js +64 -0
- package/dist/extensions/enforcement/state.d.ts +40 -0
- package/dist/extensions/enforcement/state.js +74 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
- package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
- package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
- package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
- package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
- package/dist/extensions/enforcement/substate/session-state.js +45 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
- package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
- package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
- package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
- package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
- package/dist/extensions/enforcement/task-evidence.js +335 -0
- package/dist/extensions/enforcement/types.d.ts +35 -0
- package/dist/extensions/enforcement/types.js +5 -0
- package/dist/extensions/enforcement/validation.d.ts +12 -0
- package/dist/extensions/enforcement/validation.js +151 -0
- package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
- package/dist/extensions/enforcement/verification-judge.js +214 -0
- package/dist/extensions/enforcement/whisper.d.ts +46 -0
- package/dist/extensions/enforcement/whisper.js +104 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
- package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
- package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
- package/dist/extensions/heartbeat/analytics/core.js +201 -0
- package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
- package/dist/extensions/heartbeat/analytics/format.js +111 -0
- package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
- package/dist/extensions/heartbeat/analytics/index.js +352 -0
- package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
- package/dist/extensions/heartbeat/analytics/shared.js +69 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
- package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
- package/dist/extensions/manifest.d.ts +32 -0
- package/dist/extensions/manifest.js +251 -0
- package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
- package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
- package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
- package/dist/extensions/memory/context-lifecycle/index.js +977 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
- package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
- package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
- package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
- package/dist/extensions/memory/context-lifecycle/state.js +90 -0
- package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
- package/dist/extensions/memory/context-lifecycle/types.js +273 -0
- package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
- package/dist/extensions/memory/context-manager/analysis.js +264 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
- package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
- package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
- package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
- package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
- package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
- package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
- package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
- package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
- package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
- package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
- package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
- package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
- package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
- package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
- package/dist/extensions/memory/context-manager/index.d.ts +3 -0
- package/dist/extensions/memory/context-manager/index.js +88 -0
- package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
- package/dist/extensions/memory/context-manager/pruning.js +406 -0
- package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
- package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
- package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
- package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
- package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
- package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
- package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
- package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
- package/dist/extensions/memory/scratchpad/format.js +135 -0
- package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
- package/dist/extensions/memory/scratchpad/handlers.js +469 -0
- package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
- package/dist/extensions/memory/scratchpad/index.js +168 -0
- package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
- package/dist/extensions/memory/scratchpad/persistence.js +343 -0
- package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
- package/dist/extensions/memory/scratchpad/types.js +8 -0
- package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
- package/dist/extensions/memory/scratchpad/utils.js +236 -0
- package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
- package/dist/extensions/memory/session-recall/analyze.js +478 -0
- package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
- package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
- package/dist/extensions/memory/session-recall/index.d.ts +29 -0
- package/dist/extensions/memory/session-recall/index.js +820 -0
- package/dist/extensions/memory/session-recall/query.d.ts +15 -0
- package/dist/extensions/memory/session-recall/query.js +38 -0
- package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
- package/dist/extensions/memory/session-recall/rank.js +85 -0
- package/dist/extensions/memory/session-recall/search.d.ts +159 -0
- package/dist/extensions/memory/session-recall/search.js +682 -0
- package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
- package/dist/extensions/memory/session-recall/stats.js +67 -0
- package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
- package/dist/extensions/memory/session-recall/text-utils.js +184 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
- package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
- package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
- package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
- package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
- package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
- package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
- package/dist/extensions/memory/three-memory-stores/index.js +436 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
- package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
- package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
- package/dist/extensions/memory/three-memory-stores/types.js +2 -0
- package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
- package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
- package/dist/extensions/orchestrator/index.d.ts +19 -0
- package/dist/extensions/orchestrator/index.js +796 -0
- package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
- package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
- package/dist/extensions/scheduling/timer/index.d.ts +102 -0
- package/dist/extensions/scheduling/timer/index.js +1143 -0
- package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
- package/dist/extensions/scheduling/timer/poller.js +135 -0
- package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
- package/dist/extensions/scheduling/timer/recovery.js +445 -0
- package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
- package/dist/extensions/scheduling/timer/store-file.js +59 -0
- package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
- package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
- package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
- package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
- package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
- package/dist/extensions/self/auto-recovery/index.js +89 -0
- package/dist/extensions/self/error-tracking/index.d.ts +3 -0
- package/dist/extensions/self/error-tracking/index.js +244 -0
- package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
- package/dist/extensions/self/health-maintenance/format.js +60 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
- package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
- package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
- package/dist/extensions/self/health-maintenance/helpers.js +67 -0
- package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
- package/dist/extensions/self/health-maintenance/index.js +238 -0
- package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
- package/dist/extensions/self/health-maintenance/types.js +2 -0
- package/dist/extensions/self/latent-activator/index.d.ts +12 -0
- package/dist/extensions/self/latent-activator/index.js +173 -0
- package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
- package/dist/extensions/self/latent-activator/mixes.js +20 -0
- package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
- package/dist/extensions/self/latent-activator/signals.js +228 -0
- package/dist/extensions/self/latent-activator/state.d.ts +43 -0
- package/dist/extensions/self/latent-activator/state.js +59 -0
- package/dist/extensions/self/latent-activator/types.d.ts +8 -0
- package/dist/extensions/self/latent-activator/types.js +8 -0
- package/dist/extensions/self/watchdog/config.d.ts +4 -0
- package/dist/extensions/self/watchdog/config.js +79 -0
- package/dist/extensions/self/watchdog/engine.d.ts +256 -0
- package/dist/extensions/self/watchdog/engine.js +935 -0
- package/dist/extensions/self/watchdog/index.d.ts +23 -0
- package/dist/extensions/self/watchdog/index.js +485 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +81 -0
- package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
- package/dist/lib/ai/consolidated-claim-critic.js +191 -0
- package/dist/lib/ai/cost-report.d.ts +83 -0
- package/dist/lib/ai/cost-report.js +116 -0
- package/dist/lib/ai/critic-cache.d.ts +57 -0
- package/dist/lib/ai/critic-cache.js +100 -0
- package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
- package/dist/lib/ai/critic-fallbacks.js +75 -0
- package/dist/lib/ai/critic-gate.d.ts +75 -0
- package/dist/lib/ai/critic-gate.js +81 -0
- package/dist/lib/ai/critic-helpers.d.ts +26 -0
- package/dist/lib/ai/critic-helpers.js +131 -0
- package/dist/lib/ai/critic-registry.d.ts +417 -0
- package/dist/lib/ai/critic-registry.js +639 -0
- package/dist/lib/ai/critic-stats.d.ts +78 -0
- package/dist/lib/ai/critic-stats.js +90 -0
- package/dist/lib/ai/judge-budget.d.ts +138 -0
- package/dist/lib/ai/judge-budget.js +143 -0
- package/dist/lib/ai/language-hint.d.ts +21 -0
- package/dist/lib/ai/language-hint.js +58 -0
- package/dist/lib/ai/llm-call.d.ts +141 -0
- package/dist/lib/ai/llm-call.js +745 -0
- package/dist/lib/ai/model-resolver.d.ts +90 -0
- package/dist/lib/ai/model-resolver.js +185 -0
- package/dist/lib/ai/models-init.d.ts +46 -0
- package/dist/lib/ai/models-init.js +65 -0
- package/dist/lib/ai/payload-hygiene.d.ts +74 -0
- package/dist/lib/ai/payload-hygiene.js +240 -0
- package/dist/lib/ai/post-loop-classify.d.ts +128 -0
- package/dist/lib/ai/post-loop-classify.js +87 -0
- package/dist/lib/ai/text-classifier.d.ts +142 -0
- package/dist/lib/ai/text-classifier.js +548 -0
- package/dist/lib/cognitive/hints.d.ts +33 -0
- package/dist/lib/cognitive/hints.js +223 -0
- package/dist/lib/cognitive/openspec.d.ts +29 -0
- package/dist/lib/cognitive/openspec.js +108 -0
- package/dist/lib/config/braid-paths.d.ts +188 -0
- package/dist/lib/config/braid-paths.js +340 -0
- package/dist/lib/config/braid-settings.d.ts +489 -0
- package/dist/lib/config/braid-settings.js +938 -0
- package/dist/lib/config/per-tool-settings.d.ts +95 -0
- package/dist/lib/config/per-tool-settings.js +161 -0
- package/dist/lib/config/session-profiles.d.ts +68 -0
- package/dist/lib/config/session-profiles.js +143 -0
- package/dist/lib/constants/injection-details.d.ts +30 -0
- package/dist/lib/constants/injection-details.js +30 -0
- package/dist/lib/constants/session-thresholds.d.ts +42 -0
- package/dist/lib/constants/session-thresholds.js +54 -0
- package/dist/lib/constants/tool-constants.d.ts +11 -0
- package/dist/lib/constants/tool-constants.js +12 -0
- package/dist/lib/core/event-names.d.ts +23 -0
- package/dist/lib/core/event-names.js +26 -0
- package/dist/lib/core/logger.d.ts +102 -0
- package/dist/lib/core/logger.js +274 -0
- package/dist/lib/detection/compression-strategy.d.ts +38 -0
- package/dist/lib/detection/compression-strategy.js +147 -0
- package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
- package/dist/lib/detection/consolidated-topic-critic.js +132 -0
- package/dist/lib/detection/context-density.d.ts +70 -0
- package/dist/lib/detection/context-density.js +193 -0
- package/dist/lib/detection/context-thresholds.d.ts +88 -0
- package/dist/lib/detection/context-thresholds.js +107 -0
- package/dist/lib/detection/context-tiers.d.ts +80 -0
- package/dist/lib/detection/context-tiers.js +144 -0
- package/dist/lib/detection/context-usage.d.ts +75 -0
- package/dist/lib/detection/context-usage.js +209 -0
- package/dist/lib/detection/degradation-detector.d.ts +74 -0
- package/dist/lib/detection/degradation-detector.js +454 -0
- package/dist/lib/detection/test-burst.d.ts +77 -0
- package/dist/lib/detection/test-burst.js +126 -0
- package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
- package/dist/lib/detection/tool-loop-detector.js +302 -0
- package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
- package/dist/lib/detection/topic-drift-detector.js +252 -0
- package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
- package/dist/lib/enforcement/adherence-meter.js +420 -0
- package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
- package/dist/lib/enforcement/turn-dedup.js +195 -0
- package/dist/lib/errors/llm-error.d.ts +79 -0
- package/dist/lib/errors/llm-error.js +241 -0
- package/dist/lib/events/consolidation-channel.d.ts +109 -0
- package/dist/lib/events/consolidation-channel.js +374 -0
- package/dist/lib/events/consolidation-scoring.d.ts +59 -0
- package/dist/lib/events/consolidation-scoring.js +95 -0
- package/dist/lib/events/event-bus.d.ts +123 -0
- package/dist/lib/events/event-bus.js +108 -0
- package/dist/lib/events/event-types.d.ts +39 -0
- package/dist/lib/events/event-types.js +30 -0
- package/dist/lib/events/timer-bus.d.ts +21 -0
- package/dist/lib/events/timer-bus.js +41 -0
- package/dist/lib/events/timer-types.d.ts +64 -0
- package/dist/lib/events/timer-types.js +8 -0
- package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
- package/dist/lib/events/turn-end-coordinator.js +89 -0
- package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
- package/dist/lib/harness/failure-trace-collector.js +114 -0
- package/dist/lib/harness/index.d.ts +20 -0
- package/dist/lib/harness/index.js +21 -0
- package/dist/lib/harness/types.d.ts +85 -0
- package/dist/lib/harness/types.js +20 -0
- package/dist/lib/harness/weakness-miner.d.ts +29 -0
- package/dist/lib/harness/weakness-miner.js +165 -0
- package/dist/lib/memory/constants.d.ts +11 -0
- package/dist/lib/memory/constants.js +29 -0
- package/dist/lib/memory/index.d.ts +147 -0
- package/dist/lib/memory/index.js +564 -0
- package/dist/lib/memory/lifecycle.d.ts +50 -0
- package/dist/lib/memory/lifecycle.js +139 -0
- package/dist/lib/memory/past-insights.d.ts +35 -0
- package/dist/lib/memory/past-insights.js +189 -0
- package/dist/lib/memory/storage.d.ts +38 -0
- package/dist/lib/memory/storage.js +167 -0
- package/dist/lib/memory/store-lock.d.ts +23 -0
- package/dist/lib/memory/store-lock.js +69 -0
- package/dist/lib/memory/store-merge.d.ts +38 -0
- package/dist/lib/memory/store-merge.js +73 -0
- package/dist/lib/memory/types.d.ts +65 -0
- package/dist/lib/memory/types.js +5 -0
- package/dist/lib/memory/utils.d.ts +35 -0
- package/dist/lib/memory/utils.js +156 -0
- package/dist/lib/memory/write-log.d.ts +85 -0
- package/dist/lib/memory/write-log.js +124 -0
- package/dist/lib/memory/write-quality.d.ts +197 -0
- package/dist/lib/memory/write-quality.js +314 -0
- package/dist/lib/orchestrator/branch.d.ts +63 -0
- package/dist/lib/orchestrator/branch.js +192 -0
- package/dist/lib/orchestrator/index.d.ts +14 -0
- package/dist/lib/orchestrator/index.js +11 -0
- package/dist/lib/orchestrator/locks.d.ts +46 -0
- package/dist/lib/orchestrator/locks.js +122 -0
- package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
- package/dist/lib/orchestrator/slop-scanner.js +207 -0
- package/dist/lib/orchestrator/workers.d.ts +453 -0
- package/dist/lib/orchestrator/workers.js +1001 -0
- package/dist/lib/public.d.ts +18 -0
- package/dist/lib/public.js +23 -0
- package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
- package/dist/lib/reasoning/advice-tracker.js +177 -0
- package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
- package/dist/lib/reasoning/belief-policy-engine.js +268 -0
- package/dist/lib/reasoning/belief-types.d.ts +32 -0
- package/dist/lib/reasoning/belief-types.js +8 -0
- package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
- package/dist/lib/reasoning/classifier-offline.js +75 -0
- package/dist/lib/reasoning/dreamer.d.ts +37 -0
- package/dist/lib/reasoning/dreamer.js +169 -0
- package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
- package/dist/lib/reasoning/nudge-analytics.js +62 -0
- package/dist/lib/reasoning/policy-rules.d.ts +18 -0
- package/dist/lib/reasoning/policy-rules.js +153 -0
- package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
- package/dist/lib/reasoning/reasoning-metrics.js +174 -0
- package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
- package/dist/lib/reasoning/reasoning-summary.js +122 -0
- package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
- package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
- package/dist/lib/state/async-storage.d.ts +52 -0
- package/dist/lib/state/async-storage.js +171 -0
- package/dist/lib/state/extension-state.d.ts +184 -0
- package/dist/lib/state/extension-state.js +373 -0
- package/dist/lib/state/global-state.d.ts +358 -0
- package/dist/lib/state/global-state.js +741 -0
- package/dist/lib/state/metacognitive-state.d.ts +21 -0
- package/dist/lib/state/metacognitive-state.js +50 -0
- package/dist/lib/state/session-manager.d.ts +32 -0
- package/dist/lib/state/session-manager.js +11 -0
- package/dist/lib/state/session-start-queue.d.ts +42 -0
- package/dist/lib/state/session-start-queue.js +105 -0
- package/dist/lib/state/state-checkpoint.d.ts +72 -0
- package/dist/lib/state/state-checkpoint.js +252 -0
- package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
- package/dist/lib/state/telegram-poller-liveness.js +67 -0
- package/dist/lib/state/tool-provenance.d.ts +22 -0
- package/dist/lib/state/tool-provenance.js +25 -0
- package/dist/lib/state/workspace-snapshot.d.ts +111 -0
- package/dist/lib/state/workspace-snapshot.js +372 -0
- package/dist/lib/store/belief-store.d.ts +112 -0
- package/dist/lib/store/belief-store.js +252 -0
- package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
- package/dist/lib/store/bidirectional-verifier.js +242 -0
- package/dist/lib/store/claim-tracker.d.ts +66 -0
- package/dist/lib/store/claim-tracker.js +276 -0
- package/dist/lib/store/conflict-qa.d.ts +96 -0
- package/dist/lib/store/conflict-qa.js +283 -0
- package/dist/lib/store/evidence-pool.d.ts +185 -0
- package/dist/lib/store/evidence-pool.js +598 -0
- package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
- package/dist/lib/telemetry/context-heartbeat.js +449 -0
- package/dist/lib/telemetry/drift-signals.d.ts +46 -0
- package/dist/lib/telemetry/drift-signals.js +75 -0
- package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
- package/dist/lib/telemetry/rss-telemetry.js +53 -0
- package/dist/lib/types/episode-types.d.ts +31 -0
- package/dist/lib/types/episode-types.js +9 -0
- package/dist/lib/types/standard-result.d.ts +32 -0
- package/dist/lib/types/standard-result.js +22 -0
- package/dist/lib/utils/async-fs.d.ts +17 -0
- package/dist/lib/utils/async-fs.js +22 -0
- package/dist/lib/utils/bounded.d.ts +38 -0
- package/dist/lib/utils/bounded.js +59 -0
- package/dist/lib/utils/dedup.d.ts +40 -0
- package/dist/lib/utils/dedup.js +43 -0
- package/dist/lib/utils/error-guard.d.ts +15 -0
- package/dist/lib/utils/error-guard.js +22 -0
- package/dist/lib/utils/extension-utils.d.ts +36 -0
- package/dist/lib/utils/extension-utils.js +65 -0
- package/dist/lib/utils/extract-json.d.ts +23 -0
- package/dist/lib/utils/extract-json.js +90 -0
- package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
- package/dist/lib/utils/file-mutation-queue.js +150 -0
- package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
- package/dist/lib/utils/filter-safe-to-remove.js +256 -0
- package/dist/lib/utils/format-tool-result.d.ts +47 -0
- package/dist/lib/utils/format-tool-result.js +88 -0
- package/dist/lib/utils/id.d.ts +44 -0
- package/dist/lib/utils/id.js +59 -0
- package/dist/lib/utils/injection-tracker.d.ts +317 -0
- package/dist/lib/utils/injection-tracker.js +840 -0
- package/dist/lib/utils/local-time.d.ts +57 -0
- package/dist/lib/utils/local-time.js +181 -0
- package/dist/lib/utils/memory-fence.d.ts +55 -0
- package/dist/lib/utils/memory-fence.js +66 -0
- package/dist/lib/utils/sop-extractor.d.ts +75 -0
- package/dist/lib/utils/sop-extractor.js +259 -0
- package/dist/lib/utils/sop-suggestion.d.ts +34 -0
- package/dist/lib/utils/sop-suggestion.js +336 -0
- package/dist/lib/utils/wake-gate.d.ts +151 -0
- package/dist/lib/utils/wake-gate.js +265 -0
- package/dist/lib/utils/whisper-format.d.ts +95 -0
- package/dist/lib/utils/whisper-format.js +115 -0
- package/dist/lib/verification/coordination-checker.d.ts +72 -0
- package/dist/lib/verification/coordination-checker.js +126 -0
- package/dist/loader/api.d.ts +19 -0
- package/dist/loader/api.js +114 -0
- package/dist/loader/loader.d.ts +85 -0
- package/dist/loader/loader.js +534 -0
- package/docs/BEGINNERS.md +144 -0
- package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
- package/docs/CONTEXT-MAP.md +220 -0
- package/docs/CONTEXT-POLICY.md +86 -0
- package/docs/HISTORY.md +110 -0
- package/docs/LOCAL_DEV.md +246 -0
- package/docs/ROADMAP.md +107 -0
- package/docs/SETUP.md +459 -0
- package/package.json +97 -4
- package/skills/agent-testing/SKILL.md +214 -0
- package/skills/braid-reference/SKILL.md +88 -0
- package/skills/code-refactoring/SKILL.md +211 -0
- package/skills/code-search/SKILL.md +14 -0
- package/skills/documentation/SKILL.md +89 -0
- package/skills/dox/AGENTS.md.template +83 -0
- package/skills/dox/SKILL.md +86 -0
- package/skills/healthcheck/SKILL.md +65 -0
- package/skills/herdr-topology/SKILL.md +269 -0
- package/skills/meta-cognition/SKILL.md +24 -0
- package/skills/meta-improvement/SKILL.md +180 -0
- package/skills/misdirection-audit/SKILL.md +66 -0
- package/skills/pi-reference/SKILL.md +104 -0
- package/skills/placement-discipline/SKILL.md +69 -0
- package/skills/probe-evaluation/SKILL.md +85 -0
- package/skills/release-pipeline/SKILL.md +191 -0
- package/skills/research/SKILL.md +166 -0
- package/skills/skill-usage/SKILL.md +81 -0
- package/skills/software-engineer/SKILL.md +83 -0
- package/skills/subagent-orchestration/SKILL.md +454 -0
- package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
- package/skills/subagent-verification/SKILL.md +127 -0
- package/skills/tone-quality/SKILL.md +176 -0
- package/skills/voice-replies/SKILL.md +125 -0
- package/src/AGENTS.md +111 -0
- package/src/extensions/cognitive/AGENTS.md +29 -0
- package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
- package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
- package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
- package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
- package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
- package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
- package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
- package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
- package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
- package/src/extensions/cognitive/metacognition/index.ts +109 -0
- package/src/extensions/cognitive/reasoning/index.ts +168 -0
- package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
- package/src/extensions/cognitive/topic-drift/index.ts +429 -0
- package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
- package/src/extensions/context-management/README.md +102 -0
- package/src/extensions/context-management/index.ts +383 -0
- package/src/extensions/core/AGENTS.md +34 -0
- package/src/extensions/core/agent-environment/index.ts +135 -0
- package/src/extensions/core/polyfill/index.ts +617 -0
- package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
- package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
- package/src/extensions/core/prompt-builder/context-section.ts +120 -0
- package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
- package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
- package/src/extensions/core/prompt-builder/identity.ts +98 -0
- package/src/extensions/core/prompt-builder/index.ts +602 -0
- package/src/extensions/core/prompt-builder/inspect.ts +227 -0
- package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
- package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
- package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
- package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
- package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
- package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
- package/src/extensions/core/prompt-builder/section.ts +150 -0
- package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
- package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
- package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
- package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
- package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
- package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
- package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
- package/src/extensions/core/skills-tool/index.ts +240 -0
- package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
- package/src/extensions/core/skills-tool/session-records.ts +328 -0
- package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
- package/src/extensions/enforcement/AGENTS.md +69 -0
- package/src/extensions/enforcement/detection/malformed.ts +42 -0
- package/src/extensions/enforcement/detection/verification.ts +52 -0
- package/src/extensions/enforcement/enforcement-types.ts +42 -0
- package/src/extensions/enforcement/handler-registry.ts +225 -0
- package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
- package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
- package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
- package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
- package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
- package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
- package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
- package/src/extensions/enforcement/handlers/blocking.ts +50 -0
- package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
- package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
- package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
- package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
- package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
- package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
- package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
- package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
- package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
- package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
- package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
- package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
- package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
- package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
- package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
- package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
- package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
- package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
- package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
- package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
- package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
- package/src/extensions/enforcement/index.ts +28 -0
- package/src/extensions/enforcement/judge-utils.ts +106 -0
- package/src/extensions/enforcement/nudge-manager.ts +298 -0
- package/src/extensions/enforcement/self-state-claims.ts +204 -0
- package/src/extensions/enforcement/session-health.ts +317 -0
- package/src/extensions/enforcement/signals.ts +88 -0
- package/src/extensions/enforcement/similarity.ts +76 -0
- package/src/extensions/enforcement/state.ts +115 -0
- package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
- package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
- package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
- package/src/extensions/enforcement/substate/session-state.ts +79 -0
- package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
- package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
- package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
- package/src/extensions/enforcement/task-evidence.ts +436 -0
- package/src/extensions/enforcement/types.ts +38 -0
- package/src/extensions/enforcement/validation.ts +194 -0
- package/src/extensions/enforcement/verification-judge.ts +317 -0
- package/src/extensions/enforcement/whisper.ts +120 -0
- package/src/extensions/heartbeat/AGENTS.md +47 -0
- package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
- package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
- package/src/extensions/heartbeat/analytics/core.ts +222 -0
- package/src/extensions/heartbeat/analytics/format.ts +144 -0
- package/src/extensions/heartbeat/analytics/index.ts +373 -0
- package/src/extensions/heartbeat/analytics/shared.ts +149 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
- package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
- package/src/extensions/manifest.ts +293 -0
- package/src/extensions/memory/AGENTS.md +93 -0
- package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
- package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
- package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
- package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
- package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
- package/src/extensions/memory/context-lifecycle/state.ts +165 -0
- package/src/extensions/memory/context-lifecycle/types.ts +441 -0
- package/src/extensions/memory/context-manager/analysis.ts +344 -0
- package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
- package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
- package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
- package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
- package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
- package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
- package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
- package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
- package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
- package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
- package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
- package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
- package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
- package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
- package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
- package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
- package/src/extensions/memory/context-manager/index.ts +111 -0
- package/src/extensions/memory/context-manager/pruning.ts +479 -0
- package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
- package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
- package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
- package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
- package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
- package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
- package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
- package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
- package/src/extensions/memory/scratchpad/format.ts +161 -0
- package/src/extensions/memory/scratchpad/handlers.ts +601 -0
- package/src/extensions/memory/scratchpad/index.ts +230 -0
- package/src/extensions/memory/scratchpad/persistence.ts +374 -0
- package/src/extensions/memory/scratchpad/types.ts +149 -0
- package/src/extensions/memory/scratchpad/utils.ts +268 -0
- package/src/extensions/memory/session-recall/AGENTS.md +104 -0
- package/src/extensions/memory/session-recall/analyze.ts +605 -0
- package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
- package/src/extensions/memory/session-recall/index.ts +956 -0
- package/src/extensions/memory/session-recall/query.ts +44 -0
- package/src/extensions/memory/session-recall/rank.ts +121 -0
- package/src/extensions/memory/session-recall/search.ts +801 -0
- package/src/extensions/memory/session-recall/stats.ts +93 -0
- package/src/extensions/memory/session-recall/text-utils.ts +209 -0
- package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
- package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
- package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
- package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
- package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
- package/src/extensions/memory/three-memory-stores/index.ts +549 -0
- package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
- package/src/extensions/memory/three-memory-stores/types.ts +74 -0
- package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
- package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
- package/src/extensions/orchestrator/index.ts +1141 -0
- package/src/extensions/scheduling/AGENTS.md +26 -0
- package/src/extensions/scheduling/timer/AGENTS.md +259 -0
- package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
- package/src/extensions/scheduling/timer/index.ts +1331 -0
- package/src/extensions/scheduling/timer/poller.ts +138 -0
- package/src/extensions/scheduling/timer/recovery.ts +462 -0
- package/src/extensions/scheduling/timer/store-file.ts +59 -0
- package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
- package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
- package/src/extensions/self/AGENTS.md +30 -0
- package/src/extensions/self/auto-recovery/index.ts +112 -0
- package/src/extensions/self/error-tracking/AGENTS.md +38 -0
- package/src/extensions/self/error-tracking/index.ts +299 -0
- package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
- package/src/extensions/self/health-maintenance/format.ts +87 -0
- package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
- package/src/extensions/self/health-maintenance/helpers.ts +78 -0
- package/src/extensions/self/health-maintenance/index.ts +308 -0
- package/src/extensions/self/health-maintenance/types.ts +14 -0
- package/src/extensions/self/latent-activator/AGENTS.md +64 -0
- package/src/extensions/self/latent-activator/index.ts +206 -0
- package/src/extensions/self/latent-activator/mixes.ts +22 -0
- package/src/extensions/self/latent-activator/signals.ts +237 -0
- package/src/extensions/self/latent-activator/state.ts +79 -0
- package/src/extensions/self/latent-activator/types.ts +47 -0
- package/src/extensions/self/watchdog/AGENTS.md +27 -0
- package/src/extensions/self/watchdog/config.ts +73 -0
- package/src/extensions/self/watchdog/engine.ts +1246 -0
- package/src/extensions/self/watchdog/index.ts +577 -0
- package/src/index.ts +93 -0
- package/src/lib/AGENTS.md +39 -0
- package/src/lib/ai/AGENTS.md +37 -0
- package/src/lib/ai/consolidated-claim-critic.ts +287 -0
- package/src/lib/ai/cost-report.ts +206 -0
- package/src/lib/ai/critic-cache.ts +122 -0
- package/src/lib/ai/critic-fallbacks.ts +74 -0
- package/src/lib/ai/critic-gate.ts +135 -0
- package/src/lib/ai/critic-helpers.ts +135 -0
- package/src/lib/ai/critic-registry.ts +754 -0
- package/src/lib/ai/critic-stats.ts +158 -0
- package/src/lib/ai/judge-budget.ts +241 -0
- package/src/lib/ai/language-hint.ts +70 -0
- package/src/lib/ai/llm-call.ts +975 -0
- package/src/lib/ai/model-resolver.ts +224 -0
- package/src/lib/ai/models-init.ts +68 -0
- package/src/lib/ai/payload-hygiene.ts +265 -0
- package/src/lib/ai/post-loop-classify.ts +185 -0
- package/src/lib/ai/text-classifier.ts +746 -0
- package/src/lib/cognitive/AGENTS.md +40 -0
- package/src/lib/cognitive/hints.ts +254 -0
- package/src/lib/cognitive/openspec.ts +124 -0
- package/src/lib/config/AGENTS.md +17 -0
- package/src/lib/config/braid-paths.ts +401 -0
- package/src/lib/config/braid-settings.ts +1442 -0
- package/src/lib/config/per-tool-settings.ts +197 -0
- package/src/lib/config/session-profiles.ts +165 -0
- package/src/lib/constants/AGENTS.md +15 -0
- package/src/lib/constants/injection-details.ts +32 -0
- package/src/lib/constants/session-thresholds.ts +64 -0
- package/src/lib/constants/tool-constants.ts +16 -0
- package/src/lib/core/AGENTS.md +23 -0
- package/src/lib/core/event-names.ts +31 -0
- package/src/lib/core/logger.ts +334 -0
- package/src/lib/detection/AGENTS.md +21 -0
- package/src/lib/detection/compression-strategy.ts +183 -0
- package/src/lib/detection/consolidated-topic-critic.ts +188 -0
- package/src/lib/detection/context-density.ts +237 -0
- package/src/lib/detection/context-thresholds.ts +132 -0
- package/src/lib/detection/context-tiers.ts +201 -0
- package/src/lib/detection/context-usage.ts +270 -0
- package/src/lib/detection/degradation-detector.ts +583 -0
- package/src/lib/detection/test-burst.ts +170 -0
- package/src/lib/detection/tool-loop-detector.ts +364 -0
- package/src/lib/detection/topic-drift-detector.ts +323 -0
- package/src/lib/enforcement/AGENTS.md +20 -0
- package/src/lib/enforcement/adherence-meter.ts +578 -0
- package/src/lib/enforcement/turn-dedup.ts +246 -0
- package/src/lib/errors/llm-error.ts +288 -0
- package/src/lib/events/AGENTS.md +23 -0
- package/src/lib/events/consolidation-channel.ts +493 -0
- package/src/lib/events/consolidation-scoring.ts +112 -0
- package/src/lib/events/event-bus.ts +213 -0
- package/src/lib/events/event-types.ts +53 -0
- package/src/lib/events/timer-bus.ts +53 -0
- package/src/lib/events/timer-types.ts +64 -0
- package/src/lib/events/turn-end-coordinator.ts +108 -0
- package/src/lib/harness/AGENTS.md +20 -0
- package/src/lib/harness/failure-trace-collector.ts +157 -0
- package/src/lib/harness/index.ts +41 -0
- package/src/lib/harness/types.ts +122 -0
- package/src/lib/harness/weakness-miner.ts +209 -0
- package/src/lib/memory/AGENTS.md +36 -0
- package/src/lib/memory/constants.ts +34 -0
- package/src/lib/memory/index.ts +705 -0
- package/src/lib/memory/lifecycle.ts +159 -0
- package/src/lib/memory/past-insights.ts +221 -0
- package/src/lib/memory/storage.ts +187 -0
- package/src/lib/memory/store-lock.ts +70 -0
- package/src/lib/memory/store-merge.ts +100 -0
- package/src/lib/memory/types.ts +82 -0
- package/src/lib/memory/utils.ts +173 -0
- package/src/lib/memory/write-log.ts +174 -0
- package/src/lib/memory/write-quality.ts +383 -0
- package/src/lib/orchestrator/branch.ts +193 -0
- package/src/lib/orchestrator/index.ts +78 -0
- package/src/lib/orchestrator/locks.ts +160 -0
- package/src/lib/orchestrator/slop-scanner.ts +258 -0
- package/src/lib/orchestrator/workers.ts +1382 -0
- package/src/lib/public.ts +43 -0
- package/src/lib/reasoning/AGENTS.md +25 -0
- package/src/lib/reasoning/advice-tracker.ts +244 -0
- package/src/lib/reasoning/belief-policy-engine.ts +342 -0
- package/src/lib/reasoning/belief-types.ts +45 -0
- package/src/lib/reasoning/classifier-offline.ts +111 -0
- package/src/lib/reasoning/dreamer.ts +215 -0
- package/src/lib/reasoning/nudge-analytics.ts +85 -0
- package/src/lib/reasoning/policy-rules.ts +172 -0
- package/src/lib/reasoning/reasoning-metrics.ts +202 -0
- package/src/lib/reasoning/reasoning-summary.ts +154 -0
- package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
- package/src/lib/state/AGENTS.md +192 -0
- package/src/lib/state/async-storage.ts +189 -0
- package/src/lib/state/extension-state.ts +419 -0
- package/src/lib/state/global-state.ts +1046 -0
- package/src/lib/state/metacognitive-state.ts +65 -0
- package/src/lib/state/session-manager.ts +43 -0
- package/src/lib/state/session-start-queue.ts +135 -0
- package/src/lib/state/state-checkpoint.ts +352 -0
- package/src/lib/state/telegram-poller-liveness.ts +75 -0
- package/src/lib/state/tool-provenance.ts +26 -0
- package/src/lib/state/workspace-snapshot.ts +466 -0
- package/src/lib/store/AGENTS.md +24 -0
- package/src/lib/store/belief-store.ts +325 -0
- package/src/lib/store/bidirectional-verifier.ts +316 -0
- package/src/lib/store/claim-tracker.ts +382 -0
- package/src/lib/store/conflict-qa.ts +385 -0
- package/src/lib/store/evidence-pool.ts +779 -0
- package/src/lib/telemetry/AGENTS.md +28 -0
- package/src/lib/telemetry/context-heartbeat.ts +555 -0
- package/src/lib/telemetry/drift-signals.ts +105 -0
- package/src/lib/telemetry/rss-telemetry.ts +57 -0
- package/src/lib/types/AGENTS.md +21 -0
- package/src/lib/types/episode-types.ts +31 -0
- package/src/lib/types/standard-result.ts +40 -0
- package/src/lib/utils/AGENTS.md +30 -0
- package/src/lib/utils/async-fs.ts +23 -0
- package/src/lib/utils/bounded.ts +58 -0
- package/src/lib/utils/dedup.ts +44 -0
- package/src/lib/utils/error-guard.ts +27 -0
- package/src/lib/utils/extension-utils.ts +72 -0
- package/src/lib/utils/extract-json.ts +89 -0
- package/src/lib/utils/file-mutation-queue.ts +172 -0
- package/src/lib/utils/filter-safe-to-remove.ts +301 -0
- package/src/lib/utils/format-tool-result.ts +109 -0
- package/src/lib/utils/id.ts +64 -0
- package/src/lib/utils/injection-tracker.ts +1014 -0
- package/src/lib/utils/local-time.ts +196 -0
- package/src/lib/utils/memory-fence.ts +70 -0
- package/src/lib/utils/sop-extractor.ts +329 -0
- package/src/lib/utils/sop-suggestion.ts +426 -0
- package/src/lib/utils/wake-gate.ts +318 -0
- package/src/lib/utils/whisper-format.ts +120 -0
- package/src/lib/verification/coordination-checker.ts +183 -0
- package/src/loader/AGENTS.md +32 -0
- package/src/loader/api.ts +138 -0
- package/src/loader/loader.ts +600 -0
- package/src/types/extension-context.d.ts +85 -0
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
export const NATIVE_SECTION_POLICY = [
|
|
2
|
+
{
|
|
3
|
+
key: "preamble",
|
|
4
|
+
disposition: "replaced",
|
|
5
|
+
reason: "braid's stable group is published as customPrompt and rendered as the preamble; the generic native preamble is not reused",
|
|
6
|
+
},
|
|
7
|
+
{
|
|
8
|
+
key: "tools",
|
|
9
|
+
disposition: "replaced",
|
|
10
|
+
reason: "braid's tools section renders owned guideline rows; descriptions ride the API tools channel",
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
key: "rules",
|
|
14
|
+
disposition: "replaced",
|
|
15
|
+
reason: "braid's guidelines section owns the cross-tool rules",
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
key: "docs",
|
|
19
|
+
disposition: "dropped",
|
|
20
|
+
reason: "the pi-reference skill owns pi's docs index and paths; the prompt carries only a pointer to that skill",
|
|
21
|
+
},
|
|
22
|
+
{
|
|
23
|
+
key: "addendum",
|
|
24
|
+
disposition: "preserved",
|
|
25
|
+
reason: "appendSystemPrompt is re-appended as braid's deduped append section; the native option is emptied so it is not rendered twice",
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
key: "project_context",
|
|
29
|
+
disposition: "replaced",
|
|
30
|
+
reason: "pointer-only project docs, read on demand; contextFiles is emptied so the native inline content is not injected",
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
key: "skills",
|
|
34
|
+
disposition: "replaced",
|
|
35
|
+
reason: "list_skills serves discovery; the skills collection is emptied so no catalog is inlined",
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
key: "cwd",
|
|
39
|
+
disposition: "rendered",
|
|
40
|
+
reason: "pi renders cwd unconditionally; the compact Instance line carries cwd, model, and session as well",
|
|
41
|
+
},
|
|
42
|
+
{
|
|
43
|
+
key: "sections",
|
|
44
|
+
disposition: "rendered",
|
|
45
|
+
reason: "caller entries are read from the options and rendered into braid's stable group; the map is then replaced by braid's own named sections",
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
key: "promptGuidelines",
|
|
49
|
+
disposition: "dropped",
|
|
50
|
+
reason: "options-level embedder bullets; braid owns its guideline set and the CLI leaves this empty",
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
key: "customPrompt",
|
|
54
|
+
disposition: "dropped",
|
|
55
|
+
reason: "a user .pi/SYSTEM.md is never read: braid's identity is the product, and the slot carries braid's stable group (documented policy)",
|
|
56
|
+
},
|
|
57
|
+
];
|
|
58
|
+
const LISTED = new Set(NATIVE_SECTION_POLICY.map((entry) => entry.key));
|
|
59
|
+
/**
|
|
60
|
+
* Native section keys with no recorded disposition, sorted and deduplicated.
|
|
61
|
+
* Empty means every key pi rendered is an explicit braid decision.
|
|
62
|
+
*/
|
|
63
|
+
export function unlistedNativeSections(nativeKeys) {
|
|
64
|
+
return [...new Set(nativeKeys)].filter((key) => !LISTED.has(key)).sort();
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=section-parity.js.map
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Publish braid's composed prompt through pi's section seam.
|
|
3
|
+
*
|
|
4
|
+
* braid publishes through the section seam rather than a single opaque
|
|
5
|
+
* `systemPrompt`: one string would re-send the whole head prompt on any
|
|
6
|
+
* change, while named sections are diffed against the transcript, so a change
|
|
7
|
+
* re-sends that section alone.
|
|
8
|
+
*
|
|
9
|
+
* Publishing splits braid's prompt in two:
|
|
10
|
+
* - the stable group rides `customPrompt`, which pi renders as the untagged
|
|
11
|
+
* `preamble` and which suppresses pi's native preamble, tools, rules, and
|
|
12
|
+
* docs;
|
|
13
|
+
* - the turn-to-turn text rides named `sections` entries, each wrapped in a
|
|
14
|
+
* tag of its own name.
|
|
15
|
+
*
|
|
16
|
+
* Native sections braid replaces would otherwise reach the model, so they
|
|
17
|
+
* are neutralized here. Caller-supplied
|
|
18
|
+
* section entries are replaced as well: the caller must have read them out
|
|
19
|
+
* first (the handler renders them inside the stable group), because pi renders
|
|
20
|
+
* every `sections` entry verbatim and leaving them in the map would render
|
|
21
|
+
* each one twice.
|
|
22
|
+
*/
|
|
23
|
+
import type { NormalizedBuildSystemPromptOptions } from "@earendil-works/pi-coding-agent";
|
|
24
|
+
/**
|
|
25
|
+
* Write braid's sections into the live prompt options. Mutates in place: pi
|
|
26
|
+
* hands the handler a normalized, mutable options object and reads it back
|
|
27
|
+
* after every handler has run.
|
|
28
|
+
*/
|
|
29
|
+
export declare function publishPromptSections(options: NormalizedBuildSystemPromptOptions, stablePrompt: string, volatileSections: Record<string, string>): void;
|
|
30
|
+
//# sourceMappingURL=section-publish.d.ts.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Write braid's sections into the live prompt options. Mutates in place: pi
|
|
3
|
+
* hands the handler a normalized, mutable options object and reads it back
|
|
4
|
+
* after every handler has run.
|
|
5
|
+
*/
|
|
6
|
+
export function publishPromptSections(options, stablePrompt, volatileSections) {
|
|
7
|
+
// project_context: braid renders pointer-only project docs, read on demand.
|
|
8
|
+
options.contextFiles = [];
|
|
9
|
+
// skills: list_skills serves discovery; no skill catalog is inlined.
|
|
10
|
+
options.skills = [];
|
|
11
|
+
// addendum: braid re-appends appendSystemPrompt as its own deduped section.
|
|
12
|
+
options.appendSystemPrompt = "";
|
|
13
|
+
options.sections = volatileSections;
|
|
14
|
+
options.customPrompt = stablePrompt;
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=section-publish.js.map
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PromptSection - canonical primitive for assembling the system prompt.
|
|
3
|
+
*
|
|
4
|
+
* Replaces the mixed patterns of `parts.push`, `lines.push`,
|
|
5
|
+
* `addGuideline`, and inline template literals with a single contract:
|
|
6
|
+
*
|
|
7
|
+
* 1. Every section is a `PromptSection`.
|
|
8
|
+
* 2. Every section renders to a single string (never an array).
|
|
9
|
+
* 3. Sections know their own boundaries and formatting.
|
|
10
|
+
* 4. The main handler composes sections with `composeSections(sections)`.
|
|
11
|
+
* 5. Dedup is opt-in via `linesSection(..., { dedup: true })`.
|
|
12
|
+
*
|
|
13
|
+
* The primitive is intentionally small. Helpers like `linesSection`
|
|
14
|
+
* and `headingSection` are layered on top in the consuming files.
|
|
15
|
+
*/
|
|
16
|
+
/**
|
|
17
|
+
* A self-contained string rendered into the system prompt.
|
|
18
|
+
* Sections know their own boundaries and produce one string.
|
|
19
|
+
*/
|
|
20
|
+
export interface PromptSection {
|
|
21
|
+
/** Stable name for logs and tests. */
|
|
22
|
+
readonly name: string;
|
|
23
|
+
/**
|
|
24
|
+
* Render the section. Return "" (or a string that trims to "")
|
|
25
|
+
* to omit the section entirely. May be async.
|
|
26
|
+
*/
|
|
27
|
+
render(): string | Promise<string>;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Compose an ordered list of sections with a section separator.
|
|
31
|
+
* Empty sections (after trim) are dropped. Default separator is the
|
|
32
|
+
* canonical double newline used by the rest of the prompt-builder.
|
|
33
|
+
*
|
|
34
|
+
* If `dedupSet` is provided, sections whose rendered output is already
|
|
35
|
+
* in the set are skipped, and the set is updated with each kept section.
|
|
36
|
+
* This is the canonical primitive for `appendSystemPrompt`-style dedup
|
|
37
|
+
* (where user-provided content may duplicate a static section).
|
|
38
|
+
*/
|
|
39
|
+
export declare function composeSections(sections: readonly PromptSection[], separator?: string, dedupSet?: Set<string>): Promise<string>;
|
|
40
|
+
/**
|
|
41
|
+
* Compose sections into a `name -> text` map, with the same empty-skip and
|
|
42
|
+
* dedup semantics as `composeSections`. For callers that need the sections
|
|
43
|
+
* kept apart rather than joined: pi's prompt options carry a `sections`
|
|
44
|
+
* record whose entries it wraps and diffs individually, so a change to one
|
|
45
|
+
* entry re-sends that entry alone.
|
|
46
|
+
*
|
|
47
|
+
* A section whose text was already consumed by `dedupSet` is omitted from the
|
|
48
|
+
* map, so the caller can omit it the way `composeSections` would.
|
|
49
|
+
*/
|
|
50
|
+
export declare function composeSectionMap(sections: readonly PromptSection[], dedupSet?: Set<string>): Promise<Record<string, string>>;
|
|
51
|
+
/**
|
|
52
|
+
* A single block of text. Trims the content; emits "" if empty.
|
|
53
|
+
* Use for sections that have no internal structure (identity, footer,
|
|
54
|
+
* interaction style, etc.).
|
|
55
|
+
*/
|
|
56
|
+
export declare function simpleSection(name: string, content: string): PromptSection;
|
|
57
|
+
/**
|
|
58
|
+
* A section that joins an ordered list of lines with "\n".
|
|
59
|
+
*
|
|
60
|
+
* - Trims each line and drops empties.
|
|
61
|
+
* - `dedup: true` skips duplicate lines.
|
|
62
|
+
* - Use for guideline lists and other line-shaped sections.
|
|
63
|
+
*/
|
|
64
|
+
export declare function linesSection(name: string, lines: readonly string[], opts?: {
|
|
65
|
+
dedup?: boolean;
|
|
66
|
+
}): PromptSection;
|
|
67
|
+
/**
|
|
68
|
+
* A section with a markdown heading prefix.
|
|
69
|
+
*
|
|
70
|
+
* - Renders to `## ${heading}\n${body}`.
|
|
71
|
+
* - Returns "" if the body (after trim) is empty.
|
|
72
|
+
* - Use for headed sections (project-docs block, etc.).
|
|
73
|
+
*/
|
|
74
|
+
export declare function headingSection(name: string, heading: string, body: string): PromptSection;
|
|
75
|
+
//# sourceMappingURL=section.d.ts.map
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PromptSection - canonical primitive for assembling the system prompt.
|
|
3
|
+
*
|
|
4
|
+
* Replaces the mixed patterns of `parts.push`, `lines.push`,
|
|
5
|
+
* `addGuideline`, and inline template literals with a single contract:
|
|
6
|
+
*
|
|
7
|
+
* 1. Every section is a `PromptSection`.
|
|
8
|
+
* 2. Every section renders to a single string (never an array).
|
|
9
|
+
* 3. Sections know their own boundaries and formatting.
|
|
10
|
+
* 4. The main handler composes sections with `composeSections(sections)`.
|
|
11
|
+
* 5. Dedup is opt-in via `linesSection(..., { dedup: true })`.
|
|
12
|
+
*
|
|
13
|
+
* The primitive is intentionally small. Helpers like `linesSection`
|
|
14
|
+
* and `headingSection` are layered on top in the consuming files.
|
|
15
|
+
*/
|
|
16
|
+
/**
|
|
17
|
+
* Compose an ordered list of sections with a section separator.
|
|
18
|
+
* Empty sections (after trim) are dropped. Default separator is the
|
|
19
|
+
* canonical double newline used by the rest of the prompt-builder.
|
|
20
|
+
*
|
|
21
|
+
* If `dedupSet` is provided, sections whose rendered output is already
|
|
22
|
+
* in the set are skipped, and the set is updated with each kept section.
|
|
23
|
+
* This is the canonical primitive for `appendSystemPrompt`-style dedup
|
|
24
|
+
* (where user-provided content may duplicate a static section).
|
|
25
|
+
*/
|
|
26
|
+
export async function composeSections(sections, separator = "\n\n", dedupSet) {
|
|
27
|
+
const parts = [];
|
|
28
|
+
for (const s of sections) {
|
|
29
|
+
const text = (await s.render()).trim();
|
|
30
|
+
if (!text)
|
|
31
|
+
continue;
|
|
32
|
+
if (dedupSet) {
|
|
33
|
+
if (dedupSet.has(text))
|
|
34
|
+
continue;
|
|
35
|
+
dedupSet.add(text);
|
|
36
|
+
}
|
|
37
|
+
parts.push(text);
|
|
38
|
+
}
|
|
39
|
+
return parts.join(separator);
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Compose sections into a `name -> text` map, with the same empty-skip and
|
|
43
|
+
* dedup semantics as `composeSections`. For callers that need the sections
|
|
44
|
+
* kept apart rather than joined: pi's prompt options carry a `sections`
|
|
45
|
+
* record whose entries it wraps and diffs individually, so a change to one
|
|
46
|
+
* entry re-sends that entry alone.
|
|
47
|
+
*
|
|
48
|
+
* A section whose text was already consumed by `dedupSet` is omitted from the
|
|
49
|
+
* map, so the caller can omit it the way `composeSections` would.
|
|
50
|
+
*/
|
|
51
|
+
export async function composeSectionMap(sections, dedupSet) {
|
|
52
|
+
const map = {};
|
|
53
|
+
for (const s of sections) {
|
|
54
|
+
const text = (await s.render()).trim();
|
|
55
|
+
if (!text)
|
|
56
|
+
continue;
|
|
57
|
+
if (dedupSet) {
|
|
58
|
+
if (dedupSet.has(text))
|
|
59
|
+
continue;
|
|
60
|
+
dedupSet.add(text);
|
|
61
|
+
}
|
|
62
|
+
map[s.name] = text;
|
|
63
|
+
}
|
|
64
|
+
return map;
|
|
65
|
+
}
|
|
66
|
+
// Section builders. Canonical ways to construct a PromptSection; each
|
|
67
|
+
// enforces one rule: the section returns a single string. Internal line
|
|
68
|
+
// arrangement is the builder's concern; the section as a whole is opaque
|
|
69
|
+
// to the top-level handler.
|
|
70
|
+
/**
|
|
71
|
+
* A single block of text. Trims the content; emits "" if empty.
|
|
72
|
+
* Use for sections that have no internal structure (identity, footer,
|
|
73
|
+
* interaction style, etc.).
|
|
74
|
+
*/
|
|
75
|
+
export function simpleSection(name, content) {
|
|
76
|
+
return {
|
|
77
|
+
name,
|
|
78
|
+
render: () => content.trim(),
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* A section that joins an ordered list of lines with "\n".
|
|
83
|
+
*
|
|
84
|
+
* - Trims each line and drops empties.
|
|
85
|
+
* - `dedup: true` skips duplicate lines.
|
|
86
|
+
* - Use for guideline lists and other line-shaped sections.
|
|
87
|
+
*/
|
|
88
|
+
export function linesSection(name, lines, opts = {}) {
|
|
89
|
+
return {
|
|
90
|
+
name,
|
|
91
|
+
render: () => {
|
|
92
|
+
const seen = opts.dedup ? new Set() : null;
|
|
93
|
+
const out = [];
|
|
94
|
+
for (const l of lines) {
|
|
95
|
+
const t = l.trim();
|
|
96
|
+
if (!t)
|
|
97
|
+
continue;
|
|
98
|
+
if (seen) {
|
|
99
|
+
if (seen.has(t))
|
|
100
|
+
continue;
|
|
101
|
+
seen.add(t);
|
|
102
|
+
}
|
|
103
|
+
out.push(t);
|
|
104
|
+
}
|
|
105
|
+
return out.join("\n");
|
|
106
|
+
},
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* A section with a markdown heading prefix.
|
|
111
|
+
*
|
|
112
|
+
* - Renders to `## ${heading}\n${body}`.
|
|
113
|
+
* - Returns "" if the body (after trim) is empty.
|
|
114
|
+
* - Use for headed sections (project-docs block, etc.).
|
|
115
|
+
*/
|
|
116
|
+
export function headingSection(name, heading, body) {
|
|
117
|
+
return {
|
|
118
|
+
name,
|
|
119
|
+
render: () => {
|
|
120
|
+
const trimmed = body.trim();
|
|
121
|
+
if (!trimmed)
|
|
122
|
+
return "";
|
|
123
|
+
return `## ${heading}\n${trimmed}`;
|
|
124
|
+
},
|
|
125
|
+
};
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=section.js.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type PromptSection } from "./section.js";
|
|
2
|
+
/**
|
|
3
|
+
* Surface-discipline block, rendered as its own prompt section.
|
|
4
|
+
*
|
|
5
|
+
* Text-quality contract for the non-prose surfaces: code comments, commits,
|
|
6
|
+
* tests, docs, reports, logs. COMMUNICATION speaks of sentences and chat;
|
|
7
|
+
* this block names the non-prose surfaces and supplies a positive why-test
|
|
8
|
+
* instead of a prohibition list. The text is pinned verbatim by the lockstep
|
|
9
|
+
* test — no paraphrasing here either.
|
|
10
|
+
*/
|
|
11
|
+
export declare const SURFACE_DISCIPLINE = "Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why \u2014 code that needs a what-narration is rewritten, not annotated. Never commit internal task IDs, wave or phase labels, or session-ephemeral figures: a future reader has no context for them. Internal labels present in task text or briefs are never copied into code, tests, comments, docs, or commit messages \u2014 the only sanctioned seats for wave context are a report's filename and title and the commit subject. Write any spec or brief so a teammate with zero context can act on it.";
|
|
12
|
+
/**
|
|
13
|
+
* Its own section: the handler places it between the identity block and the
|
|
14
|
+
* identity-core block — render order: COMMUNICATION ��� SURFACE_DISCIPLINE
|
|
15
|
+
* → EPISTEMIC_STANCE.
|
|
16
|
+
*/
|
|
17
|
+
export declare function surfaceDisciplineSection(): PromptSection;
|
|
18
|
+
//# sourceMappingURL=surface-discipline-section.d.ts.map
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { simpleSection } from "./section.js";
|
|
2
|
+
/**
|
|
3
|
+
* Surface-discipline block, rendered as its own prompt section.
|
|
4
|
+
*
|
|
5
|
+
* Text-quality contract for the non-prose surfaces: code comments, commits,
|
|
6
|
+
* tests, docs, reports, logs. COMMUNICATION speaks of sentences and chat;
|
|
7
|
+
* this block names the non-prose surfaces and supplies a positive why-test
|
|
8
|
+
* instead of a prohibition list. The text is pinned verbatim by the lockstep
|
|
9
|
+
* test — no paraphrasing here either.
|
|
10
|
+
*/
|
|
11
|
+
export const SURFACE_DISCIPLINE = `Signal discipline binds every surface you produce: code comments, commit messages, tests, docs, reports, logs. A comment earns its place only by explaining why — code that needs a what-narration is rewritten, not annotated. Never commit internal task IDs, wave or phase labels, or session-ephemeral figures: a future reader has no context for them. Internal labels present in task text or briefs are never copied into code, tests, comments, docs, or commit messages — the only sanctioned seats for wave context are a report's filename and title and the commit subject. Write any spec or brief so a teammate with zero context can act on it.`;
|
|
12
|
+
/**
|
|
13
|
+
* Its own section: the handler places it between the identity block and the
|
|
14
|
+
* identity-core block — render order: COMMUNICATION ��� SURFACE_DISCIPLINE
|
|
15
|
+
* → EPISTEMIC_STANCE.
|
|
16
|
+
*/
|
|
17
|
+
export function surfaceDisciplineSection() {
|
|
18
|
+
return simpleSection("surface-discipline", SURFACE_DISCIPLINE);
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=surface-discipline-section.js.map
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* System Info Tool — returns the runtime environment on demand.
|
|
3
|
+
*
|
|
4
|
+
* Extracts the Instance section (Agent version, pi-core version, paths,
|
|
5
|
+
* OS, session stats, extensions, other instances) from the system prompt
|
|
6
|
+
* into a read-on-demand tool. The prompt keeps only a compact one-line
|
|
7
|
+
* orientation (version | cwd | session) at the bottom; the full Instance
|
|
8
|
+
* block lives here.
|
|
9
|
+
*
|
|
10
|
+
* This saves ~60-100+ tokens per prompt turn while keeping the data
|
|
11
|
+
* available when the agent actually needs it.
|
|
12
|
+
*/
|
|
13
|
+
import { Type } from "typebox";
|
|
14
|
+
import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
|
|
15
|
+
export declare function createSystemInfoTool(pi: ExtensionAPI): {
|
|
16
|
+
name: "system_info";
|
|
17
|
+
label: string;
|
|
18
|
+
promptSnippet: string;
|
|
19
|
+
description: string;
|
|
20
|
+
parameters: Type.TObject<{
|
|
21
|
+
detail: Type.TOptional<Type.TUnion<[Type.TLiteral<"full">, Type.TLiteral<"compact">]>>;
|
|
22
|
+
}>;
|
|
23
|
+
execute: (_toolCallId: string, params: {
|
|
24
|
+
detail?: "full" | "compact";
|
|
25
|
+
}, _signal: unknown, _onUpdate: unknown, ctx: ExtensionContext | undefined) => Promise<any>;
|
|
26
|
+
};
|
|
27
|
+
//# sourceMappingURL=system-info-tool.d.ts.map
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* System Info Tool — returns the runtime environment on demand.
|
|
3
|
+
*
|
|
4
|
+
* Extracts the Instance section (Agent version, pi-core version, paths,
|
|
5
|
+
* OS, session stats, extensions, other instances) from the system prompt
|
|
6
|
+
* into a read-on-demand tool. The prompt keeps only a compact one-line
|
|
7
|
+
* orientation (version | cwd | session) at the bottom; the full Instance
|
|
8
|
+
* block lives here.
|
|
9
|
+
*
|
|
10
|
+
* This saves ~60-100+ tokens per prompt turn while keeping the data
|
|
11
|
+
* available when the agent actually needs it.
|
|
12
|
+
*/
|
|
13
|
+
import { Type } from "typebox";
|
|
14
|
+
import { gatherInstanceData, renderInstance } from "./instance-composition.js";
|
|
15
|
+
const systemInfoSchema = Type.Object({
|
|
16
|
+
detail: Type.Optional(Type.Union([Type.Literal("full"), Type.Literal("compact")], {
|
|
17
|
+
description: '"full" (default) returns the complete Instance block with extensions and other instances. ' +
|
|
18
|
+
'"compact" returns only the essentials (version, core, cwd, session).',
|
|
19
|
+
default: "full",
|
|
20
|
+
})),
|
|
21
|
+
});
|
|
22
|
+
export function createSystemInfoTool(pi) {
|
|
23
|
+
return {
|
|
24
|
+
name: "system_info",
|
|
25
|
+
label: "System Info",
|
|
26
|
+
promptSnippet: "Show the runtime environment: versions, paths, session stats, extensions",
|
|
27
|
+
description: "Show the runtime environment: versions, paths, OS, session stats, extensions, other Pi instances; " +
|
|
28
|
+
"detail='compact' for essentials.",
|
|
29
|
+
parameters: systemInfoSchema,
|
|
30
|
+
execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
|
|
31
|
+
if (!ctx) {
|
|
32
|
+
return {
|
|
33
|
+
content: [{ type: "text", text: "system_info requires a valid context." }],
|
|
34
|
+
details: { error: "no_context" },
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
const data = await gatherInstanceData(pi, ctx, {
|
|
38
|
+
skillCount: 0,
|
|
39
|
+
skillDirs: [],
|
|
40
|
+
skills: [],
|
|
41
|
+
memoryCount: 0,
|
|
42
|
+
});
|
|
43
|
+
const raw = await renderInstance(data);
|
|
44
|
+
if (params.detail === "compact") {
|
|
45
|
+
// Compact mode: identity, paths, session, environment lines
|
|
46
|
+
const lines = raw.split("\n");
|
|
47
|
+
const compact = lines.filter((l) => {
|
|
48
|
+
return (l.startsWith("Agent:") ||
|
|
49
|
+
l.startsWith("Core:") ||
|
|
50
|
+
l.startsWith("Cwd:") ||
|
|
51
|
+
l.startsWith("Settings:") ||
|
|
52
|
+
l.startsWith("Session:") ||
|
|
53
|
+
l.startsWith("OS:") ||
|
|
54
|
+
l.startsWith("Started:") ||
|
|
55
|
+
l.startsWith("PID:"));
|
|
56
|
+
});
|
|
57
|
+
return {
|
|
58
|
+
content: [{ type: "text", text: compact.join("\n") }],
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
content: [{ type: "text", text: raw }],
|
|
63
|
+
};
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=system-info-tool.js.map
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool-description trim — progressive
|
|
3
|
+
* disclosure for third-party npm extensions whose registered tool
|
|
4
|
+
* descriptions are long.
|
|
5
|
+
*
|
|
6
|
+
* MECHANISM NOTE: the registered
|
|
7
|
+
* `description` reaches the model through the API tools channel —
|
|
8
|
+
* wrapToolDefinition copies it by value into the AgentTool that lands in
|
|
9
|
+
* agent.state.tools, and the provider payload carries it verbatim. There is
|
|
10
|
+
* no earlier interception point an extension legitimately has:
|
|
11
|
+
* - `pi.registerTool` same-name re-registration cannot work: the runner
|
|
12
|
+
* keeps the FIRST registration per name across extensions (braid loads
|
|
13
|
+
* before pi-herdr per the settings packages order, so braid would shadow
|
|
14
|
+
* the real tool's execute; a late registration is silently ignored).
|
|
15
|
+
* - `pi.getAllTools()` returns copies; no live-definition accessor and no
|
|
16
|
+
* `refreshTools` is exposed on the extension API.
|
|
17
|
+
* - `transformContext` sees messages only; `before_agent_start` shapes the
|
|
18
|
+
* system prompt, which braid's toolsSection already renders as one line
|
|
19
|
+
* per tool from the tool's own `promptGuidelines[0]`.
|
|
20
|
+
* `before_provider_request` is the official seam: it fires after the
|
|
21
|
+
* provider-specific payload is built and a returned payload replaces the
|
|
22
|
+
* request. This module rewrites ONLY the `description` field of tools whose
|
|
23
|
+
* name matches the trim rules below; names, parameters, and every other
|
|
24
|
+
* field pass through untouched. Input objects are never mutated — changed
|
|
25
|
+
* entries are shallow-copied.
|
|
26
|
+
*
|
|
27
|
+
* Dependency-inversion compatibility: descriptions remain owned by the
|
|
28
|
+
* registering package. The curated strings below only SHORTEN the channel
|
|
29
|
+
* form and point at the herdr-topology SKILL for the deep form
|
|
30
|
+
* (progressive disclosure). The when-gate ("only when the user explicitly
|
|
31
|
+
* mentions Herdr") is load-bearing and preserved in every rewrite.
|
|
32
|
+
*
|
|
33
|
+
* The rewrite is deterministic per tool name, so provider prompt caching is
|
|
34
|
+
* stable across turns after the first trimmed request.
|
|
35
|
+
*/
|
|
36
|
+
/**
|
|
37
|
+
* Curated tools-channel descriptions, 1-2 lines per tool. Keyed by tool
|
|
38
|
+
* name; currently covers @ogulcancelik/pi-herdr (layout/pane/agent).
|
|
39
|
+
*/
|
|
40
|
+
export declare const TRIM_TOOL_DESCRIPTIONS: Record<string, string>;
|
|
41
|
+
/**
|
|
42
|
+
* Resolve the trimmed description for one tool.
|
|
43
|
+
* Returns undefined when the tool must pass through unchanged:
|
|
44
|
+
* curated map miss that is not a herdr_* tool, empty/absent description,
|
|
45
|
+
* or an already-short herdr description (owner's own short form wins).
|
|
46
|
+
*/
|
|
47
|
+
export declare function trimToolDescription(name: string, description: string): string | undefined;
|
|
48
|
+
/**
|
|
49
|
+
* before_provider_request handler body. Rewrites tool descriptions in the
|
|
50
|
+
* provider payload for trimmed tools; returns a new payload when anything
|
|
51
|
+
* changed, undefined otherwise (runner contract: undefined = unchanged).
|
|
52
|
+
* Handles both OpenAI-compat ({type:"function",function:{...}}) and
|
|
53
|
+
* flat ({name, description, input_schema}) tool shapes. Never throws.
|
|
54
|
+
*/
|
|
55
|
+
export declare function trimProviderTools(payload: unknown): unknown | undefined;
|
|
56
|
+
//# sourceMappingURL=tool-description-trim.d.ts.map
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tool-description trim — progressive
|
|
3
|
+
* disclosure for third-party npm extensions whose registered tool
|
|
4
|
+
* descriptions are long.
|
|
5
|
+
*
|
|
6
|
+
* MECHANISM NOTE: the registered
|
|
7
|
+
* `description` reaches the model through the API tools channel —
|
|
8
|
+
* wrapToolDefinition copies it by value into the AgentTool that lands in
|
|
9
|
+
* agent.state.tools, and the provider payload carries it verbatim. There is
|
|
10
|
+
* no earlier interception point an extension legitimately has:
|
|
11
|
+
* - `pi.registerTool` same-name re-registration cannot work: the runner
|
|
12
|
+
* keeps the FIRST registration per name across extensions (braid loads
|
|
13
|
+
* before pi-herdr per the settings packages order, so braid would shadow
|
|
14
|
+
* the real tool's execute; a late registration is silently ignored).
|
|
15
|
+
* - `pi.getAllTools()` returns copies; no live-definition accessor and no
|
|
16
|
+
* `refreshTools` is exposed on the extension API.
|
|
17
|
+
* - `transformContext` sees messages only; `before_agent_start` shapes the
|
|
18
|
+
* system prompt, which braid's toolsSection already renders as one line
|
|
19
|
+
* per tool from the tool's own `promptGuidelines[0]`.
|
|
20
|
+
* `before_provider_request` is the official seam: it fires after the
|
|
21
|
+
* provider-specific payload is built and a returned payload replaces the
|
|
22
|
+
* request. This module rewrites ONLY the `description` field of tools whose
|
|
23
|
+
* name matches the trim rules below; names, parameters, and every other
|
|
24
|
+
* field pass through untouched. Input objects are never mutated — changed
|
|
25
|
+
* entries are shallow-copied.
|
|
26
|
+
*
|
|
27
|
+
* Dependency-inversion compatibility: descriptions remain owned by the
|
|
28
|
+
* registering package. The curated strings below only SHORTEN the channel
|
|
29
|
+
* form and point at the herdr-topology SKILL for the deep form
|
|
30
|
+
* (progressive disclosure). The when-gate ("only when the user explicitly
|
|
31
|
+
* mentions Herdr") is load-bearing and preserved in every rewrite.
|
|
32
|
+
*
|
|
33
|
+
* The rewrite is deterministic per tool name, so provider prompt caching is
|
|
34
|
+
* stable across turns after the first trimmed request.
|
|
35
|
+
*/
|
|
36
|
+
/**
|
|
37
|
+
* Curated tools-channel descriptions, 1-2 lines per tool. Keyed by tool
|
|
38
|
+
* name; currently covers @ogulcancelik/pi-herdr (layout/pane/agent).
|
|
39
|
+
*/
|
|
40
|
+
export const TRIM_TOOL_DESCRIPTIONS = {
|
|
41
|
+
herdr_layout: "Create/inspect Herdr terminal topology (workspaces, tabs, panes; layout only, never starts agents or commands). Use only when the user explicitly mentions Herdr. Read pane IDs from results; deep procedures live in the herdr-topology skill.",
|
|
42
|
+
herdr_pane: "Raw Herdr terminal pane control: run, read, wait_output, send_text/send_keys, inspect, close. Use only when the user explicitly mentions Herdr; prefer herdr_agent for recognized coding agents. Deep procedures: herdr-topology skill.",
|
|
43
|
+
herdr_agent: "Drive a recognized coding agent in an existing Herdr pane: start, prompt, wait, read, send_keys. Use only when the user explicitly mentions Herdr; needs an available shell pane from herdr_layout first. Deep procedures: herdr-topology skill.",
|
|
44
|
+
};
|
|
45
|
+
/** Third-party family the trim applies to (prefix match for the fallback). */
|
|
46
|
+
const TRIMMED_PREFIX = "herdr_";
|
|
47
|
+
/** The when-gate is load-bearing. */
|
|
48
|
+
const HERDR_GATE = "Use only when the user explicitly mentions Herdr";
|
|
49
|
+
/** Skill pointer appended to fallback trims (progressive disclosure home). */
|
|
50
|
+
const SKILL_POINTER = "Deep procedures: herdr-topology skill.";
|
|
51
|
+
/** Fallback trim applies only to descriptions longer than this. */
|
|
52
|
+
const FALLBACK_MAX_CHARS = 240;
|
|
53
|
+
/** Cap the description to its leading sentences within maxChars. */
|
|
54
|
+
function firstSentences(text, maxChars) {
|
|
55
|
+
const sentences = text.split(/(?<=[.!?])\s+/);
|
|
56
|
+
let out = "";
|
|
57
|
+
for (const sentence of sentences) {
|
|
58
|
+
if (out && (out + " " + sentence).length > maxChars)
|
|
59
|
+
break;
|
|
60
|
+
out = out ? `${out} ${sentence}` : sentence;
|
|
61
|
+
}
|
|
62
|
+
if (!out)
|
|
63
|
+
out = text.slice(0, maxChars);
|
|
64
|
+
return out.length > maxChars ? `${out.slice(0, maxChars - 3)}...` : out;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Resolve the trimmed description for one tool.
|
|
68
|
+
* Returns undefined when the tool must pass through unchanged:
|
|
69
|
+
* curated map miss that is not a herdr_* tool, empty/absent description,
|
|
70
|
+
* or an already-short herdr description (owner's own short form wins).
|
|
71
|
+
*/
|
|
72
|
+
export function trimToolDescription(name, description) {
|
|
73
|
+
const curated = TRIM_TOOL_DESCRIPTIONS[name];
|
|
74
|
+
if (curated !== undefined)
|
|
75
|
+
return curated;
|
|
76
|
+
if (!name.startsWith(TRIMMED_PREFIX))
|
|
77
|
+
return undefined;
|
|
78
|
+
if (!description)
|
|
79
|
+
return undefined;
|
|
80
|
+
if (description.length <= FALLBACK_MAX_CHARS)
|
|
81
|
+
return undefined;
|
|
82
|
+
return `${firstSentences(description, FALLBACK_MAX_CHARS)} ${HERDR_GATE}. ${SKILL_POINTER}`;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* before_provider_request handler body. Rewrites tool descriptions in the
|
|
86
|
+
* provider payload for trimmed tools; returns a new payload when anything
|
|
87
|
+
* changed, undefined otherwise (runner contract: undefined = unchanged).
|
|
88
|
+
* Handles both OpenAI-compat ({type:"function",function:{...}}) and
|
|
89
|
+
* flat ({name, description, input_schema}) tool shapes. Never throws.
|
|
90
|
+
*/
|
|
91
|
+
export function trimProviderTools(payload) {
|
|
92
|
+
try {
|
|
93
|
+
if (typeof payload !== "object" || payload === null)
|
|
94
|
+
return undefined;
|
|
95
|
+
const tools = payload.tools;
|
|
96
|
+
if (!Array.isArray(tools) || tools.length === 0)
|
|
97
|
+
return undefined;
|
|
98
|
+
let changed = false;
|
|
99
|
+
const newTools = tools.map((tool) => {
|
|
100
|
+
if (typeof tool !== "object" || tool === null)
|
|
101
|
+
return tool;
|
|
102
|
+
const entry = tool;
|
|
103
|
+
const fn = typeof entry.function === "object" && entry.function !== null
|
|
104
|
+
? entry.function
|
|
105
|
+
: undefined;
|
|
106
|
+
const name = fn ? fn.name : entry.name;
|
|
107
|
+
if (typeof name !== "string" || name.length === 0)
|
|
108
|
+
return tool;
|
|
109
|
+
const description = fn ? fn.description : entry.description;
|
|
110
|
+
if (typeof description !== "string" || description.length === 0)
|
|
111
|
+
return tool;
|
|
112
|
+
const trimmed = trimToolDescription(name, description);
|
|
113
|
+
if (trimmed === undefined || trimmed === description)
|
|
114
|
+
return tool;
|
|
115
|
+
changed = true;
|
|
116
|
+
if (fn)
|
|
117
|
+
return { ...entry, function: { ...fn, description: trimmed } };
|
|
118
|
+
return { ...entry, description: trimmed };
|
|
119
|
+
});
|
|
120
|
+
if (!changed)
|
|
121
|
+
return undefined;
|
|
122
|
+
return { ...payload, tools: newTools };
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
// Any anomaly leaves the payload untouched — the request must go out.
|
|
126
|
+
return undefined;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
//# sourceMappingURL=tool-description-trim.js.map
|