@draht/coding-agent 2026.7.30 → 2026.9.5-1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +154 -0
- package/README.md +46 -2
- package/agents/debugger.md +12 -1
- package/agents/git-committer.md +1 -0
- package/agents/implementer.md +20 -0
- package/agents/investigator.md +75 -0
- package/agents/reviewer.md +7 -0
- package/agents/spec-reviewer.md +66 -0
- package/agents/verifier.md +4 -3
- package/bin/draht-tools.cjs +472 -41
- package/dist/agents/debugger.md +12 -1
- package/dist/agents/git-committer.md +1 -0
- package/dist/agents/implementer.md +20 -0
- package/dist/agents/investigator.md +75 -0
- package/dist/agents/reviewer.md +7 -0
- package/dist/agents/spec-reviewer.md +66 -0
- package/dist/agents/verifier.md +4 -3
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +69 -2
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/attach-mode.d.ts +61 -0
- package/dist/cli/attach-mode.d.ts.map +1 -1
- package/dist/cli/attach-mode.js +243 -5
- package/dist/cli/attach-mode.js.map +1 -1
- package/dist/cli/credential-print.d.ts +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +5 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/config.d.ts +9 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +31 -4
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +17 -1
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +87 -30
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +1 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +1 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +35 -16
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +149 -64
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +5 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +72 -15
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/builtins/checkpoints.d.ts +20 -0
- package/dist/core/builtins/checkpoints.d.ts.map +1 -0
- package/dist/core/builtins/checkpoints.js +161 -0
- package/dist/core/builtins/checkpoints.js.map +1 -0
- package/dist/core/builtins/duet.d.ts +26 -0
- package/dist/core/builtins/duet.d.ts.map +1 -0
- package/dist/core/builtins/duet.js +660 -0
- package/dist/core/builtins/duet.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +7 -1
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts +24 -4
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +278 -35
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.js +78 -0
- package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.js +865 -0
- package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
- package/dist/core/checkpoints/rewind.d.ts +141 -0
- package/dist/core/checkpoints/rewind.d.ts.map +1 -0
- package/dist/core/checkpoints/rewind.js +246 -0
- package/dist/core/checkpoints/rewind.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts +1 -1
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +9 -4
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -0
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +25 -4
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/extensions/index.d.ts +1 -1
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +83 -20
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +13 -2
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +37 -2
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +189 -6
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +7 -0
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +5 -0
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +1 -0
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-registry.d.ts +3 -2
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +8 -8
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +34 -7
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +7 -1
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +30 -10
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
- package/dist/core/multi-agent/permission-gate.js +4 -3
- package/dist/core/multi-agent/permission-gate.js.map +1 -1
- package/dist/core/multi-agent/worktree.d.ts +2 -0
- package/dist/core/multi-agent/worktree.d.ts.map +1 -1
- package/dist/core/multi-agent/worktree.js +2 -2
- package/dist/core/multi-agent/worktree.js.map +1 -1
- package/dist/core/package-manager.d.ts +7 -1
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +21 -44
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/permission-relay/index.d.ts +19 -0
- package/dist/core/permission-relay/index.d.ts.map +1 -0
- package/dist/core/permission-relay/index.js +49 -0
- package/dist/core/permission-relay/index.js.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.js +788 -0
- package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
- package/dist/core/permission-relay/types.d.ts +222 -0
- package/dist/core/permission-relay/types.d.ts.map +1 -0
- package/dist/core/permission-relay/types.js +15 -0
- package/dist/core/permission-relay/types.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +14 -0
- package/dist/core/pi-manifest.d.ts.map +1 -0
- package/dist/core/pi-manifest.js +35 -0
- package/dist/core/pi-manifest.js.map +1 -0
- package/dist/core/project-trust.js +2 -2
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/resource-loader.d.ts +21 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +101 -24
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sandbox/bash-operations.d.ts +149 -0
- package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
- package/dist/core/sandbox/bash-operations.js +163 -0
- package/dist/core/sandbox/bash-operations.js.map +1 -0
- package/dist/core/sandbox/env.d.ts +83 -0
- package/dist/core/sandbox/env.d.ts.map +1 -0
- package/dist/core/sandbox/env.js +123 -0
- package/dist/core/sandbox/env.js.map +1 -0
- package/dist/core/sandbox/executor.d.ts +104 -0
- package/dist/core/sandbox/executor.d.ts.map +1 -0
- package/dist/core/sandbox/executor.js +92 -0
- package/dist/core/sandbox/executor.js.map +1 -0
- package/dist/core/sandbox/index.d.ts +36 -0
- package/dist/core/sandbox/index.d.ts.map +1 -0
- package/dist/core/sandbox/index.js +36 -0
- package/dist/core/sandbox/index.js.map +1 -0
- package/dist/core/sandbox/linux.d.ts +121 -0
- package/dist/core/sandbox/linux.d.ts.map +1 -0
- package/dist/core/sandbox/linux.js +260 -0
- package/dist/core/sandbox/linux.js.map +1 -0
- package/dist/core/sandbox/policy.d.ts +142 -0
- package/dist/core/sandbox/policy.d.ts.map +1 -0
- package/dist/core/sandbox/policy.js +297 -0
- package/dist/core/sandbox/policy.js.map +1 -0
- package/dist/core/sandbox/real-path.d.ts +112 -0
- package/dist/core/sandbox/real-path.d.ts.map +1 -0
- package/dist/core/sandbox/real-path.js +158 -0
- package/dist/core/sandbox/real-path.js.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.js +239 -0
- package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
- package/dist/core/sandbox/seatbelt.d.ts +95 -0
- package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt.js +154 -0
- package/dist/core/sandbox/seatbelt.js.map +1 -0
- package/dist/core/sandbox/self-test.d.ts +109 -0
- package/dist/core/sandbox/self-test.d.ts.map +1 -0
- package/dist/core/sandbox/self-test.js +369 -0
- package/dist/core/sandbox/self-test.js.map +1 -0
- package/dist/core/sandbox/spawn.d.ts +33 -0
- package/dist/core/sandbox/spawn.d.ts.map +1 -0
- package/dist/core/sandbox/spawn.js +87 -0
- package/dist/core/sandbox/spawn.js.map +1 -0
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +3 -1
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +60 -1
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +53 -6
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +21 -0
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +36 -16
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +3 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +19 -6
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +1 -0
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/soak/soak-log.d.ts +298 -0
- package/dist/core/soak/soak-log.d.ts.map +1 -0
- package/dist/core/soak/soak-log.js +660 -0
- package/dist/core/soak/soak-log.js.map +1 -0
- package/dist/core/soak/soak-reader.d.ts +60 -0
- package/dist/core/soak/soak-reader.d.ts.map +1 -0
- package/dist/core/soak/soak-reader.js +106 -0
- package/dist/core/soak/soak-reader.js.map +1 -0
- package/dist/core/socket-server/discovery.d.ts +78 -1
- package/dist/core/socket-server/discovery.d.ts.map +1 -1
- package/dist/core/socket-server/discovery.js +356 -37
- package/dist/core/socket-server/discovery.js.map +1 -1
- package/dist/core/socket-server/index.d.ts +10 -4
- package/dist/core/socket-server/index.d.ts.map +1 -1
- package/dist/core/socket-server/index.js +6 -3
- package/dist/core/socket-server/index.js.map +1 -1
- package/dist/core/socket-server/permission-delivery.d.ts +125 -0
- package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
- package/dist/core/socket-server/permission-delivery.js +152 -0
- package/dist/core/socket-server/permission-delivery.js.map +1 -0
- package/dist/core/socket-server/permission-registry.d.ts +301 -0
- package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
- package/dist/core/socket-server/permission-registry.js +410 -0
- package/dist/core/socket-server/permission-registry.js.map +1 -0
- package/dist/core/socket-server/permission-relay.d.ts +81 -0
- package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
- package/dist/core/socket-server/permission-relay.js +528 -0
- package/dist/core/socket-server/permission-relay.js.map +1 -0
- package/dist/core/socket-server/safe-text.d.ts +83 -0
- package/dist/core/socket-server/safe-text.d.ts.map +1 -0
- package/dist/core/socket-server/safe-text.js +277 -0
- package/dist/core/socket-server/safe-text.js.map +1 -0
- package/dist/core/socket-server/session-integration.d.ts +65 -2
- package/dist/core/socket-server/session-integration.d.ts.map +1 -1
- package/dist/core/socket-server/session-integration.js +434 -32
- package/dist/core/socket-server/session-integration.js.map +1 -1
- package/dist/core/socket-server/socket-client.d.ts +21 -2
- package/dist/core/socket-server/socket-client.d.ts.map +1 -1
- package/dist/core/socket-server/socket-client.js +52 -1
- package/dist/core/socket-server/socket-client.js.map +1 -1
- package/dist/core/socket-server/socket-server.d.ts +152 -1
- package/dist/core/socket-server/socket-server.d.ts.map +1 -1
- package/dist/core/socket-server/socket-server.js +775 -26
- package/dist/core/socket-server/socket-server.js.map +1 -1
- package/dist/core/socket-server/types.d.ts +106 -2
- package/dist/core/socket-server/types.d.ts.map +1 -1
- package/dist/core/socket-server/types.js +13 -1
- package/dist/core/socket-server/types.js.map +1 -1
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +8 -9
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +1 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +5 -2
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +17 -2
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +3 -0
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +11 -18
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/trust-manager.d.ts +6 -4
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +55 -21
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +5 -1
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +5 -1
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/stub-provider/index.d.ts +9 -0
- package/dist/extensions/stub-provider/index.d.ts.map +1 -0
- package/dist/extensions/stub-provider/index.js +13 -0
- package/dist/extensions/stub-provider/index.js.map +1 -0
- package/dist/extensions/stub-provider/provider.d.ts +77 -0
- package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
- package/dist/extensions/stub-provider/provider.js +193 -0
- package/dist/extensions/stub-provider/provider.js.map +1 -0
- package/dist/hooks/gsd/draht-quality-gate.js +3 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +242 -45
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +3 -2
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +202 -5
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +10 -2
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +10 -0
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +10 -1
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +21 -5
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +97 -3
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +394 -24
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +165 -7
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +68 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +1 -12
- package/dist/prompts/commands/brainstorm.md +12 -15
- package/dist/prompts/commands/create-verification-skill.md +108 -0
- package/dist/prompts/commands/discuss-phase.md +3 -14
- package/dist/prompts/commands/execute-phase.md +3 -11
- package/dist/prompts/commands/fix.md +41 -18
- package/dist/prompts/commands/grill.md +66 -0
- package/dist/prompts/commands/init-project.md +5 -15
- package/dist/prompts/commands/map-codebase.md +1 -13
- package/dist/prompts/commands/new-project.md +5 -15
- package/dist/prompts/commands/next-milestone.md +1 -13
- package/dist/prompts/commands/orchestrate.md +1 -1
- package/dist/prompts/commands/pause-work.md +1 -13
- package/dist/prompts/commands/plan-phase.md +2 -11
- package/dist/prompts/commands/progress.md +0 -13
- package/dist/prompts/commands/quick.md +3 -11
- package/dist/prompts/commands/resolve-conflicts.md +71 -0
- package/dist/prompts/commands/resume-work.md +0 -13
- package/dist/prompts/commands/review.md +4 -13
- package/dist/prompts/commands/triage.md +159 -0
- package/dist/prompts/commands/verify-work.md +4 -14
- package/dist/prompts/commands/why.md +135 -0
- package/dist/skills/atomic-reasoning/SKILL.md +115 -0
- package/dist/skills/blast-radius/SKILL.md +55 -0
- package/dist/skills/epistemics/SKILL.md +99 -0
- package/dist/skills/hexagon-animation/SKILL.md +49 -0
- package/dist/skills/hexagon-animation/generate.mjs +81 -0
- package/dist/skills/hexagon-animation/template.html +361 -0
- package/dist/skills/typescript-discipline/SKILL.md +50 -0
- package/dist/skills/typescript-discipline/references/patterns.md +294 -0
- package/dist/skills/unslop/SKILL.md +101 -0
- package/dist/utils/canonical-path.d.ts +28 -0
- package/dist/utils/canonical-path.d.ts.map +1 -0
- package/dist/utils/canonical-path.js +90 -0
- package/dist/utils/canonical-path.js.map +1 -0
- package/dist/utils/child-process.d.ts +12 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +25 -8
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard.d.ts +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +22 -2
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js +2 -3
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/paths.d.ts +2 -7
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +13 -15
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +6 -4
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +3 -5
- package/dist/utils/tools-manager.js.map +1 -1
- package/docs/attachable-sessions.md +79 -0
- package/docs/compaction.md +21 -21
- package/docs/containerization.md +23 -23
- package/docs/custom-provider.md +16 -16
- package/docs/development.md +9 -9
- package/docs/docs.json +6 -2
- package/docs/duet.md +42 -0
- package/docs/extensions.md +58 -58
- package/docs/index.md +10 -10
- package/docs/json.md +7 -7
- package/docs/keybindings.md +6 -5
- package/docs/llama-cpp.md +6 -6
- package/docs/models.md +6 -6
- package/docs/packages.md +43 -43
- package/docs/prompt-templates.md +4 -4
- package/docs/providers.md +12 -12
- package/docs/quickstart.md +32 -32
- package/docs/rpc.md +83 -12
- package/docs/sdk.md +15 -15
- package/docs/security.md +18 -18
- package/docs/session-format.md +35 -13
- package/docs/sessions.md +17 -14
- package/docs/settings.md +25 -18
- package/docs/shell-aliases.md +2 -2
- package/docs/skills.md +12 -11
- package/docs/terminal-setup.md +12 -12
- package/docs/termux.md +6 -6
- package/docs/themes.md +11 -11
- package/docs/tmux.md +4 -4
- package/docs/tui.md +5 -5
- package/docs/usage.md +50 -50
- package/docs/windows.md +2 -2
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +11 -10
- package/prompts/commands/atomic-commit.md +1 -12
- package/prompts/commands/brainstorm.md +12 -15
- package/prompts/commands/create-verification-skill.md +108 -0
- package/prompts/commands/discuss-phase.md +3 -14
- package/prompts/commands/execute-phase.md +3 -11
- package/prompts/commands/fix.md +41 -18
- package/prompts/commands/grill.md +66 -0
- package/prompts/commands/init-project.md +5 -15
- package/prompts/commands/map-codebase.md +1 -13
- package/prompts/commands/new-project.md +5 -15
- package/prompts/commands/next-milestone.md +1 -13
- package/prompts/commands/orchestrate.md +1 -1
- package/prompts/commands/pause-work.md +1 -13
- package/prompts/commands/plan-phase.md +2 -11
- package/prompts/commands/progress.md +0 -13
- package/prompts/commands/quick.md +3 -11
- package/prompts/commands/resolve-conflicts.md +71 -0
- package/prompts/commands/resume-work.md +0 -13
- package/prompts/commands/review.md +4 -13
- package/prompts/commands/triage.md +159 -0
- package/prompts/commands/verify-work.md +4 -14
- package/prompts/commands/why.md +135 -0
- package/skills/atomic-reasoning/SKILL.md +115 -0
- package/skills/blast-radius/SKILL.md +55 -0
- package/skills/epistemics/SKILL.md +99 -0
- package/skills/hexagon-animation/SKILL.md +49 -0
- package/skills/hexagon-animation/generate.mjs +81 -0
- package/skills/hexagon-animation/template.html +361 -0
- package/skills/typescript-discipline/SKILL.md +50 -0
- package/skills/typescript-discipline/references/patterns.md +294 -0
- package/skills/unslop/SKILL.md +101 -0
- package/dist/prompts/agents/build.md +0 -86
- package/dist/prompts/agents/plan.md +0 -79
- package/dist/prompts/agents/verify.md +0 -69
- package/prompts/agents/build.md +0 -86
- package/prompts/agents/plan.md +0 -79
- package/prompts/agents/verify.md +0 -69
package/docs/docs.json
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
"path": "quickstart.md"
|
|
13
13
|
},
|
|
14
14
|
{
|
|
15
|
-
"title": "Using
|
|
15
|
+
"title": "Using Draht",
|
|
16
16
|
"path": "usage.md"
|
|
17
17
|
},
|
|
18
18
|
{
|
|
@@ -39,6 +39,10 @@
|
|
|
39
39
|
"title": "Sessions",
|
|
40
40
|
"path": "sessions.md"
|
|
41
41
|
},
|
|
42
|
+
{
|
|
43
|
+
"title": "Attachable Sessions",
|
|
44
|
+
"path": "attachable-sessions.md"
|
|
45
|
+
},
|
|
42
46
|
{
|
|
43
47
|
"title": "Compaction",
|
|
44
48
|
"path": "compaction.md"
|
|
@@ -65,7 +69,7 @@
|
|
|
65
69
|
"path": "themes.md"
|
|
66
70
|
},
|
|
67
71
|
{
|
|
68
|
-
"title": "
|
|
72
|
+
"title": "Draht Packages",
|
|
69
73
|
"path": "packages.md"
|
|
70
74
|
},
|
|
71
75
|
{
|
package/docs/duet.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Duet mode
|
|
2
|
+
|
|
3
|
+
Duet mode lets multiple authenticated models collaborate in one Draht session. Configuration and turn position are stored in the session, so `/resume`, `/tree`, and compaction continue to work normally.
|
|
4
|
+
|
|
5
|
+
## Configure
|
|
6
|
+
|
|
7
|
+
Pass two to eight comma-separated models. Optional role names use `role=model`; optional thinking levels use `model:level`.
|
|
8
|
+
|
|
9
|
+
```text
|
|
10
|
+
/duet turns implementer=openai-codex/gpt-5.5:high,reviewer=anthropic/claude-opus-4-8:high
|
|
11
|
+
/duet triage lead=openai-codex/gpt-5.5:high,reviewer=anthropic/claude-opus-4-8,tester=google/gemini-3.1-pro-preview
|
|
12
|
+
/duet status
|
|
13
|
+
/duet off
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
With no model list, `/duet turns` and `/duet triage` use the models configured by `/scoped-models` or `--models`. At least two scoped models are required.
|
|
17
|
+
|
|
18
|
+
Duet can also start from CLI flags:
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
draht \
|
|
22
|
+
--duet "lead=openai-codex/gpt-5.5,reviewer=anthropic/claude-opus-4-8" \
|
|
23
|
+
--duet-strategy triage
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Strategies
|
|
27
|
+
|
|
28
|
+
### Turn taking
|
|
29
|
+
|
|
30
|
+
`turns` rotates the active model before each new, idle user prompt. Every model receives the same persisted conversation, tool results, session tree, and working directory. Steering and follow-up messages queued during an active response stay with that response's model; rotation happens on the next prompt submitted while idle.
|
|
31
|
+
|
|
32
|
+
### Triage
|
|
33
|
+
|
|
34
|
+
`triage` makes the first participant the lead. For non-trivial requests, the lead can call `duet_delegate` to assign independent investigations to the remaining model roles concurrently. Results return as one tool result in the shared conversation, then the lead synthesizes them and performs the implementation.
|
|
35
|
+
|
|
36
|
+
Triage teammates intentionally receive only `read`, `grep`, `find`, and `ls`, and user/project extensions are disabled in their child processes. They cannot modify the shared working tree. This avoids concurrent edits and leaves one model accountable for integration. Use the existing `subagent` tool with worktree isolation when autonomous writing agents are required.
|
|
37
|
+
|
|
38
|
+
Teammates can read project content and send it to their configured providers. Choose participant providers according to the project's data policy, and do not expose secrets through project files or symlinks.
|
|
39
|
+
|
|
40
|
+
## Cost and authentication
|
|
41
|
+
|
|
42
|
+
Every participant must already be authenticated. Parallel triage assignments make concurrent provider requests and are billed independently. By default, each delegation batch requires approval through Draht's permission gate; explicit permission rules can change that behavior. Draht limits triage to one delegation batch per user prompt and records nested teammate usage in session totals. The lead is instructed to skip delegation when it would only add latency or cost.
|
package/docs/extensions.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
>
|
|
1
|
+
> draht can create extensions. Ask it to build one for your use case.
|
|
2
2
|
|
|
3
3
|
# Extensions
|
|
4
4
|
|
|
5
|
-
Extensions are TypeScript modules that extend
|
|
5
|
+
Extensions are TypeScript modules that extend draht's behavior. They can subscribe to lifecycle events, register custom tools callable by the LLM, add commands, and more.
|
|
6
6
|
|
|
7
|
-
> **Placement for /reload:** Put extensions in `~/.
|
|
7
|
+
> **Placement for /reload:** Put extensions in `~/.draht/agent/extensions/` (global) or `.draht/extensions/` (project-local) for auto-discovery. Use `draht -e ./path.ts` only for quick tests. Extensions in auto-discovered locations can be hot-reloaded with `/reload`.
|
|
8
8
|
|
|
9
9
|
**Key capabilities:**
|
|
10
10
|
- **Custom tools** - Register tools the LLM can call via `pi.registerTool()`
|
|
@@ -55,7 +55,7 @@ See [examples/extensions/](../examples/extensions/) for working implementations.
|
|
|
55
55
|
|
|
56
56
|
## Quick Start
|
|
57
57
|
|
|
58
|
-
Create `~/.
|
|
58
|
+
Create `~/.draht/agent/extensions/my-extension.ts`:
|
|
59
59
|
|
|
60
60
|
```typescript
|
|
61
61
|
import type { ExtensionAPI } from "@draht/coding-agent";
|
|
@@ -103,21 +103,21 @@ export default function (pi: ExtensionAPI) {
|
|
|
103
103
|
Test with `--extension` (or `-e`) flag:
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
|
-
|
|
106
|
+
draht -e ./my-extension.ts
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
## Extension Locations
|
|
110
110
|
|
|
111
111
|
> **Security:** Extensions run with your full system permissions and can execute arbitrary code. Only install from sources you trust.
|
|
112
112
|
|
|
113
|
-
Extensions are auto-discovered from trusted locations. Project-local `.
|
|
113
|
+
Extensions are auto-discovered from trusted locations. Project-local `.draht/extensions` entries load only after the project is trusted.
|
|
114
114
|
|
|
115
115
|
| Location | Scope |
|
|
116
116
|
|----------|-------|
|
|
117
|
-
| `~/.
|
|
118
|
-
| `~/.
|
|
119
|
-
| `.
|
|
120
|
-
| `.
|
|
117
|
+
| `~/.draht/agent/extensions/*.ts` | Global (all projects) |
|
|
118
|
+
| `~/.draht/agent/extensions/*/index.ts` | Global (subdirectory) |
|
|
119
|
+
| `.draht/extensions/*.ts` | Project-local |
|
|
120
|
+
| `.draht/extensions/*/index.ts` | Project-local (subdirectory) |
|
|
121
121
|
|
|
122
122
|
Additional paths via `settings.json`:
|
|
123
123
|
|
|
@@ -134,7 +134,7 @@ Additional paths via `settings.json`:
|
|
|
134
134
|
}
|
|
135
135
|
```
|
|
136
136
|
|
|
137
|
-
To share extensions via npm or git as
|
|
137
|
+
To share extensions via npm or git as draht packages, see [packages.md](packages.md).
|
|
138
138
|
|
|
139
139
|
## Available Imports
|
|
140
140
|
|
|
@@ -147,7 +147,7 @@ To share extensions via npm or git as pi packages, see [packages.md](packages.md
|
|
|
147
147
|
|
|
148
148
|
npm dependencies work too. Add a `package.json` next to your extension (or in a parent directory), run `npm install`, and imports from `node_modules/` are resolved automatically.
|
|
149
149
|
|
|
150
|
-
For distributed
|
|
150
|
+
For distributed draht packages installed with `draht install` (npm or git), runtime deps must be in `dependencies`. Package installation uses production installs (`npm install --omit=dev`) by default, so `devDependencies` are not available at runtime; when `npmCommand` is configured, git packages use plain `install` for compatibility with wrappers.
|
|
151
151
|
|
|
152
152
|
Node.js built-ins (`node:fs`, `node:path`, etc.) are also available.
|
|
153
153
|
|
|
@@ -178,7 +178,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
178
178
|
|
|
179
179
|
Extensions are loaded via [jiti](https://github.com/unjs/jiti), so TypeScript works without compilation.
|
|
180
180
|
|
|
181
|
-
If the factory returns a `Promise`,
|
|
181
|
+
If the factory returns a `Promise`, draht awaits it before continuing startup. That means async initialization completes before `session_start`, before `resources_discover`, and before provider registrations queued via `pi.registerProvider()` are flushed.
|
|
182
182
|
|
|
183
183
|
### Async factory functions
|
|
184
184
|
|
|
@@ -215,21 +215,21 @@ export default async function (pi: ExtensionAPI) {
|
|
|
215
215
|
}
|
|
216
216
|
```
|
|
217
217
|
|
|
218
|
-
This pattern makes the fetched models available during normal startup and to `
|
|
218
|
+
This pattern makes the fetched models available during normal startup and to `draht --list-models`.
|
|
219
219
|
|
|
220
220
|
### Extension Styles
|
|
221
221
|
|
|
222
222
|
**Single file** - simplest, for small extensions:
|
|
223
223
|
|
|
224
224
|
```
|
|
225
|
-
~/.
|
|
225
|
+
~/.draht/agent/extensions/
|
|
226
226
|
└── my-extension.ts
|
|
227
227
|
```
|
|
228
228
|
|
|
229
229
|
**Directory with index.ts** - for multi-file extensions:
|
|
230
230
|
|
|
231
231
|
```
|
|
232
|
-
~/.
|
|
232
|
+
~/.draht/agent/extensions/
|
|
233
233
|
└── my-extension/
|
|
234
234
|
├── index.ts # Entry point (exports default function)
|
|
235
235
|
├── tools.ts # Helper module
|
|
@@ -239,7 +239,7 @@ This pattern makes the fetched models available during normal startup and to `pi
|
|
|
239
239
|
**Package with dependencies** - for extensions that need npm packages:
|
|
240
240
|
|
|
241
241
|
```
|
|
242
|
-
~/.
|
|
242
|
+
~/.draht/agent/extensions/
|
|
243
243
|
└── my-extension/
|
|
244
244
|
├── package.json # Declares dependencies and entry points
|
|
245
245
|
├── package-lock.json
|
|
@@ -271,7 +271,7 @@ Run `npm install` in the extension directory, then imports from `node_modules/`
|
|
|
271
271
|
### Lifecycle Overview
|
|
272
272
|
|
|
273
273
|
```
|
|
274
|
-
|
|
274
|
+
draht starts
|
|
275
275
|
│
|
|
276
276
|
├─► project_trust (user/global and CLI extensions only, before project resources load)
|
|
277
277
|
├─► session_start { reason: "startup" }
|
|
@@ -346,7 +346,7 @@ exit (Ctrl+C, Ctrl+D, SIGHUP, SIGTERM)
|
|
|
346
346
|
|
|
347
347
|
#### project_trust
|
|
348
348
|
|
|
349
|
-
Fired before
|
|
349
|
+
Fired before draht decides whether to trust a project with dynamic configs (`.draht` or `.agents/skills`). It runs during startup and when session replacement (for example `/resume`) enters a cwd whose trust has not been resolved in the current process. Only user/global extensions and CLI `-e` extensions participate; project-local extensions are not loaded until after trust is resolved.
|
|
350
350
|
|
|
351
351
|
```typescript
|
|
352
352
|
pi.on("project_trust", async (event, ctx) => {
|
|
@@ -359,7 +359,7 @@ pi.on("project_trust", async (event, ctx) => {
|
|
|
359
359
|
});
|
|
360
360
|
```
|
|
361
361
|
|
|
362
|
-
A `project_trust` handler must return `{ trusted: "yes" | "no" | "undecided" }`. A user/global or CLI extension that returns `"yes"` or `"no"` owns the decision; the first yes/no decision wins and suppresses the built-in trust prompt. Use `remember: true` to persist a yes/no decision; otherwise it applies only to the current process. Return `"undecided"` to let later handlers or the built-in trust flow decide. Check `ctx.hasUI` before prompting. If no handler returns yes/no, normal trust resolution continues: saved `trust.json` decisions apply first, then `defaultProjectTrust` controls whether
|
|
362
|
+
A `project_trust` handler must return `{ trusted: "yes" | "no" | "undecided" }`. A user/global or CLI extension that returns `"yes"` or `"no"` owns the decision; the first yes/no decision wins and suppresses the built-in trust prompt. Use `remember: true` to persist a yes/no decision; otherwise it applies only to the current process. Return `"undecided"` to let later handlers or the built-in trust flow decide. Check `ctx.hasUI` before prompting. If no handler returns yes/no, normal trust resolution continues: saved `trust.json` decisions apply first, then `defaultProjectTrust` controls whether draht asks, trusts, or declines by default.
|
|
363
363
|
|
|
364
364
|
### Resource Events
|
|
365
365
|
|
|
@@ -423,7 +423,7 @@ pi.on("session_before_switch", async (event, ctx) => {
|
|
|
423
423
|
});
|
|
424
424
|
```
|
|
425
425
|
|
|
426
|
-
After a successful switch or new-session action,
|
|
426
|
+
After a successful switch or new-session action, draht emits `session_shutdown` for the old extension instance, reloads and rebinds extensions for the new session, then emits `session_start` with `reason: "new" | "resume"` and `previousSessionFile`.
|
|
427
427
|
Do cleanup work in `session_shutdown`, then reestablish any in-memory state in `session_start`.
|
|
428
428
|
|
|
429
429
|
#### session_before_fork
|
|
@@ -440,7 +440,7 @@ pi.on("session_before_fork", async (event, ctx) => {
|
|
|
440
440
|
});
|
|
441
441
|
```
|
|
442
442
|
|
|
443
|
-
After a successful fork or clone,
|
|
443
|
+
After a successful fork or clone, draht emits `session_shutdown` for the old extension instance, reloads and rebinds extensions for the new session, then emits `session_start` with `reason: "fork"` and `previousSessionFile`.
|
|
444
444
|
Do cleanup work in `session_shutdown`, then reestablish any in-memory state in `session_start`.
|
|
445
445
|
|
|
446
446
|
#### session_before_compact / session_compact
|
|
@@ -541,13 +541,13 @@ pi.on("before_agent_start", async (event, ctx) => {
|
|
|
541
541
|
});
|
|
542
542
|
```
|
|
543
543
|
|
|
544
|
-
The `systemPromptOptions` field gives extensions access to the same structured data
|
|
544
|
+
The `systemPromptOptions` field gives extensions access to the same structured data draht uses to build the system prompt. This lets you inspect what draht has loaded — custom prompts, guidelines, tool snippets, context files, skills — without re-discovering resources or re-parsing flags. Use it when your extension needs to make deep, informed changes to the system prompt while respecting user-provided configuration.
|
|
545
545
|
|
|
546
546
|
Inside `before_agent_start`, `event.systemPrompt` and `ctx.getSystemPrompt()` both reflect the chained system prompt as of the current handler. Later `before_agent_start` handlers can still modify it again.
|
|
547
547
|
|
|
548
548
|
#### agent_start / agent_end / agent_settled
|
|
549
549
|
|
|
550
|
-
`agent_start` fires when a low-level agent run begins. `agent_end` fires when that run ends, but
|
|
550
|
+
`agent_start` fires when a low-level agent run begins. `agent_end` fires when that run ends, but draht may still auto-retry, auto-compact and retry, or continue with queued follow-up messages. Use `agent_settled` for status integrations that need to know draht will not continue running automatically.
|
|
551
551
|
|
|
552
552
|
```typescript
|
|
553
553
|
pi.on("agent_start", async (_event, ctx) => {});
|
|
@@ -651,7 +651,7 @@ pi.on("context", async (event, ctx) => {
|
|
|
651
651
|
|
|
652
652
|
Fired after the provider-specific payload is built, right before the request is sent. Handlers run in extension load order. Returning `undefined` keeps the payload unchanged. Returning any other value replaces the payload for later handlers and for the actual request.
|
|
653
653
|
|
|
654
|
-
This hook can rewrite provider-level system instructions or remove them entirely. Those payload-level changes are not reflected by `ctx.getSystemPrompt()`, which reports
|
|
654
|
+
This hook can rewrite provider-level system instructions or remove them entirely. Those payload-level changes are not reflected by `ctx.getSystemPrompt()`, which reports draht's system prompt string rather than the final serialized provider payload.
|
|
655
655
|
|
|
656
656
|
```typescript
|
|
657
657
|
pi.on("before_provider_request", (event, ctx) => {
|
|
@@ -724,7 +724,7 @@ Use this to update extension UI when `pi.setThinkingLevel()`, model changes, or
|
|
|
724
724
|
|
|
725
725
|
Fired after `tool_execution_start`, before the tool executes. **Can block.** Use `isToolCallEventType` to narrow and get typed inputs.
|
|
726
726
|
|
|
727
|
-
Before `tool_call` runs,
|
|
727
|
+
Before `tool_call` runs, draht waits for previously emitted Agent events to finish draining through `AgentSession`. This means `ctx.sessionManager` is up to date through the current assistant tool-calling message.
|
|
728
728
|
|
|
729
729
|
In the default parallel tool execution mode, sibling tool calls from the same assistant message are preflighted sequentially, then executed concurrently. `tool_call` is not guaranteed to see sibling tool results from that same assistant message in `ctx.sessionManager`.
|
|
730
730
|
|
|
@@ -835,7 +835,7 @@ pi.on("user_bash", (event, ctx) => {
|
|
|
835
835
|
// Option 1: Provide custom operations (e.g., SSH)
|
|
836
836
|
return { operations: remoteBashOps };
|
|
837
837
|
|
|
838
|
-
// Option 2: Wrap
|
|
838
|
+
// Option 2: Wrap draht's built-in local bash backend
|
|
839
839
|
const local = createLocalBashOperations();
|
|
840
840
|
return {
|
|
841
841
|
operations: {
|
|
@@ -956,7 +956,7 @@ Use this for abort-aware nested work started by extension handlers, for example:
|
|
|
956
956
|
- file or process helpers that accept `AbortSignal`
|
|
957
957
|
|
|
958
958
|
`ctx.signal` is typically defined during active turn events such as `tool_call`, `tool_result`, `message_update`, and `turn_end`.
|
|
959
|
-
It is usually `undefined` in idle or non-turn contexts such as session events, extension commands, and shortcuts fired while
|
|
959
|
+
It is usually `undefined` in idle or non-turn contexts such as session events, extension commands, and shortcuts fired while draht is idle.
|
|
960
960
|
|
|
961
961
|
```typescript
|
|
962
962
|
pi.on("tool_result", async (event, ctx) => {
|
|
@@ -973,11 +973,11 @@ pi.on("tool_result", async (event, ctx) => {
|
|
|
973
973
|
|
|
974
974
|
### ctx.isIdle() / ctx.abort() / ctx.hasPendingMessages()
|
|
975
975
|
|
|
976
|
-
Control flow helpers. `ctx.isIdle()` is false while
|
|
976
|
+
Control flow helpers. `ctx.isIdle()` is false while draht is processing an agent run, automatic retry, auto-compaction retry, or queued continuation.
|
|
977
977
|
|
|
978
978
|
### ctx.shutdown()
|
|
979
979
|
|
|
980
|
-
Request a graceful shutdown of
|
|
980
|
+
Request a graceful shutdown of draht.
|
|
981
981
|
|
|
982
982
|
- **Interactive mode:** Deferred until the agent becomes idle (after processing all queued steering and follow-up messages).
|
|
983
983
|
- **RPC mode:** Deferred until the next idle state (after completing the current command response, when waiting for the next command).
|
|
@@ -1022,7 +1022,7 @@ ctx.compact({
|
|
|
1022
1022
|
|
|
1023
1023
|
### ctx.getSystemPrompt()
|
|
1024
1024
|
|
|
1025
|
-
Returns
|
|
1025
|
+
Returns draht's current system prompt string.
|
|
1026
1026
|
|
|
1027
1027
|
- During `before_agent_start`, this reflects chained system-prompt changes made so far for the current turn.
|
|
1028
1028
|
- It does not include later `context` message mutations.
|
|
@@ -1042,7 +1042,7 @@ Command handlers receive `ExtensionCommandContext`, which extends `ExtensionCont
|
|
|
1042
1042
|
|
|
1043
1043
|
### ctx.getSystemPromptOptions()
|
|
1044
1044
|
|
|
1045
|
-
Returns the base inputs
|
|
1045
|
+
Returns the base inputs draht currently uses to build the system prompt.
|
|
1046
1046
|
|
|
1047
1047
|
```typescript
|
|
1048
1048
|
const options = ctx.getSystemPromptOptions();
|
|
@@ -1452,7 +1452,7 @@ Labels persist in the session and survive restarts. Use them to mark important p
|
|
|
1452
1452
|
|
|
1453
1453
|
Register a command.
|
|
1454
1454
|
|
|
1455
|
-
If multiple extensions register the same command name,
|
|
1455
|
+
If multiple extensions register the same command name, draht keeps them all and assigns numeric invocation suffixes in load order, for example `/review:1` and `/review:2`.
|
|
1456
1456
|
|
|
1457
1457
|
```typescript
|
|
1458
1458
|
pi.registerCommand("stats", {
|
|
@@ -1606,9 +1606,9 @@ Typical `sourceInfo.source` values:
|
|
|
1606
1606
|
- `sdk` for tools passed via `createAgentSession({ customTools })`
|
|
1607
1607
|
- extension source metadata for tools registered by extensions
|
|
1608
1608
|
|
|
1609
|
-
### pi.setModel(model)
|
|
1609
|
+
### pi.setModel(model, options?)
|
|
1610
1610
|
|
|
1611
|
-
Set the current model. Returns `false` if no API key is available for the model. See [models.md](models.md) for configuring custom models.
|
|
1611
|
+
Set the current model. Returns `false` if no API key is available for the model. See [models.md](models.md) for configuring custom models. Pass `{ persistDefault: false }` for session-scoped orchestration that must not replace the user's global default model.
|
|
1612
1612
|
|
|
1613
1613
|
```typescript
|
|
1614
1614
|
const model = ctx.modelRegistry.find("anthropic", "claude-sonnet-4-5");
|
|
@@ -1620,9 +1620,9 @@ if (model) {
|
|
|
1620
1620
|
}
|
|
1621
1621
|
```
|
|
1622
1622
|
|
|
1623
|
-
### pi.getThinkingLevel() / pi.setThinkingLevel(level)
|
|
1623
|
+
### pi.getThinkingLevel() / pi.setThinkingLevel(level, options?)
|
|
1624
1624
|
|
|
1625
|
-
Get or set the thinking level. Level is clamped to model capabilities (non-reasoning models always use "off"). Changes emit `thinking_level_select`.
|
|
1625
|
+
Get or set the thinking level. Level is clamped to model capabilities (non-reasoning models always use "off"). Changes emit `thinking_level_select`. Pass `{ persistDefault: false }` when the change should remain session-scoped.
|
|
1626
1626
|
|
|
1627
1627
|
```typescript
|
|
1628
1628
|
const current = pi.getThinkingLevel(); // "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"
|
|
@@ -1644,7 +1644,7 @@ Register or override a model provider dynamically. Useful for proxies, custom en
|
|
|
1644
1644
|
|
|
1645
1645
|
Calls made during the extension factory function are queued and applied once the runner initialises. Calls made after that — for example from a command handler following a user setup flow — take effect immediately without requiring a `/reload`.
|
|
1646
1646
|
|
|
1647
|
-
Dynamic providers can implement `refreshModels`.
|
|
1647
|
+
Dynamic providers can implement `refreshModels`. draht calls it during model refresh, publishes the returned list synchronously through the provider, and passes the canonical credential/store/network/signal context. The extension decides whether to persist the catalog through `context.store`; live servers such as llama.cpp can ignore it.
|
|
1648
1648
|
|
|
1649
1649
|
Extensions that need native provider auth, filtering, refresh, or stream behavior can register a complete `Provider` from `@draht/ai`. The provider becomes the composition base and `models.json` overrides still apply above it.
|
|
1650
1650
|
|
|
@@ -1912,7 +1912,7 @@ pi.registerTool({
|
|
|
1912
1912
|
});
|
|
1913
1913
|
```
|
|
1914
1914
|
|
|
1915
|
-
**Usage accounting:** If a tool makes nested LLM calls, return their combined `Usage` as `usage`.
|
|
1915
|
+
**Usage accounting:** If a tool makes nested LLM calls, return their combined `Usage` as `usage`. draht persists it on the tool result and includes it in footer, `/session`, and RPC session totals. `tool_result` handlers can inspect or replace this value.
|
|
1916
1916
|
|
|
1917
1917
|
**Signaling errors:** To mark a tool execution as failed (sets `isError: true` on the result and reports it to the LLM), throw an error from `execute`. Returning a value never sets the error flag regardless of what properties you include in the return object.
|
|
1918
1918
|
|
|
@@ -1930,7 +1930,7 @@ async execute(toolCallId, params) {
|
|
|
1930
1930
|
|
|
1931
1931
|
**Important:** Use `StringEnum` from `@draht/ai` for string enums. `Type.Union`/`Type.Literal` doesn't work with Google's API.
|
|
1932
1932
|
|
|
1933
|
-
**Argument preparation:** `prepareArguments(args)` is optional. If defined, it runs before schema validation and before `execute()`. Use it to mimic an older accepted input shape when
|
|
1933
|
+
**Argument preparation:** `prepareArguments(args)` is optional. If defined, it runs before schema validation and before `execute()`. Use it to mimic an older accepted input shape when draht resumes an older session whose stored tool call arguments no longer match the current schema. Return the object you want validated against `parameters`. Keep the public schema strict. Do not add deprecated compatibility fields to `parameters` just to keep old resumed sessions working.
|
|
1934
1934
|
|
|
1935
1935
|
Example: an older session may contain an `edit` tool call with top-level `oldText` and `newText`, while the current schema only accepts `edits: [{ oldText, newText }]`.
|
|
1936
1936
|
|
|
@@ -1983,13 +1983,13 @@ Extensions can override built-in tools (`read`, `bash`, `edit`, `write`, `grep`,
|
|
|
1983
1983
|
|
|
1984
1984
|
```bash
|
|
1985
1985
|
# Extension's read tool replaces built-in read
|
|
1986
|
-
|
|
1986
|
+
draht -e ./tool-override.ts
|
|
1987
1987
|
```
|
|
1988
1988
|
|
|
1989
1989
|
Alternatively, use `--no-builtin-tools` to start without any built-in tools while keeping extension tools enabled:
|
|
1990
1990
|
```bash
|
|
1991
1991
|
# No built-in tools, only extension tools
|
|
1992
|
-
|
|
1992
|
+
draht --no-builtin-tools -e ./my-extension.ts
|
|
1993
1993
|
```
|
|
1994
1994
|
|
|
1995
1995
|
See [examples/extensions/tool-override.ts](../examples/extensions/tool-override.ts) for a complete example that overrides `read` with logging and access control.
|
|
@@ -2001,13 +2001,13 @@ See [examples/extensions/tool-override.ts](../examples/extensions/tool-override.
|
|
|
2001
2001
|
**Your implementation must match the exact result shape**, including the `details` type. The UI and session logic depend on these shapes for rendering and state tracking.
|
|
2002
2002
|
|
|
2003
2003
|
Built-in tool implementations:
|
|
2004
|
-
- [read.ts](https://github.com/
|
|
2005
|
-
- [bash.ts](https://github.com/
|
|
2006
|
-
- [edit.ts](https://github.com/
|
|
2007
|
-
- [write.ts](https://github.com/
|
|
2008
|
-
- [grep.ts](https://github.com/
|
|
2009
|
-
- [find.ts](https://github.com/
|
|
2010
|
-
- [ls.ts](https://github.com/
|
|
2004
|
+
- [read.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/read.ts) - `ReadToolDetails`
|
|
2005
|
+
- [bash.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/bash.ts) - `BashToolDetails`
|
|
2006
|
+
- [edit.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/edit.ts)
|
|
2007
|
+
- [write.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/write.ts)
|
|
2008
|
+
- [grep.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/grep.ts) - `GrepToolDetails`
|
|
2009
|
+
- [find.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/find.ts) - `FindToolDetails`
|
|
2010
|
+
- [ls.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/tools/ls.ts) - `LsToolDetails`
|
|
2011
2011
|
|
|
2012
2012
|
### Remote Execution
|
|
2013
2013
|
|
|
@@ -2040,7 +2040,7 @@ pi.registerTool({
|
|
|
2040
2040
|
|
|
2041
2041
|
**Operations interfaces:** `ReadOperations`, `WriteOperations`, `EditOperations`, `BashOperations`, `LsOperations`, `GrepOperations`, `FindOperations`
|
|
2042
2042
|
|
|
2043
|
-
For `user_bash`, extensions can reuse
|
|
2043
|
+
For `user_bash`, extensions can reuse draht's local shell backend via `createLocalBashOperations()` instead of reimplementing local process spawning, shell resolution, and process-tree termination.
|
|
2044
2044
|
|
|
2045
2045
|
The bash tool also supports a spawn hook to adjust the command, cwd, or env before execution:
|
|
2046
2046
|
|
|
@@ -2138,7 +2138,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
2138
2138
|
|
|
2139
2139
|
### Custom Rendering
|
|
2140
2140
|
|
|
2141
|
-
Tools can provide `renderCall` and `renderResult` for custom TUI display. See [tui.md](tui.md) for the full component API and [tool-execution.ts](https://github.com/
|
|
2141
|
+
Tools can provide `renderCall` and `renderResult` for custom TUI display. See [tui.md](tui.md) for the full component API and [tool-execution.ts](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/modes/interactive/components/tool-execution.ts) for how tool rows are composed.
|
|
2142
2142
|
|
|
2143
2143
|
By default, tool output is wrapped in a `Box` that handles padding and background. A defined `renderCall` or `renderResult` must return a `Component`. If a slot renderer is not defined, `tool-execution.ts` uses fallback rendering for that slot.
|
|
2144
2144
|
|
|
@@ -2263,7 +2263,7 @@ If a slot renderer is not defined or throws:
|
|
|
2263
2263
|
|
|
2264
2264
|
### Dynamic Tool Loading
|
|
2265
2265
|
|
|
2266
|
-
Extensions can register many tools while keeping only a small initial set active. A tool can then add more tools with `pi.setActiveTools()` during execution.
|
|
2266
|
+
Extensions can register many tools while keeping only a small initial set active. A tool can then add more tools with `pi.setActiveTools()` during execution. draht detects purely additive changes, records the newly available tool names on that tool result, and applies the updated active set before the next model request.
|
|
2267
2267
|
|
|
2268
2268
|
This works with every model. Models with native deferred-loading support preserve the stable prompt prefix and load the new definitions at the tool-result position. Other models use the fallback described below.
|
|
2269
2269
|
|
|
@@ -2272,8 +2272,8 @@ The lifecycle is:
|
|
|
2272
2272
|
1. Register every tool with `pi.registerTool()` so it appears in `pi.getAllTools()`.
|
|
2273
2273
|
2. Keep loader tools, such as `search_tools`, active and leave searchable tools inactive.
|
|
2274
2274
|
3. During loader execution, call `pi.setActiveTools([...currentTools, ...matchingTools])`. The change must be additive: do not remove currently active tools in the same call.
|
|
2275
|
-
4.
|
|
2276
|
-
5. Before the next model response,
|
|
2275
|
+
4. draht records which tools were added on the loader's tool result.
|
|
2276
|
+
5. Before the next model response, draht exposes the added definitions using native deferred loading when supported, or the normal active tool list otherwise.
|
|
2277
2277
|
|
|
2278
2278
|
You do not need to return provider-specific tool references or mark the loader as a special search tool. The active-tool change is the signal. Names passed to `pi.setActiveTools()` must already be registered; unknown names are ignored.
|
|
2279
2279
|
|
|
@@ -2284,15 +2284,15 @@ You do not need to return provider-specific tool references or mark the loader a
|
|
|
2284
2284
|
- **Native representation:** Deferred definitions use `defer_loading`; the load point uses `tool_reference` content.
|
|
2285
2285
|
- **OpenAI**
|
|
2286
2286
|
- **Models:** `gpt-5.4` and newer family
|
|
2287
|
-
- **Native representation:**
|
|
2287
|
+
- **Native representation:** draht adds completed client `tool_search_call` and `tool_search_output` items at the load point.
|
|
2288
2288
|
|
|
2289
2289
|
For a verified custom model or proxy, native handling can be enabled with `compat.supportsToolReferences: true` for `anthropic-messages`, or `compat.supportsToolSearch: true` for `openai-responses` and `openai-codex-responses`. Leave these disabled unless the endpoint and model accept the corresponding native protocol.
|
|
2290
2290
|
|
|
2291
2291
|
#### Fallback behavior
|
|
2292
2292
|
|
|
2293
|
-
For all other models and providers, dynamic activation still works:
|
|
2293
|
+
For all other models and providers, dynamic activation still works: draht sends the complete current active tool list normally on the next request. The model can call the newly activated tools, but adding their definitions may invalidate the provider's cached prompt prefix.
|
|
2294
2294
|
|
|
2295
|
-
|
|
2295
|
+
draht also uses this safe fallback when the active set is not purely additive, such as replacing one group of tools with another. Tool removals therefore work, but they do not use deferred loading.
|
|
2296
2296
|
|
|
2297
2297
|
For the best cache behavior, keep the loader tool active for the whole session and add tools instead of replacing the active set. Also note that activating a tool with `promptSnippet` or `promptGuidelines` rebuilds the system prompt; that system-prompt change can invalidate the prefix even when the provider supports deferred schemas. Lazily loaded tools should usually rely on their tool `description` and omit active-only prompt metadata.
|
|
2298
2298
|
|
|
@@ -2524,7 +2524,7 @@ ctx.ui.setFooter((tui, theme) => ({
|
|
|
2524
2524
|
ctx.ui.setFooter(undefined); // Restore built-in footer
|
|
2525
2525
|
|
|
2526
2526
|
// Terminal title
|
|
2527
|
-
ctx.ui.setTitle("
|
|
2527
|
+
ctx.ui.setTitle("draht - my-project");
|
|
2528
2528
|
|
|
2529
2529
|
// Editor text
|
|
2530
2530
|
ctx.ui.setEditorText("Prefill text");
|
package/docs/index.md
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# draht Documentation
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
draht is a minimal terminal coding harness. It is designed to stay small at the core while being extended through TypeScript extensions, skills, prompt templates, themes, and draht packages.
|
|
4
4
|
|
|
5
5
|
## Quick start
|
|
6
6
|
|
|
7
|
-
Install
|
|
7
|
+
Install draht with npm:
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g --ignore-scripts @draht/coding-agent
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
`--ignore-scripts` disables dependency lifecycle scripts during install.
|
|
13
|
+
`--ignore-scripts` disables dependency lifecycle scripts during install. draht does not require install scripts for normal npm installs.
|
|
14
14
|
|
|
15
15
|
On Linux or macOS, you can also use the installer:
|
|
16
16
|
|
|
@@ -18,7 +18,7 @@ On Linux or macOS, you can also use the installer:
|
|
|
18
18
|
curl -fsSL https://pi.dev/install.sh | sh
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
To uninstall
|
|
21
|
+
To uninstall draht itself, use npm for curl and npm installs:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
npm uninstall -g @draht/coding-agent
|
|
@@ -29,7 +29,7 @@ For pnpm, Yarn, or Bun installs, use the matching global remove command: `pnpm r
|
|
|
29
29
|
Then run it in a project directory:
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
|
|
32
|
+
draht
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
Authenticate with `/login` for subscription providers, or set an API key such as `ANTHROPIC_API_KEY` before starting pi.
|
|
@@ -39,11 +39,11 @@ For the full first-run flow, see [Quickstart](quickstart.md).
|
|
|
39
39
|
## Start here
|
|
40
40
|
|
|
41
41
|
- [Quickstart](quickstart.md) - install, authenticate, and run a first session.
|
|
42
|
-
- [Using
|
|
42
|
+
- [Using draht](usage.md) - interactive mode, slash commands, context files, and CLI reference.
|
|
43
43
|
- [Providers](providers.md) - subscription and API-key setup for built-in providers.
|
|
44
44
|
- [llama.cpp](llama-cpp.md) - run a local router and manage models with `/llama`.
|
|
45
45
|
- [Security](security.md) - project trust, sandbox boundaries, and vulnerability reporting.
|
|
46
|
-
- [Containerization](containerization.md) - sandbox
|
|
46
|
+
- [Containerization](containerization.md) - sandbox draht with OpenShell, Gondolin, or Docker.
|
|
47
47
|
- [Settings](settings.md) - global and project settings.
|
|
48
48
|
- [Keybindings](keybindings.md) - default shortcuts and custom keybindings.
|
|
49
49
|
- [Sessions](sessions.md) - session management, branching, and tree navigation.
|
|
@@ -55,13 +55,13 @@ For the full first-run flow, see [Quickstart](quickstart.md).
|
|
|
55
55
|
- [Skills](skills.md) - Agent Skills for reusable on-demand capabilities.
|
|
56
56
|
- [Prompt templates](prompt-templates.md) - reusable prompts that expand from slash commands.
|
|
57
57
|
- [Themes](themes.md) - built-in and custom terminal themes.
|
|
58
|
-
- [
|
|
58
|
+
- [draht packages](packages.md) - bundle and share extensions, skills, prompts, and themes.
|
|
59
59
|
- [Custom models](models.md) - add model entries for supported provider APIs.
|
|
60
60
|
- [Custom providers](custom-provider.md) - implement custom APIs and OAuth flows.
|
|
61
61
|
|
|
62
62
|
## Programmatic usage
|
|
63
63
|
|
|
64
|
-
- [SDK](sdk.md) - embed
|
|
64
|
+
- [SDK](sdk.md) - embed draht in Node.js applications.
|
|
65
65
|
- [RPC mode](rpc.md) - integrate over stdin/stdout JSONL.
|
|
66
66
|
- [JSON event stream mode](json.md) - print mode with structured events.
|
|
67
67
|
- [TUI components](tui.md) - build custom terminal UI for extensions.
|
package/docs/json.md
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
# JSON Event Stream Mode
|
|
2
2
|
|
|
3
3
|
```bash
|
|
4
|
-
|
|
4
|
+
draht --mode json "Your prompt"
|
|
5
5
|
```
|
|
6
6
|
|
|
7
|
-
Outputs all session events as JSON lines to stdout. Useful for integrating
|
|
7
|
+
Outputs all session events as JSON lines to stdout. Useful for integrating draht into other tools or custom UIs.
|
|
8
8
|
|
|
9
9
|
## Event Types
|
|
10
10
|
|
|
11
|
-
Events are defined in [`AgentSessionEvent`](https://github.com/
|
|
11
|
+
Events are defined in [`AgentSessionEvent`](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/agent-session.ts#L102):
|
|
12
12
|
|
|
13
13
|
```typescript
|
|
14
14
|
type AgentSessionEvent =
|
|
@@ -26,7 +26,7 @@ type AgentSessionEvent =
|
|
|
26
26
|
|
|
27
27
|
`queue_update` emits the full pending steering and follow-up queues whenever they change. `compaction_start` and `compaction_end` cover both manual and automatic compaction.
|
|
28
28
|
|
|
29
|
-
Base events from [`AgentEvent`](https://github.com/
|
|
29
|
+
Base events from [`AgentEvent`](https://github.com/draht-dev/draht/blob/main/packages/agent/src/types.ts#L179):
|
|
30
30
|
|
|
31
31
|
```typescript
|
|
32
32
|
type AgentEvent =
|
|
@@ -48,12 +48,12 @@ type AgentEvent =
|
|
|
48
48
|
|
|
49
49
|
## Message Types
|
|
50
50
|
|
|
51
|
-
Base messages from [`packages/ai/src/types.ts`](https://github.com/
|
|
51
|
+
Base messages from [`packages/ai/src/types.ts`](https://github.com/draht-dev/draht/blob/main/packages/ai/src/types.ts#L134):
|
|
52
52
|
- `UserMessage` (line 134)
|
|
53
53
|
- `AssistantMessage` (line 140)
|
|
54
54
|
- `ToolResultMessage` (line 152)
|
|
55
55
|
|
|
56
|
-
Extended messages from [`packages/coding-agent/src/core/messages.ts`](https://github.com/
|
|
56
|
+
Extended messages from [`packages/coding-agent/src/core/messages.ts`](https://github.com/draht-dev/draht/blob/main/packages/coding-agent/src/core/messages.ts#L29):
|
|
57
57
|
- `BashExecutionMessage` (line 29)
|
|
58
58
|
- `CustomMessage` (line 46)
|
|
59
59
|
- `BranchSummaryMessage` (line 55)
|
|
@@ -82,5 +82,5 @@ Followed by events as they occur:
|
|
|
82
82
|
## Example
|
|
83
83
|
|
|
84
84
|
```bash
|
|
85
|
-
|
|
85
|
+
draht --mode json "List files" 2>/dev/null | jq -c 'select(.type == "message_end")'
|
|
86
86
|
```
|
package/docs/keybindings.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Keybindings
|
|
2
2
|
|
|
3
|
-
All keyboard shortcuts can be customized via `~/.
|
|
3
|
+
All keyboard shortcuts can be customized via `~/.draht/agent/keybindings.json`. Each action can be bound to one or more keys.
|
|
4
4
|
|
|
5
|
-
The config file uses the same namespaced keybinding ids that
|
|
5
|
+
The config file uses the same namespaced keybinding ids that draht uses internally and that extension authors use in `keyHint()` and injected `keybindings` managers.
|
|
6
6
|
|
|
7
7
|
Older configs using pre-namespaced ids such as `cursorUp` or `expandTools` are migrated automatically to the namespaced ids on startup.
|
|
8
8
|
|
|
9
|
-
After editing `keybindings.json`, run `/reload` in
|
|
9
|
+
After editing `keybindings.json`, run `/reload` in draht to apply the changes without restarting the session.
|
|
10
10
|
|
|
11
11
|
## Key Format
|
|
12
12
|
|
|
@@ -95,6 +95,7 @@ Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1
|
|
|
95
95
|
|--------|---------|-------------|
|
|
96
96
|
| `app.session.new` | *(none)* | Start a new session (`/new`) |
|
|
97
97
|
| `app.session.tree` | *(none)* | Open session tree navigator (`/tree`) |
|
|
98
|
+
| `app.session.rewind` | *(none)* | Rewind conversation and/or files (`/rewind`) |
|
|
98
99
|
| `app.session.fork` | *(none)* | Fork current session (`/fork`) |
|
|
99
100
|
| `app.session.resume` | *(none)* | Open session resume picker (`/resume`) |
|
|
100
101
|
| `app.session.togglePath` | `ctrl+p` | Toggle path display |
|
|
@@ -155,7 +156,7 @@ Used inside the scoped models selector (opened via `/scoped-models`).
|
|
|
155
156
|
|
|
156
157
|
## Custom Configuration
|
|
157
158
|
|
|
158
|
-
Create `~/.
|
|
159
|
+
Create `~/.draht/agent/keybindings.json`:
|
|
159
160
|
|
|
160
161
|
```json
|
|
161
162
|
{
|
|
@@ -167,7 +168,7 @@ Create `~/.pi/agent/keybindings.json`:
|
|
|
167
168
|
|
|
168
169
|
Each action can have a single key or an array of keys. User config overrides defaults.
|
|
169
170
|
|
|
170
|
-
On native Windows, `app.suspend` has no default binding because Windows terminals do not support Unix job control. If you bind it manually,
|
|
171
|
+
On native Windows, `app.suspend` has no default binding because Windows terminals do not support Unix job control. If you bind it manually, draht shows a status message instead of suspending. In WSL, the normal Linux `ctrl+z`/`fg` behavior still applies.
|
|
171
172
|
|
|
172
173
|
### Emacs Example
|
|
173
174
|
|