@neurocode-ai/core 1.18.8

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 (490) hide show
  1. package/bin/neurocode +199 -0
  2. package/bunfig.toml +2 -0
  3. package/drizzle.config.ts +10 -0
  4. package/package.json +131 -0
  5. package/schema.json +2071 -0
  6. package/script/fix-node-pty.ts +28 -0
  7. package/script/migration.ts +196 -0
  8. package/src/account/sql.ts +39 -0
  9. package/src/account.ts +101 -0
  10. package/src/agent.ts +111 -0
  11. package/src/aisdk.ts +235 -0
  12. package/src/background-job.ts +365 -0
  13. package/src/catalog.ts +301 -0
  14. package/src/command.ts +64 -0
  15. package/src/config/agent.ts +25 -0
  16. package/src/config/attachments.ts +15 -0
  17. package/src/config/command.ts +12 -0
  18. package/src/config/compaction.ts +15 -0
  19. package/src/config/experimental.ts +18 -0
  20. package/src/config/formatter.ts +12 -0
  21. package/src/config/lsp.ts +18 -0
  22. package/src/config/markdown.ts +36 -0
  23. package/src/config/mcp.ts +48 -0
  24. package/src/config/plugin/agent.ts +179 -0
  25. package/src/config/plugin/command.ts +83 -0
  26. package/src/config/plugin/external.ts +91 -0
  27. package/src/config/plugin/provider.ts +113 -0
  28. package/src/config/plugin/reference.ts +70 -0
  29. package/src/config/plugin/skill.ts +50 -0
  30. package/src/config/plugin.ts +13 -0
  31. package/src/config/provider.ts +71 -0
  32. package/src/config/reference.ts +22 -0
  33. package/src/config/tool-output.ts +9 -0
  34. package/src/config/watcher.ts +7 -0
  35. package/src/config.ts +227 -0
  36. package/src/control-plane/move-session.ts +148 -0
  37. package/src/control-plane/workspace.sql.ts +20 -0
  38. package/src/credential/sql.ts +14 -0
  39. package/src/credential.ts +138 -0
  40. package/src/cross-spawn-spawner.ts +507 -0
  41. package/src/data-migration.sql.ts +6 -0
  42. package/src/database/database.ts +57 -0
  43. package/src/database/migration/20260127222353_familiar_lady_ursula.ts +107 -0
  44. package/src/database/migration/20260211171708_add_project_commands.ts +11 -0
  45. package/src/database/migration/20260213144116_wakeful_the_professor.ts +23 -0
  46. package/src/database/migration/20260225215848_workspace.ts +19 -0
  47. package/src/database/migration/20260227213759_add_session_workspace_id.ts +12 -0
  48. package/src/database/migration/20260228203230_blue_harpoon.ts +30 -0
  49. package/src/database/migration/20260303231226_add_workspace_fields.ts +15 -0
  50. package/src/database/migration/20260309230000_move_org_to_state.ts +15 -0
  51. package/src/database/migration/20260312043431_session_message_cursor.ts +16 -0
  52. package/src/database/migration/20260323234822_events.ts +26 -0
  53. package/src/database/migration/20260410174513_workspace-name.ts +29 -0
  54. package/src/database/migration/20260413175956_chief_energizer.ts +24 -0
  55. package/src/database/migration/20260423070820_add_icon_url_override.ts +14 -0
  56. package/src/database/migration/20260427172553_slow_nightmare.ts +30 -0
  57. package/src/database/migration/20260428004200_add_session_path.ts +11 -0
  58. package/src/database/migration/20260501142318_next_venus.ts +12 -0
  59. package/src/database/migration/20260504145000_add_sync_owner.ts +11 -0
  60. package/src/database/migration/20260507164347_add_workspace_time.ts +11 -0
  61. package/src/database/migration/20260510033149_session_usage.ts +56 -0
  62. package/src/database/migration/20260511000411_data_migration_state.ts +16 -0
  63. package/src/database/migration/20260511173437_session-metadata.ts +16 -0
  64. package/src/database/migration/20260601010001_normalize_storage_paths.ts +22 -0
  65. package/src/database/migration/20260601202201_amazing_prowler.ts +11 -0
  66. package/src/database/migration/20260602002951_lowly_union_jack.ts +24 -0
  67. package/src/database/migration/20260602182828_add_project_directories.ts +20 -0
  68. package/src/database/migration/20260603001617_session_message_projection_indexes.ts +19 -0
  69. package/src/database/migration/20260603040000_session_message_projection_order.ts +19 -0
  70. package/src/database/migration/20260603141458_session_input_inbox.ts +25 -0
  71. package/src/database/migration/20260603160727_jittery_ezekiel_stane.ts +20 -0
  72. package/src/database/migration/20260604172448_event_sourced_session_input.ts +47 -0
  73. package/src/database/migration/20260605003541_add_session_context_snapshot.ts +21 -0
  74. package/src/database/migration/20260605042240_add_context_epoch_agent.ts +11 -0
  75. package/src/database/migration/20260611035744_credential.ts +25 -0
  76. package/src/database/migration/20260611192811_lush_chimera.ts +25 -0
  77. package/src/database/migration/20260612174303_project_dir_strategy.ts +29 -0
  78. package/src/database/migration/20260622142730_simplify_session_context_epoch.ts +13 -0
  79. package/src/database/migration/20260622170816_reset_v2_session_state.ts +17 -0
  80. package/src/database/migration/20260622202450_simplify_session_input.ts +17 -0
  81. package/src/database/migration.gen.ts +44 -0
  82. package/src/database/migration.ts +81 -0
  83. package/src/database/path.ts +91 -0
  84. package/src/database/schema.gen.ts +274 -0
  85. package/src/database/schema.sql.ts +10 -0
  86. package/src/database/sqlite.bun.ts +183 -0
  87. package/src/database/sqlite.node.ts +178 -0
  88. package/src/database/sqlite.ts +8 -0
  89. package/src/effect/app-node-builder.ts +23 -0
  90. package/src/effect/app-node-platform.ts +18 -0
  91. package/src/effect/app-node.ts +14 -0
  92. package/src/effect/dfdf +1 -0
  93. package/src/effect/keyed-mutex.ts +45 -0
  94. package/src/effect/layer-node.ts +333 -0
  95. package/src/effect/memo-map.ts +3 -0
  96. package/src/effect/runtime.ts +21 -0
  97. package/src/effect/service-use.ts +43 -0
  98. package/src/event/sql.ts +25 -0
  99. package/src/event.ts +638 -0
  100. package/src/file-mutation.ts +207 -0
  101. package/src/file.ts +6 -0
  102. package/src/filesystem/fff.bun.ts +140 -0
  103. package/src/filesystem/fff.node.ts +138 -0
  104. package/src/filesystem/ignore.ts +67 -0
  105. package/src/filesystem/protected.ts +53 -0
  106. package/src/filesystem/search.ts +239 -0
  107. package/src/filesystem/watcher.ts +140 -0
  108. package/src/filesystem.ts +118 -0
  109. package/src/flag/flag.ts +78 -0
  110. package/src/fs-util.ts +274 -0
  111. package/src/git.ts +987 -0
  112. package/src/github-copilot/README.md +5 -0
  113. package/src/github-copilot/chat/convert-to-openai-compatible-chat-messages.ts +170 -0
  114. package/src/github-copilot/chat/get-response-metadata.ts +15 -0
  115. package/src/github-copilot/chat/map-openai-compatible-finish-reason.ts +19 -0
  116. package/src/github-copilot/chat/openai-compatible-api-types.ts +64 -0
  117. package/src/github-copilot/chat/openai-compatible-chat-language-model.ts +815 -0
  118. package/src/github-copilot/chat/openai-compatible-chat-options.ts +28 -0
  119. package/src/github-copilot/chat/openai-compatible-metadata-extractor.ts +44 -0
  120. package/src/github-copilot/chat/openai-compatible-prepare-tools.ts +83 -0
  121. package/src/github-copilot/copilot-provider.ts +100 -0
  122. package/src/github-copilot/openai-compatible-error.ts +27 -0
  123. package/src/github-copilot/responses/convert-to-openai-responses-input.ts +335 -0
  124. package/src/github-copilot/responses/map-openai-responses-finish-reason.ts +22 -0
  125. package/src/github-copilot/responses/openai-config.ts +18 -0
  126. package/src/github-copilot/responses/openai-error.ts +22 -0
  127. package/src/github-copilot/responses/openai-responses-api-types.ts +214 -0
  128. package/src/github-copilot/responses/openai-responses-language-model.ts +1770 -0
  129. package/src/github-copilot/responses/openai-responses-prepare-tools.ts +173 -0
  130. package/src/github-copilot/responses/openai-responses-settings.ts +1 -0
  131. package/src/github-copilot/responses/tool/code-interpreter.ts +87 -0
  132. package/src/github-copilot/responses/tool/file-search.ts +127 -0
  133. package/src/github-copilot/responses/tool/image-generation.ts +114 -0
  134. package/src/github-copilot/responses/tool/local-shell.ts +64 -0
  135. package/src/github-copilot/responses/tool/web-search-preview.ts +103 -0
  136. package/src/github-copilot/responses/tool/web-search.ts +102 -0
  137. package/src/global.ts +87 -0
  138. package/src/id/id.ts +47 -0
  139. package/src/image/photon.ts +94 -0
  140. package/src/image.ts +81 -0
  141. package/src/installation/version.ts +8 -0
  142. package/src/instruction-context.ts +101 -0
  143. package/src/integration/connection.ts +12 -0
  144. package/src/integration.ts +520 -0
  145. package/src/location-mutation.ts +162 -0
  146. package/src/location-service-map.ts +18 -0
  147. package/src/location-services.ts +115 -0
  148. package/src/location.ts +39 -0
  149. package/src/markdown.d.ts +4 -0
  150. package/src/model.ts +41 -0
  151. package/src/models-dev.ts +260 -0
  152. package/src/npm-config.ts +40 -0
  153. package/src/npm.ts +269 -0
  154. package/src/oauth/page.ts +276 -0
  155. package/src/observability/logging.ts +71 -0
  156. package/src/observability/otlp.ts +79 -0
  157. package/src/observability/shared.ts +1 -0
  158. package/src/observability.ts +24 -0
  159. package/src/patch.ts +197 -0
  160. package/src/permission/saved.ts +79 -0
  161. package/src/permission/sql.ts +20 -0
  162. package/src/permission.ts +310 -0
  163. package/src/plugin/agent.ts +206 -0
  164. package/src/plugin/command/initialize.txt +65 -0
  165. package/src/plugin/command/review.txt +100 -0
  166. package/src/plugin/command.ts +25 -0
  167. package/src/plugin/host.ts +219 -0
  168. package/src/plugin/internal.ts +153 -0
  169. package/src/plugin/layer-map.example.ts +94 -0
  170. package/src/plugin/models-dev.ts +183 -0
  171. package/src/plugin/promise.ts +93 -0
  172. package/src/plugin/provider/alibaba.ts +15 -0
  173. package/src/plugin/provider/amazon-bedrock.ts +126 -0
  174. package/src/plugin/provider/anthropic.ts +27 -0
  175. package/src/plugin/provider/azure.ts +82 -0
  176. package/src/plugin/provider/cerebras.ts +26 -0
  177. package/src/plugin/provider/cloudflare-ai-gateway.ts +81 -0
  178. package/src/plugin/provider/cloudflare-workers-ai.ts +81 -0
  179. package/src/plugin/provider/cohere.ts +15 -0
  180. package/src/plugin/provider/deepinfra.ts +15 -0
  181. package/src/plugin/provider/dynamic.ts +31 -0
  182. package/src/plugin/provider/gateway.ts +15 -0
  183. package/src/plugin/provider/github-copilot.ts +52 -0
  184. package/src/plugin/provider/gitlab.ts +65 -0
  185. package/src/plugin/provider/google-vertex.ts +173 -0
  186. package/src/plugin/provider/google.ts +15 -0
  187. package/src/plugin/provider/groq.ts +15 -0
  188. package/src/plugin/provider/kilo.ts +21 -0
  189. package/src/plugin/provider/llmgateway.ts +26 -0
  190. package/src/plugin/provider/mistral.ts +15 -0
  191. package/src/plugin/provider/nvidia.ts +22 -0
  192. package/src/plugin/provider/openai-compatible.ts +17 -0
  193. package/src/plugin/provider/openai.ts +292 -0
  194. package/src/plugin/provider/opencode.ts +311 -0
  195. package/src/plugin/provider/openrouter.ts +36 -0
  196. package/src/plugin/provider/perplexity.ts +15 -0
  197. package/src/plugin/provider/sap-ai-core.ts +46 -0
  198. package/src/plugin/provider/snowflake-cortex.ts +89 -0
  199. package/src/plugin/provider/togetherai.ts +15 -0
  200. package/src/plugin/provider/venice.ts +15 -0
  201. package/src/plugin/provider/vercel.ts +27 -0
  202. package/src/plugin/provider/xai.ts +22 -0
  203. package/src/plugin/provider/zenmux.ts +21 -0
  204. package/src/plugin/provider.ts +71 -0
  205. package/src/plugin/skill/customize-neurocode.md +452 -0
  206. package/src/plugin/skill.ts +31 -0
  207. package/src/plugin/variant.ts +39 -0
  208. package/src/plugin.ts +167 -0
  209. package/src/policy.ts +49 -0
  210. package/src/process.ts +261 -0
  211. package/src/project/copy-strategies.ts +35 -0
  212. package/src/project/copy.ts +292 -0
  213. package/src/project/directories.ts +158 -0
  214. package/src/project/schema.ts +16 -0
  215. package/src/project/sql.ts +35 -0
  216. package/src/project.ts +136 -0
  217. package/src/provider.ts +25 -0
  218. package/src/pty/protocol.ts +37 -0
  219. package/src/pty/pty.bun.ts +26 -0
  220. package/src/pty/pty.node.ts +29 -0
  221. package/src/pty/pty.ts +25 -0
  222. package/src/pty/schema.ts +1 -0
  223. package/src/pty/ticket.ts +56 -0
  224. package/src/pty.ts +318 -0
  225. package/src/public-event-manifest.ts +7 -0
  226. package/src/question.ts +153 -0
  227. package/src/reference/guidance.ts +69 -0
  228. package/src/reference.ts +125 -0
  229. package/src/repository-cache.ts +259 -0
  230. package/src/repository.ts +214 -0
  231. package/src/ripgrep/binary.ts +132 -0
  232. package/src/ripgrep.ts +281 -0
  233. package/src/schema.ts +79 -0
  234. package/src/session/compaction.ts +241 -0
  235. package/src/session/context-epoch.ts +174 -0
  236. package/src/session/error.ts +24 -0
  237. package/src/session/event.ts +2 -0
  238. package/src/session/execution/local.ts +46 -0
  239. package/src/session/execution.ts +34 -0
  240. package/src/session/history.ts +101 -0
  241. package/src/session/info.ts +50 -0
  242. package/src/session/input.ts +288 -0
  243. package/src/session/message-updater.ts +397 -0
  244. package/src/session/message.ts +2 -0
  245. package/src/session/projector.ts +458 -0
  246. package/src/session/prompt.ts +1 -0
  247. package/src/session/revert.ts +121 -0
  248. package/src/session/run-coordinator.ts +104 -0
  249. package/src/session/runner/index.ts +28 -0
  250. package/src/session/runner/llm.ts +432 -0
  251. package/src/session/runner/max-steps.ts +16 -0
  252. package/src/session/runner/model.ts +218 -0
  253. package/src/session/runner/publish-llm-event.ts +423 -0
  254. package/src/session/runner/to-llm-message.ts +171 -0
  255. package/src/session/schema.ts +9 -0
  256. package/src/session/sql.ts +176 -0
  257. package/src/session/store.ts +63 -0
  258. package/src/session/todo.ts +78 -0
  259. package/src/session.ts +486 -0
  260. package/src/share/sql.ts +13 -0
  261. package/src/shell.ts +226 -0
  262. package/src/skill/discovery.ts +213 -0
  263. package/src/skill/guidance.ts +76 -0
  264. package/src/skill.ts +132 -0
  265. package/src/snapshot.ts +266 -0
  266. package/src/state.ts +128 -0
  267. package/src/system-context/builtins.ts +50 -0
  268. package/src/system-context/index.ts +320 -0
  269. package/src/system-context/registry.ts +49 -0
  270. package/src/tool/AGENTS.md +59 -0
  271. package/src/tool/application-tools.ts +57 -0
  272. package/src/tool/apply-patch.ts +219 -0
  273. package/src/tool/bash.ts +207 -0
  274. package/src/tool/builtins.ts +48 -0
  275. package/src/tool/edit.ts +223 -0
  276. package/src/tool/glob.ts +105 -0
  277. package/src/tool/grep.ts +137 -0
  278. package/src/tool/http-body.ts +30 -0
  279. package/src/tool/question.ts +94 -0
  280. package/src/tool/read-filesystem.ts +366 -0
  281. package/src/tool/read.ts +117 -0
  282. package/src/tool/registry.ts +147 -0
  283. package/src/tool/skill.ts +109 -0
  284. package/src/tool/todowrite.ts +62 -0
  285. package/src/tool/tool.ts +162 -0
  286. package/src/tool/tools.ts +13 -0
  287. package/src/tool/webfetch.ts +218 -0
  288. package/src/tool/websearch.ts +260 -0
  289. package/src/tool/write.ts +101 -0
  290. package/src/tool-output-store.ts +211 -0
  291. package/src/util/array.ts +10 -0
  292. package/src/util/binary.ts +41 -0
  293. package/src/util/effect-flock.ts +284 -0
  294. package/src/util/encode.ts +51 -0
  295. package/src/util/error.ts +70 -0
  296. package/src/util/flock.ts +358 -0
  297. package/src/util/glob.ts +34 -0
  298. package/src/util/hash.ts +11 -0
  299. package/src/util/identifier.ts +1 -0
  300. package/src/util/iife.ts +3 -0
  301. package/src/util/lazy.ts +11 -0
  302. package/src/util/module.ts +10 -0
  303. package/src/util/path.ts +37 -0
  304. package/src/util/retry.ts +42 -0
  305. package/src/util/slug.ts +74 -0
  306. package/src/util/token.ts +5 -0
  307. package/src/util/which.ts +14 -0
  308. package/src/util/wildcard.ts +14 -0
  309. package/src/v1/config/agent.ts +89 -0
  310. package/src/v1/config/attachment.ts +25 -0
  311. package/src/v1/config/command.ts +13 -0
  312. package/src/v1/config/config.ts +192 -0
  313. package/src/v1/config/console-state.ts +16 -0
  314. package/src/v1/config/error.ts +39 -0
  315. package/src/v1/config/formatter.ts +13 -0
  316. package/src/v1/config/layout.ts +6 -0
  317. package/src/v1/config/lsp.ts +80 -0
  318. package/src/v1/config/mcp.ts +63 -0
  319. package/src/v1/config/migrate.ts +254 -0
  320. package/src/v1/config/permission.ts +50 -0
  321. package/src/v1/config/plugin.ts +9 -0
  322. package/src/v1/config/provider-options.ts +227 -0
  323. package/src/v1/config/provider.ts +121 -0
  324. package/src/v1/config/server.ts +19 -0
  325. package/src/v1/config/skills.ts +13 -0
  326. package/src/v1/permission.ts +33 -0
  327. package/src/v1/session.ts +68 -0
  328. package/src/v2-schema.ts +3 -0
  329. package/src/workspace.ts +6 -0
  330. package/sst-env.d.ts +10 -0
  331. package/test/agent.test.ts +131 -0
  332. package/test/application-tools.test.ts +287 -0
  333. package/test/background-job.test.ts +106 -0
  334. package/test/catalog.test.ts +353 -0
  335. package/test/command.test.ts +56 -0
  336. package/test/config/agent.test.ts +349 -0
  337. package/test/config/command.test.ts +83 -0
  338. package/test/config/config.test.ts +798 -0
  339. package/test/config/fixtures/plugin/directory-plugin.ts +13 -0
  340. package/test/config/plugin.test.ts +248 -0
  341. package/test/config/provider-options.test.ts +224 -0
  342. package/test/config/provider.test.ts +269 -0
  343. package/test/config/skill.test.ts +80 -0
  344. package/test/credential.test.ts +36 -0
  345. package/test/database-migration.test.ts +644 -0
  346. package/test/effect/cross-spawn-spawner.test.ts +426 -0
  347. package/test/effect/keyed-mutex.test.ts +73 -0
  348. package/test/effect/layer-node/layer-node-types.test.ts +143 -0
  349. package/test/effect/layer-node/layer-node.test.ts +261 -0
  350. package/test/effect/layer-node/node-build.test.ts +125 -0
  351. package/test/effect/observability.test.ts +109 -0
  352. package/test/event.test.ts +1124 -0
  353. package/test/file-mutation.test.ts +368 -0
  354. package/test/filesystem/filesystem.test.ts +387 -0
  355. package/test/filesystem/ignore.test.ts +10 -0
  356. package/test/filesystem/search.test.ts +44 -0
  357. package/test/filesystem/watcher.test.ts +266 -0
  358. package/test/fixture/effect-flock-worker.ts +60 -0
  359. package/test/fixture/flock-worker.ts +72 -0
  360. package/test/fixture/git.ts +49 -0
  361. package/test/fixture/location.ts +26 -0
  362. package/test/fixture/tmpdir.ts +25 -0
  363. package/test/fixtures/recordings/session-runner/openai-chat-streams-text.json +27 -0
  364. package/test/git.test.ts +164 -0
  365. package/test/github-copilot/convert-to-copilot-messages.test.ts +523 -0
  366. package/test/github-copilot/copilot-chat-model.test.ts +592 -0
  367. package/test/github-copilot/openai-responses-language-model.test.ts +206 -0
  368. package/test/global.test.ts +16 -0
  369. package/test/instruction-context.test.ts +323 -0
  370. package/test/integration.test.ts +349 -0
  371. package/test/legacy-event-schema.test.ts +16 -0
  372. package/test/lib/effect.ts +53 -0
  373. package/test/lib/tool.ts +20 -0
  374. package/test/location-filesystem.test.ts +69 -0
  375. package/test/location-layer.test.ts +226 -0
  376. package/test/location-mutation.test.ts +178 -0
  377. package/test/location.test.ts +42 -0
  378. package/test/model.test.ts +23 -0
  379. package/test/models.test.ts +290 -0
  380. package/test/move-session.test.ts +235 -0
  381. package/test/npm-config.test.ts +51 -0
  382. package/test/npm.test.ts +84 -0
  383. package/test/oauth-page.test.ts +15 -0
  384. package/test/patch.test.ts +68 -0
  385. package/test/permission.test.ts +315 -0
  386. package/test/plugin/command.test.ts +47 -0
  387. package/test/plugin/fixture.ts +52 -0
  388. package/test/plugin/fixtures/config-effect-plugin.ts +15 -0
  389. package/test/plugin/fixtures/config-promise-plugin.ts +13 -0
  390. package/test/plugin/fixtures/invalid-plugin.ts +1 -0
  391. package/test/plugin/fixtures/models-dev.json +14 -0
  392. package/test/plugin/fixtures/provider-factory.ts +9 -0
  393. package/test/plugin/host.ts +303 -0
  394. package/test/plugin/models-dev.test.ts +170 -0
  395. package/test/plugin/promise.test.ts +67 -0
  396. package/test/plugin/provider-alibaba.test.ts +92 -0
  397. package/test/plugin/provider-amazon-bedrock.test.ts +622 -0
  398. package/test/plugin/provider-anthropic.test.ts +94 -0
  399. package/test/plugin/provider-azure-cognitive-services.test.ts +199 -0
  400. package/test/plugin/provider-azure.test.ts +293 -0
  401. package/test/plugin/provider-cerebras.test.ts +136 -0
  402. package/test/plugin/provider-cloudflare-ai-gateway.test.ts +426 -0
  403. package/test/plugin/provider-cloudflare-workers-ai.test.ts +279 -0
  404. package/test/plugin/provider-cohere.test.ts +123 -0
  405. package/test/plugin/provider-deepinfra.test.ts +159 -0
  406. package/test/plugin/provider-dynamic.test.ts +184 -0
  407. package/test/plugin/provider-gateway.test.ts +115 -0
  408. package/test/plugin/provider-github-copilot.test.ts +278 -0
  409. package/test/plugin/provider-gitlab.test.ts +308 -0
  410. package/test/plugin/provider-google-vertex-anthropic.test.ts +264 -0
  411. package/test/plugin/provider-google-vertex.test.ts +387 -0
  412. package/test/plugin/provider-google.test.ts +80 -0
  413. package/test/plugin/provider-groq.test.ts +121 -0
  414. package/test/plugin/provider-kilo.test.ts +99 -0
  415. package/test/plugin/provider-llmgateway.test.ts +80 -0
  416. package/test/plugin/provider-mistral.test.ts +129 -0
  417. package/test/plugin/provider-nvidia.test.ts +97 -0
  418. package/test/plugin/provider-openai-compatible.test.ts +107 -0
  419. package/test/plugin/provider-openai.test.ts +176 -0
  420. package/test/plugin/provider-opencode.test.ts +423 -0
  421. package/test/plugin/provider-openrouter.test.ts +113 -0
  422. package/test/plugin/provider-perplexity.test.ts +122 -0
  423. package/test/plugin/provider-sap-ai-core.test.ts +159 -0
  424. package/test/plugin/provider-snowflake-cortex.test.ts +261 -0
  425. package/test/plugin/provider-togetherai.test.ts +129 -0
  426. package/test/plugin/provider-venice.test.ts +115 -0
  427. package/test/plugin/provider-vercel.test.ts +83 -0
  428. package/test/plugin/provider-xai.test.ts +125 -0
  429. package/test/plugin/provider-zenmux.test.ts +110 -0
  430. package/test/plugin/skill.test.ts +25 -0
  431. package/test/plugin/variant.test.ts +67 -0
  432. package/test/plugin.test.ts +71 -0
  433. package/test/policy.test.ts +85 -0
  434. package/test/preload.ts +5 -0
  435. package/test/process/process.test.ts +368 -0
  436. package/test/project-copy.test.ts +400 -0
  437. package/test/project-directories.test.ts +61 -0
  438. package/test/project.test.ts +221 -0
  439. package/test/provider-mistral.test.ts +282 -0
  440. package/test/provider-xai-responses.test.ts +32 -0
  441. package/test/pty/info-schema.test.ts +32 -0
  442. package/test/pty/protocol.test.ts +27 -0
  443. package/test/pty/pty-session.test.ts +240 -0
  444. package/test/pty/ticket.test.ts +62 -0
  445. package/test/question.test.ts +114 -0
  446. package/test/reference-guidance.test.ts +76 -0
  447. package/test/reference.test.ts +78 -0
  448. package/test/repository-cache.test.ts +153 -0
  449. package/test/repository.test.ts +71 -0
  450. package/test/ripgrep.test.ts +65 -0
  451. package/test/session-compaction.test.ts +27 -0
  452. package/test/session-create.test.ts +425 -0
  453. package/test/session-history.test.ts +165 -0
  454. package/test/session-projector.test.ts +533 -0
  455. package/test/session-prompt.test.ts +584 -0
  456. package/test/session-run-coordinator.test.ts +418 -0
  457. package/test/session-runner-message.test.ts +501 -0
  458. package/test/session-runner-model.test.ts +347 -0
  459. package/test/session-runner-recorded.test.ts +193 -0
  460. package/test/session-runner-tool-events.test.ts +136 -0
  461. package/test/session-runner-tool-registry.test.ts +452 -0
  462. package/test/session-runner.test.ts +3365 -0
  463. package/test/session-todo.test.ts +94 -0
  464. package/test/session-tool-progress.test.ts +158 -0
  465. package/test/shared-schema.test.ts +206 -0
  466. package/test/shell.test.ts +108 -0
  467. package/test/skill/guidance.test.ts +144 -0
  468. package/test/skill-discovery.test.ts +165 -0
  469. package/test/skill.test.ts +125 -0
  470. package/test/snapshot.test.ts +178 -0
  471. package/test/state.test.ts +115 -0
  472. package/test/system-context/builtins.test.ts +129 -0
  473. package/test/system-context/index.test.ts +307 -0
  474. package/test/system-context/registry.test.ts +114 -0
  475. package/test/tool-apply-patch.test.ts +436 -0
  476. package/test/tool-bash.test.ts +437 -0
  477. package/test/tool-edit.test.ts +434 -0
  478. package/test/tool-output-store.test.ts +247 -0
  479. package/test/tool-question.test.ts +162 -0
  480. package/test/tool-read-filesystem.test.ts +118 -0
  481. package/test/tool-read.test.ts +674 -0
  482. package/test/tool-skill.test.ts +149 -0
  483. package/test/tool-todowrite.test.ts +125 -0
  484. package/test/tool-webfetch.test.ts +281 -0
  485. package/test/tool-websearch.test.ts +316 -0
  486. package/test/tool-write.test.ts +305 -0
  487. package/test/util/effect-flock.test.ts +392 -0
  488. package/test/util/flock.test.ts +428 -0
  489. package/test/util/which.test.ts +100 -0
  490. package/tsconfig.json +7 -0
@@ -0,0 +1,674 @@
1
+ import { beforeEach, describe, expect } from "bun:test"
2
+ import path from "path"
3
+ import { Effect, Exit, Layer, PlatformError } from "effect"
4
+ import { Config } from "@neurocode-ai/core/config"
5
+ import { ConfigAttachments } from "@neurocode-ai/core/config/attachments"
6
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
7
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
8
+ import { FileSystem } from "@neurocode-ai/core/filesystem"
9
+ import { FSUtil } from "@neurocode-ai/core/fs-util"
10
+ import { Location } from "@neurocode-ai/core/location"
11
+ import { Image } from "@neurocode-ai/core/image"
12
+ import { PermissionV2 } from "@neurocode-ai/core/permission"
13
+ import { SessionV2 } from "@neurocode-ai/core/session"
14
+ import { AbsolutePath } from "@neurocode-ai/core/schema"
15
+ import { Global } from "@neurocode-ai/core/global"
16
+ import { LocationMutation } from "@neurocode-ai/core/location-mutation"
17
+ import { location } from "./fixture/location"
18
+ import { ToolRegistry } from "@neurocode-ai/core/tool/registry"
19
+ import { ToolOutputStore } from "@neurocode-ai/core/tool-output-store"
20
+ import { ReadTool } from "@neurocode-ai/core/tool/read"
21
+ import { ReadToolFileSystem } from "@neurocode-ai/core/tool/read-filesystem"
22
+ import { testEffect } from "./lib/effect"
23
+ import { toolIdentity, executeTool, settleTool, toolDefinitions } from "./lib/tool"
24
+
25
+ const assertions: PermissionV2.AssertInput[] = []
26
+ const missingPath = "__missing_read_target__.txt"
27
+ const missingAbsolutePath = path.join(process.cwd(), missingPath)
28
+ const readCalls: {
29
+ input: AbsolutePath
30
+ page: ReadToolFileSystem.PageInput
31
+ }[] = []
32
+ const listCalls: ReadToolFileSystem.PageInput[] = []
33
+ let resolvedType: "file" | "directory" = "file"
34
+ let resolveFailure: unknown
35
+ let readResult: FileSystem.Content | ReadToolFileSystem.TextPage = {
36
+ uri: "file:///README.md",
37
+ name: "README.md",
38
+ content: "hello",
39
+ encoding: "utf8",
40
+ mime: "text/plain",
41
+ }
42
+ let readFailure: ReadToolFileSystem.ReadError | undefined
43
+ let configEntries: Config.Entry[] = []
44
+ const reader = Layer.succeed(
45
+ ReadToolFileSystem.Service,
46
+ ReadToolFileSystem.Service.of({
47
+ inspect: () => (resolveFailure === undefined ? Effect.succeed(resolvedType) : Effect.die(resolveFailure)),
48
+ read: (input, _resource, page = {}) => {
49
+ readCalls.push({ input, page })
50
+ if (readFailure !== undefined) return Effect.fail(readFailure)
51
+ return Effect.succeed(readResult)
52
+ },
53
+ list: (_path, input = {}) =>
54
+ Effect.sync(() => {
55
+ listCalls.push(input)
56
+ return new ReadToolFileSystem.ListPage({ entries: [], truncated: false })
57
+ }),
58
+ }),
59
+ )
60
+ let allow = true
61
+ const permission = Layer.succeed(
62
+ PermissionV2.Service,
63
+ PermissionV2.Service.of({
64
+ assert: (input) =>
65
+ Effect.sync(() => {
66
+ assertions.push(input)
67
+ }).pipe(Effect.andThen(allow ? Effect.void : Effect.fail(new PermissionV2.BlockedError({ rules: [] })))),
68
+ ask: () => Effect.die("unused"),
69
+ reply: () => Effect.die("unused"),
70
+ get: () => Effect.die("unused"),
71
+ forSession: () => Effect.die("unused"),
72
+ list: () => Effect.die("unused"),
73
+ }),
74
+ )
75
+ const config = Layer.succeed(Config.Service, Config.Service.of({ entries: () => Effect.succeed(configEntries) }))
76
+ const imageLayer = AppNodeBuilder.build(Image.node, [[Config.node, config]])
77
+ const testFileSystem = Layer.effect(
78
+ FSUtil.Service,
79
+ FSUtil.Service.use((fs) =>
80
+ Effect.succeed(
81
+ FSUtil.Service.of({
82
+ ...fs,
83
+ realPath: (path) =>
84
+ path === missingAbsolutePath
85
+ ? Effect.fail(
86
+ PlatformError.systemError({
87
+ _tag: "NotFound",
88
+ module: "FileSystem",
89
+ method: "realPath",
90
+ pathOrDescriptor: path,
91
+ }),
92
+ )
93
+ : Effect.succeed(path),
94
+ }),
95
+ ),
96
+ ),
97
+ ).pipe(Layer.provide(LayerNode.compile(FSUtil.node)))
98
+ const locationLayer = Layer.succeed(
99
+ Location.Service,
100
+ Location.Service.of(location({ directory: AbsolutePath.make(process.cwd()) })),
101
+ )
102
+ const mutation = Layer.succeed(
103
+ LocationMutation.Service,
104
+ LocationMutation.Service.of({
105
+ resolve: (input) => {
106
+ if (input.path === missingPath)
107
+ return Effect.fail(new LocationMutation.PathError({ path: input.path, reason: "non_directory_ancestor" }))
108
+ const canonical = path.resolve(process.cwd(), input.path)
109
+ const external = path.isAbsolute(input.path) && !FSUtil.contains(process.cwd(), canonical)
110
+ const resource = external ? canonical.replaceAll("\\", "/") : path.relative(process.cwd(), canonical) || "."
111
+ const directory = path.dirname(canonical)
112
+ const externalResource = path.join(directory, "*").replaceAll("\\", "/")
113
+ return Effect.succeed({
114
+ canonical,
115
+ resource,
116
+ externalDirectory: external
117
+ ? {
118
+ action: "external_directory" as const,
119
+ directory,
120
+ resource: externalResource,
121
+ save: externalResource,
122
+ }
123
+ : undefined,
124
+ })
125
+ },
126
+ }),
127
+ )
128
+ const unavailableImage = Layer.succeed(
129
+ Image.Service,
130
+ Image.Service.of({ normalize: () => Effect.fail(new Image.ResizerUnavailableError()) }),
131
+ )
132
+ const readLayer = (imageLayer: Layer.Layer<Image.Service>) =>
133
+ AppNodeBuilder.build(LayerNode.group([ToolRegistry.node, ToolRegistry.toolsNode, ReadTool.node]), [
134
+ [ReadToolFileSystem.node, reader],
135
+ [PermissionV2.node, permission],
136
+ [Config.node, config],
137
+ [Image.node, imageLayer],
138
+ [LocationMutation.node, mutation],
139
+ [FSUtil.node, testFileSystem],
140
+ [Location.node, locationLayer],
141
+ [Global.node, Global.layerWith({ data: Global.Path.data })],
142
+ [ToolOutputStore.node, ToolOutputStore.nodeWithoutConfig],
143
+ ])
144
+ const it = testEffect(readLayer(imageLayer))
145
+ const itWithoutResizer = testEffect(readLayer(unavailableImage))
146
+ const sessionID = SessionV2.ID.make("ses_read_tool_test")
147
+
148
+ describe("ReadTool", () => {
149
+ beforeEach(() => {
150
+ assertions.length = 0
151
+ readCalls.length = 0
152
+ listCalls.length = 0
153
+ allow = true
154
+ resolvedType = "file"
155
+ resolveFailure = undefined
156
+ readResult = {
157
+ uri: "file:///README.md",
158
+ name: "README.md",
159
+ content: "hello",
160
+ encoding: "utf8",
161
+ mime: "text/plain",
162
+ }
163
+ readFailure = undefined
164
+ configEntries = []
165
+ })
166
+
167
+ it.effect("registers, authorizes, and reads through the location filesystem", () =>
168
+ Effect.gen(function* () {
169
+ const registry = yield* ToolRegistry.Service
170
+
171
+ expect(yield* toolDefinitions(registry)).toMatchObject([{ name: "read" }])
172
+ expect(yield* toolDefinitions(registry, [{ action: "read", resource: "*", effect: "deny" }])).toEqual([])
173
+ expect(
174
+ yield* executeTool(registry, {
175
+ sessionID,
176
+ ...toolIdentity,
177
+ call: { type: "tool-call", id: "call-read", name: "read", input: { path: "README.md" } },
178
+ }),
179
+ ).toEqual({
180
+ type: "json",
181
+ value: {
182
+ uri: "file:///README.md",
183
+ name: "README.md",
184
+ content: "hello",
185
+ encoding: "utf8",
186
+ mime: "text/plain",
187
+ },
188
+ })
189
+ expect(assertions).toMatchObject([{ sessionID, action: "read", resources: ["README.md"], save: ["*"] }])
190
+ expect(readCalls).toEqual([
191
+ {
192
+ input: AbsolutePath.make(path.join(process.cwd(), "README.md")),
193
+ page: { offset: undefined, limit: undefined },
194
+ },
195
+ ])
196
+ }),
197
+ )
198
+
199
+ it.effect("asks for external_directory approval before reading an external absolute path", () =>
200
+ Effect.gen(function* () {
201
+ const registry = yield* ToolRegistry.Service
202
+ const external = path.join(path.parse(process.cwd()).root, "external-read", "notes.txt")
203
+
204
+ expect(
205
+ yield* executeTool(registry, {
206
+ sessionID,
207
+ ...toolIdentity,
208
+ call: { type: "tool-call", id: "call-external-read", name: "read", input: { path: external } },
209
+ }),
210
+ ).toMatchObject({ type: "json" })
211
+ expect(assertions).toMatchObject([
212
+ {
213
+ sessionID,
214
+ action: "external_directory",
215
+ resources: [path.join(path.dirname(external), "*").replaceAll("\\", "/")],
216
+ },
217
+ { sessionID, action: "read", resources: [external.replaceAll("\\", "/")], save: ["*"] },
218
+ ])
219
+ expect(readCalls).toEqual([{ input: AbsolutePath.make(external), page: { offset: undefined, limit: undefined } }])
220
+ }),
221
+ )
222
+
223
+ it.effect("returns a small PNG as native media instead of durable base64 text", () =>
224
+ Effect.gen(function* () {
225
+ const png = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
226
+ readResult = {
227
+ uri: "file:///pixel.png",
228
+ name: "pixel.png",
229
+ content: png,
230
+ encoding: "base64",
231
+ mime: "image/png",
232
+ }
233
+ const registry = yield* ToolRegistry.Service
234
+
235
+ expect(
236
+ yield* executeTool(registry, {
237
+ sessionID,
238
+ ...toolIdentity,
239
+ call: { type: "tool-call", id: "call-image", name: "read", input: { path: "pixel.png" } },
240
+ }),
241
+ ).toEqual({
242
+ type: "content",
243
+ value: [
244
+ { type: "text", text: "Image read successfully" },
245
+ { type: "file", uri: `data:image/png;base64,${png}`, mime: "image/png", name: "pixel.png" },
246
+ ],
247
+ })
248
+ expect(readCalls).toEqual([
249
+ {
250
+ input: AbsolutePath.make(path.join(process.cwd(), "pixel.png")),
251
+ page: { offset: undefined, limit: undefined },
252
+ },
253
+ ])
254
+
255
+ const settled = yield* settleTool(registry, {
256
+ sessionID,
257
+ ...toolIdentity,
258
+ call: { type: "tool-call", id: "call-image-settle", name: "read", input: { path: "pixel.png" } },
259
+ })
260
+ expect(settled.output?.structured).toMatchObject({
261
+ uri: "file:///pixel.png",
262
+ name: "pixel.png",
263
+ mime: "image/png",
264
+ encoding: "base64",
265
+ })
266
+ expect(settled.output?.content).toMatchObject([
267
+ { type: "text", text: "Image read successfully" },
268
+ { type: "file", mime: "image/png", uri: `data:image/png;base64,${png}` },
269
+ ])
270
+ }),
271
+ )
272
+
273
+ it.effect("preserves a PNG above the generic text limit as native media", () =>
274
+ Effect.gen(function* () {
275
+ const photon = yield* Effect.promise(() => import("@silvia-odwyer/photon-node"))
276
+ const pixels = Uint8Array.from({ length: 256 * 256 * 4 }, (_, index) => (index * 73 + (index >> 3)) % 256)
277
+ const source = new photon.PhotonImage(pixels, 256, 256)
278
+ const png = Buffer.from(source.get_bytes()).toString("base64")
279
+ source.free()
280
+ expect(Buffer.byteLength(png)).toBeGreaterThan(50 * 1024)
281
+ readResult = {
282
+ uri: "file:///large.png",
283
+ name: "large.png",
284
+ content: png,
285
+ encoding: "base64",
286
+ mime: "image/png",
287
+ }
288
+ const registry = yield* ToolRegistry.Service
289
+
290
+ const settled = yield* settleTool(registry, {
291
+ sessionID,
292
+ ...toolIdentity,
293
+ call: { type: "tool-call", id: "call-large-image", name: "read", input: { path: "large.png" } },
294
+ })
295
+
296
+ expect(settled.outputPaths).toBeUndefined()
297
+ expect(settled.output?.structured).toMatchObject({
298
+ uri: "file:///large.png",
299
+ name: "large.png",
300
+ mime: "image/png",
301
+ encoding: "base64",
302
+ })
303
+ expect(settled.result).toEqual({
304
+ type: "content",
305
+ value: [
306
+ { type: "text", text: "Image read successfully" },
307
+ { type: "file", uri: `data:image/png;base64,${png}`, mime: "image/png", name: "large.png" },
308
+ ],
309
+ })
310
+ }),
311
+ )
312
+
313
+ itWithoutResizer.effect("returns the original image when the resizer is unavailable", () =>
314
+ Effect.gen(function* () {
315
+ const png = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
316
+ readResult = {
317
+ uri: "file:///pixel.png",
318
+ name: "pixel.png",
319
+ content: png,
320
+ encoding: "base64",
321
+ mime: "image/png",
322
+ }
323
+ const registry = yield* ToolRegistry.Service
324
+
325
+ expect(
326
+ yield* executeTool(registry, {
327
+ sessionID,
328
+ ...toolIdentity,
329
+ call: { type: "tool-call", id: "call-image-fallback", name: "read", input: { path: "pixel.png" } },
330
+ }),
331
+ ).toMatchObject({
332
+ type: "content",
333
+ value: [{ type: "text" }, { type: "file", uri: `data:image/png;base64,${png}`, mime: "image/png" }],
334
+ })
335
+ }),
336
+ )
337
+
338
+ it.effect("rejects invalid image data returned by the filesystem", () =>
339
+ Effect.gen(function* () {
340
+ readResult = {
341
+ uri: "file:///truncated.png",
342
+ name: "truncated.png",
343
+ content: "iVBORw0KGgo=",
344
+ encoding: "base64",
345
+ mime: "image/png",
346
+ }
347
+ const registry = yield* ToolRegistry.Service
348
+
349
+ expect(
350
+ yield* executeTool(registry, {
351
+ sessionID,
352
+ ...toolIdentity,
353
+ call: { type: "tool-call", id: "call-truncated-image", name: "read", input: { path: "truncated.png" } },
354
+ }),
355
+ ).toEqual({ type: "error", value: "Image could not be decoded: truncated.png" })
356
+ }),
357
+ )
358
+
359
+ it.effect("rejects oversized images when resizing is disabled", () =>
360
+ Effect.gen(function* () {
361
+ const photon = yield* Effect.promise(() => import("@silvia-odwyer/photon-node"))
362
+ const source = new photon.PhotonImage(new Uint8Array(Array.from({ length: 16 * 4 }, () => 255)), 16, 1)
363
+ const base64 = Buffer.from(source.get_bytes()).toString("base64")
364
+ source.free()
365
+ readResult = {
366
+ uri: "file:///wide.png",
367
+ name: "wide.png",
368
+ content: base64,
369
+ encoding: "base64",
370
+ mime: "image/png",
371
+ }
372
+ configEntries = [
373
+ new Config.Document({
374
+ type: "document",
375
+ info: new Config.Info({
376
+ attachments: new ConfigAttachments.Info({
377
+ image: new ConfigAttachments.Image({ auto_resize: false, max_width: 4 }),
378
+ }),
379
+ }),
380
+ }),
381
+ ]
382
+ const registry = yield* ToolRegistry.Service
383
+ const result = yield* executeTool(registry, {
384
+ sessionID,
385
+ ...toolIdentity,
386
+ call: { type: "tool-call", id: "call-wide-image", name: "read", input: { path: "wide.png" } },
387
+ })
388
+
389
+ expect(result.type).toBe("error")
390
+ if (result.type === "error") expect(result.value).toContain("exceeding configured limits 4x2000")
391
+ }),
392
+ )
393
+
394
+ it.effect("resizes images to configured dimensions before returning media", () =>
395
+ Effect.gen(function* () {
396
+ const photon = yield* Effect.promise(() => import("@silvia-odwyer/photon-node"))
397
+ const source = new photon.PhotonImage(new Uint8Array(Array.from({ length: 16 * 4 }, () => 255)), 16, 1)
398
+ const base64 = Buffer.from(source.get_bytes()).toString("base64")
399
+ source.free()
400
+ readResult = {
401
+ uri: "file:///wide.png",
402
+ name: "wide.png",
403
+ content: base64,
404
+ encoding: "base64",
405
+ mime: "image/png",
406
+ }
407
+ configEntries = [
408
+ new Config.Document({
409
+ type: "document",
410
+ info: new Config.Info({
411
+ attachments: new ConfigAttachments.Info({ image: new ConfigAttachments.Image({ max_width: 4 }) }),
412
+ }),
413
+ }),
414
+ ]
415
+ const registry = yield* ToolRegistry.Service
416
+ const result = yield* executeTool(registry, {
417
+ sessionID,
418
+ ...toolIdentity,
419
+ call: { type: "tool-call", id: "call-resize-image", name: "read", input: { path: "wide.png" } },
420
+ })
421
+
422
+ expect(result.type).toBe("content")
423
+ if (result.type !== "content") return
424
+ const media = result.value[1]
425
+ expect(media?.type).toBe("file")
426
+ if (media?.type !== "file") return
427
+ const resized = photon.PhotonImage.new_from_byteslice(Buffer.from(media.uri.split(",")[1] ?? "", "base64"))
428
+ expect(resized.get_width()).toBeLessThanOrEqual(4)
429
+ expect(resized.get_height()).toBeLessThanOrEqual(2_000)
430
+ resized.free()
431
+ }),
432
+ )
433
+
434
+ it.effect("enforces max base64 bytes after resize attempts", () =>
435
+ Effect.gen(function* () {
436
+ const png = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
437
+ readResult = {
438
+ uri: "file:///pixel.png",
439
+ name: "pixel.png",
440
+ content: png,
441
+ encoding: "base64",
442
+ mime: "image/png",
443
+ }
444
+ configEntries = [
445
+ new Config.Document({
446
+ type: "document",
447
+ info: new Config.Info({
448
+ attachments: new ConfigAttachments.Info({
449
+ image: new ConfigAttachments.Image({ max_base64_bytes: 1 }),
450
+ }),
451
+ }),
452
+ }),
453
+ ]
454
+ const registry = yield* ToolRegistry.Service
455
+ const result = yield* executeTool(registry, {
456
+ sessionID,
457
+ ...toolIdentity,
458
+ call: { type: "tool-call", id: "call-max-bytes", name: "read", input: { path: "pixel.png" } },
459
+ })
460
+
461
+ expect(result.type).toBe("error")
462
+ if (result.type === "error") expect(result.value).toContain("/1 bytes")
463
+ }),
464
+ )
465
+
466
+ it.effect("returns supported image contents despite a misleading binary extension", () =>
467
+ Effect.gen(function* () {
468
+ const png = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII="
469
+ readResult = {
470
+ uri: "file:///pixel.bin",
471
+ name: "pixel.bin",
472
+ content: png,
473
+ encoding: "base64",
474
+ mime: "image/png",
475
+ }
476
+ const registry = yield* ToolRegistry.Service
477
+
478
+ expect(
479
+ yield* executeTool(registry, {
480
+ sessionID,
481
+ ...toolIdentity,
482
+ call: { type: "tool-call", id: "call-disguised-image", name: "read", input: { path: "pixel.bin" } },
483
+ }),
484
+ ).toMatchObject({
485
+ type: "content",
486
+ value: [{ type: "text" }, { type: "file", mime: "image/png", name: "pixel.bin" }],
487
+ })
488
+ }),
489
+ )
490
+
491
+ it.effect("returns expected filesystem failures to the model", () =>
492
+ Effect.gen(function* () {
493
+ readFailure = new ReadToolFileSystem.BinaryFileError({ resource: "archive.dat" })
494
+ const registry = yield* ToolRegistry.Service
495
+
496
+ expect(
497
+ yield* executeTool(registry, {
498
+ sessionID,
499
+ ...toolIdentity,
500
+ call: {
501
+ type: "tool-call",
502
+ id: "call-binary",
503
+ name: "read",
504
+ input: { path: "archive.dat", offset: 2, limit: 1 },
505
+ },
506
+ }),
507
+ ).toEqual({ type: "error", value: "Cannot read binary file: archive.dat" })
508
+ expect(readCalls).toEqual([
509
+ { input: AbsolutePath.make(path.join(process.cwd(), "archive.dat")), page: { offset: 2, limit: 1 } },
510
+ ])
511
+ }),
512
+ )
513
+
514
+ it.effect("preserves unexpected filesystem defects", () =>
515
+ Effect.gen(function* () {
516
+ resolveFailure = new Error("unexpected")
517
+ const registry = yield* ToolRegistry.Service
518
+
519
+ expect(
520
+ Exit.isFailure(
521
+ yield* executeTool(registry, {
522
+ sessionID,
523
+ ...toolIdentity,
524
+ call: { type: "tool-call", id: "call-defect", name: "read", input: { path: "README.md" } },
525
+ }).pipe(Effect.exit),
526
+ ),
527
+ ).toBe(true)
528
+ }),
529
+ )
530
+
531
+ it.effect("does not read when permission is denied", () =>
532
+ Effect.gen(function* () {
533
+ allow = false
534
+ const registry = yield* ToolRegistry.Service
535
+
536
+ expect(
537
+ yield* executeTool(registry, {
538
+ sessionID,
539
+ ...toolIdentity,
540
+ call: { type: "tool-call", id: "call-read", name: "read", input: { path: "README.md" } },
541
+ }),
542
+ ).toEqual({ type: "error", value: "Unable to read README.md" })
543
+ expect(readCalls).toEqual([])
544
+ }),
545
+ )
546
+
547
+ it.effect("returns missing paths as model-visible tool failures", () =>
548
+ Effect.gen(function* () {
549
+ const registry = yield* ToolRegistry.Service
550
+
551
+ expect(
552
+ yield* executeTool(registry, {
553
+ sessionID,
554
+ ...toolIdentity,
555
+ call: { type: "tool-call", id: "call-missing-path", name: "read", input: { path: missingPath } },
556
+ }),
557
+ ).toEqual({ type: "error", value: `Unable to read ${missingPath}` })
558
+ expect(assertions).toEqual([])
559
+ expect(readCalls).toEqual([])
560
+ }),
561
+ )
562
+
563
+ it.effect("lists a bounded directory page through read", () =>
564
+ Effect.gen(function* () {
565
+ resolvedType = "directory"
566
+ const registry = yield* ToolRegistry.Service
567
+
568
+ expect(
569
+ yield* executeTool(registry, {
570
+ sessionID,
571
+ ...toolIdentity,
572
+ call: {
573
+ type: "tool-call",
574
+ id: "call-read-directory",
575
+ name: "read",
576
+ input: { path: "src", offset: 2, limit: 10 },
577
+ },
578
+ }),
579
+ ).toEqual({ type: "json", value: { entries: [], truncated: false } })
580
+ expect(assertions).toMatchObject([{ sessionID, action: "read", resources: ["src"], save: ["*"] }])
581
+ expect(listCalls).toEqual([{ offset: 2, limit: 10 }])
582
+ }),
583
+ )
584
+
585
+ it.effect("does not list a directory when permission is denied", () =>
586
+ Effect.gen(function* () {
587
+ allow = false
588
+ resolvedType = "directory"
589
+ const registry = yield* ToolRegistry.Service
590
+
591
+ expect(
592
+ yield* executeTool(registry, {
593
+ sessionID,
594
+ ...toolIdentity,
595
+ call: { type: "tool-call", id: "call-read-directory-denied", name: "read", input: { path: "src" } },
596
+ }),
597
+ ).toEqual({ type: "error", value: "Unable to read src" })
598
+ expect(listCalls).toEqual([])
599
+ }),
600
+ )
601
+
602
+ it.effect("preserves unexpected resolution defects", () =>
603
+ Effect.gen(function* () {
604
+ const registry = yield* ToolRegistry.Service
605
+
606
+ resolveFailure = new Error("missing")
607
+ expect(
608
+ Exit.isFailure(
609
+ yield* executeTool(registry, {
610
+ sessionID,
611
+ ...toolIdentity,
612
+ call: { type: "tool-call", id: "call-missing", name: "read", input: { path: "missing.txt" } },
613
+ }).pipe(Effect.exit),
614
+ ),
615
+ ).toBe(true)
616
+
617
+ expect(readCalls).toEqual([])
618
+ }),
619
+ )
620
+
621
+ it.effect("forwards pagination and returns bounded text pages with continuation", () =>
622
+ Effect.gen(function* () {
623
+ readResult = new ReadToolFileSystem.TextPage({
624
+ type: "text-page",
625
+ content: "hello",
626
+ mime: "text/plain",
627
+ offset: 2,
628
+ truncated: true,
629
+ next: 3,
630
+ })
631
+ const registry = yield* ToolRegistry.Service
632
+
633
+ expect(
634
+ yield* executeTool(registry, {
635
+ sessionID,
636
+ ...toolIdentity,
637
+ call: {
638
+ type: "tool-call",
639
+ id: "call-large",
640
+ name: "read",
641
+ input: { path: "large.txt", offset: 2, limit: 1 },
642
+ },
643
+ }),
644
+ ).toEqual({
645
+ type: "json",
646
+ value: { type: "text-page", content: "hello", mime: "text/plain", offset: 2, truncated: true, next: 3 },
647
+ })
648
+ expect(readCalls).toEqual([
649
+ { input: AbsolutePath.make(path.join(process.cwd(), "large.txt")), page: { offset: 2, limit: 1 } },
650
+ ])
651
+ }),
652
+ )
653
+
654
+ it.effect("rejects unsupported binary discovered by a direct read", () =>
655
+ Effect.gen(function* () {
656
+ readResult = {
657
+ uri: "file:///late-binary",
658
+ name: "late-binary",
659
+ content: "AAECAw==",
660
+ encoding: "base64",
661
+ mime: "application/octet-stream",
662
+ }
663
+ const registry = yield* ToolRegistry.Service
664
+
665
+ expect(
666
+ yield* executeTool(registry, {
667
+ sessionID,
668
+ ...toolIdentity,
669
+ call: { type: "tool-call", id: "call-direct-binary", name: "read", input: { path: "late-binary" } },
670
+ }),
671
+ ).toEqual({ type: "error", value: "Cannot read binary file: late-binary" })
672
+ }),
673
+ )
674
+ })