keycode-ai 0.0.0-stage → 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 (363) hide show
  1. package/CHANGELOG.md +85 -0
  2. package/LICENSE +201 -0
  3. package/README.md +547 -2
  4. package/dist/app/agent.d.ts +126 -0
  5. package/dist/app/agent.js +613 -0
  6. package/dist/app/agent.js.map +1 -0
  7. package/dist/app/commands.d.ts +15 -0
  8. package/dist/app/commands.js +281 -0
  9. package/dist/app/commands.js.map +1 -0
  10. package/dist/app/compact.d.ts +23 -0
  11. package/dist/app/compact.js +75 -0
  12. package/dist/app/compact.js.map +1 -0
  13. package/dist/app/export.d.ts +6 -0
  14. package/dist/app/export.js +56 -0
  15. package/dist/app/export.js.map +1 -0
  16. package/dist/app/factory.d.ts +106 -0
  17. package/dist/app/factory.js +687 -0
  18. package/dist/app/factory.js.map +1 -0
  19. package/dist/app/onboarding.d.ts +6 -0
  20. package/dist/app/onboarding.js +32 -0
  21. package/dist/app/onboarding.js.map +1 -0
  22. package/dist/app/subagent.d.ts +16 -0
  23. package/dist/app/subagent.js +14 -0
  24. package/dist/app/subagent.js.map +1 -0
  25. package/dist/app/trust.d.ts +6 -0
  26. package/dist/app/trust.js +74 -0
  27. package/dist/app/trust.js.map +1 -0
  28. package/dist/app/trustManifest.d.ts +18 -0
  29. package/dist/app/trustManifest.js +171 -0
  30. package/dist/app/trustManifest.js.map +1 -0
  31. package/dist/artifacts/store.d.ts +43 -0
  32. package/dist/artifacts/store.js +159 -0
  33. package/dist/artifacts/store.js.map +1 -0
  34. package/dist/cli/auth.d.ts +7 -0
  35. package/dist/cli/auth.js +68 -0
  36. package/dist/cli/auth.js.map +1 -0
  37. package/dist/cli/doctor.d.ts +19 -0
  38. package/dist/cli/doctor.js +205 -0
  39. package/dist/cli/doctor.js.map +1 -0
  40. package/dist/cli/extra.d.ts +2 -0
  41. package/dist/cli/extra.js +989 -0
  42. package/dist/cli/extra.js.map +1 -0
  43. package/dist/cli/headless.d.ts +20 -0
  44. package/dist/cli/headless.js +224 -0
  45. package/dist/cli/headless.js.map +1 -0
  46. package/dist/cli/index.d.ts +3 -0
  47. package/dist/cli/index.js +283 -0
  48. package/dist/cli/index.js.map +1 -0
  49. package/dist/contracts/message.d.ts +34 -0
  50. package/dist/contracts/message.js +10 -0
  51. package/dist/contracts/message.js.map +1 -0
  52. package/dist/contracts/permissions.d.ts +16 -0
  53. package/dist/contracts/permissions.js +9 -0
  54. package/dist/contracts/permissions.js.map +1 -0
  55. package/dist/contracts/provider.d.ts +65 -0
  56. package/dist/contracts/provider.js +2 -0
  57. package/dist/contracts/provider.js.map +1 -0
  58. package/dist/contracts/session.d.ts +101 -0
  59. package/dist/contracts/session.js +11 -0
  60. package/dist/contracts/session.js.map +1 -0
  61. package/dist/contracts/tool.d.ts +81 -0
  62. package/dist/contracts/tool.js +15 -0
  63. package/dist/contracts/tool.js.map +1 -0
  64. package/dist/core/budget.d.ts +11 -0
  65. package/dist/core/budget.js +22 -0
  66. package/dist/core/budget.js.map +1 -0
  67. package/dist/core/context.d.ts +27 -0
  68. package/dist/core/context.js +92 -0
  69. package/dist/core/context.js.map +1 -0
  70. package/dist/extensions/commands.d.ts +23 -0
  71. package/dist/extensions/commands.js +103 -0
  72. package/dist/extensions/commands.js.map +1 -0
  73. package/dist/extensions/customAgents.d.ts +19 -0
  74. package/dist/extensions/customAgents.js +85 -0
  75. package/dist/extensions/customAgents.js.map +1 -0
  76. package/dist/extensions/frontmatter.d.ts +6 -0
  77. package/dist/extensions/frontmatter.js +73 -0
  78. package/dist/extensions/frontmatter.js.map +1 -0
  79. package/dist/extensions/hooks.d.ts +63 -0
  80. package/dist/extensions/hooks.js +145 -0
  81. package/dist/extensions/hooks.js.map +1 -0
  82. package/dist/extensions/loops.d.ts +27 -0
  83. package/dist/extensions/loops.js +119 -0
  84. package/dist/extensions/loops.js.map +1 -0
  85. package/dist/extensions/plugins.d.ts +29 -0
  86. package/dist/extensions/plugins.js +119 -0
  87. package/dist/extensions/plugins.js.map +1 -0
  88. package/dist/extensions/skills.d.ts +21 -0
  89. package/dist/extensions/skills.js +89 -0
  90. package/dist/extensions/skills.js.map +1 -0
  91. package/dist/extensions/statusline.d.ts +13 -0
  92. package/dist/extensions/statusline.js +30 -0
  93. package/dist/extensions/statusline.js.map +1 -0
  94. package/dist/extensions/styles.d.ts +14 -0
  95. package/dist/extensions/styles.js +79 -0
  96. package/dist/extensions/styles.js.map +1 -0
  97. package/dist/extensions/teams.d.ts +44 -0
  98. package/dist/extensions/teams.js +79 -0
  99. package/dist/extensions/teams.js.map +1 -0
  100. package/dist/extensions/themes.d.ts +25 -0
  101. package/dist/extensions/themes.js +109 -0
  102. package/dist/extensions/themes.js.map +1 -0
  103. package/dist/extensions/workflows.d.ts +28 -0
  104. package/dist/extensions/workflows.js +65 -0
  105. package/dist/extensions/workflows.js.map +1 -0
  106. package/dist/gateway/index.d.ts +25 -0
  107. package/dist/gateway/index.js +125 -0
  108. package/dist/gateway/index.js.map +1 -0
  109. package/dist/integrations/background.d.ts +35 -0
  110. package/dist/integrations/background.js +167 -0
  111. package/dist/integrations/background.js.map +1 -0
  112. package/dist/integrations/browser.d.ts +36 -0
  113. package/dist/integrations/browser.js +80 -0
  114. package/dist/integrations/browser.js.map +1 -0
  115. package/dist/integrations/github.d.ts +44 -0
  116. package/dist/integrations/github.js +72 -0
  117. package/dist/integrations/github.js.map +1 -0
  118. package/dist/integrations/ide.d.ts +29 -0
  119. package/dist/integrations/ide.js +69 -0
  120. package/dist/integrations/ide.js.map +1 -0
  121. package/dist/integrations/import.d.ts +14 -0
  122. package/dist/integrations/import.js +76 -0
  123. package/dist/integrations/import.js.map +1 -0
  124. package/dist/integrations/playwrightDriver.d.ts +8 -0
  125. package/dist/integrations/playwrightDriver.js +70 -0
  126. package/dist/integrations/playwrightDriver.js.map +1 -0
  127. package/dist/integrations/pr.d.ts +23 -0
  128. package/dist/integrations/pr.js +81 -0
  129. package/dist/integrations/pr.js.map +1 -0
  130. package/dist/integrations/remote.d.ts +107 -0
  131. package/dist/integrations/remote.js +636 -0
  132. package/dist/integrations/remote.js.map +1 -0
  133. package/dist/integrations/runner.d.ts +30 -0
  134. package/dist/integrations/runner.js +56 -0
  135. package/dist/integrations/runner.js.map +1 -0
  136. package/dist/integrations/worktrees.d.ts +17 -0
  137. package/dist/integrations/worktrees.js +40 -0
  138. package/dist/integrations/worktrees.js.map +1 -0
  139. package/dist/integrations/ws.d.ts +9 -0
  140. package/dist/integrations/ws.js +102 -0
  141. package/dist/integrations/ws.js.map +1 -0
  142. package/dist/lsp/client.d.ts +51 -0
  143. package/dist/lsp/client.js +251 -0
  144. package/dist/lsp/client.js.map +1 -0
  145. package/dist/mcp/client.d.ts +56 -0
  146. package/dist/mcp/client.js +152 -0
  147. package/dist/mcp/client.js.map +1 -0
  148. package/dist/mcp/management.d.ts +20 -0
  149. package/dist/mcp/management.js +97 -0
  150. package/dist/mcp/management.js.map +1 -0
  151. package/dist/mcp/tools.d.ts +3 -0
  152. package/dist/mcp/tools.js +26 -0
  153. package/dist/mcp/tools.js.map +1 -0
  154. package/dist/notifications/index.d.ts +25 -0
  155. package/dist/notifications/index.js +63 -0
  156. package/dist/notifications/index.js.map +1 -0
  157. package/dist/permissions/audit.d.ts +25 -0
  158. package/dist/permissions/audit.js +58 -0
  159. package/dist/permissions/audit.js.map +1 -0
  160. package/dist/permissions/broker.d.ts +20 -0
  161. package/dist/permissions/broker.js +51 -0
  162. package/dist/permissions/broker.js.map +1 -0
  163. package/dist/permissions/dangerous.d.ts +7 -0
  164. package/dist/permissions/dangerous.js +42 -0
  165. package/dist/permissions/dangerous.js.map +1 -0
  166. package/dist/permissions/pipeline.d.ts +34 -0
  167. package/dist/permissions/pipeline.js +217 -0
  168. package/dist/permissions/pipeline.js.map +1 -0
  169. package/dist/permissions/prompt.d.ts +2 -0
  170. package/dist/permissions/prompt.js +33 -0
  171. package/dist/permissions/prompt.js.map +1 -0
  172. package/dist/permissions/rules.d.ts +7 -0
  173. package/dist/permissions/rules.js +176 -0
  174. package/dist/permissions/rules.js.map +1 -0
  175. package/dist/platform/index.d.ts +16 -0
  176. package/dist/platform/index.js +55 -0
  177. package/dist/platform/index.js.map +1 -0
  178. package/dist/privacy/index.d.ts +27 -0
  179. package/dist/privacy/index.js +98 -0
  180. package/dist/privacy/index.js.map +1 -0
  181. package/dist/providers/anthropic.d.ts +25 -0
  182. package/dist/providers/anthropic.js +225 -0
  183. package/dist/providers/anthropic.js.map +1 -0
  184. package/dist/providers/budget.d.ts +24 -0
  185. package/dist/providers/budget.js +47 -0
  186. package/dist/providers/budget.js.map +1 -0
  187. package/dist/providers/capabilities.d.ts +9 -0
  188. package/dist/providers/capabilities.js +39 -0
  189. package/dist/providers/capabilities.js.map +1 -0
  190. package/dist/providers/credentials.d.ts +21 -0
  191. package/dist/providers/credentials.js +81 -0
  192. package/dist/providers/credentials.js.map +1 -0
  193. package/dist/providers/fake.d.ts +32 -0
  194. package/dist/providers/fake.js +95 -0
  195. package/dist/providers/fake.js.map +1 -0
  196. package/dist/providers/openai.d.ts +27 -0
  197. package/dist/providers/openai.js +243 -0
  198. package/dist/providers/openai.js.map +1 -0
  199. package/dist/providers/presets.d.ts +20 -0
  200. package/dist/providers/presets.js +166 -0
  201. package/dist/providers/presets.js.map +1 -0
  202. package/dist/providers/registry.d.ts +27 -0
  203. package/dist/providers/registry.js +127 -0
  204. package/dist/providers/registry.js.map +1 -0
  205. package/dist/providers/retry.d.ts +22 -0
  206. package/dist/providers/retry.js +69 -0
  207. package/dist/providers/retry.js.map +1 -0
  208. package/dist/providers/sse.d.ts +5 -0
  209. package/dist/providers/sse.js +74 -0
  210. package/dist/providers/sse.js.map +1 -0
  211. package/dist/providers/textProtocol.d.ts +10 -0
  212. package/dist/providers/textProtocol.js +45 -0
  213. package/dist/providers/textProtocol.js.map +1 -0
  214. package/dist/questions/broker.d.ts +16 -0
  215. package/dist/questions/broker.js +40 -0
  216. package/dist/questions/broker.js.map +1 -0
  217. package/dist/sandbox/command.d.ts +20 -0
  218. package/dist/sandbox/command.js +296 -0
  219. package/dist/sandbox/command.js.map +1 -0
  220. package/dist/sandbox/index.d.ts +21 -0
  221. package/dist/sandbox/index.js +32 -0
  222. package/dist/sandbox/index.js.map +1 -0
  223. package/dist/sdk/index.d.ts +14 -0
  224. package/dist/sdk/index.js +57 -0
  225. package/dist/sdk/index.js.map +1 -0
  226. package/dist/sdk/structured.d.ts +7 -0
  227. package/dist/sdk/structured.js +66 -0
  228. package/dist/sdk/structured.js.map +1 -0
  229. package/dist/storage/autoMemory.d.ts +22 -0
  230. package/dist/storage/autoMemory.js +93 -0
  231. package/dist/storage/autoMemory.js.map +1 -0
  232. package/dist/storage/checkpoints.d.ts +15 -0
  233. package/dist/storage/checkpoints.js +86 -0
  234. package/dist/storage/checkpoints.js.map +1 -0
  235. package/dist/storage/memory.d.ts +21 -0
  236. package/dist/storage/memory.js +137 -0
  237. package/dist/storage/memory.js.map +1 -0
  238. package/dist/storage/schema.d.ts +177 -0
  239. package/dist/storage/schema.js +120 -0
  240. package/dist/storage/schema.js.map +1 -0
  241. package/dist/storage/session.d.ts +56 -0
  242. package/dist/storage/session.js +305 -0
  243. package/dist/storage/session.js.map +1 -0
  244. package/dist/storage/settings.d.ts +17 -0
  245. package/dist/storage/settings.js +150 -0
  246. package/dist/storage/settings.js.map +1 -0
  247. package/dist/telemetry/otel.d.ts +21 -0
  248. package/dist/telemetry/otel.js +71 -0
  249. package/dist/telemetry/otel.js.map +1 -0
  250. package/dist/tools/agent.d.ts +13 -0
  251. package/dist/tools/agent.js +45 -0
  252. package/dist/tools/agent.js.map +1 -0
  253. package/dist/tools/artifact.d.ts +31 -0
  254. package/dist/tools/artifact.js +137 -0
  255. package/dist/tools/artifact.js.map +1 -0
  256. package/dist/tools/bash.d.ts +29 -0
  257. package/dist/tools/bash.js +191 -0
  258. package/dist/tools/bash.js.map +1 -0
  259. package/dist/tools/codemode.d.ts +13 -0
  260. package/dist/tools/codemode.js +77 -0
  261. package/dist/tools/codemode.js.map +1 -0
  262. package/dist/tools/edit.d.ts +11 -0
  263. package/dist/tools/edit.js +128 -0
  264. package/dist/tools/edit.js.map +1 -0
  265. package/dist/tools/glob.d.ts +10 -0
  266. package/dist/tools/glob.js +33 -0
  267. package/dist/tools/glob.js.map +1 -0
  268. package/dist/tools/grep.d.ts +20 -0
  269. package/dist/tools/grep.js +143 -0
  270. package/dist/tools/grep.js.map +1 -0
  271. package/dist/tools/index.d.ts +11 -0
  272. package/dist/tools/index.js +47 -0
  273. package/dist/tools/index.js.map +1 -0
  274. package/dist/tools/lsp.d.ts +30 -0
  275. package/dist/tools/lsp.js +206 -0
  276. package/dist/tools/lsp.js.map +1 -0
  277. package/dist/tools/notebook.d.ts +19 -0
  278. package/dist/tools/notebook.js +83 -0
  279. package/dist/tools/notebook.js.map +1 -0
  280. package/dist/tools/powershell.d.ts +10 -0
  281. package/dist/tools/powershell.js +83 -0
  282. package/dist/tools/powershell.js.map +1 -0
  283. package/dist/tools/question.d.ts +15 -0
  284. package/dist/tools/question.js +50 -0
  285. package/dist/tools/question.js.map +1 -0
  286. package/dist/tools/read.d.ts +10 -0
  287. package/dist/tools/read.js +188 -0
  288. package/dist/tools/read.js.map +1 -0
  289. package/dist/tools/shared.d.ts +8 -0
  290. package/dist/tools/shared.js +35 -0
  291. package/dist/tools/shared.js.map +1 -0
  292. package/dist/tools/skill.d.ts +9 -0
  293. package/dist/tools/skill.js +38 -0
  294. package/dist/tools/skill.js.map +1 -0
  295. package/dist/tools/tasks.d.ts +35 -0
  296. package/dist/tools/tasks.js +139 -0
  297. package/dist/tools/tasks.js.map +1 -0
  298. package/dist/tools/todo.d.ts +27 -0
  299. package/dist/tools/todo.js +40 -0
  300. package/dist/tools/todo.js.map +1 -0
  301. package/dist/tools/walk.d.ts +15 -0
  302. package/dist/tools/walk.js +144 -0
  303. package/dist/tools/walk.js.map +1 -0
  304. package/dist/tools/webfetch.d.ts +22 -0
  305. package/dist/tools/webfetch.js +201 -0
  306. package/dist/tools/webfetch.js.map +1 -0
  307. package/dist/tools/websearch.d.ts +33 -0
  308. package/dist/tools/websearch.js +129 -0
  309. package/dist/tools/websearch.js.map +1 -0
  310. package/dist/tools/write.d.ts +8 -0
  311. package/dist/tools/write.js +51 -0
  312. package/dist/tools/write.js.map +1 -0
  313. package/dist/tui/accessibility.d.ts +4 -0
  314. package/dist/tui/accessibility.js +24 -0
  315. package/dist/tui/accessibility.js.map +1 -0
  316. package/dist/tui/app.d.ts +21 -0
  317. package/dist/tui/app.js +280 -0
  318. package/dist/tui/app.js.map +1 -0
  319. package/dist/tui/format.d.ts +22 -0
  320. package/dist/tui/format.js +91 -0
  321. package/dist/tui/format.js.map +1 -0
  322. package/dist/tui/input.d.ts +9 -0
  323. package/dist/tui/input.js +71 -0
  324. package/dist/tui/input.js.map +1 -0
  325. package/dist/tui/permission.d.ts +2 -0
  326. package/dist/tui/permission.js +2 -0
  327. package/dist/tui/permission.js.map +1 -0
  328. package/dist/updates/index.d.ts +33 -0
  329. package/dist/updates/index.js +60 -0
  330. package/dist/updates/index.js.map +1 -0
  331. package/dist/util/clipboard.d.ts +1 -0
  332. package/dist/util/clipboard.js +30 -0
  333. package/dist/util/clipboard.js.map +1 -0
  334. package/dist/util/clock.d.ts +7 -0
  335. package/dist/util/clock.js +6 -0
  336. package/dist/util/clock.js.map +1 -0
  337. package/dist/util/errors.d.ts +19 -0
  338. package/dist/util/errors.js +64 -0
  339. package/dist/util/errors.js.map +1 -0
  340. package/dist/util/fsx.d.ts +4 -0
  341. package/dist/util/fsx.js +35 -0
  342. package/dist/util/fsx.js.map +1 -0
  343. package/dist/util/ids.d.ts +5 -0
  344. package/dist/util/ids.js +17 -0
  345. package/dist/util/ids.js.map +1 -0
  346. package/dist/util/logger.d.ts +13 -0
  347. package/dist/util/logger.js +23 -0
  348. package/dist/util/logger.js.map +1 -0
  349. package/dist/util/paths.d.ts +14 -0
  350. package/dist/util/paths.js +77 -0
  351. package/dist/util/paths.js.map +1 -0
  352. package/dist/util/redact.d.ts +6 -0
  353. package/dist/util/redact.js +44 -0
  354. package/dist/util/redact.js.map +1 -0
  355. package/dist/util/text.d.ts +4 -0
  356. package/dist/util/text.js +23 -0
  357. package/dist/util/text.js.map +1 -0
  358. package/dist/web/public/app.js +917 -0
  359. package/dist/web/public/favicon.svg +5 -0
  360. package/dist/web/public/index.html +197 -0
  361. package/dist/web/public/markdown.js +176 -0
  362. package/dist/web/public/styles.css +1245 -0
  363. package/package.json +55 -4
@@ -0,0 +1,989 @@
1
+ import { spawn } from "node:child_process";
2
+ import { readFileSync } from "node:fs";
3
+ import { extname, join, resolve } from "node:path";
4
+ import { pathToFileURL } from "node:url";
5
+ import { stdout } from "node:process";
6
+ import { createAgentSetup } from "../app/factory.js";
7
+ import { trustWorkspace, untrustWorkspace } from "../app/trust.js";
8
+ import { PRESETS } from "../providers/presets.js";
9
+ import { keycodeHome, projectDir } from "../util/paths.js";
10
+ import { silentLogger } from "../util/logger.js";
11
+ import { systemClock } from "../util/clock.js";
12
+ import { KeycodeError } from "../util/errors.js";
13
+ import { runCommand } from "../tools/bash.js";
14
+ import { createCodeModeTool } from "../tools/codemode.js";
15
+ import { createBrowserTool } from "../integrations/browser.js";
16
+ import { BackgroundSessions } from "../integrations/background.js";
17
+ import { IdeBridge } from "../integrations/ide.js";
18
+ import { startRemoteControl, defaultWebDir } from "../integrations/remote.js";
19
+ import { PermissionBroker } from "../permissions/broker.js";
20
+ import { QuestionBroker } from "../questions/broker.js";
21
+ import { createWorktree, listWorktrees, removeWorktree } from "../integrations/worktrees.js";
22
+ import { buildPrComment, getPullRequestDiff, reviewDiff, securityReview, } from "../integrations/pr.js";
23
+ import { postIssueComment } from "../integrations/github.js";
24
+ import { importConfigs } from "../integrations/import.js";
25
+ import { checkForUpdate } from "../updates/index.js";
26
+ import { startGateway } from "../gateway/index.js";
27
+ import { ArtifactStore, startPreview } from "../artifacts/store.js";
28
+ import { LspClient } from "../lsp/client.js";
29
+ import { AutoMemoryStore } from "../storage/autoMemory.js";
30
+ import { runWorkflow } from "../extensions/workflows.js";
31
+ import { LoopManager } from "../extensions/loops.js";
32
+ import { Notifier, webhookChannel } from "../notifications/index.js";
33
+ import { OtelExporter } from "../telemetry/otel.js";
34
+ import { addMcpServer, listMcpServers, oauthRefresh, reconnectMcp, removeMcpServer, setMcpEnabled, } from "../mcp/management.js";
35
+ import { installPlugin, listPlugins, pinPlugin, removePlugin, setPluginEnabled, } from "../extensions/plugins.js";
36
+ function opts(cmd) {
37
+ const parent = cmd.parent;
38
+ return { ...(parent ? parent.opts() : {}), ...cmd.opts() };
39
+ }
40
+ function emit(value, json) {
41
+ if (json === true) {
42
+ stdout.write(`${JSON.stringify(value, null, 2)}\n`);
43
+ }
44
+ else if (typeof value === "string") {
45
+ stdout.write(`${value}\n`);
46
+ }
47
+ else {
48
+ stdout.write(`${JSON.stringify(value, null, 2)}\n`);
49
+ }
50
+ }
51
+ function arrayOption(value, label) {
52
+ if (typeof value !== "string" || value.trim().length === 0)
53
+ return undefined;
54
+ const raw = value.trim();
55
+ try {
56
+ const parsed = JSON.parse(raw);
57
+ if (Array.isArray(parsed))
58
+ return parsed.map((entry) => String(entry));
59
+ }
60
+ catch {
61
+ // Fall through to the comma-separated form.
62
+ }
63
+ const inner = raw.replace(/^\[/, "").replace(/\]$/, "");
64
+ if (inner.trim().length === 0)
65
+ return [];
66
+ const parts = inner
67
+ .split(",")
68
+ .map((entry) => entry.trim().replace(/^["']|["']$/g, ""))
69
+ .filter((entry) => entry.length > 0);
70
+ if (parts.length > 0)
71
+ return parts;
72
+ throw new KeycodeError("CONFIG_INVALID", `${label} must be a JSON array or a comma-separated list`);
73
+ }
74
+ function scopeOption(value) {
75
+ return value === "project" || value === "local" ? value : "user";
76
+ }
77
+ function toolContext(home, cwd) {
78
+ return {
79
+ sessionId: "cli",
80
+ cwd,
81
+ workspaceRoots: [cwd],
82
+ signal: new AbortController().signal,
83
+ permissions: { check: async () => ({ behavior: "allow", reason: "CLI" }) },
84
+ logger: silentLogger,
85
+ clock: systemClock,
86
+ state: { readFiles: new Set(), todos: [], metadata: new Map() },
87
+ home,
88
+ };
89
+ }
90
+ function keepAlive(close) {
91
+ const shutdown = () => {
92
+ void close().finally(() => process.exit(0));
93
+ };
94
+ process.on("SIGINT", shutdown);
95
+ process.on("SIGTERM", shutdown);
96
+ }
97
+ function openBrowser(url) {
98
+ const command = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
99
+ const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
100
+ try {
101
+ const child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true });
102
+ // Browser launch is best effort; the URL is always printed as well.
103
+ child.on("error", () => undefined);
104
+ child.unref();
105
+ }
106
+ catch {
107
+ // Ignore a missing launcher and keep the server running.
108
+ }
109
+ }
110
+ export function registerExtraCommands(program) {
111
+ program
112
+ .command("mcp <action> [name]")
113
+ .description("Manage MCP servers: list, add, remove, enable, disable, reconnect, oauth")
114
+ .option("--command <command>", "stdio command")
115
+ .option("--args <json>", "stdio arguments as JSON")
116
+ .option("--url <url>", "HTTP or SSE URL")
117
+ .option("--scope <scope>", "user, project, or local", "user")
118
+ .option("--json", "emit JSON")
119
+ .action(async (...args) => {
120
+ const cmd = args[args.length - 1];
121
+ const options = opts(cmd);
122
+ const [action, name] = cmd.args;
123
+ const home = keycodeHome();
124
+ const cwd = process.cwd();
125
+ if (action === "list") {
126
+ const servers = listMcpServers(home, cwd);
127
+ emit(options.json === true
128
+ ? servers
129
+ : servers.length === 0
130
+ ? "No MCP servers."
131
+ : servers
132
+ .map((server) => `${server.name} ${server.scope} ${server.enabled ? "enabled" : "disabled"} ${server.config.type ?? (server.config.url ? "http" : "stdio")}`)
133
+ .join("\n"), options.json);
134
+ return;
135
+ }
136
+ if (!name)
137
+ throw new KeycodeError("CONFIG_INVALID", `mcp ${action} requires a server name`);
138
+ if (action === "add") {
139
+ const type = options.url !== undefined ? "http" : "stdio";
140
+ const argsList = arrayOption(options.args, "--args");
141
+ const config = {
142
+ type,
143
+ ...(typeof options.command === "string" ? { command: options.command } : {}),
144
+ ...(argsList === undefined ? {} : { args: argsList }),
145
+ ...(typeof options.url === "string" ? { url: options.url } : {}),
146
+ };
147
+ addMcpServer(home, cwd, name, config, scopeOption(options.scope));
148
+ emit(`Added MCP server ${name}.`, options.json);
149
+ return;
150
+ }
151
+ if (action === "remove") {
152
+ emit(removeMcpServer(home, cwd, name) ? `Removed ${name}.` : `Not found: ${name}`, options.json);
153
+ return;
154
+ }
155
+ if (action === "enable" || action === "disable") {
156
+ const ok = setMcpEnabled(home, cwd, name, action === "enable");
157
+ emit(ok ? `${action}d ${name}.` : `Not found: ${name}`, options.json);
158
+ return;
159
+ }
160
+ if (action === "reconnect") {
161
+ emit(await reconnectMcp(home, cwd, name), options.json);
162
+ return;
163
+ }
164
+ if (action === "oauth") {
165
+ emit(oauthRefresh(home, cwd, name) ? `Refreshed OAuth for ${name}.` : `Not found: ${name}`, options.json);
166
+ return;
167
+ }
168
+ throw new KeycodeError("CONFIG_INVALID", `Unknown mcp action: ${action}`);
169
+ });
170
+ program
171
+ .command("plugins <action> [target]")
172
+ .description("Manage plugins: list, install, enable, disable, remove, pin")
173
+ .option("--version <version>", "pin to a version")
174
+ .option("--json", "emit JSON")
175
+ .action((...args) => {
176
+ const cmd = args[args.length - 1];
177
+ const options = opts(cmd);
178
+ const [action, target] = cmd.args;
179
+ const home = keycodeHome();
180
+ if (action === "list") {
181
+ const plugins = listPlugins(home);
182
+ emit(options.json === true
183
+ ? plugins
184
+ : plugins.length === 0
185
+ ? "No plugins."
186
+ : plugins
187
+ .map((plugin) => `${plugin.name} ${plugin.pinnedVersion ?? plugin.version} ${plugin.enabled ? "enabled" : "disabled"} ${plugin.trusted ? "trusted" : "untrusted"}`)
188
+ .join("\n"), options.json);
189
+ return;
190
+ }
191
+ if (!target)
192
+ throw new KeycodeError("CONFIG_INVALID", `plugins ${action} requires a target`);
193
+ if (action === "install") {
194
+ emit(installPlugin(home, resolve(process.cwd(), target), { trusted: true }), options.json);
195
+ return;
196
+ }
197
+ if (action === "enable" || action === "disable") {
198
+ const record = setPluginEnabled(home, target, action === "enable");
199
+ emit(record ?? `Not found: ${target}`, options.json);
200
+ return;
201
+ }
202
+ if (action === "remove") {
203
+ emit(removePlugin(home, target) ? `Removed ${target}.` : `Not found: ${target}`, options.json);
204
+ return;
205
+ }
206
+ if (action === "pin") {
207
+ if (typeof options.version !== "string") {
208
+ throw new KeycodeError("CONFIG_INVALID", "plugins pin requires --version");
209
+ }
210
+ emit(pinPlugin(home, target, options.version) ?? `Not found: ${target}`, options.json);
211
+ return;
212
+ }
213
+ throw new KeycodeError("CONFIG_INVALID", `Unknown plugins action: ${action}`);
214
+ });
215
+ program
216
+ .command("import")
217
+ .description("Import Codex, Gemini, and Cursor configuration")
218
+ .option("--dry-run", "report without writing")
219
+ .option("--codex <path>", "Codex config path")
220
+ .option("--gemini <path>", "Gemini config path")
221
+ .option("--cursor <path>", "Cursor rules directory")
222
+ .option("--json", "emit JSON")
223
+ .action(async (...args) => {
224
+ const cmd = args[args.length - 1];
225
+ const options = opts(cmd);
226
+ const result = await importConfigs({
227
+ home: keycodeHome(),
228
+ cwd: process.cwd(),
229
+ dryRun: options.dryRun === true,
230
+ ...(typeof options.codex === "string" ? { codexPath: options.codex } : {}),
231
+ ...(typeof options.gemini === "string" ? { geminiPath: options.gemini } : {}),
232
+ ...(typeof options.cursor === "string" ? { cursorPath: options.cursor } : {}),
233
+ });
234
+ emit(result, options.json);
235
+ });
236
+ program
237
+ .command("update")
238
+ .description("Check the release feed for an update")
239
+ .option("--feed <url>", "release feed URL")
240
+ .option("--channel <channel>", "stable or latest", "stable")
241
+ .option("--current <version>", "current version", "0.1.0")
242
+ .option("--json", "emit JSON")
243
+ .action(async (...args) => {
244
+ const cmd = args[args.length - 1];
245
+ const options = opts(cmd);
246
+ if (typeof options.feed !== "string") {
247
+ throw new KeycodeError("CONFIG_INVALID", "update requires --feed <url>");
248
+ }
249
+ const check = await checkForUpdate({
250
+ feedUrl: options.feed,
251
+ channel: options.channel === "latest" ? "latest" : "stable",
252
+ currentVersion: typeof options.current === "string" ? options.current : "0.1.0",
253
+ });
254
+ emit(check, options.json);
255
+ });
256
+ program
257
+ .command("worktree <action> [name]")
258
+ .description("Create, list, or remove git worktrees")
259
+ .option("--base-dir <dir>", "worktree base directory")
260
+ .option("--force", "force removal")
261
+ .option("--json", "emit JSON")
262
+ .action((...args) => {
263
+ const cmd = args[args.length - 1];
264
+ const options = opts(cmd);
265
+ const [action, name] = cmd.args;
266
+ const repo = process.cwd();
267
+ if (action === "list") {
268
+ emit(listWorktrees(repo), options.json);
269
+ return;
270
+ }
271
+ if (!name)
272
+ throw new KeycodeError("CONFIG_INVALID", `worktree ${action} requires a name`);
273
+ if (action === "create") {
274
+ emit(createWorktree(repo, name, {
275
+ ...(typeof options.baseDir === "string" ? { baseDir: options.baseDir } : {}),
276
+ }), options.json);
277
+ return;
278
+ }
279
+ if (action === "remove") {
280
+ removeWorktree(repo, resolve(repo, name), { force: options.force === true });
281
+ emit(`Removed ${name}.`, options.json);
282
+ return;
283
+ }
284
+ throw new KeycodeError("CONFIG_INVALID", `Unknown worktree action: ${action}`);
285
+ });
286
+ program
287
+ .command("bg <action> [id]")
288
+ .description("Manage background sessions: start, list, logs, stop, rm, respawn")
289
+ .option("--name <name>", "session name")
290
+ .option("--command <command>", "command to run")
291
+ .option("--args <json>", "arguments as JSON")
292
+ .option("--json", "emit JSON")
293
+ .action(async (...args) => {
294
+ const cmd = args[args.length - 1];
295
+ const options = opts(cmd);
296
+ const [action, id] = cmd.args;
297
+ const home = keycodeHome();
298
+ const manager = new BackgroundSessions(join(home, "background"));
299
+ if (action === "start") {
300
+ if (typeof options.command !== "string") {
301
+ throw new KeycodeError("CONFIG_INVALID", "bg start requires --command");
302
+ }
303
+ const argsList = arrayOption(options.args, "--args") ?? [];
304
+ emit(manager.start({
305
+ ...(typeof options.name === "string" ? { name: options.name } : {}),
306
+ command: options.command,
307
+ args: argsList,
308
+ cwd: process.cwd(),
309
+ }), options.json);
310
+ return;
311
+ }
312
+ if (action === "list") {
313
+ emit(manager.list(), options.json);
314
+ return;
315
+ }
316
+ if (!id)
317
+ throw new KeycodeError("CONFIG_INVALID", `bg ${action} requires an id`);
318
+ if (action === "logs") {
319
+ emit(manager.logs(id), options.json);
320
+ return;
321
+ }
322
+ if (action === "stop") {
323
+ emit(manager.stop(id), options.json);
324
+ return;
325
+ }
326
+ if (action === "rm") {
327
+ emit(manager.remove(id) ? `Removed ${id}.` : `Not found: ${id}`, options.json);
328
+ return;
329
+ }
330
+ if (action === "respawn") {
331
+ emit(manager.respawn(id), options.json);
332
+ return;
333
+ }
334
+ throw new KeycodeError("CONFIG_INVALID", `Unknown bg action: ${action}`);
335
+ });
336
+ program
337
+ .command("ide")
338
+ .description("Start the IDE bridge and write its discovery file")
339
+ .option("--token <token>", "pairing token")
340
+ .action(async (...args) => {
341
+ const cmd = args[args.length - 1];
342
+ const options = opts(cmd);
343
+ const bridge = new IdeBridge({
344
+ home: keycodeHome(),
345
+ cwd: process.cwd(),
346
+ ...(typeof options.token === "string" ? { token: options.token } : {}),
347
+ });
348
+ const started = await bridge.start();
349
+ stdout.write(`IDE bridge listening on 127.0.0.1:${started.port}\nDiscovery: ${started.discoveryFile}\nToken: ${started.token}\n`);
350
+ keepAlive(() => bridge.stop());
351
+ });
352
+ program
353
+ .command("remote")
354
+ .description("Start Remote Control on loopback with a pairing token")
355
+ .option("--token <token>", "pairing token")
356
+ .option("--open", "open the web UI in the default browser")
357
+ .option("--provider <id>", "provider id")
358
+ .option("--model <id>", "model id")
359
+ .option("--permission-mode <mode>", "permission mode", "manual")
360
+ .action(async (...args) => {
361
+ const cmd = args[args.length - 1];
362
+ const options = opts(cmd);
363
+ const broker = new PermissionBroker();
364
+ const questions = new QuestionBroker();
365
+ let currentProvider = typeof options.provider === "string" ? options.provider : undefined;
366
+ let currentModel = typeof options.model === "string" ? options.model : undefined;
367
+ const buildOptions = (overrides = {}) => ({
368
+ cwd: process.cwd(),
369
+ ...(currentProvider === undefined ? {} : { provider: currentProvider }),
370
+ ...(currentModel === undefined ? {} : { model: currentModel }),
371
+ permissionMode: options.permissionMode,
372
+ prompter: broker,
373
+ askQuestions: (items) => questions.ask(items),
374
+ ...overrides,
375
+ });
376
+ const eventListeners = new Set();
377
+ const dispatch = (event) => {
378
+ for (const listener of eventListeners)
379
+ listener(event);
380
+ };
381
+ let setup = await createAgentSetup(buildOptions());
382
+ currentProvider = setup.providerId;
383
+ currentModel = setup.model;
384
+ let unsubscribeAgent = setup.agent.subscribe(dispatch);
385
+ let controller = new AbortController();
386
+ const describe = (current) => ({
387
+ provider: current.providerId,
388
+ model: current.model,
389
+ sessionId: current.sessionId,
390
+ permissionMode: current.permissionMode,
391
+ });
392
+ const sessionList = () => setup.store.list().slice(0, 50);
393
+ const activate = async (overrides) => {
394
+ broker.cancelAll();
395
+ questions.cancelAll();
396
+ unsubscribeAgent();
397
+ controller.abort();
398
+ setup.lsp?.stop();
399
+ setup.artifacts?.stop();
400
+ await setup.telemetry?.flush();
401
+ await setup.browser?.stop();
402
+ await Promise.all(setup.mcpClients.map((client) => client.close()));
403
+ setup = await createAgentSetup(buildOptions(overrides));
404
+ currentProvider = setup.providerId;
405
+ currentModel = setup.model;
406
+ unsubscribeAgent = setup.agent.subscribe(dispatch);
407
+ controller = new AbortController();
408
+ return describe(setup);
409
+ };
410
+ const providerCatalog = () => {
411
+ const custom = setup.settings.providers ?? {};
412
+ const ids = [
413
+ ...new Set([
414
+ ...Object.keys(PRESETS),
415
+ ...Object.keys(custom),
416
+ ...(currentProvider === undefined ? [] : [currentProvider]),
417
+ ]),
418
+ ];
419
+ return ids.map((id) => {
420
+ const preset = PRESETS[id];
421
+ const config = custom[id];
422
+ return {
423
+ id,
424
+ name: preset?.displayName ?? id,
425
+ models: preset?.models ?? config?.models ?? (id === currentProvider && currentModel ? [currentModel] : []),
426
+ defaultModel: preset?.defaultModel ??
427
+ config?.defaultModel ??
428
+ (id === currentProvider ? (currentModel ?? "") : ""),
429
+ free: preset?.free ?? true,
430
+ local: preset?.local ?? (id === "fake" || id === currentProvider),
431
+ };
432
+ });
433
+ };
434
+ const remotePermission = () => {
435
+ const pending = broker.current;
436
+ if (!pending)
437
+ return null;
438
+ return {
439
+ id: pending.id,
440
+ tool: pending.request.tool,
441
+ reason: pending.decision.reason,
442
+ ...(pending.request.preview === undefined ? {} : { preview: pending.request.preview }),
443
+ ...(pending.request.diff === undefined ? {} : { diff: pending.request.diff }),
444
+ };
445
+ };
446
+ const server = await startRemoteControl({
447
+ ...(typeof options.token === "string" ? { token: options.token } : {}),
448
+ staticDir: defaultWebDir(),
449
+ handler: {
450
+ info: () => describe(setup),
451
+ trust: () => setup.trust,
452
+ setTrust: async (accept) => {
453
+ const sessionId = setup.sessionId;
454
+ if (accept) {
455
+ trustWorkspace(setup.home, setup.store.cwd, setup.trust.fingerprint);
456
+ }
457
+ else {
458
+ untrustWorkspace(setup.home, setup.store.cwd);
459
+ }
460
+ return activate({
461
+ resume: sessionId,
462
+ provider: setup.providerId,
463
+ model: setup.model,
464
+ trust: accept,
465
+ });
466
+ },
467
+ subscribe: (listener) => {
468
+ eventListeners.add(listener);
469
+ return () => {
470
+ eventListeners.delete(listener);
471
+ };
472
+ },
473
+ onPrompt: async (prompt) => {
474
+ const result = await setup.agent.runTurn(prompt, controller.signal);
475
+ return result.text;
476
+ },
477
+ onStop: () => {
478
+ controller.abort();
479
+ broker.cancelAll();
480
+ questions.cancelAll();
481
+ controller = new AbortController();
482
+ },
483
+ sessions: () => sessionList().map((session) => ({
484
+ id: session.id,
485
+ name: session.name,
486
+ messageCount: session.messageCount,
487
+ createdAt: session.createdAt,
488
+ provider: session.provider,
489
+ model: session.model,
490
+ ...(session.parentId === undefined || session.parentId === null
491
+ ? {}
492
+ : { parentId: session.parentId }),
493
+ })),
494
+ history: () => setup.store.load(setup.sessionId).messages,
495
+ artifacts: () => setup.artifacts?.list() ?? [],
496
+ artifactPreview: async (id, version) => (await setup.artifacts?.preview(id, version)) ?? null,
497
+ resume: async (id) => {
498
+ if (id === null)
499
+ return activate({});
500
+ const meta = setup.store.resolve(id);
501
+ return activate({ resume: meta.id, provider: meta.provider, model: meta.model });
502
+ },
503
+ catalog: () => providerCatalog(),
504
+ setModel: async (provider, model) => {
505
+ const sessionId = setup.sessionId;
506
+ setup.store.setModel(sessionId, provider, model);
507
+ return activate({ resume: sessionId, provider, model });
508
+ },
509
+ renameSession: (id, name) => {
510
+ setup.store.rename(id, name.trim().length === 0 ? id.slice(0, 8) : name.trim());
511
+ return sessionList().map((session) => ({
512
+ id: session.id,
513
+ name: session.name,
514
+ messageCount: session.messageCount,
515
+ createdAt: session.createdAt,
516
+ provider: session.provider,
517
+ model: session.model,
518
+ ...(session.parentId === undefined || session.parentId === null
519
+ ? {}
520
+ : { parentId: session.parentId }),
521
+ }));
522
+ },
523
+ forkSession: async (id, name) => {
524
+ const header = setup.store.fork(id, name);
525
+ const view = setup.store.load(header.id);
526
+ return activate({
527
+ resume: header.id,
528
+ provider: view.header.provider,
529
+ model: view.header.model,
530
+ });
531
+ },
532
+ deleteSession: (id) => {
533
+ setup.store.delete(id);
534
+ },
535
+ },
536
+ permissions: {
537
+ current: remotePermission,
538
+ subscribe: (listener) => broker.subscribe(() => listener(remotePermission())),
539
+ resolve: (id, choice) => {
540
+ const behaviors = [
541
+ "allow_once",
542
+ "allow_always",
543
+ "allow_session",
544
+ "deny",
545
+ "cancel",
546
+ ];
547
+ if (!behaviors.includes(choice))
548
+ return false;
549
+ return broker.resolveById(id, {
550
+ behavior: choice,
551
+ });
552
+ },
553
+ },
554
+ questions: {
555
+ current: () => {
556
+ const pending = questions.current;
557
+ if (!pending)
558
+ return null;
559
+ return { id: pending.id, questions: pending.questions };
560
+ },
561
+ subscribe: (listener) => questions.subscribe(() => listener(questions.current === null
562
+ ? null
563
+ : { id: questions.current.id, questions: questions.current.questions })),
564
+ resolve: (id, result) => questions.resolveById(id, result),
565
+ },
566
+ });
567
+ stdout.write(`Remote Control: ${server.url}/#token=${server.token}\n`);
568
+ stdout.write(`Token: ${server.token}\nSession: ${setup.sessionId}\n`);
569
+ if (options.open === true)
570
+ openBrowser(`${server.url}/#token=${server.token}`);
571
+ keepAlive(async () => {
572
+ broker.cancelAll();
573
+ questions.cancelAll();
574
+ unsubscribeAgent();
575
+ setup.lsp?.stop();
576
+ setup.artifacts?.stop();
577
+ await setup.telemetry?.flush();
578
+ await setup.browser?.stop();
579
+ await Promise.all(setup.mcpClients.map((client) => client.close()));
580
+ await server.close();
581
+ });
582
+ });
583
+ program
584
+ .command("gateway")
585
+ .description("Start the local provider gateway")
586
+ .option("--api-key <key>", "provider API key to inject")
587
+ .option("--client-token <token>", "allowed client token (repeatable)", (value, previous) => [...previous, value], [])
588
+ .option("--rate <requests>", "requests per window", "60")
589
+ .option("--window <ms>", "rate-limit window in ms", "60000")
590
+ .option("--allow-private", "allow private upstream targets")
591
+ .action(async (...args) => {
592
+ const cmd = args[args.length - 1];
593
+ const options = opts(cmd);
594
+ if (typeof options.apiKey !== "string") {
595
+ throw new KeycodeError("CONFIG_INVALID", "gateway requires --api-key");
596
+ }
597
+ const clientTokens = Array.isArray(options.clientToken) ? options.clientToken : [];
598
+ if (clientTokens.length === 0) {
599
+ throw new KeycodeError("CONFIG_INVALID", "gateway requires at least one --client-token");
600
+ }
601
+ const server = await startGateway({
602
+ apiKey: options.apiKey,
603
+ clientTokens,
604
+ rateLimit: {
605
+ requests: Number(options.rate ?? 60),
606
+ windowMs: Number(options.window ?? 60_000),
607
+ },
608
+ allowPrivate: options.allowPrivate === true,
609
+ });
610
+ stdout.write(`Gateway listening on ${server.url}\n`);
611
+ keepAlive(() => server.close());
612
+ });
613
+ program
614
+ .command("pr <action> [number]")
615
+ .description("Review a pull request diff")
616
+ .option("--repo <owner/name>", "repository")
617
+ .option("--security", "only high-severity findings")
618
+ .option("--comment", "post the review as a comment")
619
+ .option("--token <token>", "GitHub token for posting")
620
+ .option("--json", "emit JSON")
621
+ .action(async (...args) => {
622
+ const cmd = args[args.length - 1];
623
+ const options = opts(cmd);
624
+ const [action, numberRaw] = cmd.args;
625
+ if (action !== "review")
626
+ throw new KeycodeError("CONFIG_INVALID", `Unknown pr action: ${action}`);
627
+ if (typeof options.repo !== "string") {
628
+ throw new KeycodeError("CONFIG_INVALID", "pr review requires --repo");
629
+ }
630
+ const number = Number(numberRaw);
631
+ const diff = await getPullRequestDiff({ repo: options.repo, number });
632
+ const findings = options.security === true ? securityReview(diff) : reviewDiff(diff);
633
+ const comment = buildPrComment(findings);
634
+ let posted = null;
635
+ if (options.comment === true) {
636
+ if (typeof options.token !== "string") {
637
+ throw new KeycodeError("CONFIG_INVALID", "pr review --comment requires --token");
638
+ }
639
+ posted = await postIssueComment({
640
+ token: options.token,
641
+ repo: options.repo,
642
+ issueNumber: number,
643
+ body: comment,
644
+ });
645
+ }
646
+ emit(options.json === true ? { findings, comment, posted } : comment, options.json);
647
+ });
648
+ program
649
+ .command("artifacts <action> [id]")
650
+ .description("Create, publish, preview, inspect, or annotate local artifacts")
651
+ .option("--name <name>", "artifact name")
652
+ .option("--file <path>", "HTML file")
653
+ .option("--version <n>", "version")
654
+ .option("--text <text>", "comment text")
655
+ .option("--key <key>", "data key")
656
+ .option("--value <value>", "data value")
657
+ .option("--token <token>", "preview token", "preview")
658
+ .option("--json", "emit JSON")
659
+ .action(async (...args) => {
660
+ const cmd = args[args.length - 1];
661
+ const options = opts(cmd);
662
+ const [action, id] = cmd.args;
663
+ const home = keycodeHome();
664
+ const store = new ArtifactStore(join(home, "artifacts"));
665
+ const version = options.version === undefined ? undefined : Number(options.version);
666
+ if (action === "create") {
667
+ if (typeof options.name !== "string" || typeof options.file !== "string") {
668
+ throw new KeycodeError("CONFIG_INVALID", "artifacts create requires --name and --file");
669
+ }
670
+ const artifact = store.create(options.name, readFileSync(resolve(process.cwd(), options.file), "utf8"));
671
+ emit({ id: artifact.id, version: 1 }, options.json);
672
+ return;
673
+ }
674
+ if (action === "list") {
675
+ emit(store.list(), options.json);
676
+ return;
677
+ }
678
+ if (!id)
679
+ throw new KeycodeError("CONFIG_INVALID", `artifacts ${action} requires an id`);
680
+ if (action === "publish") {
681
+ if (typeof options.file !== "string") {
682
+ throw new KeycodeError("CONFIG_INVALID", "artifacts publish requires --file");
683
+ }
684
+ const artifact = store.publish(id, readFileSync(resolve(process.cwd(), options.file), "utf8"));
685
+ emit({ id: artifact.id, version: artifact.versions.length }, options.json);
686
+ return;
687
+ }
688
+ if (action === "inspect") {
689
+ emit(store.inspect(id, version), options.json);
690
+ return;
691
+ }
692
+ if (action === "comment") {
693
+ if (typeof options.text !== "string") {
694
+ throw new KeycodeError("CONFIG_INVALID", "artifacts comment requires --text");
695
+ }
696
+ const targetVersion = version ?? store.get(id)?.version ?? 1;
697
+ emit(store.comment(id, targetVersion, options.text) ? "Comment added." : "Artifact not found.", options.json);
698
+ return;
699
+ }
700
+ if (action === "data") {
701
+ if (typeof options.key !== "string") {
702
+ throw new KeycodeError("CONFIG_INVALID", "artifacts data requires --key");
703
+ }
704
+ const targetVersion = version ?? store.get(id)?.version ?? 1;
705
+ emit(store.setData(id, targetVersion, options.key, options.value ?? "") ? "Data set." : "Artifact not found.", options.json);
706
+ return;
707
+ }
708
+ if (action === "preview") {
709
+ const server = await startPreview(store, {
710
+ token: typeof options.token === "string" ? options.token : "preview",
711
+ });
712
+ const versionPath = version === undefined ? "" : `/${version}`;
713
+ stdout.write(`Preview: ${server.url}/artifacts/${id}${versionPath}?token=${String(options.token ?? "preview")}\n`);
714
+ keepAlive(() => server.close());
715
+ return;
716
+ }
717
+ throw new KeycodeError("CONFIG_INVALID", `Unknown artifacts action: ${action}`);
718
+ });
719
+ program
720
+ .command("codemode [code]")
721
+ .description("Evaluate JavaScript in an opt-in persistent Code Mode session")
722
+ .option("--file <path>", "read code from a file")
723
+ .option("--reset", "reset the session state")
724
+ .option("--json", "emit JSON")
725
+ .action(async (...args) => {
726
+ const cmd = args[args.length - 1];
727
+ const options = opts(cmd);
728
+ const [codeArg] = cmd.args;
729
+ const code = typeof options.file === "string"
730
+ ? readFileSync(resolve(process.cwd(), options.file), "utf8")
731
+ : codeArg;
732
+ if (!code)
733
+ throw new KeycodeError("CONFIG_INVALID", "codemode requires code or --file");
734
+ const tool = createCodeModeTool({ enabled: true });
735
+ const result = await tool.execute({ code, ...(options.reset === true ? { reset: true } : {}) }, toolContext(keycodeHome(), process.cwd()));
736
+ const text = result.content
737
+ .map((block) => (block.type === "text" ? block.text : `[${block.type}]`))
738
+ .join("\n");
739
+ emit(options.json === true ? { ok: result.ok, text } : text, options.json);
740
+ if (!result.ok)
741
+ process.exitCode = 1;
742
+ });
743
+ program
744
+ .command("lsp <file>")
745
+ .description("Start a language server and print diagnostics")
746
+ .option("--command <command>", "language server command")
747
+ .option("--args <json>", "language server arguments as JSON")
748
+ .option("--language <id>", "language id", "typescript")
749
+ .option("--hover <line:character>", "request hover at a position")
750
+ .option("--json", "emit JSON")
751
+ .action(async (...args) => {
752
+ const cmd = args[args.length - 1];
753
+ const options = opts(cmd);
754
+ const [file] = cmd.args;
755
+ if (typeof options.command !== "string") {
756
+ throw new KeycodeError("CONFIG_INVALID", "lsp requires --command");
757
+ }
758
+ if (!file)
759
+ throw new KeycodeError("CONFIG_INVALID", "lsp requires a file");
760
+ const path = resolve(process.cwd(), file);
761
+ const uri = pathToFileURL(path).toString();
762
+ const client = new LspClient({
763
+ command: options.command,
764
+ args: arrayOption(options.args, "--args") ?? [],
765
+ cwd: process.cwd(),
766
+ rootUri: pathToFileURL(process.cwd()).toString(),
767
+ timeoutMs: 10_000,
768
+ });
769
+ await client.start();
770
+ await client.initialize();
771
+ client.openDocument(uri, typeof options.language === "string" ? options.language : extname(path).replace(".", ""), readFileSync(path, "utf8"));
772
+ const diagnostics = await client.waitForDiagnostics(uri);
773
+ let hover = null;
774
+ if (typeof options.hover === "string") {
775
+ const [line, character] = options.hover.split(":").map(Number);
776
+ hover = await client.hover(uri, line ?? 0, character ?? 0);
777
+ }
778
+ emit(options.json === true ? { diagnostics, hover } : diagnostics, options.json);
779
+ client.stop();
780
+ });
781
+ program
782
+ .command("memory <action> [text]")
783
+ .description("Manage auto-memory: list, search, add, remove, pause, resume")
784
+ .option("--id <id>", "entry id")
785
+ .option("--query <query>", "search query")
786
+ .option("--json", "emit JSON")
787
+ .action((...args) => {
788
+ const cmd = args[args.length - 1];
789
+ const options = opts(cmd);
790
+ const [action, text] = cmd.args;
791
+ const home = keycodeHome();
792
+ const cwd = process.cwd();
793
+ const store = new AutoMemoryStore(join(projectDir(home, cwd), "memory.json"));
794
+ if (action === "list") {
795
+ emit(store.list(), options.json);
796
+ return;
797
+ }
798
+ if (action === "search") {
799
+ emit(store.recall(typeof options.query === "string" ? options.query : ""), options.json);
800
+ return;
801
+ }
802
+ if (action === "add") {
803
+ if (!text)
804
+ throw new KeycodeError("CONFIG_INVALID", "memory add requires text");
805
+ emit(store.add(text), options.json);
806
+ return;
807
+ }
808
+ if (action === "remove") {
809
+ if (typeof options.id !== "string")
810
+ throw new KeycodeError("CONFIG_INVALID", "memory remove requires --id");
811
+ emit(store.remove(options.id) ? "Removed." : "Not found.", options.json);
812
+ return;
813
+ }
814
+ if (action === "pause") {
815
+ store.pause();
816
+ emit("Auto-memory paused.", options.json);
817
+ return;
818
+ }
819
+ if (action === "resume") {
820
+ store.resume();
821
+ emit("Auto-memory resumed.", options.json);
822
+ return;
823
+ }
824
+ throw new KeycodeError("CONFIG_INVALID", `Unknown memory action: ${action}`);
825
+ });
826
+ program
827
+ .command("workflow <script>")
828
+ .description("Run a workflow script with checkpoints and resume")
829
+ .option("--context <json>", "workflow context as JSON")
830
+ .option("--checkpoint-dir <dir>", "checkpoint directory")
831
+ .option("--budget <usd>", "budget in USD")
832
+ .option("--json", "emit JSON")
833
+ .action(async (...args) => {
834
+ const cmd = args[args.length - 1];
835
+ const options = opts(cmd);
836
+ const [script] = cmd.args;
837
+ if (!script)
838
+ throw new KeycodeError("CONFIG_INVALID", "workflow requires a script path");
839
+ const result = await runWorkflow({
840
+ scriptPath: resolve(process.cwd(), script),
841
+ checkpointDir: typeof options.checkpointDir === "string"
842
+ ? options.checkpointDir
843
+ : join(keycodeHome(), "workflows"),
844
+ context: typeof options.context === "string"
845
+ ? JSON.parse(options.context)
846
+ : {},
847
+ ...(typeof options.budget === "string" ? { budgetUsd: Number(options.budget) } : {}),
848
+ });
849
+ emit(result, options.json);
850
+ if (result.status === "failed")
851
+ process.exitCode = 1;
852
+ });
853
+ program
854
+ .command("loops <action> [id]")
855
+ .description("Manage cron loops: list, add, remove, run")
856
+ .option("--cron <expression>", "cron expression")
857
+ .option("--command <command>", "command to run")
858
+ .option("--timezone <timezone>", "timezone label")
859
+ .option("--json", "emit JSON")
860
+ .action(async (...args) => {
861
+ const cmd = args[args.length - 1];
862
+ const options = opts(cmd);
863
+ const [action, id] = cmd.args;
864
+ const manager = new LoopManager(join(keycodeHome(), "loops.json"));
865
+ if (action === "list") {
866
+ emit(manager.list(), options.json);
867
+ return;
868
+ }
869
+ if (action === "add") {
870
+ if (typeof options.cron !== "string" || typeof options.command !== "string") {
871
+ throw new KeycodeError("CONFIG_INVALID", "loops add requires --cron and --command");
872
+ }
873
+ emit(manager.add({
874
+ cron: options.cron,
875
+ command: options.command,
876
+ ...(typeof options.timezone === "string" ? { timezone: options.timezone } : {}),
877
+ }), options.json);
878
+ return;
879
+ }
880
+ if (!id)
881
+ throw new KeycodeError("CONFIG_INVALID", `loops ${action} requires an id`);
882
+ if (action === "remove") {
883
+ emit(manager.remove(id) ? "Removed." : "Not found.", options.json);
884
+ return;
885
+ }
886
+ if (action === "run") {
887
+ const ran = await manager.runDue(new Date(), async (job) => {
888
+ await runCommand({ command: job.command, cwd: process.cwd(), timeoutMs: 60_000 });
889
+ });
890
+ emit(`Ran ${ran} loop(s).`, options.json);
891
+ return;
892
+ }
893
+ throw new KeycodeError("CONFIG_INVALID", `Unknown loops action: ${action}`);
894
+ });
895
+ program
896
+ .command("notify")
897
+ .description("Send a test notification")
898
+ .option("--event <event>", "idle, permission_required, task_complete, or input_needed", "idle")
899
+ .option("--text <text>", "notification text", "KeyCode notification")
900
+ .option("--webhook <url>", "webhook URL")
901
+ .option("--json", "emit JSON")
902
+ .action(async (...args) => {
903
+ const cmd = args[args.length - 1];
904
+ const options = opts(cmd);
905
+ const channels = [
906
+ {
907
+ name: "stdout",
908
+ send: (event, text) => {
909
+ stdout.write(`${event}: ${text}\n`);
910
+ },
911
+ },
912
+ ];
913
+ if (typeof options.webhook === "string") {
914
+ channels.push(webhookChannel(options.webhook));
915
+ }
916
+ const notifier = new Notifier({ channels });
917
+ const sent = await notifier.notify(options.event, typeof options.text === "string" ? options.text : "KeyCode notification");
918
+ emit({ sent }, options.json);
919
+ });
920
+ program
921
+ .command("otel")
922
+ .description("Send one OTLP metric to a local collector")
923
+ .option("--endpoint <url>", "OTLP HTTP endpoint")
924
+ .option("--name <name>", "metric name", "keycode.cli")
925
+ .option("--value <value>", "metric value", "1")
926
+ .option("--attributes <json>", "attributes as JSON")
927
+ .option("--json", "emit JSON")
928
+ .action(async (...args) => {
929
+ const cmd = args[args.length - 1];
930
+ const options = opts(cmd);
931
+ if (typeof options.endpoint !== "string") {
932
+ throw new KeycodeError("CONFIG_INVALID", "otel requires --endpoint");
933
+ }
934
+ const attributes = typeof options.attributes === "string"
935
+ ? JSON.parse(options.attributes)
936
+ : {};
937
+ const exporter = new OtelExporter({ endpoint: options.endpoint, serviceName: "keycode-cli" });
938
+ exporter.record({
939
+ name: typeof options.name === "string" ? options.name : "keycode.cli",
940
+ value: Number(options.value ?? 1),
941
+ attributes,
942
+ });
943
+ const ok = await exporter.flush();
944
+ emit({ ok }, options.json);
945
+ if (!ok)
946
+ process.exitCode = 1;
947
+ });
948
+ program
949
+ .command("browser <action> [url]")
950
+ .description("Browser automation through a driver module")
951
+ .option("--driver <module>", "driver module exporting createBrowserDriver")
952
+ .option("--allow <domains>", "comma-separated allowed domains", "")
953
+ .option("--selector <selector>", "CSS selector")
954
+ .option("--text <text>", "text to type")
955
+ .option("--json", "emit JSON")
956
+ .action(async (...args) => {
957
+ const cmd = args[args.length - 1];
958
+ const options = opts(cmd);
959
+ const [action, url] = cmd.args;
960
+ if (typeof options.driver !== "string") {
961
+ throw new KeycodeError("CONFIG_INVALID", "Browser automation requires --driver <module> exporting createBrowserDriver.");
962
+ }
963
+ const module = (await import(pathToFileURL(resolve(process.cwd(), options.driver)).href));
964
+ const driver = module.createBrowserDriver !== undefined
965
+ ? await module.createBrowserDriver({})
966
+ : module.default;
967
+ if (!driver) {
968
+ throw new KeycodeError("CONFIG_INVALID", "Driver module does not export createBrowserDriver or a default driver");
969
+ }
970
+ const allowedDomains = String(options.allow ?? "")
971
+ .split(",")
972
+ .map((entry) => entry.trim())
973
+ .filter((entry) => entry.length > 0);
974
+ const tool = createBrowserTool({ driver, allowedDomains });
975
+ const result = await tool.execute({
976
+ action: action,
977
+ ...(url === undefined ? {} : { url }),
978
+ ...(typeof options.selector === "string" ? { selector: options.selector } : {}),
979
+ ...(typeof options.text === "string" ? { text: options.text } : {}),
980
+ }, toolContext(keycodeHome(), process.cwd()));
981
+ const text = result.content
982
+ .map((block) => (block.type === "text" ? block.text : `[${block.type}]`))
983
+ .join("\n");
984
+ emit(options.json === true ? { ok: result.ok, text } : text, options.json);
985
+ if (!result.ok)
986
+ process.exitCode = 1;
987
+ });
988
+ }
989
+ //# sourceMappingURL=extra.js.map