@draht/coding-agent 2026.3.25 → 2026.4.23

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.
Files changed (265) hide show
  1. package/CHANGELOG.md +896 -624
  2. package/README.md +110 -97
  3. package/dist/cli/args.d.ts +7 -10
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +42 -44
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/cli.d.ts.map +1 -1
  8. package/dist/cli.js +1 -0
  9. package/dist/cli.js.map +1 -1
  10. package/dist/config.d.ts +9 -0
  11. package/dist/config.d.ts.map +1 -1
  12. package/dist/config.js +18 -0
  13. package/dist/config.js.map +1 -1
  14. package/dist/core/agent-session-runtime.d.ts +83 -0
  15. package/dist/core/agent-session-runtime.d.ts.map +1 -0
  16. package/dist/core/agent-session-runtime.js +236 -0
  17. package/dist/core/agent-session-runtime.js.map +1 -0
  18. package/dist/core/agent-session-services.d.ts +86 -0
  19. package/dist/core/agent-session-services.d.ts.map +1 -0
  20. package/dist/core/agent-session-services.js +116 -0
  21. package/dist/core/agent-session-services.js.map +1 -0
  22. package/dist/core/agent-session.d.ts +17 -47
  23. package/dist/core/agent-session.d.ts.map +1 -1
  24. package/dist/core/agent-session.js +166 -291
  25. package/dist/core/agent-session.js.map +1 -1
  26. package/dist/core/auth-storage.d.ts +3 -1
  27. package/dist/core/auth-storage.d.ts.map +1 -1
  28. package/dist/core/auth-storage.js +5 -2
  29. package/dist/core/auth-storage.js.map +1 -1
  30. package/dist/core/bash-executor.d.ts.map +1 -1
  31. package/dist/core/bash-executor.js +19 -7
  32. package/dist/core/bash-executor.js.map +1 -1
  33. package/dist/core/compaction/branch-summarization.d.ts +2 -0
  34. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  35. package/dist/core/compaction/branch-summarization.js +2 -2
  36. package/dist/core/compaction/branch-summarization.js.map +1 -1
  37. package/dist/core/compaction/compaction.d.ts +3 -3
  38. package/dist/core/compaction/compaction.d.ts.map +1 -1
  39. package/dist/core/compaction/compaction.js +27 -26
  40. package/dist/core/compaction/compaction.js.map +1 -1
  41. package/dist/core/export-html/tool-renderer.d.ts +2 -0
  42. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  43. package/dist/core/export-html/tool-renderer.js +2 -2
  44. package/dist/core/export-html/tool-renderer.js.map +1 -1
  45. package/dist/core/extensions/index.d.ts +2 -2
  46. package/dist/core/extensions/index.d.ts.map +1 -1
  47. package/dist/core/extensions/index.js +1 -1
  48. package/dist/core/extensions/index.js.map +1 -1
  49. package/dist/core/extensions/loader.d.ts.map +1 -1
  50. package/dist/core/extensions/loader.js +7 -7
  51. package/dist/core/extensions/loader.js.map +1 -1
  52. package/dist/core/extensions/runner.d.ts +1 -0
  53. package/dist/core/extensions/runner.d.ts.map +1 -1
  54. package/dist/core/extensions/runner.js +4 -0
  55. package/dist/core/extensions/runner.js.map +1 -1
  56. package/dist/core/extensions/types.d.ts +30 -29
  57. package/dist/core/extensions/types.d.ts.map +1 -1
  58. package/dist/core/extensions/types.js +10 -0
  59. package/dist/core/extensions/types.js.map +1 -1
  60. package/dist/core/footer-data-provider.d.ts +5 -1
  61. package/dist/core/footer-data-provider.d.ts.map +1 -1
  62. package/dist/core/footer-data-provider.js +70 -8
  63. package/dist/core/footer-data-provider.js.map +1 -1
  64. package/dist/core/index.d.ts +3 -1
  65. package/dist/core/index.d.ts.map +1 -1
  66. package/dist/core/index.js +3 -1
  67. package/dist/core/index.js.map +1 -1
  68. package/dist/core/keybindings.d.ts +14 -1
  69. package/dist/core/keybindings.d.ts.map +1 -1
  70. package/dist/core/keybindings.js +13 -14
  71. package/dist/core/keybindings.js.map +1 -1
  72. package/dist/core/model-registry.d.ts +21 -3
  73. package/dist/core/model-registry.d.ts.map +1 -1
  74. package/dist/core/model-registry.js +120 -71
  75. package/dist/core/model-registry.js.map +1 -1
  76. package/dist/core/model-resolver.d.ts.map +1 -1
  77. package/dist/core/model-resolver.js +4 -4
  78. package/dist/core/model-resolver.js.map +1 -1
  79. package/dist/core/package-manager.d.ts +21 -1
  80. package/dist/core/package-manager.d.ts.map +1 -1
  81. package/dist/core/package-manager.js +108 -43
  82. package/dist/core/package-manager.js.map +1 -1
  83. package/dist/core/prompt-templates.d.ts.map +1 -1
  84. package/dist/core/prompt-templates.js +1 -22
  85. package/dist/core/prompt-templates.js.map +1 -1
  86. package/dist/core/resolve-config-value.d.ts +6 -0
  87. package/dist/core/resolve-config-value.d.ts.map +1 -1
  88. package/dist/core/resolve-config-value.js +37 -5
  89. package/dist/core/resolve-config-value.js.map +1 -1
  90. package/dist/core/resource-loader.d.ts.map +1 -1
  91. package/dist/core/resource-loader.js +25 -3
  92. package/dist/core/resource-loader.js.map +1 -1
  93. package/dist/core/sdk.d.ts +7 -4
  94. package/dist/core/sdk.d.ts.map +1 -1
  95. package/dist/core/sdk.js +18 -24
  96. package/dist/core/sdk.js.map +1 -1
  97. package/dist/core/session-cwd.d.ts +19 -0
  98. package/dist/core/session-cwd.d.ts.map +1 -0
  99. package/dist/core/session-cwd.js +38 -0
  100. package/dist/core/session-cwd.js.map +1 -0
  101. package/dist/core/session-manager.d.ts +5 -1
  102. package/dist/core/session-manager.d.ts.map +1 -1
  103. package/dist/core/session-manager.js +16 -8
  104. package/dist/core/session-manager.js.map +1 -1
  105. package/dist/core/settings-manager.d.ts +3 -1
  106. package/dist/core/settings-manager.d.ts.map +1 -1
  107. package/dist/core/settings-manager.js +5 -1
  108. package/dist/core/settings-manager.js.map +1 -1
  109. package/dist/core/skills.d.ts +1 -1
  110. package/dist/core/skills.d.ts.map +1 -1
  111. package/dist/core/skills.js +3 -3
  112. package/dist/core/skills.js.map +1 -1
  113. package/dist/core/system-prompt.d.ts.map +1 -1
  114. package/dist/core/system-prompt.js +6 -6
  115. package/dist/core/system-prompt.js.map +1 -1
  116. package/dist/core/timings.d.ts +1 -0
  117. package/dist/core/timings.d.ts.map +1 -1
  118. package/dist/core/timings.js +6 -0
  119. package/dist/core/timings.js.map +1 -1
  120. package/dist/core/tools/bash.d.ts.map +1 -1
  121. package/dist/core/tools/bash.js +19 -9
  122. package/dist/core/tools/bash.js.map +1 -1
  123. package/dist/core/tools/edit-diff.d.ts +23 -1
  124. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  125. package/dist/core/tools/edit-diff.js +150 -57
  126. package/dist/core/tools/edit-diff.js.map +1 -1
  127. package/dist/core/tools/edit.d.ts +13 -11
  128. package/dist/core/tools/edit.d.ts.map +1 -1
  129. package/dist/core/tools/edit.js +55 -77
  130. package/dist/core/tools/edit.js.map +1 -1
  131. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  132. package/dist/core/tools/file-mutation-queue.js +4 -4
  133. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  134. package/dist/core/tools/index.d.ts +9 -6
  135. package/dist/core/tools/index.d.ts.map +1 -1
  136. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  137. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  138. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  139. package/dist/index.d.ts +4 -6
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +4 -6
  142. package/dist/index.js.map +1 -1
  143. package/dist/main.d.ts.map +1 -1
  144. package/dist/main.js +259 -422
  145. package/dist/main.js.map +1 -1
  146. package/dist/migrations.d.ts +3 -3
  147. package/dist/migrations.d.ts.map +1 -1
  148. package/dist/migrations.js +25 -5
  149. package/dist/migrations.js.map +1 -1
  150. package/dist/modes/interactive/components/assistant-message.d.ts +3 -1
  151. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  152. package/dist/modes/interactive/components/assistant-message.js +14 -3
  153. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  154. package/dist/modes/interactive/components/earendil-announcement.d.ts +5 -0
  155. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -0
  156. package/dist/modes/interactive/components/earendil-announcement.js +40 -0
  157. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -0
  158. package/dist/modes/interactive/components/footer.d.ts +1 -0
  159. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  160. package/dist/modes/interactive/components/footer.js +4 -1
  161. package/dist/modes/interactive/components/footer.js.map +1 -1
  162. package/dist/modes/interactive/components/tool-execution.d.ts +0 -1
  163. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  164. package/dist/modes/interactive/components/tool-execution.js +2 -7
  165. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  166. package/dist/modes/interactive/components/tree-selector.d.ts +4 -2
  167. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  168. package/dist/modes/interactive/components/tree-selector.js +48 -15
  169. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  170. package/dist/modes/interactive/interactive-mode.d.ts +18 -5
  171. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  172. package/dist/modes/interactive/interactive-mode.js +287 -188
  173. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  174. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  175. package/dist/modes/interactive/theme/theme.js +15 -11
  176. package/dist/modes/interactive/theme/theme.js.map +1 -1
  177. package/dist/modes/print-mode.d.ts +2 -2
  178. package/dist/modes/print-mode.d.ts.map +1 -1
  179. package/dist/modes/print-mode.js +89 -72
  180. package/dist/modes/print-mode.js.map +1 -1
  181. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  182. package/dist/modes/rpc/rpc-client.js +1 -0
  183. package/dist/modes/rpc/rpc-client.js.map +1 -1
  184. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  185. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  186. package/dist/modes/rpc/rpc-mode.js +95 -64
  187. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  188. package/dist/package-manager-cli.d.ts +4 -0
  189. package/dist/package-manager-cli.d.ts.map +1 -0
  190. package/dist/package-manager-cli.js +234 -0
  191. package/dist/package-manager-cli.js.map +1 -0
  192. package/dist/prompts/commands/atomic-commit.md +17 -0
  193. package/dist/prompts/commands/discuss-phase.md +15 -0
  194. package/dist/prompts/commands/execute-phase.md +14 -0
  195. package/dist/prompts/commands/fix.md +14 -0
  196. package/dist/prompts/commands/init-project.md +16 -0
  197. package/dist/prompts/commands/map-codebase.md +16 -0
  198. package/dist/prompts/commands/new-project.md +16 -0
  199. package/dist/prompts/commands/next-milestone.md +16 -0
  200. package/dist/prompts/commands/pause-work.md +13 -0
  201. package/dist/prompts/commands/plan-phase.md +15 -0
  202. package/dist/prompts/commands/progress.md +13 -0
  203. package/dist/prompts/commands/quick.md +14 -0
  204. package/dist/prompts/commands/resume-work.md +13 -0
  205. package/dist/prompts/commands/review.md +15 -0
  206. package/dist/prompts/commands/verify-work.md +15 -0
  207. package/dist/utils/paths.d.ts +7 -0
  208. package/dist/utils/paths.d.ts.map +1 -0
  209. package/dist/utils/paths.js +19 -0
  210. package/dist/utils/paths.js.map +1 -0
  211. package/docs/compaction.md +5 -3
  212. package/docs/custom-provider.md +1 -1
  213. package/docs/development.md +5 -3
  214. package/docs/extensions.md +221 -69
  215. package/docs/json.md +5 -2
  216. package/docs/keybindings.md +2 -0
  217. package/docs/models.md +60 -3
  218. package/docs/packages.md +3 -3
  219. package/docs/rpc.md +23 -9
  220. package/docs/sdk.md +240 -84
  221. package/docs/session.md +3 -3
  222. package/docs/settings.md +12 -0
  223. package/docs/skills.md +3 -2
  224. package/docs/tree.md +6 -3
  225. package/examples/README.md +1 -1
  226. package/examples/extensions/README.md +1 -0
  227. package/examples/extensions/antigravity-image-gen.ts +1 -1
  228. package/examples/extensions/custom-compaction.ts +17 -4
  229. package/examples/extensions/custom-provider-gitlab-duo/index.ts +1 -1
  230. package/examples/extensions/doom-overlay/doom/build.sh +2 -2
  231. package/examples/extensions/handoff.ts +5 -2
  232. package/examples/extensions/hello.ts +18 -17
  233. package/examples/extensions/hidden-thinking-label.ts +53 -0
  234. package/examples/extensions/overlay-qa-tests.ts +2 -2
  235. package/examples/extensions/qna.ts +5 -2
  236. package/examples/extensions/rpc-demo.ts +3 -9
  237. package/examples/extensions/sandbox/index.ts +8 -4
  238. package/examples/extensions/status-line.ts +0 -8
  239. package/examples/extensions/subagent/index.ts +6 -6
  240. package/examples/extensions/summarize.ts +15 -4
  241. package/examples/extensions/todo.ts +0 -2
  242. package/examples/extensions/tools.ts +0 -5
  243. package/examples/extensions/trigger-compact.ts +11 -1
  244. package/examples/extensions/widget-placement.ts +4 -12
  245. package/examples/sdk/02-custom-model.ts +1 -1
  246. package/examples/sdk/09-api-keys-and-oauth.ts +3 -3
  247. package/examples/sdk/12-full-control.ts +1 -1
  248. package/examples/sdk/13-session-runtime.ts +67 -0
  249. package/examples/sdk/README.md +8 -5
  250. package/package.json +7 -8
  251. package/prompts/commands/atomic-commit.md +17 -0
  252. package/prompts/commands/discuss-phase.md +15 -0
  253. package/prompts/commands/execute-phase.md +14 -0
  254. package/prompts/commands/fix.md +14 -0
  255. package/prompts/commands/init-project.md +16 -0
  256. package/prompts/commands/map-codebase.md +16 -0
  257. package/prompts/commands/new-project.md +16 -0
  258. package/prompts/commands/next-milestone.md +16 -0
  259. package/prompts/commands/pause-work.md +13 -0
  260. package/prompts/commands/plan-phase.md +15 -0
  261. package/prompts/commands/progress.md +13 -0
  262. package/prompts/commands/quick.md +14 -0
  263. package/prompts/commands/resume-work.md +13 -0
  264. package/prompts/commands/review.md +15 -0
  265. package/prompts/commands/verify-work.md +15 -0
@@ -16,14 +16,14 @@ import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLe
16
16
  import type { ImageContent, Model, TextContent } from "@draht/ai";
17
17
  import { type BashResult } from "./bash-executor.js";
18
18
  import { type CompactionResult } from "./compaction/index.js";
19
- import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.js";
19
+ import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.js";
20
20
  import type { CustomMessage } from "./messages.js";
21
21
  import type { ModelRegistry } from "./model-registry.js";
22
22
  import { type PromptTemplate } from "./prompt-templates.js";
23
23
  import type { ResourceLoader } from "./resource-loader.js";
24
24
  import type { BranchSummaryEntry, SessionManager } from "./session-manager.js";
25
25
  import type { SettingsManager } from "./settings-manager.js";
26
- import type { BashOperations } from "./tools/bash.js";
26
+ import { type BashOperations } from "./tools/bash.js";
27
27
  /** Parsed skill block from a user message */
28
28
  export interface ParsedSkillBlock {
29
29
  name: string;
@@ -38,10 +38,15 @@ export interface ParsedSkillBlock {
38
38
  export declare function parseSkillBlock(text: string): ParsedSkillBlock | null;
39
39
  /** Session-specific events that extend the core AgentEvent */
40
40
  export type AgentSessionEvent = AgentEvent | {
41
- type: "auto_compaction_start";
42
- reason: "threshold" | "overflow";
41
+ type: "queue_update";
42
+ steering: readonly string[];
43
+ followUp: readonly string[];
43
44
  } | {
44
- type: "auto_compaction_end";
45
+ type: "compaction_start";
46
+ reason: "manual" | "threshold" | "overflow";
47
+ } | {
48
+ type: "compaction_end";
49
+ reason: "manual" | "threshold" | "overflow";
45
50
  result: CompactionResult | undefined;
46
51
  aborted: boolean;
47
52
  willRetry: boolean;
@@ -89,6 +94,8 @@ export interface AgentSessionConfig {
89
94
  extensionRunnerRef?: {
90
95
  current?: ExtensionRunner;
91
96
  };
97
+ /** Session start event metadata emitted when extensions bind to this runtime. */
98
+ sessionStartEvent?: SessionStartEvent;
92
99
  }
93
100
  export interface ExtensionBindings {
94
101
  uiContext?: ExtensionUIContext;
@@ -166,6 +173,7 @@ export declare class AgentSession {
166
173
  private _extensionRunnerRef?;
167
174
  private _initialActiveToolNames?;
168
175
  private _baseToolsOverride?;
176
+ private _sessionStartEvent;
169
177
  private _extensionUIContext?;
170
178
  private _extensionCommandContextActions?;
171
179
  private _extensionShutdownHandler?;
@@ -180,6 +188,7 @@ export declare class AgentSession {
180
188
  constructor(config: AgentSessionConfig);
181
189
  /** Model registry for API key resolution and model discovery */
182
190
  get modelRegistry(): ModelRegistry;
191
+ private _getRequiredRequestAuth;
183
192
  /**
184
193
  * Install tool hooks once on the Agent instance.
185
194
  *
@@ -191,6 +200,7 @@ export declare class AgentSession {
191
200
  private _installAgentToolHooks;
192
201
  /** Emit an event to all listeners */
193
202
  private _emit;
203
+ private _emitQueueUpdate;
194
204
  private _lastAssistantMessage;
195
205
  /** Internal handler for agent events - shared by subscribe and reconnect */
196
206
  private _handleAgentEvent;
@@ -370,23 +380,11 @@ export declare class AgentSession {
370
380
  * Abort current operation and wait for agent to become idle.
371
381
  */
372
382
  abort(): Promise<void>;
373
- /**
374
- * Start a new session, optionally with initial messages and parent tracking.
375
- * Clears all messages and starts a new session.
376
- * Listeners are preserved and will continue receiving events.
377
- * @param options.parentSession - Optional parent session path for tracking
378
- * @param options.setup - Optional callback to initialize session (e.g., append messages)
379
- * @returns true if completed, false if cancelled by extension
380
- */
381
- newSession(options?: {
382
- parentSession?: string;
383
- setup?: (sessionManager: SessionManager) => Promise<void>;
384
- }): Promise<boolean>;
385
383
  private _emitModelSelect;
386
384
  /**
387
385
  * Set model directly.
388
- * Validates API key, saves to session and settings.
389
- * @throws Error if no API key available for the model
386
+ * Validates that auth is configured, saves to session and settings.
387
+ * @throws Error if no auth is configured for the model
390
388
  */
391
389
  setModel(model: Model<any>): Promise<void>;
392
390
  /**
@@ -396,7 +394,6 @@ export declare class AgentSession {
396
394
  * @returns The new model info, or undefined if only one model available
397
395
  */
398
396
  cycleModel(direction?: "forward" | "backward"): Promise<ModelCycleResult | undefined>;
399
- private _getScopedModelsWithApiKey;
400
397
  private _cycleScopedModel;
401
398
  private _cycleAvailableModel;
402
399
  /**
@@ -518,30 +515,10 @@ export declare class AgentSession {
518
515
  * Called after agent turn completes to maintain proper message ordering.
519
516
  */
520
517
  private _flushPendingBashMessages;
521
- /**
522
- * Switch to a different session file.
523
- * Aborts current operation, loads messages, restores model/thinking.
524
- * Listeners are preserved and will continue receiving events.
525
- * @returns true if switch completed, false if cancelled by extension
526
- */
527
- switchSession(sessionPath: string): Promise<boolean>;
528
518
  /**
529
519
  * Set a display name for the current session.
530
520
  */
531
521
  setSessionName(name: string): void;
532
- /**
533
- * Create a fork from a specific entry.
534
- * Emits before_fork/fork session events to extensions.
535
- *
536
- * @param entryId ID of the entry to fork from
537
- * @returns Object with:
538
- * - selectedText: The text of the selected user message (for editor pre-fill)
539
- * - cancelled: True if an extension cancelled the fork
540
- */
541
- fork(entryId: string): Promise<{
542
- selectedText: string;
543
- cancelled: boolean;
544
- }>;
545
522
  /**
546
523
  * Navigate to a different node in the session tree.
547
524
  * Unlike fork() which creates a new session file, this stays in the same file.
@@ -590,13 +567,6 @@ export declare class AgentSession {
590
567
  * @returns The resolved output file path.
591
568
  */
592
569
  exportToJsonl(outputPath?: string): string;
593
- /**
594
- * Import a JSONL session file.
595
- * Copies the file into the session directory and switches to it (like /resume).
596
- * @param inputPath Path to the JSONL file to import.
597
- * @returns true if the session was switched successfully.
598
- */
599
- importFromJsonl(inputPath: string): Promise<boolean>;
600
570
  /**
601
571
  * Get text content of last assistant message.
602
572
  * Useful for /copy command.