@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
package/dist/main.js CHANGED
@@ -4,32 +4,35 @@
4
4
  * This file handles CLI argument parsing and translates them into
5
5
  * createAgentSession() options. The SDK does the heavy lifting.
6
6
  */
7
+ import { resolve } from "node:path";
8
+ import { createInterface } from "node:readline";
7
9
  import { modelsAreEqual, supportsXhigh } from "@draht/ai";
10
+ import { ProcessTerminal, setKeybindings, TUI } from "@draht/tui";
8
11
  import chalk from "chalk";
9
- import { createInterface } from "readline";
10
12
  import { parseArgs, printHelp } from "./cli/args.js";
11
- import { selectConfig } from "./cli/config-selector.js";
12
13
  import { processFileArguments } from "./cli/file-processor.js";
13
14
  import { buildInitialMessage } from "./cli/initial-message.js";
14
15
  import { listModels } from "./cli/list-models.js";
15
16
  import { selectSession } from "./cli/session-picker.js";
16
- import { APP_NAME, getAgentDir, getModelsPath, VERSION } from "./config.js";
17
+ import { getAgentDir, getModelsPath, VERSION } from "./config.js";
18
+ import { createAgentSessionRuntime } from "./core/agent-session-runtime.js";
19
+ import { createAgentSessionFromServices, createAgentSessionServices, } from "./core/agent-session-services.js";
17
20
  import { AuthStorage } from "./core/auth-storage.js";
18
21
  import { exportFromFile } from "./core/export-html/index.js";
19
- import { migrateKeybindingsConfigFile } from "./core/keybindings.js";
20
- import { ModelRegistry } from "./core/model-registry.js";
22
+ import { KeybindingsManager } from "./core/keybindings.js";
21
23
  import { resolveCliModel, resolveModelScope } from "./core/model-resolver.js";
22
24
  import { restoreStdout, takeOverStdout } from "./core/output-guard.js";
23
- import { DefaultPackageManager } from "./core/package-manager.js";
24
- import { DefaultResourceLoader } from "./core/resource-loader.js";
25
- import { createAgentSession } from "./core/sdk.js";
25
+ import { formatMissingSessionCwdPrompt, getMissingSessionCwdIssue, MissingSessionCwdError, } from "./core/session-cwd.js";
26
26
  import { SessionManager } from "./core/session-manager.js";
27
27
  import { SettingsManager } from "./core/settings-manager.js";
28
- import { printTimings, time } from "./core/timings.js";
28
+ import { printTimings, resetTimings, time } from "./core/timings.js";
29
29
  import { allTools } from "./core/tools/index.js";
30
30
  import { runMigrations, showDeprecationWarnings } from "./migrations.js";
31
31
  import { InteractiveMode, runPrintMode, runRpcMode } from "./modes/index.js";
32
+ import { ExtensionSelectorComponent } from "./modes/interactive/components/extension-selector.js";
32
33
  import { initTheme, stopThemeWatcher } from "./modes/interactive/theme/theme.js";
34
+ import { handleConfigCommand, handlePackageCommand } from "./package-manager-cli.js";
35
+ import { isLocalPath } from "./utils/paths.js";
33
36
  /**
34
37
  * Read all content from piped stdin.
35
38
  * Returns undefined if stdin is a TTY (interactive terminal).
@@ -51,13 +54,17 @@ async function readPipedStdin() {
51
54
  process.stdin.resume();
52
55
  });
53
56
  }
54
- function reportSettingsErrors(settingsManager, context) {
55
- const errors = settingsManager.drainErrors();
56
- for (const { scope, error } of errors) {
57
- console.error(chalk.yellow(`Warning (${context}, ${scope} settings): ${error.message}`));
58
- if (error.stack) {
59
- console.error(chalk.dim(error.stack));
60
- }
57
+ function collectSettingsDiagnostics(settingsManager, context) {
58
+ return settingsManager.drainErrors().map(({ scope, error }) => ({
59
+ type: "warning",
60
+ message: `(${context}, ${scope} settings) ${error.message}`,
61
+ }));
62
+ }
63
+ function reportDiagnostics(diagnostics) {
64
+ for (const diagnostic of diagnostics) {
65
+ const color = diagnostic.type === "error" ? chalk.red : diagnostic.type === "warning" ? chalk.yellow : chalk.dim;
66
+ const prefix = diagnostic.type === "error" ? "Error: " : diagnostic.type === "warning" ? "Warning: " : "";
67
+ console.error(color(`${prefix}${diagnostic.message}`));
61
68
  }
62
69
  }
63
70
  function isTruthyEnvFlag(value) {
@@ -65,212 +72,20 @@ function isTruthyEnvFlag(value) {
65
72
  return false;
66
73
  return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
67
74
  }
68
- function getPackageCommandUsage(command) {
69
- switch (command) {
70
- case "install":
71
- return `${APP_NAME} install <source> [-l]`;
72
- case "remove":
73
- return `${APP_NAME} remove <source> [-l]`;
74
- case "update":
75
- return `${APP_NAME} update [source]`;
76
- case "list":
77
- return `${APP_NAME} list`;
78
- }
79
- }
80
- function printPackageCommandHelp(command) {
81
- switch (command) {
82
- case "install":
83
- console.log(`${chalk.bold("Usage:")}
84
- ${getPackageCommandUsage("install")}
85
-
86
- Install a package and add it to settings.
87
-
88
- Options:
89
- -l, --local Install project-locally (.pi/settings.json)
90
-
91
- Examples:
92
- ${APP_NAME} install npm:@foo/bar
93
- ${APP_NAME} install git:github.com/user/repo
94
- ${APP_NAME} install git:git@github.com:user/repo
95
- ${APP_NAME} install https://github.com/user/repo
96
- ${APP_NAME} install ssh://git@github.com/user/repo
97
- ${APP_NAME} install ./local/path
98
- `);
99
- return;
100
- case "remove":
101
- console.log(`${chalk.bold("Usage:")}
102
- ${getPackageCommandUsage("remove")}
103
-
104
- Remove a package and its source from settings.
105
- Alias: ${APP_NAME} uninstall <source> [-l]
106
-
107
- Options:
108
- -l, --local Remove from project settings (.pi/settings.json)
109
-
110
- Examples:
111
- ${APP_NAME} remove npm:@foo/bar
112
- ${APP_NAME} uninstall npm:@foo/bar
113
- `);
114
- return;
115
- case "update":
116
- console.log(`${chalk.bold("Usage:")}
117
- ${getPackageCommandUsage("update")}
118
-
119
- Update installed packages.
120
- If <source> is provided, only that package is updated.
121
- `);
122
- return;
123
- case "list":
124
- console.log(`${chalk.bold("Usage:")}
125
- ${getPackageCommandUsage("list")}
126
-
127
- List installed packages from user and project settings.
128
- `);
129
- return;
130
- }
131
- }
132
- function parsePackageCommand(args) {
133
- const [rawCommand, ...rest] = args;
134
- let command;
135
- if (rawCommand === "uninstall") {
136
- command = "remove";
75
+ function resolveAppMode(parsed, stdinIsTTY) {
76
+ if (parsed.mode === "rpc") {
77
+ return "rpc";
137
78
  }
138
- else if (rawCommand === "install" || rawCommand === "remove" || rawCommand === "update" || rawCommand === "list") {
139
- command = rawCommand;
79
+ if (parsed.mode === "json") {
80
+ return "json";
140
81
  }
141
- if (!command) {
142
- return undefined;
143
- }
144
- let local = false;
145
- let help = false;
146
- let invalidOption;
147
- let source;
148
- for (const arg of rest) {
149
- if (arg === "-h" || arg === "--help") {
150
- help = true;
151
- continue;
152
- }
153
- if (arg === "-l" || arg === "--local") {
154
- if (command === "install" || command === "remove") {
155
- local = true;
156
- }
157
- else {
158
- invalidOption = invalidOption ?? arg;
159
- }
160
- continue;
161
- }
162
- if (arg.startsWith("-")) {
163
- invalidOption = invalidOption ?? arg;
164
- continue;
165
- }
166
- if (!source) {
167
- source = arg;
168
- }
82
+ if (parsed.print || !stdinIsTTY) {
83
+ return "print";
169
84
  }
170
- return { command, source, local, help, invalidOption };
85
+ return "interactive";
171
86
  }
172
- async function handlePackageCommand(args) {
173
- const options = parsePackageCommand(args);
174
- if (!options) {
175
- return false;
176
- }
177
- if (options.help) {
178
- printPackageCommandHelp(options.command);
179
- return true;
180
- }
181
- if (options.invalidOption) {
182
- console.error(chalk.red(`Unknown option ${options.invalidOption} for "${options.command}".`));
183
- console.error(chalk.dim(`Use "${APP_NAME} --help" or "${getPackageCommandUsage(options.command)}".`));
184
- process.exitCode = 1;
185
- return true;
186
- }
187
- const source = options.source;
188
- if ((options.command === "install" || options.command === "remove") && !source) {
189
- console.error(chalk.red(`Missing ${options.command} source.`));
190
- console.error(chalk.dim(`Usage: ${getPackageCommandUsage(options.command)}`));
191
- process.exitCode = 1;
192
- return true;
193
- }
194
- const cwd = process.cwd();
195
- const agentDir = getAgentDir();
196
- const settingsManager = SettingsManager.create(cwd, agentDir);
197
- reportSettingsErrors(settingsManager, "package command");
198
- const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
199
- packageManager.setProgressCallback((event) => {
200
- if (event.type === "start") {
201
- process.stdout.write(chalk.dim(`${event.message}\n`));
202
- }
203
- });
204
- try {
205
- switch (options.command) {
206
- case "install":
207
- await packageManager.install(source, { local: options.local });
208
- packageManager.addSourceToSettings(source, { local: options.local });
209
- console.log(chalk.green(`Installed ${source}`));
210
- return true;
211
- case "remove": {
212
- await packageManager.remove(source, { local: options.local });
213
- const removed = packageManager.removeSourceFromSettings(source, { local: options.local });
214
- if (!removed) {
215
- console.error(chalk.red(`No matching package found for ${source}`));
216
- process.exitCode = 1;
217
- return true;
218
- }
219
- console.log(chalk.green(`Removed ${source}`));
220
- return true;
221
- }
222
- case "list": {
223
- const globalSettings = settingsManager.getGlobalSettings();
224
- const projectSettings = settingsManager.getProjectSettings();
225
- const globalPackages = globalSettings.packages ?? [];
226
- const projectPackages = projectSettings.packages ?? [];
227
- if (globalPackages.length === 0 && projectPackages.length === 0) {
228
- console.log(chalk.dim("No packages installed."));
229
- return true;
230
- }
231
- const formatPackage = (pkg, scope) => {
232
- const source = typeof pkg === "string" ? pkg : pkg.source;
233
- const filtered = typeof pkg === "object";
234
- const display = filtered ? `${source} (filtered)` : source;
235
- console.log(` ${display}`);
236
- const path = packageManager.getInstalledPath(source, scope);
237
- if (path) {
238
- console.log(chalk.dim(` ${path}`));
239
- }
240
- };
241
- if (globalPackages.length > 0) {
242
- console.log(chalk.bold("User packages:"));
243
- for (const pkg of globalPackages) {
244
- formatPackage(pkg, "user");
245
- }
246
- }
247
- if (projectPackages.length > 0) {
248
- if (globalPackages.length > 0)
249
- console.log();
250
- console.log(chalk.bold("Project packages:"));
251
- for (const pkg of projectPackages) {
252
- formatPackage(pkg, "project");
253
- }
254
- }
255
- return true;
256
- }
257
- case "update":
258
- await packageManager.update(source);
259
- if (source) {
260
- console.log(chalk.green(`Updated ${source}`));
261
- }
262
- else {
263
- console.log(chalk.green("Updated packages"));
264
- }
265
- return true;
266
- }
267
- }
268
- catch (error) {
269
- const message = error instanceof Error ? error.message : "Unknown package command error";
270
- console.error(chalk.red(`Error: ${message}`));
271
- process.exitCode = 1;
272
- return true;
273
- }
87
+ function toPrintOutputMode(appMode) {
88
+ return appMode === "json" ? "json" : "text";
274
89
  }
275
90
  async function prepareInitialMessage(parsed, autoResizeImages, stdinContent) {
276
91
  if (parsed.fileArgs.length === 0) {
@@ -322,29 +137,6 @@ async function promptConfirm(message) {
322
137
  });
323
138
  });
324
139
  }
325
- /** Helper to call CLI-only session_directory handlers before the initial session manager is created */
326
- async function callSessionDirectoryHook(extensions, cwd) {
327
- let customSessionDir;
328
- for (const ext of extensions.extensions) {
329
- const handlers = ext.handlers.get("session_directory");
330
- if (!handlers || handlers.length === 0)
331
- continue;
332
- for (const handler of handlers) {
333
- try {
334
- const event = { type: "session_directory", cwd };
335
- const result = (await handler(event));
336
- if (result?.sessionDir) {
337
- customSessionDir = result.sessionDir;
338
- }
339
- }
340
- catch (err) {
341
- const message = err instanceof Error ? err.message : String(err);
342
- console.error(chalk.red(`Extension "${ext.path}" session_directory handler failed: ${message}`));
343
- }
344
- }
345
- }
346
- return customSessionDir;
347
- }
348
140
  function validateForkFlags(parsed) {
349
141
  if (!parsed.fork)
350
142
  return;
@@ -369,65 +161,65 @@ function forkSessionOrExit(sourcePath, cwd, sessionDir) {
369
161
  process.exit(1);
370
162
  }
371
163
  }
372
- async function createSessionManager(parsed, cwd, extensions) {
164
+ async function createSessionManager(parsed, cwd, sessionDir, settingsManager) {
373
165
  if (parsed.noSession) {
374
166
  return SessionManager.inMemory();
375
167
  }
376
- // CLI flag takes precedence, otherwise ask extensions for custom session directory
377
- let effectiveSessionDir = parsed.sessionDir;
378
- if (!effectiveSessionDir) {
379
- effectiveSessionDir = await callSessionDirectoryHook(extensions, cwd);
380
- }
381
168
  if (parsed.fork) {
382
- const resolved = await resolveSessionPath(parsed.fork, cwd, effectiveSessionDir);
169
+ const resolved = await resolveSessionPath(parsed.fork, cwd, sessionDir);
383
170
  switch (resolved.type) {
384
171
  case "path":
385
172
  case "local":
386
173
  case "global":
387
- return forkSessionOrExit(resolved.path, cwd, effectiveSessionDir);
174
+ return forkSessionOrExit(resolved.path, cwd, sessionDir);
388
175
  case "not_found":
389
176
  console.error(chalk.red(`No session found matching '${resolved.arg}'`));
390
177
  process.exit(1);
391
178
  }
392
179
  }
393
180
  if (parsed.session) {
394
- const resolved = await resolveSessionPath(parsed.session, cwd, effectiveSessionDir);
181
+ const resolved = await resolveSessionPath(parsed.session, cwd, sessionDir);
395
182
  switch (resolved.type) {
396
183
  case "path":
397
184
  case "local":
398
- return SessionManager.open(resolved.path, effectiveSessionDir);
185
+ return SessionManager.open(resolved.path, sessionDir);
399
186
  case "global": {
400
- // Session found in different project - ask user if they want to fork
401
187
  console.log(chalk.yellow(`Session found in different project: ${resolved.cwd}`));
402
188
  const shouldFork = await promptConfirm("Fork this session into current directory?");
403
189
  if (!shouldFork) {
404
190
  console.log(chalk.dim("Aborted."));
405
191
  process.exit(0);
406
192
  }
407
- return forkSessionOrExit(resolved.path, cwd, effectiveSessionDir);
193
+ return forkSessionOrExit(resolved.path, cwd, sessionDir);
408
194
  }
409
195
  case "not_found":
410
196
  console.error(chalk.red(`No session found matching '${resolved.arg}'`));
411
197
  process.exit(1);
412
198
  }
413
199
  }
414
- if (parsed.continue) {
415
- return SessionManager.continueRecent(cwd, effectiveSessionDir);
200
+ if (parsed.resume) {
201
+ initTheme(settingsManager.getTheme(), true);
202
+ try {
203
+ const selectedPath = await selectSession((onProgress) => SessionManager.list(cwd, sessionDir, onProgress), SessionManager.listAll);
204
+ if (!selectedPath) {
205
+ console.log(chalk.dim("No session selected"));
206
+ process.exit(0);
207
+ }
208
+ return SessionManager.open(selectedPath, sessionDir);
209
+ }
210
+ finally {
211
+ stopThemeWatcher();
212
+ }
416
213
  }
417
- // --resume is handled separately (needs picker UI)
418
- // If effective session dir is set, create new session there
419
- if (effectiveSessionDir) {
420
- return SessionManager.create(cwd, effectiveSessionDir);
214
+ if (parsed.continue) {
215
+ return SessionManager.continueRecent(cwd, sessionDir);
421
216
  }
422
- // Default case (new session) returns undefined, SDK will create one
423
- return undefined;
217
+ return SessionManager.create(cwd, sessionDir);
424
218
  }
425
- function buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager) {
219
+ function buildSessionOptions(parsed, scopedModels, hasExistingSession, modelRegistry, settingsManager) {
426
220
  const options = {};
221
+ const diagnostics = [];
427
222
  let cliThinkingFromModel = false;
428
- if (sessionManager) {
429
- options.sessionManager = sessionManager;
430
- }
431
223
  // Model from CLI
432
224
  // - supports --provider <name> --model <pattern>
433
225
  // - supports --model <provider>/<pattern>
@@ -438,11 +230,10 @@ function buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry
438
230
  modelRegistry,
439
231
  });
440
232
  if (resolved.warning) {
441
- console.warn(chalk.yellow(`Warning: ${resolved.warning}`));
233
+ diagnostics.push({ type: "warning", message: resolved.warning });
442
234
  }
443
235
  if (resolved.error) {
444
- console.error(chalk.red(resolved.error));
445
- process.exit(1);
236
+ diagnostics.push({ type: "error", message: resolved.error });
446
237
  }
447
238
  if (resolved.model) {
448
239
  options.model = resolved.model;
@@ -454,7 +245,7 @@ function buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry
454
245
  }
455
246
  }
456
247
  }
457
- if (!options.model && scopedModels.length > 0 && !parsed.continue && !parsed.resume) {
248
+ if (!options.model && scopedModels.length > 0 && !hasExistingSession) {
458
249
  // Check if saved default is in scoped models - use it if so, otherwise first scoped model
459
250
  const savedProvider = settingsManager.getDefaultProvider();
460
251
  const savedModelId = settingsManager.getDefaultModel();
@@ -504,27 +295,34 @@ function buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry
504
295
  else if (parsed.tools) {
505
296
  options.tools = parsed.tools.map((name) => allTools[name]);
506
297
  }
507
- return { options, cliThinkingFromModel };
298
+ return { options, cliThinkingFromModel, diagnostics };
508
299
  }
509
- async function handleConfigCommand(args) {
510
- if (args[0] !== "config") {
511
- return false;
512
- }
513
- const cwd = process.cwd();
514
- const agentDir = getAgentDir();
515
- const settingsManager = SettingsManager.create(cwd, agentDir);
516
- reportSettingsErrors(settingsManager, "config command");
517
- const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
518
- const resolvedPaths = await packageManager.resolve();
519
- await selectConfig({
520
- resolvedPaths,
521
- settingsManager,
522
- cwd,
523
- agentDir,
300
+ function resolveCliPaths(cwd, paths) {
301
+ return paths?.map((value) => (isLocalPath(value) ? resolve(cwd, value) : value));
302
+ }
303
+ async function promptForMissingSessionCwd(issue, settingsManager) {
304
+ initTheme(settingsManager.getTheme());
305
+ setKeybindings(KeybindingsManager.create());
306
+ return new Promise((resolve) => {
307
+ const ui = new TUI(new ProcessTerminal(), settingsManager.getShowHardwareCursor());
308
+ ui.setClearOnShrink(settingsManager.getClearOnShrink());
309
+ let settled = false;
310
+ const finish = (result) => {
311
+ if (settled) {
312
+ return;
313
+ }
314
+ settled = true;
315
+ ui.stop();
316
+ resolve(result);
317
+ };
318
+ const selector = new ExtensionSelectorComponent(formatMissingSessionCwdPrompt(issue), ["Continue", "Cancel"], (option) => finish(option === "Continue" ? issue.fallbackCwd : undefined), () => finish(undefined), { tui: ui });
319
+ ui.addChild(selector);
320
+ ui.setFocus(selector);
321
+ ui.start();
524
322
  });
525
- process.exit(0);
526
323
  }
527
324
  export async function main(args) {
325
+ resetTimings();
528
326
  const offlineMode = args.includes("--offline") || isTruthyEnvFlag(process.env.PI_OFFLINE);
529
327
  if (offlineMode) {
530
328
  process.env.PI_OFFLINE = "1";
@@ -536,88 +334,26 @@ export async function main(args) {
536
334
  if (await handleConfigCommand(args)) {
537
335
  return;
538
336
  }
539
- // First pass: parse args to get --extension paths
540
- const firstPass = parseArgs(args);
541
- const shouldTakeOverStdout = firstPass.mode !== undefined || firstPass.print || !process.stdin.isTTY;
542
- if (shouldTakeOverStdout) {
543
- takeOverStdout();
544
- }
545
- // Run migrations (pass cwd for project-local migrations)
546
- const { migratedAuthProviders: migratedProviders, deprecationWarnings } = runMigrations(process.cwd());
547
- // Early load extensions to discover their CLI flags
548
- const cwd = process.cwd();
549
- const agentDir = getAgentDir();
550
- const settingsManager = SettingsManager.create(cwd, agentDir);
551
- reportSettingsErrors(settingsManager, "startup");
552
- const authStorage = AuthStorage.create();
553
- const modelRegistry = new ModelRegistry(authStorage, getModelsPath());
554
- const resourceLoader = new DefaultResourceLoader({
555
- cwd,
556
- agentDir,
557
- settingsManager,
558
- additionalExtensionPaths: firstPass.extensions,
559
- additionalSkillPaths: firstPass.skills,
560
- additionalPromptTemplatePaths: firstPass.promptTemplates,
561
- additionalThemePaths: firstPass.themes,
562
- noExtensions: firstPass.noExtensions,
563
- noSkills: firstPass.noSkills,
564
- noPromptTemplates: firstPass.noPromptTemplates,
565
- noThemes: firstPass.noThemes,
566
- systemPrompt: firstPass.systemPrompt,
567
- appendSystemPrompt: firstPass.appendSystemPrompt,
568
- });
569
- await resourceLoader.reload();
570
- time("resourceLoader.reload");
571
- const extensionsResult = resourceLoader.getExtensions();
572
- for (const { path, error } of extensionsResult.errors) {
573
- console.error(chalk.red(`Failed to load extension "${path}": ${error}`));
574
- }
575
- // Apply pending provider registrations from extensions immediately
576
- // so they're available for model resolution before AgentSession is created
577
- for (const { name, config, extensionPath } of extensionsResult.runtime.pendingProviderRegistrations) {
578
- try {
579
- modelRegistry.registerProvider(name, config);
580
- }
581
- catch (error) {
582
- const message = error instanceof Error ? error.message : String(error);
583
- console.error(chalk.red(`Extension "${extensionPath}" error: ${message}`));
337
+ const parsed = parseArgs(args);
338
+ if (parsed.diagnostics.length > 0) {
339
+ for (const d of parsed.diagnostics) {
340
+ const color = d.type === "error" ? chalk.red : chalk.yellow;
341
+ console.error(color(`${d.type === "error" ? "Error" : "Warning"}: ${d.message}`));
584
342
  }
585
- }
586
- extensionsResult.runtime.pendingProviderRegistrations = [];
587
- const extensionFlags = new Map();
588
- for (const ext of extensionsResult.extensions) {
589
- for (const [name, flag] of ext.flags) {
590
- extensionFlags.set(name, { type: flag.type });
343
+ if (parsed.diagnostics.some((d) => d.type === "error")) {
344
+ process.exit(1);
591
345
  }
592
346
  }
593
- // Second pass: parse args with extension flags
594
- const parsed = parseArgs(args, extensionFlags);
595
- // Pass flag values to extensions via runtime
596
- for (const [name, value] of parsed.unknownFlags) {
597
- extensionsResult.runtime.flagValues.set(name, value);
347
+ time("parseArgs");
348
+ let appMode = resolveAppMode(parsed, process.stdin.isTTY);
349
+ const shouldTakeOverStdout = appMode !== "interactive";
350
+ if (shouldTakeOverStdout) {
351
+ takeOverStdout();
598
352
  }
599
353
  if (parsed.version) {
600
354
  console.log(VERSION);
601
355
  process.exit(0);
602
356
  }
603
- if (parsed.help) {
604
- printHelp();
605
- process.exit(0);
606
- }
607
- if (parsed.listModels !== undefined) {
608
- const searchPattern = typeof parsed.listModels === "string" ? parsed.listModels : undefined;
609
- await listModels(modelRegistry, searchPattern);
610
- process.exit(0);
611
- }
612
- // Read piped stdin content (if any) - skip for RPC mode which uses stdin for JSON-RPC
613
- let stdinContent;
614
- if (parsed.mode !== "rpc") {
615
- stdinContent = await readPipedStdin();
616
- if (stdinContent !== undefined) {
617
- // Force print mode since interactive mode requires a TTY for keyboard input
618
- parsed.print = true;
619
- }
620
- }
621
357
  if (parsed.export) {
622
358
  let result;
623
359
  try {
@@ -632,83 +368,178 @@ export async function main(args) {
632
368
  console.log(`Exported to: ${result}`);
633
369
  process.exit(0);
634
370
  }
635
- migrateKeybindingsConfigFile(agentDir);
636
371
  if (parsed.mode === "rpc" && parsed.fileArgs.length > 0) {
637
372
  console.error(chalk.red("Error: @file arguments are not supported in RPC mode"));
638
373
  process.exit(1);
639
374
  }
640
375
  validateForkFlags(parsed);
641
- const { initialMessage, initialImages } = await prepareInitialMessage(parsed, settingsManager.getImageAutoResize(), stdinContent);
642
- const isInteractive = !parsed.print && parsed.mode === undefined;
643
- const startupBenchmark = isTruthyEnvFlag(process.env.PI_STARTUP_BENCHMARK);
644
- if (startupBenchmark && !isInteractive) {
645
- console.error(chalk.red("Error: PI_STARTUP_BENCHMARK only supports interactive mode"));
646
- process.exit(1);
376
+ // Run migrations (pass cwd for project-local migrations)
377
+ const { migratedAuthProviders: migratedProviders, deprecationWarnings } = runMigrations(process.cwd());
378
+ time("runMigrations");
379
+ const cwd = process.cwd();
380
+ const agentDir = getAgentDir();
381
+ const startupSettingsManager = SettingsManager.create(cwd, agentDir);
382
+ reportDiagnostics(collectSettingsDiagnostics(startupSettingsManager, "startup session lookup"));
383
+ // Decide the final runtime cwd before creating cwd-bound runtime services.
384
+ // --session and --resume may select a session from another project, so project-local
385
+ // settings, resources, provider registrations, and models must be resolved only after
386
+ // the target session cwd is known. The startup-cwd settings manager is used only for
387
+ // sessionDir lookup during session selection.
388
+ const sessionDir = parsed.sessionDir ?? startupSettingsManager.getSessionDir();
389
+ let sessionManager = await createSessionManager(parsed, cwd, sessionDir, startupSettingsManager);
390
+ const missingSessionCwdIssue = getMissingSessionCwdIssue(sessionManager, cwd);
391
+ if (missingSessionCwdIssue) {
392
+ if (appMode === "interactive") {
393
+ const selectedCwd = await promptForMissingSessionCwd(missingSessionCwdIssue, startupSettingsManager);
394
+ if (!selectedCwd) {
395
+ process.exit(0);
396
+ }
397
+ sessionManager = SessionManager.open(missingSessionCwdIssue.sessionFile, sessionDir, selectedCwd);
398
+ }
399
+ else {
400
+ console.error(chalk.red(new MissingSessionCwdError(missingSessionCwdIssue).message));
401
+ process.exit(1);
402
+ }
647
403
  }
648
- const mode = parsed.mode || "text";
649
- initTheme(settingsManager.getTheme(), isInteractive);
650
- // Show deprecation warnings in interactive mode
651
- if (isInteractive && deprecationWarnings.length > 0) {
652
- await showDeprecationWarnings(deprecationWarnings);
404
+ time("createSessionManager");
405
+ const resolvedExtensionPaths = resolveCliPaths(cwd, parsed.extensions);
406
+ const resolvedSkillPaths = resolveCliPaths(cwd, parsed.skills);
407
+ const resolvedPromptTemplatePaths = resolveCliPaths(cwd, parsed.promptTemplates);
408
+ const resolvedThemePaths = resolveCliPaths(cwd, parsed.themes);
409
+ const authStorage = AuthStorage.create();
410
+ const createRuntime = async ({ cwd, agentDir, sessionManager, sessionStartEvent, }) => {
411
+ const services = await createAgentSessionServices({
412
+ cwd,
413
+ agentDir,
414
+ authStorage,
415
+ extensionFlagValues: parsed.unknownFlags,
416
+ resourceLoaderOptions: {
417
+ additionalExtensionPaths: resolvedExtensionPaths,
418
+ additionalSkillPaths: resolvedSkillPaths,
419
+ additionalPromptTemplatePaths: resolvedPromptTemplatePaths,
420
+ additionalThemePaths: resolvedThemePaths,
421
+ noExtensions: parsed.noExtensions,
422
+ noSkills: parsed.noSkills,
423
+ noPromptTemplates: parsed.noPromptTemplates,
424
+ noThemes: parsed.noThemes,
425
+ systemPrompt: parsed.systemPrompt,
426
+ appendSystemPrompt: parsed.appendSystemPrompt,
427
+ },
428
+ });
429
+ const { settingsManager, modelRegistry, resourceLoader } = services;
430
+ const diagnostics = [
431
+ ...services.diagnostics,
432
+ ...collectSettingsDiagnostics(settingsManager, "runtime creation"),
433
+ ...resourceLoader.getExtensions().errors.map(({ path, error }) => ({
434
+ type: "error",
435
+ message: `Failed to load extension "${path}": ${error}`,
436
+ })),
437
+ ];
438
+ const modelPatterns = parsed.models ?? settingsManager.getEnabledModels();
439
+ const scopedModels = modelPatterns && modelPatterns.length > 0 ? await resolveModelScope(modelPatterns, modelRegistry) : [];
440
+ const { options: sessionOptions, cliThinkingFromModel, diagnostics: sessionOptionDiagnostics, } = buildSessionOptions(parsed, scopedModels, sessionManager.buildSessionContext().messages.length > 0, modelRegistry, settingsManager);
441
+ diagnostics.push(...sessionOptionDiagnostics);
442
+ if (parsed.apiKey) {
443
+ if (!sessionOptions.model) {
444
+ diagnostics.push({
445
+ type: "error",
446
+ message: "--api-key requires a model to be specified via --model, --provider/--model, or --models",
447
+ });
448
+ }
449
+ else {
450
+ authStorage.setRuntimeApiKey(sessionOptions.model.provider, parsed.apiKey);
451
+ }
452
+ }
453
+ const created = await createAgentSessionFromServices({
454
+ services,
455
+ sessionManager,
456
+ sessionStartEvent,
457
+ model: sessionOptions.model,
458
+ thinkingLevel: sessionOptions.thinkingLevel,
459
+ scopedModels: sessionOptions.scopedModels,
460
+ tools: sessionOptions.tools,
461
+ customTools: sessionOptions.customTools,
462
+ });
463
+ const cliThinkingOverride = parsed.thinking !== undefined || cliThinkingFromModel;
464
+ if (created.session.model && cliThinkingOverride) {
465
+ let effectiveThinking = created.session.thinkingLevel;
466
+ if (!created.session.model.reasoning) {
467
+ effectiveThinking = "off";
468
+ }
469
+ else if (effectiveThinking === "xhigh" && !supportsXhigh(created.session.model)) {
470
+ effectiveThinking = "high";
471
+ }
472
+ if (effectiveThinking !== created.session.thinkingLevel) {
473
+ created.session.setThinkingLevel(effectiveThinking);
474
+ }
475
+ }
476
+ return {
477
+ ...created,
478
+ services,
479
+ diagnostics,
480
+ };
481
+ };
482
+ time("createRuntime");
483
+ const runtime = await createAgentSessionRuntime(createRuntime, {
484
+ cwd: sessionManager.getCwd(),
485
+ agentDir,
486
+ sessionManager,
487
+ });
488
+ const { services, session, modelFallbackMessage } = runtime;
489
+ const { settingsManager, modelRegistry, resourceLoader } = services;
490
+ if (parsed.help) {
491
+ const extensionFlags = resourceLoader
492
+ .getExtensions()
493
+ .extensions.flatMap((extension) => Array.from(extension.flags.values()));
494
+ printHelp(extensionFlags);
495
+ process.exit(0);
653
496
  }
654
- let scopedModels = [];
655
- const modelPatterns = parsed.models ?? settingsManager.getEnabledModels();
656
- if (modelPatterns && modelPatterns.length > 0) {
657
- scopedModels = await resolveModelScope(modelPatterns, modelRegistry);
497
+ if (parsed.listModels !== undefined) {
498
+ const searchPattern = typeof parsed.listModels === "string" ? parsed.listModels : undefined;
499
+ await listModels(modelRegistry, searchPattern);
500
+ process.exit(0);
658
501
  }
659
- // Create session manager based on CLI flags
660
- let sessionManager = await createSessionManager(parsed, cwd, extensionsResult);
661
- // Handle --resume: show session picker
662
- if (parsed.resume) {
663
- // Compute effective session dir for resume (same logic as createSessionManager)
664
- const effectiveSessionDir = parsed.sessionDir || (await callSessionDirectoryHook(extensionsResult, cwd));
665
- const selectedPath = await selectSession((onProgress) => SessionManager.list(cwd, effectiveSessionDir, onProgress), SessionManager.listAll);
666
- if (!selectedPath) {
667
- console.log(chalk.dim("No session selected"));
668
- stopThemeWatcher();
669
- process.exit(0);
670
- }
671
- sessionManager = SessionManager.open(selectedPath, effectiveSessionDir);
672
- }
673
- const { options: sessionOptions, cliThinkingFromModel } = buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager);
674
- sessionOptions.authStorage = authStorage;
675
- sessionOptions.modelRegistry = modelRegistry;
676
- sessionOptions.resourceLoader = resourceLoader;
677
- // Handle CLI --api-key as runtime override (not persisted)
678
- if (parsed.apiKey) {
679
- if (!sessionOptions.model) {
680
- console.error(chalk.red("--api-key requires a model to be specified via --model, --provider/--model, or --models"));
681
- process.exit(1);
502
+ // Read piped stdin content (if any) - skip for RPC mode which uses stdin for JSON-RPC
503
+ let stdinContent;
504
+ if (appMode !== "rpc") {
505
+ stdinContent = await readPipedStdin();
506
+ if (stdinContent !== undefined && appMode === "interactive") {
507
+ appMode = "print";
682
508
  }
683
- authStorage.setRuntimeApiKey(sessionOptions.model.provider, parsed.apiKey);
684
509
  }
685
- const { session, modelFallbackMessage } = await createAgentSession(sessionOptions);
686
- if (!isInteractive && !session.model) {
510
+ time("readPipedStdin");
511
+ const { initialMessage, initialImages } = await prepareInitialMessage(parsed, settingsManager.getImageAutoResize(), stdinContent);
512
+ time("prepareInitialMessage");
513
+ initTheme(settingsManager.getTheme(), appMode === "interactive");
514
+ time("initTheme");
515
+ // Show deprecation warnings in interactive mode
516
+ if (appMode === "interactive" && deprecationWarnings.length > 0) {
517
+ await showDeprecationWarnings(deprecationWarnings);
518
+ }
519
+ const scopedModels = [...session.scopedModels];
520
+ time("resolveModelScope");
521
+ reportDiagnostics(runtime.diagnostics);
522
+ if (runtime.diagnostics.some((diagnostic) => diagnostic.type === "error")) {
523
+ process.exit(1);
524
+ }
525
+ time("createAgentSession");
526
+ if (appMode !== "interactive" && !session.model) {
687
527
  console.error(chalk.red("No models available."));
688
528
  console.error(chalk.yellow("\nSet an API key environment variable:"));
689
529
  console.error(" ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, etc.");
690
530
  console.error(chalk.yellow(`\nOr create ${getModelsPath()}`));
691
531
  process.exit(1);
692
532
  }
693
- // Clamp thinking level to model capabilities for CLI-provided thinking levels.
694
- // This covers both --thinking <level> and --model <pattern>:<thinking>.
695
- const cliThinkingOverride = parsed.thinking !== undefined || cliThinkingFromModel;
696
- if (session.model && cliThinkingOverride) {
697
- let effectiveThinking = session.thinkingLevel;
698
- if (!session.model.reasoning) {
699
- effectiveThinking = "off";
700
- }
701
- else if (effectiveThinking === "xhigh" && !supportsXhigh(session.model)) {
702
- effectiveThinking = "high";
703
- }
704
- if (effectiveThinking !== session.thinkingLevel) {
705
- session.setThinkingLevel(effectiveThinking);
706
- }
533
+ const startupBenchmark = isTruthyEnvFlag(process.env.PI_STARTUP_BENCHMARK);
534
+ if (startupBenchmark && appMode !== "interactive") {
535
+ console.error(chalk.red("Error: PI_STARTUP_BENCHMARK only supports interactive mode"));
536
+ process.exit(1);
707
537
  }
708
- if (mode === "rpc") {
709
- await runRpcMode(session);
538
+ if (appMode === "rpc") {
539
+ printTimings();
540
+ await runRpcMode(runtime);
710
541
  }
711
- else if (isInteractive) {
542
+ else if (appMode === "interactive") {
712
543
  if (scopedModels.length > 0 && (parsed.verbose || !settingsManager.getQuietStartup())) {
713
544
  const modelList = scopedModels
714
545
  .map((sm) => {
@@ -718,7 +549,7 @@ export async function main(args) {
718
549
  .join(", ");
719
550
  console.log(chalk.dim(`Model scope: ${modelList} ${chalk.gray("(Ctrl+P to cycle)")}`));
720
551
  }
721
- const interactiveMode = new InteractiveMode(session, {
552
+ const interactiveMode = new InteractiveMode(runtime, {
722
553
  migratedProviders,
723
554
  modelFallbackMessage,
724
555
  initialMessage,
@@ -728,6 +559,8 @@ export async function main(args) {
728
559
  });
729
560
  if (startupBenchmark) {
730
561
  await interactiveMode.init();
562
+ time("interactiveMode.init");
563
+ printTimings();
731
564
  interactiveMode.stop();
732
565
  stopThemeWatcher();
733
566
  if (process.stdout.writableLength > 0) {
@@ -742,14 +575,18 @@ export async function main(args) {
742
575
  await interactiveMode.run();
743
576
  }
744
577
  else {
745
- await runPrintMode(session, {
746
- mode,
578
+ printTimings();
579
+ const exitCode = await runPrintMode(runtime, {
580
+ mode: toPrintOutputMode(appMode),
747
581
  messages: parsed.messages,
748
582
  initialMessage,
749
583
  initialImages,
750
584
  });
751
585
  stopThemeWatcher();
752
586
  restoreStdout();
587
+ if (exitCode !== 0) {
588
+ process.exitCode = exitCode;
589
+ }
753
590
  return;
754
591
  }
755
592
  }