shortcutxl 0.2.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 (423) hide show
  1. package/README.md +59 -0
  2. package/agent-docs/README.md +397 -0
  3. package/agent-docs/docs/compaction.md +390 -0
  4. package/agent-docs/docs/custom-provider.md +580 -0
  5. package/agent-docs/docs/development.md +69 -0
  6. package/agent-docs/docs/extensions.md +1971 -0
  7. package/agent-docs/docs/json.md +79 -0
  8. package/agent-docs/docs/keybindings.md +174 -0
  9. package/agent-docs/docs/models.md +293 -0
  10. package/agent-docs/docs/packages.md +209 -0
  11. package/agent-docs/docs/prompt-templates.md +67 -0
  12. package/agent-docs/docs/providers.md +186 -0
  13. package/agent-docs/docs/rpc.md +1317 -0
  14. package/agent-docs/docs/sdk.md +962 -0
  15. package/agent-docs/docs/session.md +412 -0
  16. package/agent-docs/docs/settings.md +223 -0
  17. package/agent-docs/docs/shell-aliases.md +13 -0
  18. package/agent-docs/docs/skills.md +231 -0
  19. package/agent-docs/docs/terminal-setup.md +70 -0
  20. package/agent-docs/docs/termux.md +127 -0
  21. package/agent-docs/docs/themes.md +295 -0
  22. package/agent-docs/docs/tree.md +219 -0
  23. package/agent-docs/docs/tui.md +887 -0
  24. package/agent-docs/docs/windows.md +17 -0
  25. package/agent-docs/examples/README.md +25 -0
  26. package/agent-docs/examples/extensions/README.md +205 -0
  27. package/agent-docs/examples/extensions/antigravity-image-gen.ts +447 -0
  28. package/agent-docs/examples/extensions/auto-commit-on-exit.ts +49 -0
  29. package/agent-docs/examples/extensions/bash-spawn-hook.ts +30 -0
  30. package/agent-docs/examples/extensions/bookmark.ts +50 -0
  31. package/agent-docs/examples/extensions/built-in-tool-renderer.ts +256 -0
  32. package/agent-docs/examples/extensions/claude-rules.ts +86 -0
  33. package/agent-docs/examples/extensions/commands.ts +75 -0
  34. package/agent-docs/examples/extensions/confirm-destructive.ts +59 -0
  35. package/agent-docs/examples/extensions/custom-compaction.ts +126 -0
  36. package/agent-docs/examples/extensions/custom-footer.ts +63 -0
  37. package/agent-docs/examples/extensions/custom-header.ts +73 -0
  38. package/agent-docs/examples/extensions/custom-provider-anthropic/index.ts +660 -0
  39. package/agent-docs/examples/extensions/custom-provider-anthropic/package-lock.json +24 -0
  40. package/agent-docs/examples/extensions/custom-provider-anthropic/package.json +19 -0
  41. package/agent-docs/examples/extensions/custom-provider-gitlab-duo/index.ts +362 -0
  42. package/agent-docs/examples/extensions/custom-provider-gitlab-duo/package.json +16 -0
  43. package/agent-docs/examples/extensions/custom-provider-gitlab-duo/test.ts +88 -0
  44. package/agent-docs/examples/extensions/custom-provider-qwen-cli/index.ts +349 -0
  45. package/agent-docs/examples/extensions/custom-provider-qwen-cli/package.json +16 -0
  46. package/agent-docs/examples/extensions/dirty-repo-guard.ts +56 -0
  47. package/agent-docs/examples/extensions/doom-overlay/README.md +46 -0
  48. package/agent-docs/examples/extensions/doom-overlay/doom/build.sh +152 -0
  49. package/agent-docs/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +72 -0
  50. package/agent-docs/examples/extensions/doom-overlay/doom-component.ts +133 -0
  51. package/agent-docs/examples/extensions/doom-overlay/doom-engine.ts +186 -0
  52. package/agent-docs/examples/extensions/doom-overlay/doom-keys.ts +108 -0
  53. package/agent-docs/examples/extensions/doom-overlay/index.ts +74 -0
  54. package/agent-docs/examples/extensions/doom-overlay/wad-finder.ts +51 -0
  55. package/agent-docs/examples/extensions/dynamic-resources/SKILL.md +8 -0
  56. package/agent-docs/examples/extensions/dynamic-resources/dynamic.json +79 -0
  57. package/agent-docs/examples/extensions/dynamic-resources/dynamic.md +5 -0
  58. package/agent-docs/examples/extensions/dynamic-resources/index.ts +15 -0
  59. package/agent-docs/examples/extensions/dynamic-tools.ts +77 -0
  60. package/agent-docs/examples/extensions/event-bus.ts +43 -0
  61. package/agent-docs/examples/extensions/file-trigger.ts +41 -0
  62. package/agent-docs/examples/extensions/git-checkpoint.ts +53 -0
  63. package/agent-docs/examples/extensions/handoff.ts +155 -0
  64. package/agent-docs/examples/extensions/hello.ts +25 -0
  65. package/agent-docs/examples/extensions/inline-bash.ts +94 -0
  66. package/agent-docs/examples/extensions/input-transform.ts +43 -0
  67. package/agent-docs/examples/extensions/interactive-shell.ts +209 -0
  68. package/agent-docs/examples/extensions/mac-system-theme.ts +47 -0
  69. package/agent-docs/examples/extensions/message-renderer.ts +59 -0
  70. package/agent-docs/examples/extensions/minimal-mode.ts +430 -0
  71. package/agent-docs/examples/extensions/modal-editor.ts +90 -0
  72. package/agent-docs/examples/extensions/model-status.ts +31 -0
  73. package/agent-docs/examples/extensions/notify.ts +55 -0
  74. package/agent-docs/examples/extensions/overlay-qa-tests.ts +936 -0
  75. package/agent-docs/examples/extensions/overlay-test.ts +159 -0
  76. package/agent-docs/examples/extensions/permission-gate.ts +37 -0
  77. package/agent-docs/examples/extensions/pirate.ts +47 -0
  78. package/agent-docs/examples/extensions/plan-mode/README.md +65 -0
  79. package/agent-docs/examples/extensions/plan-mode/index.ts +363 -0
  80. package/agent-docs/examples/extensions/plan-mode/utils.ts +173 -0
  81. package/agent-docs/examples/extensions/preset.ts +418 -0
  82. package/agent-docs/examples/extensions/protected-paths.ts +30 -0
  83. package/agent-docs/examples/extensions/qna.ts +122 -0
  84. package/agent-docs/examples/extensions/question.ts +278 -0
  85. package/agent-docs/examples/extensions/questionnaire.ts +440 -0
  86. package/agent-docs/examples/extensions/rainbow-editor.ts +90 -0
  87. package/agent-docs/examples/extensions/reload-runtime.ts +37 -0
  88. package/agent-docs/examples/extensions/rpc-demo.ts +124 -0
  89. package/agent-docs/examples/extensions/sandbox/index.ts +324 -0
  90. package/agent-docs/examples/extensions/sandbox/package-lock.json +92 -0
  91. package/agent-docs/examples/extensions/sandbox/package.json +19 -0
  92. package/agent-docs/examples/extensions/send-user-message.ts +97 -0
  93. package/agent-docs/examples/extensions/session-name.ts +27 -0
  94. package/agent-docs/examples/extensions/shutdown-command.ts +69 -0
  95. package/agent-docs/examples/extensions/snake.ts +343 -0
  96. package/agent-docs/examples/extensions/space-invaders.ts +566 -0
  97. package/agent-docs/examples/extensions/ssh.ts +233 -0
  98. package/agent-docs/examples/extensions/status-line.ts +40 -0
  99. package/agent-docs/examples/extensions/subagent/README.md +172 -0
  100. package/agent-docs/examples/extensions/subagent/agents/planner.md +37 -0
  101. package/agent-docs/examples/extensions/subagent/agents/reviewer.md +35 -0
  102. package/agent-docs/examples/extensions/subagent/agents/scout.md +50 -0
  103. package/agent-docs/examples/extensions/subagent/agents/worker.md +24 -0
  104. package/agent-docs/examples/extensions/subagent/agents.ts +130 -0
  105. package/agent-docs/examples/extensions/subagent/index.ts +1068 -0
  106. package/agent-docs/examples/extensions/subagent/prompts/implement-and-review.md +10 -0
  107. package/agent-docs/examples/extensions/subagent/prompts/implement.md +10 -0
  108. package/agent-docs/examples/extensions/subagent/prompts/scout-and-plan.md +9 -0
  109. package/agent-docs/examples/extensions/summarize.ts +206 -0
  110. package/agent-docs/examples/extensions/system-prompt-header.ts +17 -0
  111. package/agent-docs/examples/extensions/timed-confirm.ts +72 -0
  112. package/agent-docs/examples/extensions/titlebar-spinner.ts +58 -0
  113. package/agent-docs/examples/extensions/todo.ts +314 -0
  114. package/agent-docs/examples/extensions/tool-override.ts +146 -0
  115. package/agent-docs/examples/extensions/tools.ts +145 -0
  116. package/agent-docs/examples/extensions/trigger-compact.ts +40 -0
  117. package/agent-docs/examples/extensions/truncated-tool.ts +194 -0
  118. package/agent-docs/examples/extensions/widget-placement.ts +17 -0
  119. package/agent-docs/examples/extensions/with-deps/index.ts +37 -0
  120. package/agent-docs/examples/extensions/with-deps/package-lock.json +31 -0
  121. package/agent-docs/examples/extensions/with-deps/package.json +22 -0
  122. package/agent-docs/examples/rpc-extension-ui.ts +654 -0
  123. package/agent-docs/examples/sdk/01-minimal.ts +22 -0
  124. package/agent-docs/examples/sdk/02-custom-model.ts +48 -0
  125. package/agent-docs/examples/sdk/03-custom-prompt.ts +55 -0
  126. package/agent-docs/examples/sdk/04-skills.ts +53 -0
  127. package/agent-docs/examples/sdk/05-tools.ts +56 -0
  128. package/agent-docs/examples/sdk/06-extensions.ts +88 -0
  129. package/agent-docs/examples/sdk/07-context-files.ts +40 -0
  130. package/agent-docs/examples/sdk/08-prompt-templates.ts +47 -0
  131. package/agent-docs/examples/sdk/09-api-keys-and-oauth.ts +48 -0
  132. package/agent-docs/examples/sdk/10-settings.ts +54 -0
  133. package/agent-docs/examples/sdk/11-sessions.ts +48 -0
  134. package/agent-docs/examples/sdk/12-full-control.ts +82 -0
  135. package/agent-docs/examples/sdk/README.md +144 -0
  136. package/agent-docs/xll-skill.md +61 -0
  137. package/agent-docs/xll-spec.md +110 -0
  138. package/dist/cli/args.js +290 -0
  139. package/dist/cli/config-selector.js +31 -0
  140. package/dist/cli/file-processor.js +79 -0
  141. package/dist/cli/list-models.js +92 -0
  142. package/dist/cli/package-commands.js +210 -0
  143. package/dist/cli/report-settings-errors.js +11 -0
  144. package/dist/cli/session-picker.js +34 -0
  145. package/dist/cli.js +19 -0
  146. package/dist/config.js +288 -0
  147. package/dist/core/abort.js +15 -0
  148. package/dist/core/agent-loop.js +352 -0
  149. package/dist/core/agent-session.js +2019 -0
  150. package/dist/core/agent.js +410 -0
  151. package/dist/core/auth-storage.js +456 -0
  152. package/dist/core/bash-executor.js +222 -0
  153. package/dist/core/compaction/branch-summarization.js +242 -0
  154. package/dist/core/compaction/compaction.js +610 -0
  155. package/dist/core/compaction/index.js +7 -0
  156. package/dist/core/compaction/utils.js +139 -0
  157. package/dist/core/defaults.js +6 -0
  158. package/dist/core/diagnostics.js +2 -0
  159. package/dist/core/event-bus.js +25 -0
  160. package/dist/core/exec.js +71 -0
  161. package/dist/core/export-html/ansi-to-html.js +256 -0
  162. package/dist/core/export-html/index.js +238 -0
  163. package/dist/core/export-html/session-view-model.js +342 -0
  164. package/dist/core/export-html/template.css +1110 -0
  165. package/dist/core/export-html/template.html +76 -0
  166. package/dist/core/export-html/template.js +1990 -0
  167. package/dist/core/export-html/tool-renderer.js +63 -0
  168. package/dist/core/export-html/vendor/highlight.min.js +7725 -0
  169. package/dist/core/export-html/vendor/marked.min.js +1803 -0
  170. package/dist/core/extensions/index.js +9 -0
  171. package/dist/core/extensions/loader.js +422 -0
  172. package/dist/core/extensions/runner.js +651 -0
  173. package/dist/core/extensions/types.js +35 -0
  174. package/dist/core/extensions/wrapper.js +102 -0
  175. package/dist/core/footer-data-provider.js +162 -0
  176. package/dist/core/index.js +9 -0
  177. package/dist/core/keybindings.js +153 -0
  178. package/dist/core/messages.js +133 -0
  179. package/dist/core/model-registry.js +539 -0
  180. package/dist/core/model-resolver.js +370 -0
  181. package/dist/core/package-manager.js +1485 -0
  182. package/dist/core/prompt-templates.js +253 -0
  183. package/dist/core/resolve-config-value.js +59 -0
  184. package/dist/core/resource-loader.js +700 -0
  185. package/dist/core/sdk.js +197 -0
  186. package/dist/core/session-bash.js +99 -0
  187. package/dist/core/session-compaction.js +165 -0
  188. package/dist/core/session-manager.js +1153 -0
  189. package/dist/core/session-models.js +99 -0
  190. package/dist/core/session-retry.js +155 -0
  191. package/dist/core/settings-manager.js +572 -0
  192. package/dist/core/skills.js +382 -0
  193. package/dist/core/slash-commands.js +31 -0
  194. package/dist/core/system-prompt.js +161 -0
  195. package/dist/core/theme.js +770 -0
  196. package/dist/core/timings.js +26 -0
  197. package/dist/core/tools/bash.js +258 -0
  198. package/dist/core/tools/edit-diff.js +245 -0
  199. package/dist/core/tools/edit.js +148 -0
  200. package/dist/core/tools/find.js +208 -0
  201. package/dist/core/tools/grep.js +246 -0
  202. package/dist/core/tools/index.js +67 -0
  203. package/dist/core/tools/ls.js +123 -0
  204. package/dist/core/tools/path-utils.js +81 -0
  205. package/dist/core/tools/read.js +160 -0
  206. package/dist/core/tools/truncate.js +70 -0
  207. package/dist/core/tools/write.js +82 -0
  208. package/dist/custom/agents/action.js +13 -0
  209. package/dist/custom/agents/document-reader.js +70 -0
  210. package/dist/custom/agents/general.js +26 -0
  211. package/dist/custom/agents/index.js +49 -0
  212. package/dist/custom/agents/installation.js +13 -0
  213. package/dist/custom/agents/types.js +7 -0
  214. package/dist/custom/auth/refresh-timer.js +33 -0
  215. package/dist/custom/auth/shortcut-oauth.js +145 -0
  216. package/dist/custom/constants.js +21 -0
  217. package/dist/custom/context/workbook-summary.js +73 -0
  218. package/dist/custom/credits/shortcut-credits.js +29 -0
  219. package/dist/custom/cron/cron-daemon-entry.js +18 -0
  220. package/dist/custom/cron/daemon-ipc.js +131 -0
  221. package/dist/custom/cron/daemon.js +224 -0
  222. package/dist/custom/cron/jobs.js +226 -0
  223. package/dist/custom/cron/run-log.js +51 -0
  224. package/dist/custom/cron/schedule.js +72 -0
  225. package/dist/custom/cron/status-line.js +98 -0
  226. package/dist/custom/cron/store.js +87 -0
  227. package/dist/custom/cron/types.js +8 -0
  228. package/dist/custom/dev/index.js +59 -0
  229. package/dist/custom/dev/trace-export.js +58 -0
  230. package/dist/custom/ensure-excel.js +63 -0
  231. package/dist/custom/excel-config.js +36 -0
  232. package/dist/custom/preflight.js +422 -0
  233. package/dist/custom/prompts/action.js +100 -0
  234. package/dist/custom/prompts/api.js +66 -0
  235. package/dist/custom/prompts/installation.js +124 -0
  236. package/dist/custom/prompts/shared.js +138 -0
  237. package/dist/custom/providers/llm-usage.js +42 -0
  238. package/dist/custom/providers/message-converter.js +74 -0
  239. package/dist/custom/providers/provider-ids.js +9 -0
  240. package/dist/custom/providers/register-openai-codex-provider.js +27 -0
  241. package/dist/custom/providers/register-shortcut-provider.js +52 -0
  242. package/dist/custom/providers/shortcut-invoke.js +117 -0
  243. package/dist/custom/providers/shortcut-stream.js +252 -0
  244. package/dist/custom/providers/sse-protocol.js +38 -0
  245. package/dist/custom/sync-xll.js +130 -0
  246. package/dist/custom/tools/cron.js +413 -0
  247. package/dist/custom/tools/excel-exec.js +167 -0
  248. package/dist/custom/tools/excel-range.js +50 -0
  249. package/dist/custom/tools/llm-analysis.js +265 -0
  250. package/dist/custom/tools/render-helpers.js +38 -0
  251. package/dist/custom/tools/switch-mode.js +94 -0
  252. package/dist/custom/tools/task/agents.js +6 -0
  253. package/dist/custom/tools/task/index.js +8 -0
  254. package/dist/custom/tools/task/render.js +348 -0
  255. package/dist/custom/tools/task/subprocess.js +320 -0
  256. package/dist/custom/tools/task/task.js +205 -0
  257. package/dist/custom/tools/todo-list.js +195 -0
  258. package/dist/custom/tracing/session-upload.js +93 -0
  259. package/dist/index.js +45 -0
  260. package/dist/main.js +613 -0
  261. package/dist/migrations.js +265 -0
  262. package/dist/modes/index.js +8 -0
  263. package/dist/modes/interactive/components/armin.js +337 -0
  264. package/dist/modes/interactive/components/assistant-message.js +94 -0
  265. package/dist/modes/interactive/components/bash-execution.js +171 -0
  266. package/dist/modes/interactive/components/bordered-loader.js +51 -0
  267. package/dist/modes/interactive/components/branch-summary-message.js +45 -0
  268. package/dist/modes/interactive/components/compaction-summary-message.js +46 -0
  269. package/dist/modes/interactive/components/config-selector.js +488 -0
  270. package/dist/modes/interactive/components/countdown-timer.js +33 -0
  271. package/dist/modes/interactive/components/custom-editor.js +93 -0
  272. package/dist/modes/interactive/components/custom-message.js +81 -0
  273. package/dist/modes/interactive/components/daxnuts.js +140 -0
  274. package/dist/modes/interactive/components/diff.js +133 -0
  275. package/dist/modes/interactive/components/dynamic-border.js +21 -0
  276. package/dist/modes/interactive/components/extension-editor.js +105 -0
  277. package/dist/modes/interactive/components/extension-input.js +61 -0
  278. package/dist/modes/interactive/components/extension-selector.js +78 -0
  279. package/dist/modes/interactive/components/footer.js +309 -0
  280. package/dist/modes/interactive/components/index.js +33 -0
  281. package/dist/modes/interactive/components/keybinding-hints.js +61 -0
  282. package/dist/modes/interactive/components/layout.js +64 -0
  283. package/dist/modes/interactive/components/login-dialog.js +148 -0
  284. package/dist/modes/interactive/components/model-selector.js +237 -0
  285. package/dist/modes/interactive/components/oauth-selector.js +111 -0
  286. package/dist/modes/interactive/components/session-selector-search.js +157 -0
  287. package/dist/modes/interactive/components/session-selector.js +860 -0
  288. package/dist/modes/interactive/components/settings-selector.js +123 -0
  289. package/dist/modes/interactive/components/show-images-selector.js +35 -0
  290. package/dist/modes/interactive/components/skill-invocation-message.js +48 -0
  291. package/dist/modes/interactive/components/theme-selector.js +47 -0
  292. package/dist/modes/interactive/components/thinking-selector.js +47 -0
  293. package/dist/modes/interactive/components/tool-execution.js +789 -0
  294. package/dist/modes/interactive/components/tool-group.js +106 -0
  295. package/dist/modes/interactive/components/tree-selector.js +962 -0
  296. package/dist/modes/interactive/components/user-message-selector.js +115 -0
  297. package/dist/modes/interactive/components/user-message.js +48 -0
  298. package/dist/modes/interactive/components/visual-truncate.js +33 -0
  299. package/dist/modes/interactive/file-attachments.js +135 -0
  300. package/dist/modes/interactive/interactive-mode.js +3775 -0
  301. package/dist/modes/interactive/theme/dark.json +85 -0
  302. package/dist/modes/interactive/theme/light.json +85 -0
  303. package/dist/modes/interactive/theme/theme-schema.json +335 -0
  304. package/dist/modes/interactive/theme/theme.js +177 -0
  305. package/dist/modes/print-mode.js +101 -0
  306. package/dist/modes/rpc/rpc-client.js +387 -0
  307. package/dist/modes/rpc/rpc-mode.js +509 -0
  308. package/dist/modes/rpc/rpc-types.js +8 -0
  309. package/dist/subagent-entry.js +145 -0
  310. package/dist/tool-names.js +34 -0
  311. package/dist/tui/autocomplete.js +596 -0
  312. package/dist/tui/components/box.js +104 -0
  313. package/dist/tui/components/cancellable-loader.js +35 -0
  314. package/dist/tui/components/editor.js +1679 -0
  315. package/dist/tui/components/image.js +69 -0
  316. package/dist/tui/components/input.js +433 -0
  317. package/dist/tui/components/loader.js +49 -0
  318. package/dist/tui/components/markdown.js +629 -0
  319. package/dist/tui/components/select-list.js +152 -0
  320. package/dist/tui/components/settings-list.js +185 -0
  321. package/dist/tui/components/spacer.js +23 -0
  322. package/dist/tui/components/text.js +89 -0
  323. package/dist/tui/components/truncated-text.js +51 -0
  324. package/dist/tui/editor-component.js +2 -0
  325. package/dist/tui/fuzzy.js +107 -0
  326. package/dist/tui/get-east-asian-width/index.js +32 -0
  327. package/dist/tui/get-east-asian-width/lookup.js +404 -0
  328. package/dist/tui/index.js +32 -0
  329. package/dist/tui/keybindings.js +114 -0
  330. package/dist/tui/keys.js +959 -0
  331. package/dist/tui/kill-ring.js +44 -0
  332. package/dist/tui/stdin-buffer.js +317 -0
  333. package/dist/tui/terminal-image.js +288 -0
  334. package/dist/tui/terminal.js +249 -0
  335. package/dist/tui/tui/autocomplete.js +596 -0
  336. package/dist/tui/tui/components/box.js +106 -0
  337. package/dist/tui/tui/components/cancellable-loader.js +35 -0
  338. package/dist/tui/tui/components/editor.js +1679 -0
  339. package/dist/tui/tui/components/image.js +69 -0
  340. package/dist/tui/tui/components/input.js +433 -0
  341. package/dist/tui/tui/components/loader.js +49 -0
  342. package/dist/tui/tui/components/markdown.js +629 -0
  343. package/dist/tui/tui/components/select-list.js +152 -0
  344. package/dist/tui/tui/components/settings-list.js +185 -0
  345. package/dist/tui/tui/components/spacer.js +23 -0
  346. package/dist/tui/tui/components/text.js +91 -0
  347. package/dist/tui/tui/components/truncated-text.js +51 -0
  348. package/dist/tui/tui/editor-component.js +2 -0
  349. package/dist/tui/tui/fuzzy.js +107 -0
  350. package/dist/tui/tui/get-east-asian-width/index.js +32 -0
  351. package/dist/tui/tui/get-east-asian-width/lookup.js +404 -0
  352. package/dist/tui/tui/index.js +32 -0
  353. package/dist/tui/tui/keybindings.js +114 -0
  354. package/dist/tui/tui/keys.js +959 -0
  355. package/dist/tui/tui/kill-ring.js +44 -0
  356. package/dist/tui/tui/stdin-buffer.js +317 -0
  357. package/dist/tui/tui/terminal-image.js +288 -0
  358. package/dist/tui/tui/terminal.js +249 -0
  359. package/dist/tui/tui/tui.js +955 -0
  360. package/dist/tui/tui/undo-stack.js +25 -0
  361. package/dist/tui/tui/utils.js +800 -0
  362. package/dist/tui/tui.js +955 -0
  363. package/dist/tui/undo-stack.js +25 -0
  364. package/dist/tui/utils.js +800 -0
  365. package/dist/utils/changelog.js +87 -0
  366. package/dist/utils/clipboard-image.js +164 -0
  367. package/dist/utils/clipboard-native.js +14 -0
  368. package/dist/utils/clipboard.js +67 -0
  369. package/dist/utils/frontmatter.js +26 -0
  370. package/dist/utils/git.js +166 -0
  371. package/dist/utils/image-convert.js +35 -0
  372. package/dist/utils/image-resize.js +183 -0
  373. package/dist/utils/mime.js +26 -0
  374. package/dist/utils/photon.js +121 -0
  375. package/dist/utils/shell.js +217 -0
  376. package/dist/utils/sleep.js +17 -0
  377. package/dist/utils/tools-manager.js +259 -0
  378. package/package.json +78 -0
  379. package/skills/excel-com-api/SKILL.md +74 -0
  380. package/skills/excel-com-api/excel-type-library.py +27767 -0
  381. package/skills/excel-com-api/office-type-library.py +10867 -0
  382. package/skills/integrations/SKILL.md +138 -0
  383. package/skills/integrations/alphasense.md +457 -0
  384. package/skills/integrations/bloomberg.md +803 -0
  385. package/skills/integrations/calcbench.md +315 -0
  386. package/skills/integrations/capiq.md +848 -0
  387. package/skills/integrations/dynamics-365-finance.md +354 -0
  388. package/skills/integrations/earnings_transcripts.md +387 -0
  389. package/skills/integrations/factset.md +758 -0
  390. package/skills/integrations/ice-fixed-income.md +344 -0
  391. package/skills/integrations/moodys-analytics.md +313 -0
  392. package/skills/integrations/morningstar.md +433 -0
  393. package/skills/integrations/nasdaq-data-link.md +249 -0
  394. package/skills/integrations/pitchbook.md +413 -0
  395. package/skills/integrations/preqin.md +422 -0
  396. package/skills/integrations/quickbooks.md +289 -0
  397. package/skills/integrations/quickfs.md +314 -0
  398. package/skills/integrations/refinitiv.md +473 -0
  399. package/skills/integrations/sage-intacct.md +401 -0
  400. package/skills/integrations/visible-alpha.md +320 -0
  401. package/skills/integrations/xero.md +393 -0
  402. package/skills/integrations/ycharts.md +306 -0
  403. package/skills/pdf-creation/SKILL.md +93 -0
  404. package/skills/pdf-extraction/SKILL.md +32 -0
  405. package/skills/powerpoint-creation/SKILL.md +110 -0
  406. package/skills/sec-edgar/SKILL.md +127 -0
  407. package/skills/sec-edgar/sec_to_pdf.py +109 -0
  408. package/xll/ShortcutXL.xll +0 -0
  409. package/xll/modules/debug_render.py +272 -0
  410. package/xll/modules/gameboy.py +241 -0
  411. package/xll/modules/pong.py +188 -0
  412. package/xll/modules/shortcut_xl/__init__.py +18 -0
  413. package/xll/modules/shortcut_xl/_categorize.py +200 -0
  414. package/xll/modules/shortcut_xl/_com.py +108 -0
  415. package/xll/modules/shortcut_xl/_format.py +252 -0
  416. package/xll/modules/shortcut_xl/_log.py +12 -0
  417. package/xll/modules/shortcut_xl/_managed.py +116 -0
  418. package/xll/modules/shortcut_xl/_registry.py +44 -0
  419. package/xll/modules/shortcut_xl/_threading.py +161 -0
  420. package/xll/modules/shortcut_xl/_tracking.py +283 -0
  421. package/xll/modules/stocks.py +100 -0
  422. package/xll/python3.dll +0 -0
  423. package/xll/python312.dll +0 -0
@@ -0,0 +1,208 @@
1
+ import { Type } from '@sinclair/typebox';
2
+ import { spawnSync } from 'child_process';
3
+ import { ABORT_AGENT_MESSAGE } from '../abort.js';
4
+ import { existsSync } from 'fs';
5
+ import { globSync } from 'glob';
6
+ import path from 'path';
7
+ import { FIND } from '../../tool-names.js';
8
+ import { ensureTool } from '../../utils/tools-manager.js';
9
+ import { resolveToCwd } from './path-utils.js';
10
+ import { DEFAULT_MAX_CHARS, formatSize, truncateHead } from './truncate.js';
11
+ const findSchema = Type.Object({
12
+ pattern: Type.String({
13
+ description: "Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'"
14
+ }),
15
+ path: Type.Optional(Type.String({ description: 'Directory to search in (default: current directory)' })),
16
+ limit: Type.Optional(Type.Number({ description: 'Maximum number of results (default: 1000)' }))
17
+ });
18
+ const DEFAULT_LIMIT = 1000;
19
+ const defaultFindOperations = {
20
+ exists: existsSync,
21
+ glob: (_pattern, _searchCwd, _options) => {
22
+ // This is a placeholder - actual fd execution happens in execute
23
+ return [];
24
+ }
25
+ };
26
+ export function createFindTool(cwd, options) {
27
+ const customOps = options?.operations;
28
+ return {
29
+ name: FIND,
30
+ label: FIND,
31
+ description: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} results or ${DEFAULT_MAX_CHARS} characters (whichever is hit first).`,
32
+ parameters: findSchema,
33
+ execute: async (_toolCallId, { pattern, path: searchDir, limit }, signal) => {
34
+ return new Promise((resolve, reject) => {
35
+ if (signal?.aborted) {
36
+ reject(new Error(ABORT_AGENT_MESSAGE));
37
+ return;
38
+ }
39
+ const onAbort = () => reject(new Error(ABORT_AGENT_MESSAGE));
40
+ signal?.addEventListener('abort', onAbort, { once: true });
41
+ (async () => {
42
+ try {
43
+ const searchPath = resolveToCwd(searchDir || '.', cwd);
44
+ const effectiveLimit = limit ?? DEFAULT_LIMIT;
45
+ const ops = customOps ?? defaultFindOperations;
46
+ // If custom operations provided with glob, use that
47
+ if (customOps?.glob) {
48
+ if (!(await ops.exists(searchPath))) {
49
+ reject(new Error(`Path not found: ${searchPath}`));
50
+ return;
51
+ }
52
+ const results = await ops.glob(pattern, searchPath, {
53
+ ignore: ['**/node_modules/**', '**/.git/**'],
54
+ limit: effectiveLimit
55
+ });
56
+ signal?.removeEventListener('abort', onAbort);
57
+ if (results.length === 0) {
58
+ resolve({
59
+ content: [{ type: 'text', text: 'No files found matching pattern' }],
60
+ details: undefined
61
+ });
62
+ return;
63
+ }
64
+ // Relativize paths
65
+ const relativized = results.map((p) => {
66
+ if (p.startsWith(searchPath)) {
67
+ return p.slice(searchPath.length + 1);
68
+ }
69
+ return path.relative(searchPath, p);
70
+ });
71
+ const resultLimitReached = relativized.length >= effectiveLimit;
72
+ const rawOutput = relativized.join('\n');
73
+ const truncation = truncateHead(rawOutput);
74
+ let resultOutput = truncation.content;
75
+ const details = {};
76
+ const notices = [];
77
+ if (resultLimitReached) {
78
+ notices.push(`${effectiveLimit} results limit reached`);
79
+ details.resultLimitReached = effectiveLimit;
80
+ }
81
+ if (truncation.truncated) {
82
+ notices.push(`${formatSize(DEFAULT_MAX_CHARS)} limit reached`);
83
+ details.truncation = truncation;
84
+ }
85
+ if (notices.length > 0) {
86
+ resultOutput += `\n\n[${notices.join('. ')}]`;
87
+ }
88
+ resolve({
89
+ content: [{ type: 'text', text: resultOutput }],
90
+ details: Object.keys(details).length > 0 ? details : undefined
91
+ });
92
+ return;
93
+ }
94
+ // Default: use fd
95
+ const fdPath = await ensureTool('fd', true);
96
+ if (!fdPath) {
97
+ reject(new Error('fd is not available and could not be downloaded'));
98
+ return;
99
+ }
100
+ // Build fd arguments
101
+ const args = [
102
+ '--glob',
103
+ '--color=never',
104
+ '--hidden',
105
+ '--max-results',
106
+ String(effectiveLimit)
107
+ ];
108
+ // Include .gitignore files
109
+ const gitignoreFiles = new Set();
110
+ const rootGitignore = path.join(searchPath, '.gitignore');
111
+ if (existsSync(rootGitignore)) {
112
+ gitignoreFiles.add(rootGitignore);
113
+ }
114
+ try {
115
+ const nestedGitignores = globSync('**/.gitignore', {
116
+ cwd: searchPath,
117
+ dot: true,
118
+ absolute: true,
119
+ ignore: ['**/node_modules/**', '**/.git/**']
120
+ });
121
+ for (const file of nestedGitignores) {
122
+ gitignoreFiles.add(file);
123
+ }
124
+ }
125
+ catch {
126
+ // Ignore glob errors
127
+ }
128
+ for (const gitignorePath of gitignoreFiles) {
129
+ args.push('--ignore-file', gitignorePath);
130
+ }
131
+ args.push(pattern, searchPath);
132
+ const result = spawnSync(fdPath, args, {
133
+ encoding: 'utf-8',
134
+ maxBuffer: 10 * 1024 * 1024
135
+ });
136
+ signal?.removeEventListener('abort', onAbort);
137
+ if (result.error) {
138
+ reject(new Error(`Failed to run fd: ${result.error.message}`));
139
+ return;
140
+ }
141
+ const output = result.stdout?.trim() || '';
142
+ if (result.status !== 0) {
143
+ const errorMsg = result.stderr?.trim() || `fd exited with code ${result.status}`;
144
+ if (!output) {
145
+ reject(new Error(errorMsg));
146
+ return;
147
+ }
148
+ }
149
+ if (!output) {
150
+ resolve({
151
+ content: [{ type: 'text', text: 'No files found matching pattern' }],
152
+ details: undefined
153
+ });
154
+ return;
155
+ }
156
+ const lines = output.split('\n');
157
+ const relativized = [];
158
+ for (const rawLine of lines) {
159
+ const line = rawLine.replace(/\r$/, '').trim();
160
+ if (!line)
161
+ continue;
162
+ const hadTrailingSlash = line.endsWith('/') || line.endsWith('\\');
163
+ let relativePath = line;
164
+ if (line.startsWith(searchPath)) {
165
+ relativePath = line.slice(searchPath.length + 1);
166
+ }
167
+ else {
168
+ relativePath = path.relative(searchPath, line);
169
+ }
170
+ if (hadTrailingSlash && !relativePath.endsWith('/')) {
171
+ relativePath += '/';
172
+ }
173
+ relativized.push(relativePath);
174
+ }
175
+ const resultLimitReached = relativized.length >= effectiveLimit;
176
+ const rawOutput = relativized.join('\n');
177
+ const truncation = truncateHead(rawOutput);
178
+ let resultOutput = truncation.content;
179
+ const details = {};
180
+ const notices = [];
181
+ if (resultLimitReached) {
182
+ notices.push(`${effectiveLimit} results limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`);
183
+ details.resultLimitReached = effectiveLimit;
184
+ }
185
+ if (truncation.truncated) {
186
+ notices.push(`${formatSize(DEFAULT_MAX_CHARS)} limit reached`);
187
+ details.truncation = truncation;
188
+ }
189
+ if (notices.length > 0) {
190
+ resultOutput += `\n\n[${notices.join('. ')}]`;
191
+ }
192
+ resolve({
193
+ content: [{ type: 'text', text: resultOutput }],
194
+ details: Object.keys(details).length > 0 ? details : undefined
195
+ });
196
+ }
197
+ catch (e) {
198
+ signal?.removeEventListener('abort', onAbort);
199
+ reject(e);
200
+ }
201
+ })();
202
+ });
203
+ }
204
+ };
205
+ }
206
+ /** Default find tool using process.cwd() - for backwards compatibility */
207
+ export const findTool = createFindTool(process.cwd());
208
+ //# sourceMappingURL=find.js.map
@@ -0,0 +1,246 @@
1
+ import { Type } from '@sinclair/typebox';
2
+ import { ABORT_AGENT_MESSAGE } from '../abort.js';
3
+ import { spawn } from 'child_process';
4
+ import { readFileSync, statSync } from 'fs';
5
+ import { createInterface } from 'node:readline';
6
+ import path from 'path';
7
+ import { GREP } from '../../tool-names.js';
8
+ import { ensureTool } from '../../utils/tools-manager.js';
9
+ import { resolveToCwd } from './path-utils.js';
10
+ import { DEFAULT_MAX_CHARS, formatSize, GREP_MAX_LINE_LENGTH, truncateHead, truncateLine } from './truncate.js';
11
+ const grepSchema = Type.Object({
12
+ pattern: Type.String({ description: 'Search pattern (regex or literal string)' }),
13
+ path: Type.Optional(Type.String({ description: 'Directory or file to search (default: current directory)' })),
14
+ glob: Type.Optional(Type.String({ description: "Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'" })),
15
+ ignoreCase: Type.Optional(Type.Boolean({ description: 'Case-insensitive search (default: false)' })),
16
+ literal: Type.Optional(Type.Boolean({
17
+ description: 'Treat pattern as literal string instead of regex (default: false)'
18
+ })),
19
+ context: Type.Optional(Type.Number({ description: 'Number of lines to show before and after each match (default: 0)' })),
20
+ limit: Type.Optional(Type.Number({ description: 'Maximum number of matches to return (default: 100)' }))
21
+ });
22
+ const DEFAULT_LIMIT = 100;
23
+ const defaultGrepOperations = {
24
+ isDirectory: (p) => statSync(p).isDirectory(),
25
+ readFile: (p) => readFileSync(p, 'utf-8')
26
+ };
27
+ export function createGrepTool(cwd, options) {
28
+ const customOps = options?.operations;
29
+ return {
30
+ name: GREP,
31
+ label: GREP,
32
+ description: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects .gitignore. Output is truncated to ${DEFAULT_LIMIT} matches or ${DEFAULT_MAX_CHARS} characters (whichever is hit first). Long lines are truncated to ${GREP_MAX_LINE_LENGTH} chars.`,
33
+ parameters: grepSchema,
34
+ execute: async (_toolCallId, { pattern, path: searchDir, glob, ignoreCase, literal, context, limit }, signal) => {
35
+ return new Promise((resolve, reject) => {
36
+ if (signal?.aborted) {
37
+ reject(new Error(ABORT_AGENT_MESSAGE));
38
+ return;
39
+ }
40
+ let settled = false;
41
+ const settle = (fn) => {
42
+ if (!settled) {
43
+ settled = true;
44
+ fn();
45
+ }
46
+ };
47
+ (async () => {
48
+ try {
49
+ const rgPath = await ensureTool('rg', true);
50
+ if (!rgPath) {
51
+ settle(() => reject(new Error('ripgrep (rg) is not available and could not be downloaded')));
52
+ return;
53
+ }
54
+ const searchPath = resolveToCwd(searchDir || '.', cwd);
55
+ const ops = customOps ?? defaultGrepOperations;
56
+ let isDirectory;
57
+ try {
58
+ isDirectory = await ops.isDirectory(searchPath);
59
+ }
60
+ catch (_err) {
61
+ settle(() => reject(new Error(`Path not found: ${searchPath}`)));
62
+ return;
63
+ }
64
+ const contextValue = context && context > 0 ? context : 0;
65
+ const effectiveLimit = Math.max(1, limit ?? DEFAULT_LIMIT);
66
+ const formatPath = (filePath) => {
67
+ if (isDirectory) {
68
+ const relative = path.relative(searchPath, filePath);
69
+ if (relative && !relative.startsWith('..')) {
70
+ return relative.replace(/\\/g, '/');
71
+ }
72
+ }
73
+ return path.basename(filePath);
74
+ };
75
+ const fileCache = new Map();
76
+ const getFileLines = async (filePath) => {
77
+ let lines = fileCache.get(filePath);
78
+ if (!lines) {
79
+ try {
80
+ const content = await ops.readFile(filePath);
81
+ lines = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
82
+ }
83
+ catch {
84
+ lines = [];
85
+ }
86
+ fileCache.set(filePath, lines);
87
+ }
88
+ return lines;
89
+ };
90
+ const args = ['--json', '--line-number', '--color=never', '--hidden'];
91
+ if (ignoreCase) {
92
+ args.push('--ignore-case');
93
+ }
94
+ if (literal) {
95
+ args.push('--fixed-strings');
96
+ }
97
+ if (glob) {
98
+ args.push('--glob', glob);
99
+ }
100
+ args.push(pattern, searchPath);
101
+ const child = spawn(rgPath, args, { stdio: ['ignore', 'pipe', 'pipe'] });
102
+ const rl = createInterface({ input: child.stdout });
103
+ let stderr = '';
104
+ let matchCount = 0;
105
+ let matchLimitReached = false;
106
+ let linesTruncated = false;
107
+ let aborted = false;
108
+ let killedDueToLimit = false;
109
+ const outputLines = [];
110
+ const cleanup = () => {
111
+ rl.close();
112
+ signal?.removeEventListener('abort', onAbort);
113
+ };
114
+ const stopChild = (dueToLimit = false) => {
115
+ if (!child.killed) {
116
+ killedDueToLimit = dueToLimit;
117
+ child.kill();
118
+ }
119
+ };
120
+ const onAbort = () => {
121
+ aborted = true;
122
+ stopChild();
123
+ };
124
+ signal?.addEventListener('abort', onAbort, { once: true });
125
+ child.stderr?.on('data', (chunk) => {
126
+ stderr += chunk.toString();
127
+ });
128
+ const formatBlock = async (filePath, lineNumber) => {
129
+ const relativePath = formatPath(filePath);
130
+ const lines = await getFileLines(filePath);
131
+ if (!lines.length) {
132
+ return [`${relativePath}:${lineNumber}: (unable to read file)`];
133
+ }
134
+ const block = [];
135
+ const start = contextValue > 0 ? Math.max(1, lineNumber - contextValue) : lineNumber;
136
+ const end = contextValue > 0 ? Math.min(lines.length, lineNumber + contextValue) : lineNumber;
137
+ for (let current = start; current <= end; current++) {
138
+ const lineText = lines[current - 1] ?? '';
139
+ const sanitized = lineText.replace(/\r/g, '');
140
+ const isMatchLine = current === lineNumber;
141
+ // Truncate long lines
142
+ const { text: truncatedText, wasTruncated } = truncateLine(sanitized);
143
+ if (wasTruncated) {
144
+ linesTruncated = true;
145
+ }
146
+ if (isMatchLine) {
147
+ block.push(`${relativePath}:${current}: ${truncatedText}`);
148
+ }
149
+ else {
150
+ block.push(`${relativePath}-${current}- ${truncatedText}`);
151
+ }
152
+ }
153
+ return block;
154
+ };
155
+ // Collect matches during streaming, format after
156
+ const matches = [];
157
+ rl.on('line', (line) => {
158
+ if (!line.trim() || matchCount >= effectiveLimit) {
159
+ return;
160
+ }
161
+ let event;
162
+ try {
163
+ event = JSON.parse(line);
164
+ }
165
+ catch {
166
+ return;
167
+ }
168
+ if (event.type === 'match') {
169
+ matchCount++;
170
+ const filePath = event.data?.path?.text;
171
+ const lineNumber = event.data?.line_number;
172
+ if (filePath && typeof lineNumber === 'number') {
173
+ matches.push({ filePath, lineNumber });
174
+ }
175
+ if (matchCount >= effectiveLimit) {
176
+ matchLimitReached = true;
177
+ stopChild(true);
178
+ }
179
+ }
180
+ });
181
+ child.on('error', (error) => {
182
+ cleanup();
183
+ settle(() => reject(new Error(`Failed to run ripgrep: ${error.message}`)));
184
+ });
185
+ child.on('close', async (code) => {
186
+ cleanup();
187
+ if (aborted) {
188
+ settle(() => reject(new Error(ABORT_AGENT_MESSAGE)));
189
+ return;
190
+ }
191
+ if (!killedDueToLimit && code !== 0 && code !== 1) {
192
+ const errorMsg = stderr.trim() || `ripgrep exited with code ${code}`;
193
+ settle(() => reject(new Error(errorMsg)));
194
+ return;
195
+ }
196
+ if (matchCount === 0) {
197
+ settle(() => resolve({
198
+ content: [{ type: 'text', text: 'No matches found' }],
199
+ details: undefined
200
+ }));
201
+ return;
202
+ }
203
+ // Format matches (async to support remote file reading)
204
+ for (const match of matches) {
205
+ const block = await formatBlock(match.filePath, match.lineNumber);
206
+ outputLines.push(...block);
207
+ }
208
+ // Apply byte truncation (no line limit since we already have match limit)
209
+ const rawOutput = outputLines.join('\n');
210
+ const truncation = truncateHead(rawOutput);
211
+ let output = truncation.content;
212
+ const details = {};
213
+ // Build notices
214
+ const notices = [];
215
+ if (matchLimitReached) {
216
+ notices.push(`${effectiveLimit} matches limit reached. Use limit=${effectiveLimit * 2} for more, or refine pattern`);
217
+ details.matchLimitReached = effectiveLimit;
218
+ }
219
+ if (truncation.truncated) {
220
+ notices.push(`${formatSize(DEFAULT_MAX_CHARS)} limit reached`);
221
+ details.truncation = truncation;
222
+ }
223
+ if (linesTruncated) {
224
+ notices.push(`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars. Use read tool to see full lines`);
225
+ details.linesTruncated = true;
226
+ }
227
+ if (notices.length > 0) {
228
+ output += `\n\n[${notices.join('. ')}]`;
229
+ }
230
+ settle(() => resolve({
231
+ content: [{ type: 'text', text: output }],
232
+ details: Object.keys(details).length > 0 ? details : undefined
233
+ }));
234
+ });
235
+ }
236
+ catch (err) {
237
+ settle(() => reject(err));
238
+ }
239
+ })();
240
+ });
241
+ }
242
+ };
243
+ }
244
+ /** Default grep tool using process.cwd() - for backwards compatibility */
245
+ export const grepTool = createGrepTool(process.cwd());
246
+ //# sourceMappingURL=grep.js.map
@@ -0,0 +1,67 @@
1
+ export { bashTool, createBashTool } from './bash.js';
2
+ export { createEditTool, editTool } from './edit.js';
3
+ export { createFindTool, findTool } from './find.js';
4
+ export { createGrepTool, grepTool } from './grep.js';
5
+ export { createLsTool, lsTool } from './ls.js';
6
+ export { createReadTool, readTool } from './read.js';
7
+ export { DEFAULT_MAX_CHARS, formatSize, truncateHead, truncateLine, truncateOutput } from './truncate.js';
8
+ export { createWriteTool, writeTool } from './write.js';
9
+ import { bashTool, createBashTool } from './bash.js';
10
+ import { createEditTool, editTool } from './edit.js';
11
+ import { createFindTool, findTool } from './find.js';
12
+ import { createGrepTool, grepTool } from './grep.js';
13
+ import { createLsTool, lsTool } from './ls.js';
14
+ import { createReadTool, readTool } from './read.js';
15
+ import { createWriteTool, writeTool } from './write.js';
16
+ // Default tools for full access mode (using process.cwd())
17
+ export const codingTools = [readTool, bashTool, editTool, writeTool];
18
+ // Read-only tools for exploration without modification (using process.cwd())
19
+ export const readOnlyTools = [readTool, grepTool, findTool, lsTool];
20
+ import { BASH, EDIT, FIND, GREP, LS, READ, WRITE } from '../../tool-names.js';
21
+ // All available tools (using process.cwd())
22
+ export const allTools = {
23
+ [READ]: readTool,
24
+ [BASH]: bashTool,
25
+ [EDIT]: editTool,
26
+ [WRITE]: writeTool,
27
+ [GREP]: grepTool,
28
+ [FIND]: findTool,
29
+ [LS]: lsTool
30
+ };
31
+ /**
32
+ * Create coding tools configured for a specific working directory.
33
+ */
34
+ export function createCodingTools(cwd, options) {
35
+ return [
36
+ createReadTool(cwd, options?.read),
37
+ createBashTool(cwd, options?.bash),
38
+ createEditTool(cwd),
39
+ createWriteTool(cwd)
40
+ ];
41
+ }
42
+ /**
43
+ * Create read-only tools configured for a specific working directory.
44
+ */
45
+ export function createReadOnlyTools(cwd, options) {
46
+ return [
47
+ createReadTool(cwd, options?.read),
48
+ createGrepTool(cwd),
49
+ createFindTool(cwd),
50
+ createLsTool(cwd)
51
+ ];
52
+ }
53
+ /**
54
+ * Create all tools configured for a specific working directory.
55
+ */
56
+ export function createAllTools(cwd, options) {
57
+ return {
58
+ [READ]: createReadTool(cwd, options?.read),
59
+ [BASH]: createBashTool(cwd, options?.bash),
60
+ [EDIT]: createEditTool(cwd),
61
+ [WRITE]: createWriteTool(cwd),
62
+ [GREP]: createGrepTool(cwd),
63
+ [FIND]: createFindTool(cwd),
64
+ [LS]: createLsTool(cwd)
65
+ };
66
+ }
67
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,123 @@
1
+ import { Type } from '@sinclair/typebox';
2
+ import { existsSync, readdirSync, statSync } from 'fs';
3
+ import nodePath from 'path';
4
+ import { ABORT_AGENT_MESSAGE } from '../abort.js';
5
+ import { LS } from '../../tool-names.js';
6
+ import { resolveToCwd } from './path-utils.js';
7
+ import { DEFAULT_MAX_CHARS, formatSize, truncateHead } from './truncate.js';
8
+ const lsSchema = Type.Object({
9
+ path: Type.Optional(Type.String({ description: 'Directory to list (default: current directory)' })),
10
+ limit: Type.Optional(Type.Number({ description: 'Maximum number of entries to return (default: 500)' }))
11
+ });
12
+ const DEFAULT_LIMIT = 500;
13
+ const defaultLsOperations = {
14
+ exists: existsSync,
15
+ stat: statSync,
16
+ readdir: readdirSync
17
+ };
18
+ export function createLsTool(cwd, options) {
19
+ const ops = options?.operations ?? defaultLsOperations;
20
+ return {
21
+ name: LS,
22
+ label: LS,
23
+ description: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${DEFAULT_LIMIT} entries or ${DEFAULT_MAX_CHARS} characters (whichever is hit first).`,
24
+ parameters: lsSchema,
25
+ execute: async (_toolCallId, { path, limit }, signal) => {
26
+ return new Promise((resolve, reject) => {
27
+ if (signal?.aborted) {
28
+ reject(new Error(ABORT_AGENT_MESSAGE));
29
+ return;
30
+ }
31
+ const onAbort = () => reject(new Error(ABORT_AGENT_MESSAGE));
32
+ signal?.addEventListener('abort', onAbort, { once: true });
33
+ (async () => {
34
+ try {
35
+ const dirPath = resolveToCwd(path || '.', cwd);
36
+ const effectiveLimit = limit ?? DEFAULT_LIMIT;
37
+ // Check if path exists
38
+ if (!(await ops.exists(dirPath))) {
39
+ reject(new Error(`Path not found: ${dirPath}`));
40
+ return;
41
+ }
42
+ // Check if path is a directory
43
+ const stat = await ops.stat(dirPath);
44
+ if (!stat.isDirectory()) {
45
+ reject(new Error(`Not a directory: ${dirPath}`));
46
+ return;
47
+ }
48
+ // Read directory entries
49
+ let entries;
50
+ try {
51
+ entries = await ops.readdir(dirPath);
52
+ }
53
+ catch (e) {
54
+ reject(new Error(`Cannot read directory: ${e.message}`));
55
+ return;
56
+ }
57
+ // Sort alphabetically (case-insensitive)
58
+ entries.sort((a, b) => a.toLowerCase().localeCompare(b.toLowerCase()));
59
+ // Format entries with directory indicators
60
+ const results = [];
61
+ let entryLimitReached = false;
62
+ for (const entry of entries) {
63
+ if (results.length >= effectiveLimit) {
64
+ entryLimitReached = true;
65
+ break;
66
+ }
67
+ const fullPath = nodePath.join(dirPath, entry);
68
+ let suffix = '';
69
+ try {
70
+ const entryStat = await ops.stat(fullPath);
71
+ if (entryStat.isDirectory()) {
72
+ suffix = '/';
73
+ }
74
+ }
75
+ catch {
76
+ // Skip entries we can't stat
77
+ continue;
78
+ }
79
+ results.push(entry + suffix);
80
+ }
81
+ signal?.removeEventListener('abort', onAbort);
82
+ if (results.length === 0) {
83
+ resolve({
84
+ content: [{ type: 'text', text: '(empty directory)' }],
85
+ details: undefined
86
+ });
87
+ return;
88
+ }
89
+ // Apply byte truncation (no line limit since we already have entry limit)
90
+ const rawOutput = results.join('\n');
91
+ const truncation = truncateHead(rawOutput);
92
+ let output = truncation.content;
93
+ const details = {};
94
+ // Build notices
95
+ const notices = [];
96
+ if (entryLimitReached) {
97
+ notices.push(`${effectiveLimit} entries limit reached. Use limit=${effectiveLimit * 2} for more`);
98
+ details.entryLimitReached = effectiveLimit;
99
+ }
100
+ if (truncation.truncated) {
101
+ notices.push(`${formatSize(DEFAULT_MAX_CHARS)} limit reached`);
102
+ details.truncation = truncation;
103
+ }
104
+ if (notices.length > 0) {
105
+ output += `\n\n[${notices.join('. ')}]`;
106
+ }
107
+ resolve({
108
+ content: [{ type: 'text', text: output }],
109
+ details: Object.keys(details).length > 0 ? details : undefined
110
+ });
111
+ }
112
+ catch (e) {
113
+ signal?.removeEventListener('abort', onAbort);
114
+ reject(e);
115
+ }
116
+ })();
117
+ });
118
+ }
119
+ };
120
+ }
121
+ /** Default ls tool using process.cwd() - for backwards compatibility */
122
+ export const lsTool = createLsTool(process.cwd());
123
+ //# sourceMappingURL=ls.js.map