@draht/coding-agent 2026.4.26 → 2026.6.11
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 +43 -0
- package/bin/draht-tools.cjs +3809 -1
- package/dist/bun/cli.d.ts.map +1 -1
- package/dist/bun/cli.js +4 -2
- package/dist/bun/cli.js.map +1 -1
- package/dist/bun/restore-sandbox-env.d.ts +13 -0
- package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
- package/dist/bun/restore-sandbox-env.js +32 -0
- package/dist/bun/restore-sandbox-env.js.map +1 -0
- package/dist/cli/args.d.ts +9 -4
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +88 -35
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/config-selector.d.ts +2 -2
- package/dist/cli/config-selector.d.ts.map +1 -1
- package/dist/cli/config-selector.js +1 -1
- package/dist/cli/config-selector.js.map +1 -1
- package/dist/cli/file-processor.d.ts.map +1 -1
- package/dist/cli/file-processor.js +2 -3
- package/dist/cli/file-processor.js.map +1 -1
- package/dist/cli/initial-message.d.ts +1 -1
- package/dist/cli/initial-message.d.ts.map +1 -1
- package/dist/cli/initial-message.js.map +1 -1
- package/dist/cli/list-models.d.ts +1 -1
- package/dist/cli/list-models.d.ts.map +1 -1
- package/dist/cli/list-models.js +7 -1
- package/dist/cli/list-models.js.map +1 -1
- package/dist/cli/project-trust.d.ts +10 -0
- package/dist/cli/project-trust.d.ts.map +1 -0
- package/dist/cli/project-trust.js +48 -0
- package/dist/cli/project-trust.js.map +1 -0
- package/dist/cli/session-picker.d.ts +1 -1
- package/dist/cli/session-picker.d.ts.map +1 -1
- package/dist/cli/session-picker.js.map +1 -1
- package/dist/cli/startup-ui.d.ts +16 -0
- package/dist/cli/startup-ui.d.ts.map +1 -0
- package/dist/cli/startup-ui.js +112 -0
- package/dist/cli/startup-ui.js.map +1 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +7 -4
- package/dist/cli.js.map +1 -1
- package/dist/config.d.ts +23 -13
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +264 -62
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +45 -9
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +100 -33
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +6 -4
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +7 -4
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +47 -31
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +470 -443
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-guidance.d.ts +5 -0
- package/dist/core/auth-guidance.d.ts.map +1 -0
- package/dist/core/auth-guidance.js +21 -0
- package/dist/core/auth-guidance.js.map +1 -0
- package/dist/core/auth-storage.d.ts +10 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +27 -6
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/bash-executor.d.ts +1 -15
- package/dist/core/bash-executor.d.ts.map +1 -1
- package/dist/core/bash-executor.js +10 -24
- package/dist/core/bash-executor.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +1 -2
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/compaction/branch-summarization.d.ts +6 -4
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +9 -3
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -5
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +43 -37
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/compaction/index.d.ts +3 -3
- package/dist/core/compaction/index.d.ts.map +1 -1
- package/dist/core/compaction/index.js.map +1 -1
- package/dist/core/compaction/utils.d.ts +1 -1
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +1 -1
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/exec.d.ts.map +1 -1
- package/dist/core/exec.js.map +1 -1
- package/dist/core/experimental.d.ts +2 -0
- package/dist/core/experimental.d.ts.map +1 -0
- package/dist/core/experimental.js +4 -0
- package/dist/core/experimental.js.map +1 -0
- package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
- package/dist/core/export-html/ansi-to-html.js +1 -1
- package/dist/core/export-html/ansi-to-html.js.map +1 -1
- package/dist/core/export-html/index.d.ts +1 -1
- package/dist/core/export-html/index.d.ts.map +1 -1
- package/dist/core/export-html/index.js +13 -11
- package/dist/core/export-html/index.js.map +1 -1
- package/dist/core/export-html/template.css +69 -4
- package/dist/core/export-html/template.js +231 -57
- package/dist/core/export-html/tool-renderer.d.ts +0 -6
- package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
- package/dist/core/export-html/tool-renderer.js +15 -2
- package/dist/core/export-html/tool-renderer.js.map +1 -1
- package/dist/core/extensions/index.d.ts +8 -8
- 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 +3 -3
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +27 -35
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +30 -12
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +215 -32
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +163 -35
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/wrapper.d.ts.map +1 -1
- package/dist/core/extensions/wrapper.js +2 -2
- package/dist/core/extensions/wrapper.js.map +1 -1
- package/dist/core/footer-data-provider.d.ts +7 -1
- package/dist/core/footer-data-provider.d.ts.map +1 -1
- package/dist/core/footer-data-provider.js +78 -54
- package/dist/core/footer-data-provider.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts +21 -0
- package/dist/core/http-dispatcher.d.ts.map +1 -0
- package/dist/core/http-dispatcher.js +48 -0
- package/dist/core/http-dispatcher.js.map +1 -0
- package/dist/core/index.d.ts +9 -8
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js +2 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +66 -1
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +56 -1
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-registry.d.ts +22 -4
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +216 -44
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts +2 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +48 -21
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/output-guard.d.ts +1 -0
- package/dist/core/output-guard.d.ts.map +1 -1
- package/dist/core/output-guard.js +52 -22
- package/dist/core/output-guard.js.map +1 -1
- package/dist/core/package-manager.d.ts +17 -2
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +363 -121
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/project-trust.d.ts +15 -0
- package/dist/core/project-trust.d.ts.map +1 -0
- package/dist/core/project-trust.js +58 -0
- package/dist/core/project-trust.js.map +1 -0
- package/dist/core/prompt-templates.d.ts +13 -11
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +67 -76
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-attribution.d.ts +4 -0
- package/dist/core/provider-attribution.d.ts.map +1 -0
- package/dist/core/provider-attribution.js +72 -0
- package/dist/core/provider-attribution.js.map +1 -0
- package/dist/core/provider-display-names.d.ts +2 -0
- package/dist/core/provider-display-names.d.ts.map +1 -0
- package/dist/core/provider-display-names.js +36 -0
- package/dist/core/provider-display-names.js.map +1 -0
- package/dist/core/resolve-config-value.d.ts +9 -1
- package/dist/core/resolve-config-value.d.ts.map +1 -1
- package/dist/core/resolve-config-value.js +134 -11
- package/dist/core/resolve-config-value.js.map +1 -1
- package/dist/core/resource-loader.d.ts +34 -14
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +165 -76
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sdk.d.ts +26 -10
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +45 -16
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +11 -12
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +245 -132
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +52 -5
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +202 -38
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +10 -10
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +13 -35
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +7 -4
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/source-info.d.ts +1 -1
- package/dist/core/source-info.d.ts.map +1 -1
- package/dist/core/source-info.js.map +1 -1
- package/dist/core/system-prompt.d.ts +4 -4
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +14 -10
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/telemetry.d.ts +3 -0
- package/dist/core/telemetry.d.ts.map +1 -0
- package/dist/core/telemetry.js +9 -0
- package/dist/core/telemetry.js.map +1 -0
- package/dist/core/tools/bash.d.ts +11 -16
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +162 -177
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit-diff.d.ts +3 -1
- package/dist/core/tools/edit-diff.d.ts.map +1 -1
- package/dist/core/tools/edit-diff.js +11 -3
- package/dist/core/tools/edit-diff.js.map +1 -1
- package/dist/core/tools/edit.d.ts +22 -24
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +199 -111
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
- package/dist/core/tools/file-mutation-queue.js +27 -12
- package/dist/core/tools/file-mutation-queue.js.map +1 -1
- package/dist/core/tools/find.d.ts +7 -18
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +134 -95
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/tools/grep.d.ts +11 -30
- package/dist/core/tools/grep.d.ts.map +1 -1
- package/dist/core/tools/grep.js +23 -12
- package/dist/core/tools/grep.js.map +1 -1
- package/dist/core/tools/index.d.ts +26 -101
- package/dist/core/tools/index.d.ts.map +1 -1
- package/dist/core/tools/index.js +78 -52
- package/dist/core/tools/index.js.map +1 -1
- package/dist/core/tools/ls.d.ts +6 -15
- package/dist/core/tools/ls.d.ts.map +1 -1
- package/dist/core/tools/ls.js +12 -17
- package/dist/core/tools/ls.js.map +1 -1
- package/dist/core/tools/output-accumulator.d.ts +52 -0
- package/dist/core/tools/output-accumulator.d.ts.map +1 -0
- package/dist/core/tools/output-accumulator.js +184 -0
- package/dist/core/tools/output-accumulator.js.map +1 -0
- package/dist/core/tools/path-utils.d.ts +2 -0
- package/dist/core/tools/path-utils.d.ts.map +1 -1
- package/dist/core/tools/path-utils.js +40 -22
- package/dist/core/tools/path-utils.js.map +1 -1
- package/dist/core/tools/read.d.ts +7 -18
- package/dist/core/tools/read.d.ts.map +1 -1
- package/dist/core/tools/read.js +100 -36
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/render-utils.d.ts +5 -2
- package/dist/core/tools/render-utils.d.ts.map +1 -1
- package/dist/core/tools/render-utils.js +18 -2
- package/dist/core/tools/render-utils.js.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.js +2 -0
- package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
- package/dist/core/tools/truncate.d.ts.map +1 -1
- package/dist/core/tools/truncate.js +12 -2
- package/dist/core/tools/truncate.js.map +1 -1
- package/dist/core/tools/write.d.ts +5 -14
- package/dist/core/tools/write.d.ts.map +1 -1
- package/dist/core/tools/write.js +27 -46
- package/dist/core/tools/write.js.map +1 -1
- package/dist/core/trust-manager.d.ts +31 -0
- package/dist/core/trust-manager.d.ts.map +1 -0
- package/dist/core/trust-manager.js +187 -0
- package/dist/core/trust-manager.js.map +1 -0
- package/dist/index.d.ts +31 -29
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -8
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts +5 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +170 -87
- package/dist/main.js.map +1 -1
- package/dist/migrations.d.ts +2 -2
- package/dist/migrations.d.ts.map +1 -1
- package/dist/migrations.js +127 -5
- package/dist/migrations.js.map +1 -1
- package/dist/modes/index.d.ts +5 -5
- package/dist/modes/index.d.ts.map +1 -1
- package/dist/modes/index.js.map +1 -1
- package/dist/modes/interactive/components/assistant-message.d.ts +2 -0
- package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/assistant-message.js +14 -0
- package/dist/modes/interactive/components/assistant-message.js.map +1 -1
- package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
- package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/bash-execution.js +3 -3
- package/dist/modes/interactive/components/bash-execution.js.map +1 -1
- package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
- package/dist/modes/interactive/components/bordered-loader.js +3 -0
- package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts +4 -4
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +38 -11
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
- package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
- package/dist/modes/interactive/components/countdown-timer.js +2 -2
- package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
- package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
- package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-editor.js.map +1 -1
- package/dist/modes/interactive/components/custom-message.d.ts +2 -2
- package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-message.js.map +1 -1
- package/dist/modes/interactive/components/diff.d.ts.map +1 -1
- package/dist/modes/interactive/components/diff.js.map +1 -1
- package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
- package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
- package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-editor.js +14 -6
- package/dist/modes/interactive/components/extension-editor.js.map +1 -1
- package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-input.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +8 -3
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
- package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
- package/dist/modes/interactive/components/first-time-setup.js +103 -0
- package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
- package/dist/modes/interactive/components/footer.d.ts +2 -1
- package/dist/modes/interactive/components/footer.d.ts.map +1 -1
- package/dist/modes/interactive/components/footer.js +23 -7
- package/dist/modes/interactive/components/footer.js.map +1 -1
- package/dist/modes/interactive/components/index.d.ts +33 -31
- package/dist/modes/interactive/components/index.d.ts.map +1 -1
- package/dist/modes/interactive/components/index.js +2 -0
- package/dist/modes/interactive/components/index.js.map +1 -1
- package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
- package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
- package/dist/modes/interactive/components/keybinding-hints.js +19 -5
- package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
- package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
- package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
- package/dist/modes/interactive/components/login-dialog.js +46 -11
- package/dist/modes/interactive/components/login-dialog.js.map +1 -1
- package/dist/modes/interactive/components/model-selector.d.ts +2 -2
- package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/model-selector.js +8 -5
- package/dist/modes/interactive/components/model-selector.js.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
- package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.js +93 -25
- package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
- package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.js +45 -30
- package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts +2 -1
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +20 -7
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +13 -0
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +113 -4
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
- package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/thinking-selector.js +1 -1
- package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +57 -14
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +18 -9
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
- package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
- package/dist/modes/interactive/components/trust-selector.js +91 -0
- package/dist/modes/interactive/components/trust-selector.js.map +1 -0
- package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
- package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/user-message-selector.js +8 -7
- package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
- package/dist/modes/interactive/components/user-message.d.ts +1 -0
- package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/user-message.js +8 -7
- package/dist/modes/interactive/components/user-message.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +68 -13
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +1100 -319
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/interactive/theme/dark.json +5 -4
- package/dist/modes/interactive/theme/light.json +5 -4
- package/dist/modes/interactive/theme/theme.d.ts +22 -3
- package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
- package/dist/modes/interactive/theme/theme.js +160 -105
- package/dist/modes/interactive/theme/theme.js.map +1 -1
- package/dist/modes/print-mode.d.ts.map +1 -1
- package/dist/modes/print-mode.js +40 -20
- package/dist/modes/print-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-client.d.ts +11 -1
- package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-client.js +73 -8
- package/dist/modes/rpc/rpc-client.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts +2 -2
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +96 -30
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +16 -4
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/package-manager-cli.d.ts +6 -2
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +396 -21
- package/dist/package-manager-cli.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +12 -0
- package/dist/prompts/commands/execute-phase.md +48 -17
- package/dist/prompts/commands/fix.md +86 -23
- package/dist/prompts/commands/map-codebase.md +17 -3
- package/dist/prompts/commands/orchestrate.md +31 -6
- package/dist/prompts/commands/plan-phase.md +39 -6
- package/dist/prompts/commands/quick.md +36 -6
- package/dist/prompts/commands/review.md +28 -11
- package/dist/prompts/commands/verify-work.md +34 -17
- package/dist/utils/ansi.d.ts +2 -0
- package/dist/utils/ansi.d.ts.map +1 -0
- package/dist/utils/ansi.js +52 -0
- package/dist/utils/ansi.js.map +1 -0
- package/dist/utils/changelog.d.ts +2 -1
- package/dist/utils/changelog.d.ts.map +1 -1
- package/dist/utils/changelog.js +78 -0
- package/dist/utils/changelog.js.map +1 -1
- package/dist/utils/child-process.d.ts +5 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +10 -0
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard-image.d.ts.map +1 -1
- package/dist/utils/clipboard-image.js +2 -2
- package/dist/utils/clipboard-image.js.map +1 -1
- package/dist/utils/clipboard-native.d.ts +3 -1
- package/dist/utils/clipboard-native.d.ts.map +1 -1
- package/dist/utils/clipboard-native.js +14 -8
- package/dist/utils/clipboard-native.js.map +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +84 -45
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/deprecation.d.ts +4 -0
- package/dist/utils/deprecation.d.ts.map +1 -0
- package/dist/utils/deprecation.js +13 -0
- package/dist/utils/deprecation.js.map +1 -0
- package/dist/utils/exif-orientation.d.ts +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/fs-watch.d.ts +5 -0
- package/dist/utils/fs-watch.d.ts.map +1 -0
- package/dist/utils/fs-watch.js +25 -0
- package/dist/utils/fs-watch.js.map +1 -0
- package/dist/utils/git.d.ts.map +1 -1
- package/dist/utils/git.js +54 -22
- package/dist/utils/git.js.map +1 -1
- package/dist/utils/html.d.ts +7 -0
- package/dist/utils/html.d.ts.map +1 -0
- package/dist/utils/html.js +40 -0
- package/dist/utils/html.js.map +1 -0
- package/dist/utils/image-convert.d.ts.map +1 -1
- package/dist/utils/image-convert.js.map +1 -1
- package/dist/utils/image-resize-core.d.ts +30 -0
- package/dist/utils/image-resize-core.d.ts.map +1 -0
- package/dist/utils/image-resize-core.js +124 -0
- package/dist/utils/image-resize-core.js.map +1 -0
- package/dist/utils/image-resize-worker.d.ts +2 -0
- package/dist/utils/image-resize-worker.d.ts.map +1 -0
- package/dist/utils/image-resize-worker.js +31 -0
- package/dist/utils/image-resize-worker.js.map +1 -0
- package/dist/utils/image-resize.d.ts +7 -27
- package/dist/utils/image-resize.d.ts.map +1 -1
- package/dist/utils/image-resize.js +75 -115
- package/dist/utils/image-resize.js.map +1 -1
- package/dist/utils/json.d.ts +3 -0
- package/dist/utils/json.d.ts.map +1 -0
- package/dist/utils/json.js +7 -0
- package/dist/utils/json.js.map +1 -0
- package/dist/utils/mime.d.ts +1 -0
- package/dist/utils/mime.d.ts.map +1 -1
- package/dist/utils/mime.js +59 -16
- package/dist/utils/mime.js.map +1 -1
- package/dist/utils/open-browser.d.ts +9 -0
- package/dist/utils/open-browser.d.ts.map +1 -0
- package/dist/utils/open-browser.js +22 -0
- package/dist/utils/open-browser.js.map +1 -0
- package/dist/utils/paths.d.ts +25 -1
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +75 -2
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/pi-user-agent.d.ts +2 -0
- package/dist/utils/pi-user-agent.d.ts.map +1 -0
- package/dist/utils/pi-user-agent.js +5 -0
- package/dist/utils/pi-user-agent.js.map +1 -0
- package/dist/utils/shell.d.ts +10 -6
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +35 -26
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/syntax-highlight.d.ts +12 -0
- package/dist/utils/syntax-highlight.d.ts.map +1 -0
- package/dist/utils/syntax-highlight.js +118 -0
- package/dist/utils/syntax-highlight.js.map +1 -0
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +86 -10
- package/dist/utils/tools-manager.js.map +1 -1
- package/dist/utils/version-check.d.ts +15 -0
- package/dist/utils/version-check.d.ts.map +1 -0
- package/dist/utils/version-check.js +82 -0
- package/dist/utils/version-check.js.map +1 -0
- package/dist/utils/windows-self-update.d.ts +3 -0
- package/dist/utils/windows-self-update.d.ts.map +1 -0
- package/dist/utils/windows-self-update.js +77 -0
- package/dist/utils/windows-self-update.js.map +1 -0
- package/docs/compaction.md +12 -12
- package/docs/containerization.md +111 -0
- package/docs/custom-provider.md +187 -47
- package/docs/development.md +5 -5
- package/docs/docs.json +156 -0
- package/docs/extensions.md +465 -71
- package/docs/index.md +82 -0
- package/docs/json.md +4 -4
- package/docs/keybindings.md +23 -1
- package/docs/models.md +119 -17
- package/docs/packages.md +17 -9
- package/docs/prompt-templates.md +30 -2
- package/docs/providers.md +83 -22
- package/docs/quickstart.md +165 -0
- package/docs/rpc.md +41 -10
- package/docs/sdk.md +68 -50
- package/docs/security.md +55 -0
- package/docs/{session.md → session-format.md} +11 -11
- package/docs/sessions.md +145 -0
- package/docs/settings.md +61 -11
- package/docs/skills.md +16 -17
- package/docs/terminal-setup.md +44 -2
- package/docs/termux.md +4 -4
- package/docs/themes.md +3 -3
- package/docs/tmux.md +4 -2
- package/docs/tui.md +44 -4
- package/docs/usage.md +305 -0
- package/examples/extensions/border-status-editor.ts +145 -0
- package/examples/extensions/built-in-tool-renderer.ts +3 -0
- package/examples/extensions/custom-header.ts +1 -1
- package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
- package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
- package/examples/extensions/custom-provider-anthropic/package.json +2 -2
- package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
- package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
- package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
- package/examples/extensions/doom-overlay/doom-component.ts +2 -2
- package/examples/extensions/doom-overlay/index.ts +1 -1
- package/examples/extensions/dynamic-resources/dynamic.json +1 -1
- package/examples/extensions/dynamic-tools.ts +2 -2
- package/examples/extensions/git-merge-and-resolve.ts +115 -0
- package/examples/extensions/github-issue-autocomplete.ts +185 -0
- package/examples/extensions/gondolin/index.ts +531 -0
- package/examples/extensions/gondolin/package-lock.json +185 -0
- package/examples/extensions/gondolin/package.json +19 -0
- package/examples/extensions/handoff.ts +50 -12
- package/examples/extensions/input-transform-streaming.ts +39 -0
- package/examples/extensions/interactive-shell.ts +1 -1
- package/examples/extensions/notify.ts +2 -9
- package/examples/extensions/overlay-qa-tests.ts +240 -138
- package/examples/extensions/overlay-test.ts +7 -4
- package/examples/extensions/plan-mode/utils.ts +1 -1
- package/examples/extensions/preset.ts +36 -3
- package/examples/extensions/project-trust.ts +64 -0
- package/examples/extensions/prompt-customizer.ts +97 -0
- package/examples/extensions/provider-payload.ts +4 -0
- package/examples/extensions/qna.ts +1 -1
- package/examples/extensions/question.ts +2 -2
- package/examples/extensions/questionnaire.ts +2 -2
- package/examples/extensions/reload-runtime.ts +1 -1
- package/examples/extensions/sandbox/index.ts +4 -4
- package/examples/extensions/sandbox/package-lock.json +5 -5
- package/examples/extensions/sandbox/package.json +2 -2
- package/examples/extensions/shutdown-command.ts +1 -1
- package/examples/extensions/snake.ts +1 -1
- package/examples/extensions/space-invaders.ts +1 -1
- package/examples/extensions/structured-output.ts +65 -0
- package/examples/extensions/subagent/index.ts +51 -28
- package/examples/extensions/summarize.ts +1 -1
- package/examples/extensions/tic-tac-toe.ts +1008 -0
- package/examples/extensions/titlebar-spinner.ts +2 -2
- package/examples/extensions/todo.ts +2 -2
- package/examples/extensions/tool-override.ts +1 -1
- package/examples/extensions/tools.ts +5 -0
- package/examples/extensions/truncated-tool.ts +1 -1
- package/examples/extensions/with-deps/index.ts +1 -1
- package/examples/extensions/with-deps/package-lock.json +2 -2
- package/examples/extensions/with-deps/package.json +3 -3
- package/examples/extensions/working-indicator.ts +123 -0
- package/examples/extensions/working-message-test.ts +25 -0
- package/examples/sdk/01-minimal.ts +14 -10
- package/examples/sdk/02-custom-model.ts +12 -8
- package/examples/sdk/03-custom-prompt.ts +32 -17
- package/examples/sdk/04-skills.ts +5 -2
- package/examples/sdk/05-tools.ts +23 -31
- package/examples/sdk/06-extensions.ts +14 -8
- package/examples/sdk/07-context-files.ts +5 -3
- package/examples/sdk/08-prompt-templates.ts +5 -2
- package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
- package/examples/sdk/10-settings.ts +8 -6
- package/examples/sdk/11-sessions.ts +4 -0
- package/examples/sdk/12-full-control.ts +13 -17
- package/package.json +15 -7
- package/prompts/commands/atomic-commit.md +12 -0
- package/prompts/commands/execute-phase.md +48 -17
- package/prompts/commands/fix.md +86 -23
- package/prompts/commands/map-codebase.md +17 -3
- package/prompts/commands/orchestrate.md +31 -6
- package/prompts/commands/plan-phase.md +39 -6
- package/prompts/commands/quick.md +36 -6
- package/prompts/commands/review.md +28 -11
- package/prompts/commands/verify-work.md +34 -17
|
@@ -7,28 +7,30 @@
|
|
|
7
7
|
* - Register commands, keyboard shortcuts, and CLI flags
|
|
8
8
|
* - Interact with the user via UI primitives
|
|
9
9
|
*/
|
|
10
|
-
import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel } from "@draht/agent-core";
|
|
10
|
+
import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode } from "@draht/agent-core";
|
|
11
11
|
import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, OAuthCredentials, OAuthLoginCallbacks, SimpleStreamOptions, TextContent, ToolResultMessage } from "@draht/ai";
|
|
12
|
-
import type { AutocompleteItem, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@draht/tui";
|
|
13
|
-
import type { Static, TSchema } from "
|
|
14
|
-
import type { Theme } from "../../modes/interactive/theme/theme.
|
|
15
|
-
import type { BashResult } from "../bash-executor.
|
|
16
|
-
import type { CompactionPreparation, CompactionResult } from "../compaction/index.
|
|
17
|
-
import type { EventBus } from "../event-bus.
|
|
18
|
-
import type { ExecOptions, ExecResult } from "../exec.
|
|
19
|
-
import type { ReadonlyFooterDataProvider } from "../footer-data-provider.
|
|
20
|
-
import type { KeybindingsManager } from "../keybindings.
|
|
21
|
-
import type { CustomMessage } from "../messages.
|
|
22
|
-
import type { ModelRegistry } from "../model-registry.
|
|
23
|
-
import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.
|
|
24
|
-
import type { SlashCommandInfo } from "../slash-commands.
|
|
25
|
-
import type { SourceInfo } from "../source-info.
|
|
26
|
-
import type {
|
|
27
|
-
import type {
|
|
28
|
-
import type {
|
|
29
|
-
|
|
30
|
-
export type {
|
|
31
|
-
export type {
|
|
12
|
+
import type { AutocompleteItem, AutocompleteProvider, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@draht/tui";
|
|
13
|
+
import type { Static, TSchema } from "typebox";
|
|
14
|
+
import type { Theme } from "../../modes/interactive/theme/theme.ts";
|
|
15
|
+
import type { BashResult } from "../bash-executor.ts";
|
|
16
|
+
import type { CompactionPreparation, CompactionResult } from "../compaction/index.ts";
|
|
17
|
+
import type { EventBus } from "../event-bus.ts";
|
|
18
|
+
import type { ExecOptions, ExecResult } from "../exec.ts";
|
|
19
|
+
import type { ReadonlyFooterDataProvider } from "../footer-data-provider.ts";
|
|
20
|
+
import type { KeybindingsManager } from "../keybindings.ts";
|
|
21
|
+
import type { CustomMessage } from "../messages.ts";
|
|
22
|
+
import type { ModelRegistry } from "../model-registry.ts";
|
|
23
|
+
import type { BranchSummaryEntry, CompactionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
|
|
24
|
+
import type { SlashCommandInfo } from "../slash-commands.ts";
|
|
25
|
+
import type { SourceInfo } from "../source-info.ts";
|
|
26
|
+
import type { BuildSystemPromptOptions } from "../system-prompt.ts";
|
|
27
|
+
import type { BashOperations } from "../tools/bash.ts";
|
|
28
|
+
import type { EditToolDetails } from "../tools/edit.ts";
|
|
29
|
+
import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
|
|
30
|
+
export type { ExecOptions, ExecResult } from "../exec.ts";
|
|
31
|
+
export type { BuildSystemPromptOptions } from "../system-prompt.ts";
|
|
32
|
+
export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
|
|
33
|
+
export type { AppKeybinding, KeybindingsManager } from "../keybindings.ts";
|
|
32
34
|
/** Options for extension UI dialogs. */
|
|
33
35
|
export interface ExtensionUIDialogOptions {
|
|
34
36
|
/** AbortSignal to programmatically dismiss the dialog. */
|
|
@@ -48,6 +50,16 @@ export type TerminalInputHandler = (data: string) => {
|
|
|
48
50
|
consume?: boolean;
|
|
49
51
|
data?: string;
|
|
50
52
|
} | undefined;
|
|
53
|
+
/** Working indicator configuration for the interactive streaming loader. */
|
|
54
|
+
export interface WorkingIndicatorOptions {
|
|
55
|
+
/** Animation frames. Use an empty array to hide the indicator entirely. Custom frames are rendered verbatim. */
|
|
56
|
+
frames?: string[];
|
|
57
|
+
/** Frame interval in milliseconds for animated indicators. */
|
|
58
|
+
intervalMs?: number;
|
|
59
|
+
}
|
|
60
|
+
/** Wrap the current autocomplete provider with additional behavior. */
|
|
61
|
+
export type AutocompleteProviderFactory = (current: AutocompleteProvider) => AutocompleteProvider;
|
|
62
|
+
export type EditorFactory = (tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => EditorComponent;
|
|
51
63
|
/**
|
|
52
64
|
* UI context for extensions to request interactive UI.
|
|
53
65
|
* Each mode (interactive, RPC, print) provides its own implementation.
|
|
@@ -67,6 +79,17 @@ export interface ExtensionUIContext {
|
|
|
67
79
|
setStatus(key: string, text: string | undefined): void;
|
|
68
80
|
/** Set the working/loading message shown during streaming. Call with no argument to restore default. */
|
|
69
81
|
setWorkingMessage(message?: string): void;
|
|
82
|
+
/** Show or hide the built-in interactive working loader row during streaming. */
|
|
83
|
+
setWorkingVisible(visible: boolean): void;
|
|
84
|
+
/**
|
|
85
|
+
* Configure the interactive working indicator shown during streaming.
|
|
86
|
+
*
|
|
87
|
+
* - Omit the argument to restore the default animated spinner.
|
|
88
|
+
* - Use `frames: ["●"]` for a static indicator.
|
|
89
|
+
* - Use `frames: []` to hide the indicator entirely.
|
|
90
|
+
* - Custom frames are rendered as provided, so extensions must add their own colors.
|
|
91
|
+
*/
|
|
92
|
+
setWorkingIndicator(options?: WorkingIndicatorOptions): void;
|
|
70
93
|
/** Set the label shown for hidden thinking blocks. Call with no argument to restore default. */
|
|
71
94
|
setHiddenThinkingLabel(label?: string): void;
|
|
72
95
|
/** Set a widget to display above or below the editor. Accepts string array or component factory. */
|
|
@@ -109,6 +132,8 @@ export interface ExtensionUIContext {
|
|
|
109
132
|
getEditorText(): string;
|
|
110
133
|
/** Show a multi-line editor for text editing. */
|
|
111
134
|
editor(title: string, prefill?: string): Promise<string | undefined>;
|
|
135
|
+
/** Stack additional autocomplete behavior on top of the built-in provider. */
|
|
136
|
+
addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
|
|
112
137
|
/**
|
|
113
138
|
* Set a custom editor component via factory function.
|
|
114
139
|
* Pass undefined to restore the default editor.
|
|
@@ -142,7 +167,9 @@ export interface ExtensionUIContext {
|
|
|
142
167
|
* );
|
|
143
168
|
* ```
|
|
144
169
|
*/
|
|
145
|
-
setEditorComponent(factory:
|
|
170
|
+
setEditorComponent(factory: EditorFactory | undefined): void;
|
|
171
|
+
/** Get the currently configured custom editor factory, or undefined when using the default editor. */
|
|
172
|
+
getEditorComponent(): EditorFactory | undefined;
|
|
146
173
|
/** Get the current theme for styling. */
|
|
147
174
|
readonly theme: Theme;
|
|
148
175
|
/** Get all available themes with their names and file paths. */
|
|
@@ -177,10 +204,13 @@ export interface CompactOptions {
|
|
|
177
204
|
/**
|
|
178
205
|
* Context passed to extension event handlers.
|
|
179
206
|
*/
|
|
207
|
+
export type ExtensionMode = "tui" | "rpc" | "json" | "print";
|
|
180
208
|
export interface ExtensionContext {
|
|
181
209
|
/** UI methods for user interaction */
|
|
182
210
|
ui: ExtensionUIContext;
|
|
183
|
-
/**
|
|
211
|
+
/** Current run mode. Use "tui" to guard terminal-only UI such as custom components. */
|
|
212
|
+
mode: ExtensionMode;
|
|
213
|
+
/** Whether dialog-capable UI is available (true in TUI and RPC modes) */
|
|
184
214
|
hasUI: boolean;
|
|
185
215
|
/** Current working directory */
|
|
186
216
|
cwd: string;
|
|
@@ -192,6 +222,8 @@ export interface ExtensionContext {
|
|
|
192
222
|
model: Model<any> | undefined;
|
|
193
223
|
/** Whether the agent is idle (not streaming) */
|
|
194
224
|
isIdle(): boolean;
|
|
225
|
+
/** Whether project-local trust is active for this context. */
|
|
226
|
+
isProjectTrusted(): boolean;
|
|
195
227
|
/** The current abort signal, or undefined when the agent is not streaming. */
|
|
196
228
|
signal: AbortSignal | undefined;
|
|
197
229
|
/** Abort the current agent operation */
|
|
@@ -212,17 +244,23 @@ export interface ExtensionContext {
|
|
|
212
244
|
* Includes session control methods only safe in user-initiated commands.
|
|
213
245
|
*/
|
|
214
246
|
export interface ExtensionCommandContext extends ExtensionContext {
|
|
247
|
+
/** Get the current base system-prompt construction options. */
|
|
248
|
+
getSystemPromptOptions(): BuildSystemPromptOptions;
|
|
215
249
|
/** Wait for the agent to finish streaming */
|
|
216
250
|
waitForIdle(): Promise<void>;
|
|
217
251
|
/** Start a new session, optionally with initialization. */
|
|
218
252
|
newSession(options?: {
|
|
219
253
|
parentSession?: string;
|
|
220
254
|
setup?: (sessionManager: SessionManager) => Promise<void>;
|
|
255
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
221
256
|
}): Promise<{
|
|
222
257
|
cancelled: boolean;
|
|
223
258
|
}>;
|
|
224
259
|
/** Fork from a specific entry, creating a new session file. */
|
|
225
|
-
fork(entryId: string
|
|
260
|
+
fork(entryId: string, options?: {
|
|
261
|
+
position?: "before" | "at";
|
|
262
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
263
|
+
}): Promise<{
|
|
226
264
|
cancelled: boolean;
|
|
227
265
|
}>;
|
|
228
266
|
/** Navigate to a different point in the session tree. */
|
|
@@ -235,12 +273,28 @@ export interface ExtensionCommandContext extends ExtensionContext {
|
|
|
235
273
|
cancelled: boolean;
|
|
236
274
|
}>;
|
|
237
275
|
/** Switch to a different session file. */
|
|
238
|
-
switchSession(sessionPath: string
|
|
276
|
+
switchSession(sessionPath: string, options?: {
|
|
277
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
278
|
+
}): Promise<{
|
|
239
279
|
cancelled: boolean;
|
|
240
280
|
}>;
|
|
241
281
|
/** Reload extensions, skills, prompts, and themes. */
|
|
242
282
|
reload(): Promise<void>;
|
|
243
283
|
}
|
|
284
|
+
/**
|
|
285
|
+
* Fresh command-capable context bound to the replacement session after a session switch.
|
|
286
|
+
*
|
|
287
|
+
* This is passed to `withSession()` callbacks on `newSession()`, `fork()`, and `switchSession()`.
|
|
288
|
+
*/
|
|
289
|
+
export interface ReplacedSessionContext extends ExtensionCommandContext {
|
|
290
|
+
sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
|
|
291
|
+
triggerTurn?: boolean;
|
|
292
|
+
deliverAs?: "steer" | "followUp" | "nextTurn";
|
|
293
|
+
}): Promise<void>;
|
|
294
|
+
sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
|
|
295
|
+
deliverAs?: "steer" | "followUp";
|
|
296
|
+
}): Promise<void>;
|
|
297
|
+
}
|
|
244
298
|
/** Rendering options for tool results */
|
|
245
299
|
export interface ToolRenderResultOptions {
|
|
246
300
|
/** Whether the result view is expanded */
|
|
@@ -291,8 +345,18 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
|
|
|
291
345
|
promptGuidelines?: string[];
|
|
292
346
|
/** Parameter schema (TypeBox) */
|
|
293
347
|
parameters: TParams;
|
|
348
|
+
/** Controls whether ToolExecutionComponent renders the standard colored shell or the tool renders its own framing. */
|
|
349
|
+
renderShell?: "default" | "self";
|
|
294
350
|
/** Optional compatibility shim to prepare raw tool call arguments before schema validation. Must return an object conforming to TParams. */
|
|
295
351
|
prepareArguments?: (args: unknown) => Static<TParams>;
|
|
352
|
+
/**
|
|
353
|
+
* Per-tool execution mode override.
|
|
354
|
+
* - "sequential": this tool must execute one at a time with other tool calls.
|
|
355
|
+
* - "parallel": this tool can execute concurrently with other tool calls.
|
|
356
|
+
*
|
|
357
|
+
* If omitted, the default execution mode applies.
|
|
358
|
+
*/
|
|
359
|
+
executionMode?: ToolExecutionMode;
|
|
296
360
|
/** Execute the tool. */
|
|
297
361
|
execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<TDetails>>;
|
|
298
362
|
/** Custom rendering for tool call display */
|
|
@@ -309,6 +373,22 @@ type AnyToolDefinition = ToolDefinition<any, any, any>;
|
|
|
309
373
|
* `unknown`.
|
|
310
374
|
*/
|
|
311
375
|
export declare function defineTool<TParams extends TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>): ToolDefinition<TParams, TDetails, TState> & AnyToolDefinition;
|
|
376
|
+
export interface ProjectTrustEvent {
|
|
377
|
+
type: "project_trust";
|
|
378
|
+
cwd: string;
|
|
379
|
+
}
|
|
380
|
+
export type ProjectTrustEventDecision = "yes" | "no" | "undecided";
|
|
381
|
+
export interface ProjectTrustEventResult {
|
|
382
|
+
trusted: ProjectTrustEventDecision;
|
|
383
|
+
remember?: boolean;
|
|
384
|
+
}
|
|
385
|
+
export interface ProjectTrustContext {
|
|
386
|
+
cwd: string;
|
|
387
|
+
mode: ExtensionMode;
|
|
388
|
+
hasUI: boolean;
|
|
389
|
+
ui: Pick<ExtensionUIContext, "select" | "confirm" | "input" | "notify">;
|
|
390
|
+
}
|
|
391
|
+
export type ProjectTrustHandler = (event: ProjectTrustEvent, ctx: ProjectTrustContext) => Promise<ProjectTrustEventResult> | ProjectTrustEventResult;
|
|
312
392
|
/** Fired after session_start to allow extensions to provide additional resource paths. */
|
|
313
393
|
export interface ResourcesDiscoverEvent {
|
|
314
394
|
type: "resources_discover";
|
|
@@ -339,6 +419,7 @@ export interface SessionBeforeSwitchEvent {
|
|
|
339
419
|
export interface SessionBeforeForkEvent {
|
|
340
420
|
type: "session_before_fork";
|
|
341
421
|
entryId: string;
|
|
422
|
+
position: "before" | "at";
|
|
342
423
|
}
|
|
343
424
|
/** Fired before context compaction (can be cancelled or customized) */
|
|
344
425
|
export interface SessionBeforeCompactEvent {
|
|
@@ -354,9 +435,12 @@ export interface SessionCompactEvent {
|
|
|
354
435
|
compactionEntry: CompactionEntry;
|
|
355
436
|
fromExtension: boolean;
|
|
356
437
|
}
|
|
357
|
-
/** Fired
|
|
438
|
+
/** Fired before an extension runtime is torn down due to quit, reload, or session replacement. */
|
|
358
439
|
export interface SessionShutdownEvent {
|
|
359
440
|
type: "session_shutdown";
|
|
441
|
+
reason: "quit" | "reload" | "new" | "resume" | "fork";
|
|
442
|
+
/** Destination session file when shutting down due to session replacement. */
|
|
443
|
+
targetSessionFile?: string;
|
|
360
444
|
}
|
|
361
445
|
/** Preparation data for tree navigation */
|
|
362
446
|
export interface TreePreparation {
|
|
@@ -397,12 +481,23 @@ export interface BeforeProviderRequestEvent {
|
|
|
397
481
|
type: "before_provider_request";
|
|
398
482
|
payload: unknown;
|
|
399
483
|
}
|
|
484
|
+
/** Fired after a provider response is received and before the response stream is consumed. */
|
|
485
|
+
export interface AfterProviderResponseEvent {
|
|
486
|
+
type: "after_provider_response";
|
|
487
|
+
status: number;
|
|
488
|
+
headers: Record<string, string>;
|
|
489
|
+
}
|
|
400
490
|
/** Fired after user submits prompt but before agent loop. */
|
|
401
491
|
export interface BeforeAgentStartEvent {
|
|
402
492
|
type: "before_agent_start";
|
|
493
|
+
/** The raw user prompt text (after expansion). */
|
|
403
494
|
prompt: string;
|
|
495
|
+
/** Images attached to the user prompt, if any. */
|
|
404
496
|
images?: ImageContent[];
|
|
497
|
+
/** The fully assembled system prompt string. */
|
|
405
498
|
systemPrompt: string;
|
|
499
|
+
/** Structured options used to build the system prompt. Extensions can inspect this to understand what Pi loaded without re-discovering resources. */
|
|
500
|
+
systemPromptOptions: BuildSystemPromptOptions;
|
|
406
501
|
}
|
|
407
502
|
/** Fired when an agent loop starts */
|
|
408
503
|
export interface AgentStartEvent {
|
|
@@ -473,6 +568,12 @@ export interface ModelSelectEvent {
|
|
|
473
568
|
previousModel: Model<any> | undefined;
|
|
474
569
|
source: ModelSelectSource;
|
|
475
570
|
}
|
|
571
|
+
/** Fired when a new thinking level is selected */
|
|
572
|
+
export interface ThinkingLevelSelectEvent {
|
|
573
|
+
type: "thinking_level_select";
|
|
574
|
+
level: ThinkingLevel;
|
|
575
|
+
previousLevel: ThinkingLevel;
|
|
576
|
+
}
|
|
476
577
|
/** Fired when user executes a bash command via ! or !! prefix */
|
|
477
578
|
export interface UserBashEvent {
|
|
478
579
|
type: "user_bash";
|
|
@@ -494,6 +595,8 @@ export interface InputEvent {
|
|
|
494
595
|
images?: ImageContent[];
|
|
495
596
|
/** Where the input came from */
|
|
496
597
|
source: InputSource;
|
|
598
|
+
/** How the input will be delivered during streaming, or undefined when idle */
|
|
599
|
+
streamingBehavior?: "steer" | "followUp";
|
|
497
600
|
}
|
|
498
601
|
/** Result from input event handler */
|
|
499
602
|
export type InputEventResult = {
|
|
@@ -628,7 +731,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
|
|
|
628
731
|
input: TInput;
|
|
629
732
|
};
|
|
630
733
|
/** Union of all event types */
|
|
631
|
-
export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
|
|
734
|
+
export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
|
|
632
735
|
export interface ContextEventResult {
|
|
633
736
|
messages?: AgentMessage[];
|
|
634
737
|
}
|
|
@@ -650,6 +753,10 @@ export interface ToolResultEventResult {
|
|
|
650
753
|
details?: unknown;
|
|
651
754
|
isError?: boolean;
|
|
652
755
|
}
|
|
756
|
+
export interface MessageEndEventResult {
|
|
757
|
+
/** Replace the finalized message. The replacement must keep the original message role. */
|
|
758
|
+
message?: AgentMessage;
|
|
759
|
+
}
|
|
653
760
|
export interface BeforeAgentStartEventResult {
|
|
654
761
|
message?: Pick<CustomMessage, "customType" | "content" | "display" | "details">;
|
|
655
762
|
/** Replace the system prompt for this turn. If multiple extensions return this, they are chained. */
|
|
@@ -699,6 +806,7 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
|
|
|
699
806
|
* ExtensionAPI passed to extension factory functions.
|
|
700
807
|
*/
|
|
701
808
|
export interface ExtensionAPI {
|
|
809
|
+
on(event: "project_trust", handler: ProjectTrustHandler): void;
|
|
702
810
|
on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
|
|
703
811
|
on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
|
|
704
812
|
on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
|
|
@@ -710,6 +818,7 @@ export interface ExtensionAPI {
|
|
|
710
818
|
on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
|
|
711
819
|
on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): void;
|
|
712
820
|
on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): void;
|
|
821
|
+
on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): void;
|
|
713
822
|
on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
|
|
714
823
|
on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
|
|
715
824
|
on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
|
|
@@ -717,11 +826,12 @@ export interface ExtensionAPI {
|
|
|
717
826
|
on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
|
|
718
827
|
on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
|
|
719
828
|
on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): void;
|
|
720
|
-
on(event: "message_end", handler: ExtensionHandler<MessageEndEvent>): void;
|
|
829
|
+
on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): void;
|
|
721
830
|
on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
|
|
722
831
|
on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
|
|
723
832
|
on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
|
|
724
833
|
on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): void;
|
|
834
|
+
on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): void;
|
|
725
835
|
on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
|
|
726
836
|
on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
|
|
727
837
|
on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
|
|
@@ -769,7 +879,7 @@ export interface ExtensionAPI {
|
|
|
769
879
|
exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
|
|
770
880
|
/** Get the list of currently active tool names. */
|
|
771
881
|
getActiveTools(): string[];
|
|
772
|
-
/** Get all configured tools with parameter schema and source metadata. */
|
|
882
|
+
/** Get all configured tools with parameter schema, prompt guidelines, and source metadata. */
|
|
773
883
|
getAllTools(): ToolInfo[];
|
|
774
884
|
/** Set the active tools by name. */
|
|
775
885
|
setActiveTools(toolNames: string[]): void;
|
|
@@ -798,7 +908,7 @@ export interface ExtensionAPI {
|
|
|
798
908
|
* // Register a new provider with custom models
|
|
799
909
|
* pi.registerProvider("my-proxy", {
|
|
800
910
|
* baseUrl: "https://proxy.example.com",
|
|
801
|
-
* apiKey: "PROXY_API_KEY",
|
|
911
|
+
* apiKey: "$PROXY_API_KEY",
|
|
802
912
|
* api: "anthropic-messages",
|
|
803
913
|
* models: [
|
|
804
914
|
* {
|
|
@@ -853,9 +963,11 @@ export interface ExtensionAPI {
|
|
|
853
963
|
}
|
|
854
964
|
/** Configuration for registering a provider via pi.registerProvider(). */
|
|
855
965
|
export interface ProviderConfig {
|
|
966
|
+
/** Display name for the provider in UI. */
|
|
967
|
+
name?: string;
|
|
856
968
|
/** Base URL for the API endpoint. Required when defining models. */
|
|
857
969
|
baseUrl?: string;
|
|
858
|
-
/** API key or
|
|
970
|
+
/** API key literal, env interpolation ($ENV_VAR or ${ENV_VAR}), or leading !command. Required when defining models (unless oauth provided). */
|
|
859
971
|
apiKey?: string;
|
|
860
972
|
/** API type. Required at provider or model level when defining models. */
|
|
861
973
|
api?: Api;
|
|
@@ -889,8 +1001,12 @@ export interface ProviderModelConfig {
|
|
|
889
1001
|
name: string;
|
|
890
1002
|
/** API type override for this model. */
|
|
891
1003
|
api?: Api;
|
|
1004
|
+
/** API endpoint URL override for this model. */
|
|
1005
|
+
baseUrl?: string;
|
|
892
1006
|
/** Whether the model supports extended thinking. */
|
|
893
1007
|
reasoning: boolean;
|
|
1008
|
+
/** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
|
|
1009
|
+
thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
|
|
894
1010
|
/** Supported input types. */
|
|
895
1011
|
input: ("text" | "image")[];
|
|
896
1012
|
/** Cost per token (for tracking, can be 0). */
|
|
@@ -940,8 +1056,8 @@ export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) =>
|
|
|
940
1056
|
export type SetSessionNameHandler = (name: string) => void;
|
|
941
1057
|
export type GetSessionNameHandler = () => string | undefined;
|
|
942
1058
|
export type GetActiveToolsHandler = () => string[];
|
|
943
|
-
/** Tool info with name, description, parameter schema, and source metadata */
|
|
944
|
-
export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters"> & {
|
|
1059
|
+
/** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
|
|
1060
|
+
export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
|
|
945
1061
|
sourceInfo: SourceInfo;
|
|
946
1062
|
};
|
|
947
1063
|
export type GetAllToolsHandler = () => ToolInfo[];
|
|
@@ -964,6 +1080,10 @@ export interface ExtensionRuntimeState {
|
|
|
964
1080
|
config: ProviderConfig;
|
|
965
1081
|
extensionPath: string;
|
|
966
1082
|
}>;
|
|
1083
|
+
/** Throws when this extension instance is stale after runtime replacement. */
|
|
1084
|
+
assertActive: () => void;
|
|
1085
|
+
/** Marks this extension instance as stale after runtime replacement or reload. */
|
|
1086
|
+
invalidate: (message?: string) => void;
|
|
967
1087
|
/**
|
|
968
1088
|
* Register or unregister a provider.
|
|
969
1089
|
*
|
|
@@ -1000,6 +1120,7 @@ export interface ExtensionActions {
|
|
|
1000
1120
|
export interface ExtensionContextActions {
|
|
1001
1121
|
getModel: () => Model<any> | undefined;
|
|
1002
1122
|
isIdle: () => boolean;
|
|
1123
|
+
isProjectTrusted: () => boolean;
|
|
1003
1124
|
getSignal: () => AbortSignal | undefined;
|
|
1004
1125
|
abort: () => void;
|
|
1005
1126
|
hasPendingMessages: () => boolean;
|
|
@@ -1007,6 +1128,7 @@ export interface ExtensionContextActions {
|
|
|
1007
1128
|
getContextUsage: () => ContextUsage | undefined;
|
|
1008
1129
|
compact: (options?: CompactOptions) => void;
|
|
1009
1130
|
getSystemPrompt: () => string;
|
|
1131
|
+
getSystemPromptOptions?: () => BuildSystemPromptOptions;
|
|
1010
1132
|
}
|
|
1011
1133
|
/**
|
|
1012
1134
|
* Actions for ExtensionCommandContext (ctx.* in command handlers).
|
|
@@ -1017,10 +1139,14 @@ export interface ExtensionCommandContextActions {
|
|
|
1017
1139
|
newSession: (options?: {
|
|
1018
1140
|
parentSession?: string;
|
|
1019
1141
|
setup?: (sessionManager: SessionManager) => Promise<void>;
|
|
1142
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
1020
1143
|
}) => Promise<{
|
|
1021
1144
|
cancelled: boolean;
|
|
1022
1145
|
}>;
|
|
1023
|
-
fork: (entryId: string
|
|
1146
|
+
fork: (entryId: string, options?: {
|
|
1147
|
+
position?: "before" | "at";
|
|
1148
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
1149
|
+
}) => Promise<{
|
|
1024
1150
|
cancelled: boolean;
|
|
1025
1151
|
}>;
|
|
1026
1152
|
navigateTree: (targetId: string, options?: {
|
|
@@ -1031,7 +1157,9 @@ export interface ExtensionCommandContextActions {
|
|
|
1031
1157
|
}) => Promise<{
|
|
1032
1158
|
cancelled: boolean;
|
|
1033
1159
|
}>;
|
|
1034
|
-
switchSession: (sessionPath: string
|
|
1160
|
+
switchSession: (sessionPath: string, options?: {
|
|
1161
|
+
withSession?: (ctx: ReplacedSessionContext) => Promise<void>;
|
|
1162
|
+
}) => Promise<{
|
|
1035
1163
|
cancelled: boolean;
|
|
1036
1164
|
}>;
|
|
1037
1165
|
reload: () => Promise<void>;
|