indusagi-coding-agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/CHANGELOG.md +2249 -0
  2. package/README.md +546 -0
  3. package/dist/cli/args.js +282 -0
  4. package/dist/cli/config-selector.js +30 -0
  5. package/dist/cli/file-processor.js +78 -0
  6. package/dist/cli/list-models.js +91 -0
  7. package/dist/cli/session-picker.js +31 -0
  8. package/dist/cli.js +10 -0
  9. package/dist/config.js +158 -0
  10. package/dist/core/agent-session.js +2097 -0
  11. package/dist/core/auth-storage.js +278 -0
  12. package/dist/core/bash-executor.js +211 -0
  13. package/dist/core/compaction/branch-summarization.js +241 -0
  14. package/dist/core/compaction/compaction.js +606 -0
  15. package/dist/core/compaction/index.js +6 -0
  16. package/dist/core/compaction/utils.js +137 -0
  17. package/dist/core/diagnostics.js +1 -0
  18. package/dist/core/event-bus.js +24 -0
  19. package/dist/core/exec.js +70 -0
  20. package/dist/core/export-html/ansi-to-html.js +248 -0
  21. package/dist/core/export-html/index.js +221 -0
  22. package/dist/core/export-html/template.css +905 -0
  23. package/dist/core/export-html/template.html +54 -0
  24. package/dist/core/export-html/template.js +1549 -0
  25. package/dist/core/export-html/tool-renderer.js +56 -0
  26. package/dist/core/export-html/vendor/highlight.min.js +1213 -0
  27. package/dist/core/export-html/vendor/marked.min.js +6 -0
  28. package/dist/core/extensions/index.js +8 -0
  29. package/dist/core/extensions/loader.js +395 -0
  30. package/dist/core/extensions/runner.js +499 -0
  31. package/dist/core/extensions/types.js +31 -0
  32. package/dist/core/extensions/wrapper.js +101 -0
  33. package/dist/core/footer-data-provider.js +133 -0
  34. package/dist/core/index.js +8 -0
  35. package/dist/core/keybindings.js +140 -0
  36. package/dist/core/messages.js +122 -0
  37. package/dist/core/model-registry.js +454 -0
  38. package/dist/core/model-resolver.js +309 -0
  39. package/dist/core/package-manager.js +1142 -0
  40. package/dist/core/prompt-templates.js +250 -0
  41. package/dist/core/resource-loader.js +569 -0
  42. package/dist/core/sdk.js +225 -0
  43. package/dist/core/session-manager.js +1078 -0
  44. package/dist/core/settings-manager.js +430 -0
  45. package/dist/core/skills.js +339 -0
  46. package/dist/core/system-prompt.js +136 -0
  47. package/dist/core/timings.js +24 -0
  48. package/dist/core/tools/bash.js +226 -0
  49. package/dist/core/tools/edit-diff.js +242 -0
  50. package/dist/core/tools/edit.js +145 -0
  51. package/dist/core/tools/find.js +205 -0
  52. package/dist/core/tools/grep.js +238 -0
  53. package/dist/core/tools/index.js +60 -0
  54. package/dist/core/tools/ls.js +117 -0
  55. package/dist/core/tools/path-utils.js +52 -0
  56. package/dist/core/tools/read.js +165 -0
  57. package/dist/core/tools/truncate.js +204 -0
  58. package/dist/core/tools/write.js +77 -0
  59. package/dist/index.js +41 -0
  60. package/dist/main.js +565 -0
  61. package/dist/migrations.js +260 -0
  62. package/dist/modes/index.js +7 -0
  63. package/dist/modes/interactive/components/armin.js +328 -0
  64. package/dist/modes/interactive/components/assistant-message.js +86 -0
  65. package/dist/modes/interactive/components/bash-execution.js +155 -0
  66. package/dist/modes/interactive/components/bordered-loader.js +47 -0
  67. package/dist/modes/interactive/components/branch-summary-message.js +41 -0
  68. package/dist/modes/interactive/components/compaction-summary-message.js +42 -0
  69. package/dist/modes/interactive/components/config-selector.js +458 -0
  70. package/dist/modes/interactive/components/countdown-timer.js +27 -0
  71. package/dist/modes/interactive/components/custom-editor.js +61 -0
  72. package/dist/modes/interactive/components/custom-message.js +80 -0
  73. package/dist/modes/interactive/components/diff.js +132 -0
  74. package/dist/modes/interactive/components/dynamic-border.js +19 -0
  75. package/dist/modes/interactive/components/extension-editor.js +96 -0
  76. package/dist/modes/interactive/components/extension-input.js +54 -0
  77. package/dist/modes/interactive/components/extension-selector.js +70 -0
  78. package/dist/modes/interactive/components/footer.js +213 -0
  79. package/dist/modes/interactive/components/index.js +31 -0
  80. package/dist/modes/interactive/components/keybinding-hints.js +60 -0
  81. package/dist/modes/interactive/components/login-dialog.js +138 -0
  82. package/dist/modes/interactive/components/model-selector.js +253 -0
  83. package/dist/modes/interactive/components/oauth-selector.js +91 -0
  84. package/dist/modes/interactive/components/scoped-models-selector.js +262 -0
  85. package/dist/modes/interactive/components/session-selector-search.js +145 -0
  86. package/dist/modes/interactive/components/session-selector.js +698 -0
  87. package/dist/modes/interactive/components/settings-selector.js +250 -0
  88. package/dist/modes/interactive/components/show-images-selector.js +33 -0
  89. package/dist/modes/interactive/components/skill-invocation-message.js +44 -0
  90. package/dist/modes/interactive/components/theme-selector.js +43 -0
  91. package/dist/modes/interactive/components/thinking-selector.js +45 -0
  92. package/dist/modes/interactive/components/tool-execution.js +608 -0
  93. package/dist/modes/interactive/components/tree-selector.js +892 -0
  94. package/dist/modes/interactive/components/user-message-selector.js +109 -0
  95. package/dist/modes/interactive/components/user-message.js +15 -0
  96. package/dist/modes/interactive/components/visual-truncate.js +32 -0
  97. package/dist/modes/interactive/interactive-mode.js +3576 -0
  98. package/dist/modes/interactive/theme/dark.json +85 -0
  99. package/dist/modes/interactive/theme/light.json +84 -0
  100. package/dist/modes/interactive/theme/theme-schema.json +335 -0
  101. package/dist/modes/interactive/theme/theme.js +938 -0
  102. package/dist/modes/print-mode.js +96 -0
  103. package/dist/modes/rpc/rpc-client.js +390 -0
  104. package/dist/modes/rpc/rpc-mode.js +448 -0
  105. package/dist/modes/rpc/rpc-types.js +7 -0
  106. package/dist/utils/changelog.js +86 -0
  107. package/dist/utils/clipboard-image.js +116 -0
  108. package/dist/utils/clipboard.js +58 -0
  109. package/dist/utils/frontmatter.js +25 -0
  110. package/dist/utils/git.js +5 -0
  111. package/dist/utils/image-convert.js +34 -0
  112. package/dist/utils/image-resize.js +180 -0
  113. package/dist/utils/mime.js +25 -0
  114. package/dist/utils/photon.js +120 -0
  115. package/dist/utils/shell.js +164 -0
  116. package/dist/utils/sleep.js +16 -0
  117. package/dist/utils/tools-manager.js +186 -0
  118. package/docs/compaction.md +390 -0
  119. package/docs/custom-provider.md +538 -0
  120. package/docs/development.md +69 -0
  121. package/docs/extensions.md +1733 -0
  122. package/docs/images/doom-extension.png +0 -0
  123. package/docs/images/interactive-mode.png +0 -0
  124. package/docs/images/tree-view.png +0 -0
  125. package/docs/json.md +79 -0
  126. package/docs/keybindings.md +162 -0
  127. package/docs/models.md +193 -0
  128. package/docs/packages.md +163 -0
  129. package/docs/prompt-templates.md +67 -0
  130. package/docs/providers.md +147 -0
  131. package/docs/rpc.md +1048 -0
  132. package/docs/sdk.md +957 -0
  133. package/docs/session.md +412 -0
  134. package/docs/settings.md +216 -0
  135. package/docs/shell-aliases.md +13 -0
  136. package/docs/skills.md +226 -0
  137. package/docs/terminal-setup.md +65 -0
  138. package/docs/themes.md +295 -0
  139. package/docs/tree.md +219 -0
  140. package/docs/tui.md +887 -0
  141. package/docs/windows.md +17 -0
  142. package/examples/README.md +25 -0
  143. package/examples/extensions/README.md +192 -0
  144. package/examples/extensions/antigravity-image-gen.ts +414 -0
  145. package/examples/extensions/auto-commit-on-exit.ts +49 -0
  146. package/examples/extensions/bookmark.ts +50 -0
  147. package/examples/extensions/claude-rules.ts +86 -0
  148. package/examples/extensions/confirm-destructive.ts +59 -0
  149. package/examples/extensions/custom-compaction.ts +115 -0
  150. package/examples/extensions/custom-footer.ts +65 -0
  151. package/examples/extensions/custom-header.ts +73 -0
  152. package/examples/extensions/custom-provider-anthropic/index.ts +605 -0
  153. package/examples/extensions/custom-provider-anthropic/package-lock.json +24 -0
  154. package/examples/extensions/custom-provider-anthropic/package.json +19 -0
  155. package/examples/extensions/custom-provider-gitlab-duo/index.ts +350 -0
  156. package/examples/extensions/custom-provider-gitlab-duo/package.json +16 -0
  157. package/examples/extensions/custom-provider-gitlab-duo/test.ts +83 -0
  158. package/examples/extensions/dirty-repo-guard.ts +56 -0
  159. package/examples/extensions/doom-overlay/README.md +46 -0
  160. package/examples/extensions/doom-overlay/doom/build/doom.js +21 -0
  161. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  162. package/examples/extensions/doom-overlay/doom/build.sh +152 -0
  163. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +72 -0
  164. package/examples/extensions/doom-overlay/doom-component.ts +133 -0
  165. package/examples/extensions/doom-overlay/doom-engine.ts +173 -0
  166. package/examples/extensions/doom-overlay/doom-keys.ts +105 -0
  167. package/examples/extensions/doom-overlay/index.ts +74 -0
  168. package/examples/extensions/doom-overlay/wad-finder.ts +51 -0
  169. package/examples/extensions/event-bus.ts +43 -0
  170. package/examples/extensions/file-trigger.ts +41 -0
  171. package/examples/extensions/git-checkpoint.ts +53 -0
  172. package/examples/extensions/handoff.ts +151 -0
  173. package/examples/extensions/hello.ts +25 -0
  174. package/examples/extensions/inline-bash.ts +94 -0
  175. package/examples/extensions/input-transform.ts +43 -0
  176. package/examples/extensions/interactive-shell.ts +196 -0
  177. package/examples/extensions/mac-system-theme.ts +47 -0
  178. package/examples/extensions/message-renderer.ts +60 -0
  179. package/examples/extensions/modal-editor.ts +86 -0
  180. package/examples/extensions/model-status.ts +31 -0
  181. package/examples/extensions/notify.ts +25 -0
  182. package/examples/extensions/overlay-qa-tests.ts +882 -0
  183. package/examples/extensions/overlay-test.ts +151 -0
  184. package/examples/extensions/permission-gate.ts +34 -0
  185. package/examples/extensions/pirate.ts +47 -0
  186. package/examples/extensions/plan-mode/README.md +65 -0
  187. package/examples/extensions/plan-mode/index.ts +341 -0
  188. package/examples/extensions/plan-mode/utils.ts +168 -0
  189. package/examples/extensions/preset.ts +399 -0
  190. package/examples/extensions/protected-paths.ts +30 -0
  191. package/examples/extensions/qna.ts +120 -0
  192. package/examples/extensions/question.ts +265 -0
  193. package/examples/extensions/questionnaire.ts +428 -0
  194. package/examples/extensions/rainbow-editor.ts +88 -0
  195. package/examples/extensions/sandbox/index.ts +318 -0
  196. package/examples/extensions/sandbox/package-lock.json +92 -0
  197. package/examples/extensions/sandbox/package.json +19 -0
  198. package/examples/extensions/send-user-message.ts +97 -0
  199. package/examples/extensions/session-name.ts +27 -0
  200. package/examples/extensions/shutdown-command.ts +63 -0
  201. package/examples/extensions/snake.ts +344 -0
  202. package/examples/extensions/space-invaders.ts +561 -0
  203. package/examples/extensions/ssh.ts +220 -0
  204. package/examples/extensions/status-line.ts +40 -0
  205. package/examples/extensions/subagent/README.md +172 -0
  206. package/examples/extensions/subagent/agents/planner.md +37 -0
  207. package/examples/extensions/subagent/agents/reviewer.md +35 -0
  208. package/examples/extensions/subagent/agents/scout.md +50 -0
  209. package/examples/extensions/subagent/agents/worker.md +24 -0
  210. package/examples/extensions/subagent/agents.ts +127 -0
  211. package/examples/extensions/subagent/index.ts +964 -0
  212. package/examples/extensions/subagent/prompts/implement-and-review.md +10 -0
  213. package/examples/extensions/subagent/prompts/implement.md +10 -0
  214. package/examples/extensions/subagent/prompts/scout-and-plan.md +9 -0
  215. package/examples/extensions/summarize.ts +196 -0
  216. package/examples/extensions/timed-confirm.ts +70 -0
  217. package/examples/extensions/todo.ts +300 -0
  218. package/examples/extensions/tool-override.ts +144 -0
  219. package/examples/extensions/tools.ts +147 -0
  220. package/examples/extensions/trigger-compact.ts +40 -0
  221. package/examples/extensions/truncated-tool.ts +193 -0
  222. package/examples/extensions/widget-placement.ts +17 -0
  223. package/examples/extensions/with-deps/index.ts +36 -0
  224. package/examples/extensions/with-deps/package-lock.json +31 -0
  225. package/examples/extensions/with-deps/package.json +22 -0
  226. package/examples/sdk/01-minimal.ts +22 -0
  227. package/examples/sdk/02-custom-model.ts +50 -0
  228. package/examples/sdk/03-custom-prompt.ts +55 -0
  229. package/examples/sdk/04-skills.ts +46 -0
  230. package/examples/sdk/05-tools.ts +56 -0
  231. package/examples/sdk/06-extensions.ts +88 -0
  232. package/examples/sdk/07-context-files.ts +40 -0
  233. package/examples/sdk/08-prompt-templates.ts +47 -0
  234. package/examples/sdk/09-api-keys-and-oauth.ts +48 -0
  235. package/examples/sdk/10-settings.ts +38 -0
  236. package/examples/sdk/11-sessions.ts +48 -0
  237. package/examples/sdk/12-full-control.ts +82 -0
  238. package/examples/sdk/13-codex-oauth.ts +37 -0
  239. package/examples/sdk/README.md +144 -0
  240. package/package.json +85 -0
package/dist/main.js ADDED
@@ -0,0 +1,565 @@
1
+ /**
2
+ * Main entry point for the coding agent CLI.
3
+ *
4
+ * This file handles CLI argument parsing and translates them into
5
+ * createAgentSession() options. The SDK does the heavy lifting.
6
+ */
7
+ import { modelsAreEqual, supportsXhigh } from "indusagi/ai";
8
+ import chalk from "chalk";
9
+ import { createInterface } from "readline";
10
+ import { parseArgs, printHelp } from "./cli/args.js";
11
+ import { selectConfig } from "./cli/config-selector.js";
12
+ import { processFileArguments } from "./cli/file-processor.js";
13
+ import { listModels } from "./cli/list-models.js";
14
+ import { selectSession } from "./cli/session-picker.js";
15
+ import { getAgentDir, getModelsPath, VERSION } from "./config.js";
16
+ import { AuthStorage } from "./core/auth-storage.js";
17
+ import { exportFromFile } from "./core/export-html/index.js";
18
+ import { KeybindingsManager } from "./core/keybindings.js";
19
+ import { ModelRegistry } from "./core/model-registry.js";
20
+ import { resolveModelScope } from "./core/model-resolver.js";
21
+ import { DefaultPackageManager } from "./core/package-manager.js";
22
+ import { DefaultResourceLoader } from "./core/resource-loader.js";
23
+ import { createAgentSession } from "./core/sdk.js";
24
+ import { SessionManager } from "./core/session-manager.js";
25
+ import { SettingsManager } from "./core/settings-manager.js";
26
+ import { printTimings, time } from "./core/timings.js";
27
+ import { allTools } from "./core/tools/index.js";
28
+ import { runMigrations, showDeprecationWarnings } from "./migrations.js";
29
+ import { InteractiveMode, runPrintMode, runRpcMode } from "./modes/index.js";
30
+ import { initTheme, stopThemeWatcher } from "./modes/interactive/theme/theme.js";
31
+ /**
32
+ * Read all content from piped stdin.
33
+ * Returns undefined if stdin is a TTY (interactive terminal).
34
+ */
35
+ async function readPipedStdin() {
36
+ // If stdin is a TTY, we're running interactively - don't read stdin
37
+ if (process.stdin.isTTY) {
38
+ return undefined;
39
+ }
40
+ return new Promise((resolve) => {
41
+ let data = "";
42
+ process.stdin.setEncoding("utf8");
43
+ process.stdin.on("data", (chunk) => {
44
+ data += chunk;
45
+ });
46
+ process.stdin.on("end", () => {
47
+ resolve(data.trim() || undefined);
48
+ });
49
+ process.stdin.resume();
50
+ });
51
+ }
52
+ function parsePackageCommand(args) {
53
+ const [command, ...rest] = args;
54
+ if (command !== "install" && command !== "remove" && command !== "update" && command !== "list") {
55
+ return undefined;
56
+ }
57
+ let local = false;
58
+ const sources = [];
59
+ for (const arg of rest) {
60
+ if (arg === "-l" || arg === "--local") {
61
+ local = true;
62
+ continue;
63
+ }
64
+ sources.push(arg);
65
+ }
66
+ return { command, source: sources[0], local };
67
+ }
68
+ function normalizeExtensionSource(source) {
69
+ if (source.startsWith("npm:")) {
70
+ const spec = source.slice("npm:".length).trim();
71
+ const match = spec.match(/^(@?[^@]+(?:\/[^@]+)?)(?:@.+)?$/);
72
+ return { type: "npm", key: match?.[1] ?? spec };
73
+ }
74
+ if (source.startsWith("git:")) {
75
+ const repo = source.slice("git:".length).trim().split("@")[0] ?? "";
76
+ return { type: "git", key: repo.replace(/^https?:\/\//, "").replace(/\.git$/, "") };
77
+ }
78
+ // Raw git URLs
79
+ if (source.startsWith("https://") || source.startsWith("http://")) {
80
+ const repo = source.split("@")[0] ?? "";
81
+ return { type: "git", key: repo.replace(/^https?:\/\//, "").replace(/\.git$/, "") };
82
+ }
83
+ return { type: "local", key: source };
84
+ }
85
+ function sourcesMatch(a, b) {
86
+ const left = normalizeExtensionSource(a);
87
+ const right = normalizeExtensionSource(b);
88
+ return left.type === right.type && left.key === right.key;
89
+ }
90
+ function getPackageSourceString(pkg) {
91
+ return typeof pkg === "string" ? pkg : pkg.source;
92
+ }
93
+ function packageSourcesMatch(a, b) {
94
+ const aSource = getPackageSourceString(a);
95
+ return sourcesMatch(aSource, b);
96
+ }
97
+ function updatePackageSources(settingsManager, source, local, action) {
98
+ const currentSettings = local ? settingsManager.getProjectSettings() : settingsManager.getGlobalSettings();
99
+ const currentPackages = currentSettings.packages ?? [];
100
+ let nextPackages;
101
+ if (action === "add") {
102
+ const exists = currentPackages.some((existing) => packageSourcesMatch(existing, source));
103
+ nextPackages = exists ? currentPackages : [...currentPackages, source];
104
+ }
105
+ else {
106
+ nextPackages = currentPackages.filter((existing) => !packageSourcesMatch(existing, source));
107
+ }
108
+ if (local) {
109
+ settingsManager.setProjectPackages(nextPackages);
110
+ }
111
+ else {
112
+ settingsManager.setPackages(nextPackages);
113
+ }
114
+ }
115
+ async function handlePackageCommand(args) {
116
+ const options = parsePackageCommand(args);
117
+ if (!options) {
118
+ return false;
119
+ }
120
+ const cwd = process.cwd();
121
+ const agentDir = getAgentDir();
122
+ const settingsManager = SettingsManager.create(cwd, agentDir);
123
+ const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
124
+ // Set up progress callback for CLI feedback
125
+ packageManager.setProgressCallback((event) => {
126
+ if (event.type === "start") {
127
+ process.stdout.write(chalk.dim(`${event.message}\n`));
128
+ }
129
+ else if (event.type === "error") {
130
+ console.error(chalk.red(`Error: ${event.message}`));
131
+ }
132
+ });
133
+ if (options.command === "install") {
134
+ if (!options.source) {
135
+ console.error(chalk.red("Missing install source."));
136
+ process.exit(1);
137
+ }
138
+ await packageManager.install(options.source, { local: options.local });
139
+ updatePackageSources(settingsManager, options.source, options.local, "add");
140
+ console.log(chalk.green(`Installed ${options.source}`));
141
+ return true;
142
+ }
143
+ if (options.command === "remove") {
144
+ if (!options.source) {
145
+ console.error(chalk.red("Missing remove source."));
146
+ process.exit(1);
147
+ }
148
+ await packageManager.remove(options.source, { local: options.local });
149
+ updatePackageSources(settingsManager, options.source, options.local, "remove");
150
+ console.log(chalk.green(`Removed ${options.source}`));
151
+ return true;
152
+ }
153
+ if (options.command === "list") {
154
+ const globalSettings = settingsManager.getGlobalSettings();
155
+ const projectSettings = settingsManager.getProjectSettings();
156
+ const globalPackages = globalSettings.packages ?? [];
157
+ const projectPackages = projectSettings.packages ?? [];
158
+ if (globalPackages.length === 0 && projectPackages.length === 0) {
159
+ console.log(chalk.dim("No packages installed."));
160
+ return true;
161
+ }
162
+ const formatPackage = (pkg, scope) => {
163
+ const source = typeof pkg === "string" ? pkg : pkg.source;
164
+ const filtered = typeof pkg === "object";
165
+ const display = filtered ? `${source} (filtered)` : source;
166
+ console.log(` ${display}`);
167
+ // Show resolved path
168
+ const path = packageManager.getInstalledPath(source, scope);
169
+ if (path) {
170
+ console.log(chalk.dim(` ${path}`));
171
+ }
172
+ };
173
+ if (globalPackages.length > 0) {
174
+ console.log(chalk.bold("User packages:"));
175
+ for (const pkg of globalPackages) {
176
+ formatPackage(pkg, "user");
177
+ }
178
+ }
179
+ if (projectPackages.length > 0) {
180
+ if (globalPackages.length > 0)
181
+ console.log();
182
+ console.log(chalk.bold("Project packages:"));
183
+ for (const pkg of projectPackages) {
184
+ formatPackage(pkg, "project");
185
+ }
186
+ }
187
+ return true;
188
+ }
189
+ await packageManager.update(options.source);
190
+ if (options.source) {
191
+ console.log(chalk.green(`Updated ${options.source}`));
192
+ }
193
+ else {
194
+ console.log(chalk.green("Updated packages"));
195
+ }
196
+ return true;
197
+ }
198
+ async function prepareInitialMessage(parsed, autoResizeImages) {
199
+ if (parsed.fileArgs.length === 0) {
200
+ return {};
201
+ }
202
+ const { text, images } = await processFileArguments(parsed.fileArgs, { autoResizeImages });
203
+ let initialMessage;
204
+ if (parsed.messages.length > 0) {
205
+ initialMessage = text + parsed.messages[0];
206
+ parsed.messages.shift();
207
+ }
208
+ else {
209
+ initialMessage = text;
210
+ }
211
+ return {
212
+ initialMessage,
213
+ initialImages: images.length > 0 ? images : undefined,
214
+ };
215
+ }
216
+ /**
217
+ * Resolve a session argument to a file path.
218
+ * If it looks like a path, use as-is. Otherwise try to match as session ID prefix.
219
+ */
220
+ async function resolveSessionPath(sessionArg, cwd, sessionDir) {
221
+ // If it looks like a file path, use as-is
222
+ if (sessionArg.includes("/") || sessionArg.includes("\\") || sessionArg.endsWith(".jsonl")) {
223
+ return { type: "path", path: sessionArg };
224
+ }
225
+ // Try to match as session ID in current project first
226
+ const localSessions = await SessionManager.list(cwd, sessionDir);
227
+ const localMatches = localSessions.filter((s) => s.id.startsWith(sessionArg));
228
+ if (localMatches.length >= 1) {
229
+ return { type: "local", path: localMatches[0].path };
230
+ }
231
+ // Try global search across all projects
232
+ const allSessions = await SessionManager.listAll();
233
+ const globalMatches = allSessions.filter((s) => s.id.startsWith(sessionArg));
234
+ if (globalMatches.length >= 1) {
235
+ const match = globalMatches[0];
236
+ return { type: "global", path: match.path, cwd: match.cwd };
237
+ }
238
+ // Not found anywhere
239
+ return { type: "not_found", arg: sessionArg };
240
+ }
241
+ /** Prompt user for yes/no confirmation */
242
+ async function promptConfirm(message) {
243
+ return new Promise((resolve) => {
244
+ const rl = createInterface({
245
+ input: process.stdin,
246
+ output: process.stdout,
247
+ });
248
+ rl.question(`${message} [y/N] `, (answer) => {
249
+ rl.close();
250
+ resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
251
+ });
252
+ });
253
+ }
254
+ async function createSessionManager(parsed, cwd) {
255
+ if (parsed.noSession) {
256
+ return SessionManager.inMemory();
257
+ }
258
+ if (parsed.session) {
259
+ const resolved = await resolveSessionPath(parsed.session, cwd, parsed.sessionDir);
260
+ switch (resolved.type) {
261
+ case "path":
262
+ case "local":
263
+ return SessionManager.open(resolved.path, parsed.sessionDir);
264
+ case "global": {
265
+ // Session found in different project - ask user if they want to fork
266
+ console.log(chalk.yellow(`Session found in different project: ${resolved.cwd}`));
267
+ const shouldFork = await promptConfirm("Fork this session into current directory?");
268
+ if (!shouldFork) {
269
+ console.log(chalk.dim("Aborted."));
270
+ process.exit(0);
271
+ }
272
+ return SessionManager.forkFrom(resolved.path, cwd, parsed.sessionDir);
273
+ }
274
+ case "not_found":
275
+ console.error(chalk.red(`No session found matching '${resolved.arg}'`));
276
+ process.exit(1);
277
+ }
278
+ }
279
+ if (parsed.continue) {
280
+ return SessionManager.continueRecent(cwd, parsed.sessionDir);
281
+ }
282
+ // --resume is handled separately (needs picker UI)
283
+ // If --session-dir provided without --continue/--resume, create new session there
284
+ if (parsed.sessionDir) {
285
+ return SessionManager.create(cwd, parsed.sessionDir);
286
+ }
287
+ // Default case (new session) returns undefined, SDK will create one
288
+ return undefined;
289
+ }
290
+ function buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager) {
291
+ const options = {};
292
+ if (sessionManager) {
293
+ options.sessionManager = sessionManager;
294
+ }
295
+ // Model from CLI
296
+ if (parsed.provider && parsed.model) {
297
+ const model = modelRegistry.find(parsed.provider, parsed.model);
298
+ if (!model) {
299
+ console.error(chalk.red(`Model ${parsed.provider}/${parsed.model} not found`));
300
+ process.exit(1);
301
+ }
302
+ options.model = model;
303
+ }
304
+ else if (scopedModels.length > 0 && !parsed.continue && !parsed.resume) {
305
+ // Check if saved default is in scoped models - use it if so, otherwise first scoped model
306
+ const savedProvider = settingsManager.getDefaultProvider();
307
+ const savedModelId = settingsManager.getDefaultModel();
308
+ const savedModel = savedProvider && savedModelId ? modelRegistry.find(savedProvider, savedModelId) : undefined;
309
+ const savedInScope = savedModel ? scopedModels.find((sm) => modelsAreEqual(sm.model, savedModel)) : undefined;
310
+ if (savedInScope) {
311
+ options.model = savedInScope.model;
312
+ // Use thinking level from scoped model config if explicitly set
313
+ if (!parsed.thinking && savedInScope.thinkingLevel) {
314
+ options.thinkingLevel = savedInScope.thinkingLevel;
315
+ }
316
+ }
317
+ else {
318
+ options.model = scopedModels[0].model;
319
+ // Use thinking level from first scoped model if explicitly set
320
+ if (!parsed.thinking && scopedModels[0].thinkingLevel) {
321
+ options.thinkingLevel = scopedModels[0].thinkingLevel;
322
+ }
323
+ }
324
+ }
325
+ // Thinking level from CLI (takes precedence over scoped model thinking levels set above)
326
+ if (parsed.thinking) {
327
+ options.thinkingLevel = parsed.thinking;
328
+ }
329
+ // Scoped models for Ctrl+P cycling - fill in default thinking level for models without explicit level
330
+ if (scopedModels.length > 0) {
331
+ const defaultThinkingLevel = settingsManager.getDefaultThinkingLevel() ?? "off";
332
+ options.scopedModels = scopedModels.map((sm) => ({
333
+ model: sm.model,
334
+ thinkingLevel: sm.thinkingLevel ?? defaultThinkingLevel,
335
+ }));
336
+ }
337
+ // API key from CLI - set in authStorage
338
+ // (handled by caller before createAgentSession)
339
+ // Tools
340
+ if (parsed.noTools) {
341
+ // --no-tools: start with no built-in tools
342
+ // --tools can still add specific ones back
343
+ if (parsed.tools && parsed.tools.length > 0) {
344
+ options.tools = parsed.tools.map((name) => allTools[name]);
345
+ }
346
+ else {
347
+ options.tools = [];
348
+ }
349
+ }
350
+ else if (parsed.tools) {
351
+ options.tools = parsed.tools.map((name) => allTools[name]);
352
+ }
353
+ return options;
354
+ }
355
+ async function handleConfigCommand(args) {
356
+ if (args[0] !== "config") {
357
+ return false;
358
+ }
359
+ const cwd = process.cwd();
360
+ const agentDir = getAgentDir();
361
+ const settingsManager = SettingsManager.create(cwd, agentDir);
362
+ const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
363
+ const resolvedPaths = await packageManager.resolve();
364
+ await selectConfig({
365
+ resolvedPaths,
366
+ settingsManager,
367
+ cwd,
368
+ agentDir,
369
+ });
370
+ process.exit(0);
371
+ }
372
+ export async function main(args) {
373
+ if (await handlePackageCommand(args)) {
374
+ return;
375
+ }
376
+ if (await handleConfigCommand(args)) {
377
+ return;
378
+ }
379
+ // Run migrations (pass cwd for project-local migrations)
380
+ const { migratedAuthProviders: migratedProviders, deprecationWarnings } = runMigrations(process.cwd());
381
+ // First pass: parse args to get --extension paths
382
+ const firstPass = parseArgs(args);
383
+ // Early load extensions to discover their CLI flags
384
+ const cwd = process.cwd();
385
+ const agentDir = getAgentDir();
386
+ const settingsManager = SettingsManager.create(cwd, agentDir);
387
+ const authStorage = new AuthStorage();
388
+ const modelRegistry = new ModelRegistry(authStorage, getModelsPath());
389
+ const resourceLoader = new DefaultResourceLoader({
390
+ cwd,
391
+ agentDir,
392
+ settingsManager,
393
+ additionalExtensionPaths: firstPass.extensions,
394
+ additionalSkillPaths: firstPass.skills,
395
+ additionalPromptTemplatePaths: firstPass.promptTemplates,
396
+ additionalThemePaths: firstPass.themes,
397
+ noExtensions: firstPass.noExtensions,
398
+ noSkills: firstPass.noSkills,
399
+ noPromptTemplates: firstPass.noPromptTemplates,
400
+ noThemes: firstPass.noThemes,
401
+ systemPrompt: firstPass.systemPrompt,
402
+ appendSystemPrompt: firstPass.appendSystemPrompt,
403
+ });
404
+ await resourceLoader.reload();
405
+ time("resourceLoader.reload");
406
+ const extensionsResult = resourceLoader.getExtensions();
407
+ for (const { path, error } of extensionsResult.errors) {
408
+ console.error(chalk.red(`Failed to load extension "${path}": ${error}`));
409
+ }
410
+ // Apply pending provider registrations from extensions immediately
411
+ // so they're available for model resolution before AgentSession is created
412
+ for (const { name, config } of extensionsResult.runtime.pendingProviderRegistrations) {
413
+ modelRegistry.registerProvider(name, config);
414
+ }
415
+ extensionsResult.runtime.pendingProviderRegistrations = [];
416
+ const extensionFlags = new Map();
417
+ for (const ext of extensionsResult.extensions) {
418
+ for (const [name, flag] of ext.flags) {
419
+ extensionFlags.set(name, { type: flag.type });
420
+ }
421
+ }
422
+ // Second pass: parse args with extension flags
423
+ const parsed = parseArgs(args, extensionFlags);
424
+ // Pass flag values to extensions via runtime
425
+ for (const [name, value] of parsed.unknownFlags) {
426
+ extensionsResult.runtime.flagValues.set(name, value);
427
+ }
428
+ if (parsed.version) {
429
+ console.log(VERSION);
430
+ return;
431
+ }
432
+ if (parsed.help) {
433
+ printHelp();
434
+ return;
435
+ }
436
+ if (parsed.listModels !== undefined) {
437
+ const searchPattern = typeof parsed.listModels === "string" ? parsed.listModels : undefined;
438
+ await listModels(modelRegistry, searchPattern);
439
+ return;
440
+ }
441
+ // Read piped stdin content (if any) - skip for RPC mode which uses stdin for JSON-RPC
442
+ if (parsed.mode !== "rpc") {
443
+ const stdinContent = await readPipedStdin();
444
+ if (stdinContent !== undefined) {
445
+ // Force print mode since interactive mode requires a TTY for keyboard input
446
+ parsed.print = true;
447
+ // Prepend stdin content to messages
448
+ parsed.messages.unshift(stdinContent);
449
+ }
450
+ }
451
+ if (parsed.export) {
452
+ try {
453
+ const outputPath = parsed.messages.length > 0 ? parsed.messages[0] : undefined;
454
+ const result = await exportFromFile(parsed.export, outputPath);
455
+ console.log(`Exported to: ${result}`);
456
+ return;
457
+ }
458
+ catch (error) {
459
+ const message = error instanceof Error ? error.message : "Failed to export session";
460
+ console.error(chalk.red(`Error: ${message}`));
461
+ process.exit(1);
462
+ }
463
+ }
464
+ if (parsed.mode === "rpc" && parsed.fileArgs.length > 0) {
465
+ console.error(chalk.red("Error: @file arguments are not supported in RPC mode"));
466
+ process.exit(1);
467
+ }
468
+ const { initialMessage, initialImages } = await prepareInitialMessage(parsed, settingsManager.getImageAutoResize());
469
+ const isInteractive = !parsed.print && parsed.mode === undefined;
470
+ const mode = parsed.mode || "text";
471
+ initTheme(settingsManager.getTheme(), isInteractive);
472
+ // Show deprecation warnings in interactive mode
473
+ if (isInteractive && deprecationWarnings.length > 0) {
474
+ await showDeprecationWarnings(deprecationWarnings);
475
+ }
476
+ let scopedModels = [];
477
+ const modelPatterns = parsed.models ?? settingsManager.getEnabledModels();
478
+ if (modelPatterns && modelPatterns.length > 0) {
479
+ scopedModels = await resolveModelScope(modelPatterns, modelRegistry);
480
+ }
481
+ // Create session manager based on CLI flags
482
+ let sessionManager = await createSessionManager(parsed, cwd);
483
+ // Handle --resume: show session picker
484
+ if (parsed.resume) {
485
+ // Initialize keybindings so session picker respects user config
486
+ KeybindingsManager.create();
487
+ const selectedPath = await selectSession((onProgress) => SessionManager.list(cwd, parsed.sessionDir, onProgress), SessionManager.listAll);
488
+ if (!selectedPath) {
489
+ console.log(chalk.dim("No session selected"));
490
+ stopThemeWatcher();
491
+ process.exit(0);
492
+ }
493
+ sessionManager = SessionManager.open(selectedPath);
494
+ }
495
+ const sessionOptions = buildSessionOptions(parsed, scopedModels, sessionManager, modelRegistry, settingsManager);
496
+ sessionOptions.authStorage = authStorage;
497
+ sessionOptions.modelRegistry = modelRegistry;
498
+ sessionOptions.resourceLoader = resourceLoader;
499
+ // Handle CLI --api-key as runtime override (not persisted)
500
+ if (parsed.apiKey) {
501
+ if (!sessionOptions.model) {
502
+ console.error(chalk.red("--api-key requires a model to be specified via --provider/--model or -m/--models"));
503
+ process.exit(1);
504
+ }
505
+ authStorage.setRuntimeApiKey(sessionOptions.model.provider, parsed.apiKey);
506
+ }
507
+ const { session, modelFallbackMessage } = await createAgentSession(sessionOptions);
508
+ if (!isInteractive && !session.model) {
509
+ console.error(chalk.red("No models available."));
510
+ console.error(chalk.yellow("\nSet an API key environment variable:"));
511
+ console.error(" ANTHROPIC_AINDUSAGI_KEY, OPENAI_AINDUSAGI_KEY, GEMINI_AINDUSAGI_KEY, etc.");
512
+ console.error(chalk.yellow(`\nOr create ${getModelsPath()}`));
513
+ process.exit(1);
514
+ }
515
+ // Clamp thinking level to model capabilities (for CLI override case)
516
+ if (session.model && parsed.thinking) {
517
+ let effectiveThinking = parsed.thinking;
518
+ if (!session.model.reasoning) {
519
+ effectiveThinking = "off";
520
+ }
521
+ else if (effectiveThinking === "xhigh" && !supportsXhigh(session.model)) {
522
+ effectiveThinking = "high";
523
+ }
524
+ if (effectiveThinking !== session.thinkingLevel) {
525
+ session.setThinkingLevel(effectiveThinking);
526
+ }
527
+ }
528
+ if (mode === "rpc") {
529
+ await runRpcMode(session);
530
+ }
531
+ else if (isInteractive) {
532
+ if (scopedModels.length > 0 && (parsed.verbose || !settingsManager.getQuietStartup())) {
533
+ const modelList = scopedModels
534
+ .map((sm) => {
535
+ const thinkingStr = sm.thinkingLevel ? `:${sm.thinkingLevel}` : "";
536
+ return `${sm.model.id}${thinkingStr}`;
537
+ })
538
+ .join(", ");
539
+ console.log(chalk.dim(`Model scope: ${modelList} ${chalk.gray("(Ctrl+P to cycle)")}`));
540
+ }
541
+ printTimings();
542
+ const mode = new InteractiveMode(session, {
543
+ migratedProviders,
544
+ modelFallbackMessage,
545
+ initialMessage,
546
+ initialImages,
547
+ initialMessages: parsed.messages,
548
+ verbose: parsed.verbose,
549
+ });
550
+ await mode.run();
551
+ }
552
+ else {
553
+ await runPrintMode(session, {
554
+ mode,
555
+ messages: parsed.messages,
556
+ initialMessage,
557
+ initialImages,
558
+ });
559
+ stopThemeWatcher();
560
+ if (process.stdout.writableLength > 0) {
561
+ await new Promise((resolve) => process.stdout.once("drain", resolve));
562
+ }
563
+ process.exit(0);
564
+ }
565
+ }