@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,434 @@
1
+ import fs from "fs/promises"
2
+ import path from "path"
3
+ import { fileURLToPath } from "url"
4
+ import { describe, expect, test } from "bun:test"
5
+ import { Effect, Layer } from "effect"
6
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
7
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
8
+ import { FileMutation } from "@neurocode-ai/core/file-mutation"
9
+ import { FSUtil } from "@neurocode-ai/core/fs-util"
10
+ import { Location } from "@neurocode-ai/core/location"
11
+ import { LocationMutation } from "@neurocode-ai/core/location-mutation"
12
+ import { PermissionV2 } from "@neurocode-ai/core/permission"
13
+ import { AbsolutePath } from "@neurocode-ai/core/schema"
14
+ import { SessionV2 } from "@neurocode-ai/core/session"
15
+ import { ToolRegistry } from "@neurocode-ai/core/tool/registry"
16
+ import { ToolOutputStore } from "@neurocode-ai/core/tool-output-store"
17
+ import { EditTool } from "@neurocode-ai/core/tool/edit"
18
+ import { location } from "./fixture/location"
19
+ import { tmpdir } from "./fixture/tmpdir"
20
+ import { testEffect } from "./lib/effect"
21
+ import { toolIdentity, executeTool, settleTool, toolDefinitions } from "./lib/tool"
22
+
23
+ const sessionID = SessionV2.ID.make("ses_edit_tool_test")
24
+ const assertions: PermissionV2.AssertInput[] = []
25
+ const writes: string[] = []
26
+ let reads = 0
27
+ let denyAction: string | undefined
28
+ let afterRead = (_target: string, _content: Uint8Array): Effect.Effect<void> => Effect.void
29
+
30
+ const permission = Layer.succeed(
31
+ PermissionV2.Service,
32
+ PermissionV2.Service.of({
33
+ assert: (input) =>
34
+ Effect.sync(() => assertions.push(input)).pipe(
35
+ Effect.andThen(
36
+ input.action === denyAction ? Effect.fail(new PermissionV2.BlockedError({ rules: [] })) : Effect.void,
37
+ ),
38
+ ),
39
+ ask: () => Effect.die("unused"),
40
+ reply: () => Effect.die("unused"),
41
+ get: () => Effect.die("unused"),
42
+ forSession: () => Effect.die("unused"),
43
+ list: () => Effect.die("unused"),
44
+ }),
45
+ )
46
+
47
+ const reset = () => {
48
+ assertions.length = 0
49
+ writes.length = 0
50
+ reads = 0
51
+ denyAction = undefined
52
+ afterRead = () => Effect.void
53
+ }
54
+
55
+ const filesystem = Layer.effect(
56
+ FSUtil.Service,
57
+ Effect.gen(function* () {
58
+ const fs = yield* FSUtil.Service
59
+ return FSUtil.Service.of({
60
+ ...fs,
61
+ readFile: (target) =>
62
+ fs
63
+ .readFile(target)
64
+ .pipe(
65
+ Effect.tap((content) =>
66
+ Effect.sync(() => reads++).pipe(Effect.andThen(Effect.suspend(() => afterRead(target, content)))),
67
+ ),
68
+ ),
69
+ writeWithDirs: (target, content, mode) =>
70
+ Effect.sync(() => writes.push(target)).pipe(Effect.andThen(fs.writeWithDirs(target, content, mode))),
71
+ writeFile: (target, content, options) =>
72
+ Effect.sync(() => writes.push(target)).pipe(Effect.andThen(fs.writeFile(target, content, options))),
73
+ writeFileString: (target, content, options) =>
74
+ Effect.sync(() => writes.push(target)).pipe(Effect.andThen(fs.writeFileString(target, content, options))),
75
+ })
76
+ }),
77
+ ).pipe(Layer.provide(LayerNode.compile(FSUtil.node)))
78
+
79
+ const withTool = <A, E, R>(directory: string, body: (registry: ToolRegistry.Interface) => Effect.Effect<A, E, R>) => {
80
+ const activeLocation = Layer.succeed(
81
+ Location.Service,
82
+ Location.Service.of(location({ directory: AbsolutePath.make(directory) })),
83
+ )
84
+ return Effect.gen(function* () {
85
+ return yield* body(yield* ToolRegistry.Service)
86
+ }).pipe(
87
+ Effect.provide(
88
+ AppNodeBuilder.build(
89
+ LayerNode.group([
90
+ ToolRegistry.node,
91
+ ToolRegistry.toolsNode,
92
+ LocationMutation.node,
93
+ FileMutation.node,
94
+ EditTool.node,
95
+ ]),
96
+ [
97
+ [FSUtil.node, filesystem],
98
+ [Location.node, activeLocation],
99
+ [PermissionV2.node, permission],
100
+ [ToolOutputStore.node, ToolOutputStore.nodeWithoutConfig],
101
+ ],
102
+ ),
103
+ ),
104
+ )
105
+ }
106
+
107
+ const call = (input: typeof EditTool.Input.Type, id = "call-edit") => ({
108
+ sessionID,
109
+ ...toolIdentity,
110
+ call: { type: "tool-call" as const, id, name: "edit", input },
111
+ })
112
+
113
+ const it = testEffect(Layer.empty)
114
+
115
+ describe("EditTool", () => {
116
+ it.live("registers and replaces relative exact text through FileMutation once", () =>
117
+ Effect.acquireUseRelease(
118
+ Effect.promise(() => tmpdir()),
119
+ (tmp) => {
120
+ reset()
121
+ const target = path.join(tmp.path, "hello.txt")
122
+ return Effect.promise(() => fs.writeFile(target, "before\nrest\n")).pipe(
123
+ Effect.andThen(
124
+ withTool(tmp.path, (registry) =>
125
+ Effect.gen(function* () {
126
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["edit"])
127
+ expect(yield* toolDefinitions(registry, [{ action: "edit", resource: "*", effect: "deny" }])).toEqual(
128
+ [],
129
+ )
130
+ const settled = yield* settleTool(
131
+ registry,
132
+ call({ path: "hello.txt", oldString: "before", newString: "after" }),
133
+ )
134
+ expect(settled.result).toEqual({
135
+ type: "text",
136
+ value: "Edited file successfully: hello.txt\nReplacements: 1\n```diff\n-before\n+after\n```",
137
+ })
138
+ expect(settled.output?.structured).toEqual({
139
+ replacements: 1,
140
+ files: [
141
+ {
142
+ file: "hello.txt",
143
+ status: "modified",
144
+ additions: 1,
145
+ deletions: 1,
146
+ patch: expect.stringContaining("-before\n+after"),
147
+ },
148
+ ],
149
+ })
150
+ expect(yield* Effect.promise(() => fs.readFile(target, "utf8"))).toBe("after\nrest\n")
151
+ expect(assertions).toMatchObject([{ sessionID, action: "edit", resources: ["hello.txt"], save: ["*"] }])
152
+ expect(writes).toEqual([yield* Effect.promise(() => fs.realpath(target))])
153
+ }),
154
+ ),
155
+ ),
156
+ )
157
+ },
158
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
159
+ ),
160
+ )
161
+
162
+ it.live("accepts an absolute file path inside the active Location", () =>
163
+ Effect.acquireUseRelease(
164
+ Effect.promise(() => tmpdir()),
165
+ (tmp) => {
166
+ reset()
167
+ const target = path.join(tmp.path, "absolute.txt")
168
+ return Effect.promise(() => fs.writeFile(target, "before")).pipe(
169
+ Effect.andThen(
170
+ withTool(tmp.path, (registry) =>
171
+ executeTool(registry, call({ path: target, oldString: "before", newString: "after" })),
172
+ ),
173
+ ),
174
+ Effect.andThen((result) =>
175
+ Effect.gen(function* () {
176
+ expect(result.type).toBe("text")
177
+ expect(assertions.map((input) => input.action)).toEqual(["edit"])
178
+ expect(yield* Effect.promise(() => fs.readFile(target, "utf8"))).toBe("after")
179
+ }),
180
+ ),
181
+ )
182
+ },
183
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
184
+ ),
185
+ )
186
+
187
+ it.live("approves an explicit external absolute path before edit", () =>
188
+ Effect.acquireUseRelease(
189
+ Effect.promise(() => Promise.all([tmpdir(), tmpdir()])),
190
+ ([active, outside]) => {
191
+ reset()
192
+ const target = path.join(outside.path, "external.txt")
193
+ return Effect.promise(() => fs.writeFile(target, "before")).pipe(
194
+ Effect.andThen(
195
+ withTool(active.path, (registry) =>
196
+ executeTool(registry, call({ path: target, oldString: "before", newString: "after" })),
197
+ ),
198
+ ),
199
+ Effect.andThen((result) =>
200
+ Effect.gen(function* () {
201
+ expect(result.type).toBe("text")
202
+ expect(assertions.map((input) => input.action)).toEqual(["external_directory", "edit"])
203
+ expect(yield* Effect.promise(() => fs.readFile(target, "utf8"))).toBe("after")
204
+ expect(writes).toHaveLength(1)
205
+ }),
206
+ ),
207
+ )
208
+ },
209
+ ([active, outside]) =>
210
+ Effect.promise(() =>
211
+ Promise.all([active[Symbol.asyncDispose](), outside[Symbol.asyncDispose]()]).then(() => undefined),
212
+ ),
213
+ ),
214
+ )
215
+
216
+ it.live("does not write when external_directory or edit approval is denied", () =>
217
+ Effect.acquireUseRelease(
218
+ Effect.promise(() => Promise.all([tmpdir(), tmpdir()])),
219
+ ([active, outside]) =>
220
+ Effect.gen(function* () {
221
+ const external = path.join(outside.path, "denied.txt")
222
+ yield* Effect.promise(() => fs.writeFile(external, "before"))
223
+ reset()
224
+ denyAction = "external_directory"
225
+ expect(
226
+ yield* withTool(active.path, (registry) =>
227
+ executeTool(registry, call({ path: external, oldString: "before", newString: "after" })),
228
+ ),
229
+ ).toEqual({
230
+ type: "error",
231
+ value: `Unable to edit ${external}`,
232
+ })
233
+ expect(assertions.map((input) => input.action)).toEqual(["external_directory"])
234
+ expect(reads).toBe(0)
235
+ expect(writes).toEqual([])
236
+
237
+ reset()
238
+ denyAction = "edit"
239
+ expect(
240
+ yield* withTool(active.path, (registry) =>
241
+ executeTool(registry, call({ path: external, oldString: "before", newString: "after" })),
242
+ ),
243
+ ).toEqual({
244
+ type: "error",
245
+ value: `Unable to edit ${external}`,
246
+ })
247
+ expect(assertions.map((input) => input.action)).toEqual(["external_directory", "edit"])
248
+ expect(reads).toBe(0)
249
+ expect(writes).toEqual([])
250
+ expect(yield* Effect.promise(() => fs.readFile(external, "utf8"))).toBe("before")
251
+ }),
252
+ ([active, outside]) =>
253
+ Effect.promise(() =>
254
+ Promise.all([active[Symbol.asyncDispose](), outside[Symbol.asyncDispose]()]).then(() => undefined),
255
+ ),
256
+ ),
257
+ )
258
+
259
+ it.live("denied edit reads no target content and does not disclose whether oldString matches", () =>
260
+ Effect.acquireUseRelease(
261
+ Effect.promise(() => tmpdir()),
262
+ (tmp) => {
263
+ reset()
264
+ denyAction = "edit"
265
+ const target = path.join(tmp.path, "secret.txt")
266
+ return Effect.promise(() => fs.writeFile(target, "secret content")).pipe(
267
+ Effect.andThen(
268
+ withTool(tmp.path, (registry) =>
269
+ Effect.gen(function* () {
270
+ const matching = yield* executeTool(
271
+ registry,
272
+ call({ path: "secret.txt", oldString: "secret content", newString: "replacement" }),
273
+ )
274
+ const missing = yield* executeTool(
275
+ registry,
276
+ call({ path: "secret.txt", oldString: "not present", newString: "replacement" }),
277
+ )
278
+
279
+ expect(matching).toEqual({ type: "error", value: "Unable to edit secret.txt" })
280
+ expect(missing).toEqual(matching)
281
+ expect(assertions.map((input) => input.action)).toEqual(["edit", "edit"])
282
+ expect(reads).toBe(0)
283
+ expect(writes).toEqual([])
284
+ }),
285
+ ),
286
+ ),
287
+ )
288
+ },
289
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
290
+ ),
291
+ )
292
+
293
+ it.live("rejects no-op, empty, missing, and ambiguous exact replacements", () =>
294
+ Effect.acquireUseRelease(
295
+ Effect.promise(() => tmpdir()),
296
+ (tmp) => {
297
+ reset()
298
+ const target = path.join(tmp.path, "matches.txt")
299
+ return Effect.promise(() => fs.writeFile(target, "same same")).pipe(
300
+ Effect.andThen(
301
+ withTool(tmp.path, (registry) =>
302
+ Effect.gen(function* () {
303
+ expect(
304
+ yield* executeTool(registry, call({ path: "matches.txt", oldString: "same", newString: "same" })),
305
+ ).toEqual({
306
+ type: "error",
307
+ value: "No changes to apply: oldString and newString are identical.",
308
+ })
309
+ expect(
310
+ yield* executeTool(registry, call({ path: "matches.txt", oldString: "", newString: "after" })),
311
+ ).toEqual({
312
+ type: "error",
313
+ value: "oldString must not be empty. Use write to create or overwrite a file.",
314
+ })
315
+ expect(
316
+ yield* executeTool(registry, call({ path: "matches.txt", oldString: "missing", newString: "after" })),
317
+ ).toEqual({
318
+ type: "error",
319
+ value:
320
+ "Could not find oldString in the file. It must match exactly, including whitespace and indentation.",
321
+ })
322
+ expect(
323
+ yield* executeTool(registry, call({ path: "matches.txt", oldString: "same", newString: "after" })),
324
+ ).toEqual({
325
+ type: "error",
326
+ value:
327
+ "Found multiple exact matches for oldString. Provide more surrounding context or set replaceAll to true.",
328
+ })
329
+ expect(writes).toEqual([])
330
+ }),
331
+ ),
332
+ ),
333
+ )
334
+ },
335
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
336
+ ),
337
+ )
338
+
339
+ it.live("replaces every exact occurrence when replaceAll is true", () =>
340
+ Effect.acquireUseRelease(
341
+ Effect.promise(() => tmpdir()),
342
+ (tmp) => {
343
+ reset()
344
+ const target = path.join(tmp.path, "all.txt")
345
+ return Effect.promise(() => fs.writeFile(target, "same same same")).pipe(
346
+ Effect.andThen(
347
+ withTool(tmp.path, (registry) =>
348
+ settleTool(registry, call({ path: "all.txt", oldString: "same", newString: "after", replaceAll: true })),
349
+ ),
350
+ ),
351
+ Effect.andThen((settled) =>
352
+ Effect.gen(function* () {
353
+ expect(settled.output?.structured).toMatchObject({ replacements: 3 })
354
+ expect(yield* Effect.promise(() => fs.readFile(target, "utf8"))).toBe("after after after")
355
+ expect(writes).toHaveLength(1)
356
+ }),
357
+ ),
358
+ )
359
+ },
360
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
361
+ ),
362
+ )
363
+
364
+ it.live("preserves BOM and CRLF line endings", () =>
365
+ Effect.acquireUseRelease(
366
+ Effect.promise(() => tmpdir()),
367
+ (tmp) => {
368
+ reset()
369
+ const target = path.join(tmp.path, "windows.txt")
370
+ return Effect.promise(() => fs.writeFile(target, "\uFEFFbefore\r\nrest\r\n")).pipe(
371
+ Effect.andThen(
372
+ withTool(tmp.path, (registry) =>
373
+ executeTool(registry, call({ path: "windows.txt", oldString: "before\nrest", newString: "after\nrest" })),
374
+ ),
375
+ ),
376
+ Effect.andThen(() => Effect.promise(() => fs.readFile(target, "utf8"))),
377
+ Effect.tap((content) => Effect.sync(() => expect(content).toBe("\uFEFFafter\r\nrest\r\n"))),
378
+ )
379
+ },
380
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
381
+ ),
382
+ )
383
+
384
+ it.live("rejects an in-place content change after matching but before conditional commit", () =>
385
+ Effect.acquireUseRelease(
386
+ Effect.promise(() => tmpdir()),
387
+ (tmp) => {
388
+ reset()
389
+ const target = path.join(tmp.path, "concurrent.txt")
390
+ afterRead = () => (reads === 1 ? Effect.promise(() => fs.writeFile(target, "newer\n")) : Effect.void)
391
+ return Effect.promise(() => fs.writeFile(target, "before\n")).pipe(
392
+ Effect.andThen(
393
+ withTool(tmp.path, (registry) =>
394
+ executeTool(registry, call({ path: "concurrent.txt", oldString: "before", newString: "after" })),
395
+ ),
396
+ ),
397
+ Effect.andThen((result) =>
398
+ Effect.gen(function* () {
399
+ expect(result).toEqual({
400
+ type: "error",
401
+ value: "File changed after permission approval. Read it again before editing.",
402
+ })
403
+ expect(yield* Effect.promise(() => fs.readFile(target, "utf8"))).toBe("newer\n")
404
+ expect(writes).toEqual([])
405
+ }),
406
+ ),
407
+ )
408
+ },
409
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
410
+ ),
411
+ )
412
+ })
413
+
414
+ test("keeps the locked edit schema, semantics docstring, and deferred TODOs visible", async () => {
415
+ const source = (await fs.readFile(new URL("../src/tool/edit.ts", import.meta.url), "utf8")).replaceAll("\r\n", "\n")
416
+ const definition = await Effect.runPromise(
417
+ withTool(path.dirname(fileURLToPath(import.meta.url)), (registry) => toolDefinitions(registry)),
418
+ )
419
+ const schema = definition[0]?.inputSchema as { readonly properties?: Record<string, unknown> }
420
+
421
+ expect(Object.keys(schema.properties ?? {}).sort()).toEqual(["newString", "oldString", "path", "replaceAll"])
422
+ expect(source).toContain(
423
+ "absolute external paths retain mutation capability through a separate\n * external_directory approval before edit approval.",
424
+ )
425
+ for (const todo of [
426
+ "Port V1 fuzzy correction strategies only after exact-edit behavior is established: line-trimmed matching, block-anchor fallback, indentation correction, and similarity-threshold review.",
427
+ "Add formatter integration after V2 formatter runtime exists.",
428
+ "Publish watcher/file-edit events after V2 watcher integration exists.",
429
+ "Add snapshots / undo after design exists.",
430
+ "Add LSP notification and diagnostics after V2 LSP runtime exists.",
431
+ ]) {
432
+ expect(source).toContain(`TODO: ${todo}`)
433
+ }
434
+ })
@@ -0,0 +1,247 @@
1
+ import { describe, expect } from "bun:test"
2
+ import path from "path"
3
+ import { Cause, Effect, Exit, Fiber, Layer, Option } from "effect"
4
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
5
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
6
+ import { FSUtil } from "@neurocode-ai/core/fs-util"
7
+ import { Global } from "@neurocode-ai/core/global"
8
+ import { Config } from "@neurocode-ai/core/config"
9
+ import { ConfigToolOutput } from "@neurocode-ai/core/config/tool-output"
10
+ import { SessionV2 } from "@neurocode-ai/core/session"
11
+ import { ToolOutputStore } from "@neurocode-ai/core/tool-output-store"
12
+ import { testEffect } from "./lib/effect"
13
+ import { tmpdir } from "./fixture/tmpdir"
14
+
15
+ const sessionID = SessionV2.ID.make("ses_tool_output_store")
16
+
17
+ const withStore = <A, E, R>(
18
+ body: (input: { root: string; store: ToolOutputStore.Interface; fs: FSUtil.Interface }) => Effect.Effect<A, E, R>,
19
+ config?: Config.Info,
20
+ ) =>
21
+ Effect.acquireUseRelease(
22
+ Effect.promise(() => tmpdir()),
23
+ (tmp) => {
24
+ const global = Global.layerWith({ data: tmp.path })
25
+ const configured = config
26
+ ? Layer.succeed(
27
+ Config.Service,
28
+ Config.Service.of({
29
+ entries: () => Effect.succeed([new Config.Document({ type: "document", info: config })]),
30
+ }),
31
+ )
32
+ : Layer.empty
33
+
34
+ const store = AppNodeBuilder.build(LayerNode.group([ToolOutputStore.node, FSUtil.node]), [
35
+ [Global.node, global],
36
+ [Config.node, configured],
37
+ ])
38
+ return Effect.gen(function* () {
39
+ return yield* body({ root: tmp.path, store: yield* ToolOutputStore.Service, fs: yield* FSUtil.Service })
40
+ }).pipe(Effect.provide(store))
41
+ },
42
+ (tmp) => Effect.promise(() => tmp[Symbol.asyncDispose]()),
43
+ )
44
+
45
+ const it = testEffect(Layer.empty)
46
+
47
+ describe("ToolOutputStore", () => {
48
+ it.live("bounds the provider-facing text channel with one managed file", () =>
49
+ withStore(({ store, fs }) =>
50
+ Effect.gen(function* () {
51
+ const first = "HEAD-" + "x".repeat(30_000)
52
+ const second = "y".repeat(30_000) + "-TAIL"
53
+ const result = yield* store.bound({
54
+ sessionID,
55
+ toolCallID: "call-aggregate",
56
+ output: {
57
+ structured: { kind: "report" },
58
+ content: [
59
+ { type: "text", text: first },
60
+ { type: "text", text: second },
61
+ ],
62
+ },
63
+ })
64
+ expect(result.output.structured).toEqual({ kind: "report" })
65
+ expect(result.outputPaths).toHaveLength(1)
66
+ expect(yield* fs.readFileString(result.outputPaths[0])).toBe(first + second)
67
+ if (result.output.content[0]?.type !== "text") throw new Error("expected text preview")
68
+ expect(Buffer.byteLength(result.output.content[0].text)).toBeLessThanOrEqual(ToolOutputStore.MAX_BYTES)
69
+ }),
70
+ ),
71
+ )
72
+
73
+ it.live("uses bounded text for oversized structured-only output", () =>
74
+ withStore(({ store, fs }) =>
75
+ Effect.gen(function* () {
76
+ const structured = { text: "x".repeat(ToolOutputStore.MAX_BYTES) }
77
+ const result = yield* store.bound({ sessionID, toolCallID: "call-json", output: { structured, content: [] } })
78
+ expect(result.output.structured).toEqual(structured)
79
+ expect(result.outputPaths).toHaveLength(1)
80
+ expect(JSON.parse(yield* fs.readFileString(result.outputPaths[0]))).toEqual(structured)
81
+ expect(result.output.content).toHaveLength(1)
82
+ }),
83
+ ),
84
+ )
85
+
86
+ it.live("preserves native media and structured metadata without applying a settlement media limit", () =>
87
+ withStore(({ store }) =>
88
+ Effect.gen(function* () {
89
+ const data = "a".repeat(6 * 1024 * 1024)
90
+ const result = yield* store.bound({
91
+ sessionID,
92
+ toolCallID: "call-file",
93
+ output: {
94
+ structured: { caption: "pixel" },
95
+ content: [{ type: "file", uri: `data:image/png;base64,${data}`, mime: "image/png", name: "pixel.png" }],
96
+ },
97
+ })
98
+ expect(result.outputPaths).toEqual([])
99
+ expect(result.output.structured).toEqual({ caption: "pixel" })
100
+ expect(result.output.content).toHaveLength(1)
101
+ expect(result.output.content[0]).toEqual({
102
+ type: "file",
103
+ uri: `data:image/png;base64,${data}`,
104
+ mime: "image/png",
105
+ name: "pixel.png",
106
+ })
107
+ }),
108
+ ),
109
+ )
110
+
111
+ it.live("preserves structured metadata and native media when bounding text", () =>
112
+ withStore(({ store, fs }) =>
113
+ Effect.gen(function* () {
114
+ const text = "x".repeat(ToolOutputStore.MAX_BYTES + 1)
115
+ const media = {
116
+ type: "file" as const,
117
+ uri: "data:image/png;base64,aGVsbG8=",
118
+ mime: "image/png",
119
+ name: "pixel.png",
120
+ }
121
+ const result = yield* store.bound({
122
+ sessionID,
123
+ toolCallID: "call-text-and-media",
124
+ output: { structured: { caption: "pixel" }, content: [{ type: "text", text }, media] },
125
+ })
126
+
127
+ expect(result.output.structured).toEqual({ caption: "pixel" })
128
+ expect(result.output.content[1]).toEqual(media)
129
+ expect(yield* fs.readFileString(result.outputPaths[0])).toBe(text)
130
+ }),
131
+ ),
132
+ )
133
+
134
+ it.live("does not double-count structured data duplicated in projected text", () =>
135
+ withStore(({ store }) =>
136
+ Effect.gen(function* () {
137
+ const text = "x".repeat(30_000)
138
+ const output = { structured: { output: text }, content: [{ type: "text" as const, text }] }
139
+ expect(yield* store.bound({ sessionID, toolCallID: "call-duplicated", output })).toEqual({
140
+ output,
141
+ outputPaths: [],
142
+ })
143
+ }),
144
+ ),
145
+ )
146
+
147
+ it.live("fails oversized settlement when complete retention cannot be written", () =>
148
+ withStore(({ root, store, fs }) =>
149
+ Effect.gen(function* () {
150
+ yield* fs.writeFileString(path.join(root, "tool-output"), "not a directory")
151
+ const exit = yield* store
152
+ .bound({
153
+ sessionID,
154
+ toolCallID: "call-lossy",
155
+ output: { structured: {}, content: [{ type: "text", text: "x".repeat(ToolOutputStore.MAX_BYTES + 1) }] },
156
+ })
157
+ .pipe(Effect.exit)
158
+ expect(Exit.isFailure(exit)).toBe(true)
159
+ if (Exit.isFailure(exit))
160
+ expect(Option.getOrUndefined(Cause.findErrorOption(exit.cause))?._tag).toBe("ToolOutputStore.StorageError")
161
+ }),
162
+ ),
163
+ )
164
+
165
+ it.live("does not encode ignored structured metadata when projected content exists", () =>
166
+ withStore(({ store }) =>
167
+ Effect.gen(function* () {
168
+ const output = { structured: { value: 1n }, content: [{ type: "text" as const, text: "readable text" }] }
169
+ expect(yield* store.bound({ sessionID, toolCallID: "call-unencodable", output })).toEqual({
170
+ output,
171
+ outputPaths: [],
172
+ })
173
+ }),
174
+ ),
175
+ )
176
+
177
+ it.live("preserves interruption while retaining complete output", () =>
178
+ Effect.gen(function* () {
179
+ const root = yield* Effect.promise(() => tmpdir())
180
+ const blockedFilesystem = Layer.effect(
181
+ FSUtil.Service,
182
+ Effect.gen(function* () {
183
+ const fs = yield* FSUtil.Service
184
+ return FSUtil.Service.of({
185
+ ...fs,
186
+ ensureDir: () => Effect.void,
187
+ writeFileString: () => Effect.never,
188
+ })
189
+ }),
190
+ ).pipe(Layer.provide(LayerNode.compile(FSUtil.node)))
191
+ const store = AppNodeBuilder.build(ToolOutputStore.nodeWithoutConfig, [
192
+ [Global.node, Global.layerWith({ data: root.path })],
193
+ [FSUtil.node, blockedFilesystem],
194
+ ])
195
+ const exit = yield* Effect.gen(function* () {
196
+ const service = yield* ToolOutputStore.Service
197
+ const fiber = yield* service
198
+ .bound({
199
+ sessionID,
200
+ toolCallID: "call-interrupted",
201
+ output: { structured: {}, content: [{ type: "text", text: "x".repeat(ToolOutputStore.MAX_BYTES + 1) }] },
202
+ })
203
+ .pipe(Effect.forkChild)
204
+ yield* Fiber.interrupt(fiber)
205
+ return yield* Fiber.await(fiber)
206
+ }).pipe(Effect.provide(store))
207
+ expect(Exit.isFailure(exit) && Cause.hasInterrupts(exit.cause)).toBe(true)
208
+ yield* Effect.promise(() => root[Symbol.asyncDispose]())
209
+ }),
210
+ )
211
+
212
+ it.live("honors configured limits", () =>
213
+ withStore(
214
+ ({ store }) =>
215
+ Effect.gen(function* () {
216
+ expect(yield* store.limits()).toEqual({ maxLines: 2, maxBytes: 1_000 })
217
+ const result = yield* store.bound({
218
+ sessionID,
219
+ toolCallID: "call-config",
220
+ output: { structured: {}, content: [{ type: "text", text: "one\ntwo\nthree" }] },
221
+ })
222
+ expect(result.outputPaths).toHaveLength(1)
223
+ }),
224
+ new Config.Info({ tool_output: new ConfigToolOutput.Info({ max_lines: 2, max_bytes: 1_000 }) }),
225
+ ),
226
+ )
227
+
228
+ it.live("cleans expired managed files and preserves unrelated files", () =>
229
+ withStore(({ root, store, fs }) =>
230
+ Effect.gen(function* () {
231
+ const old = path.join(root, "tool-output", "tool_old")
232
+ const recent = path.join(root, "tool-output", "tool_recent")
233
+ const unrelated = path.join(root, "tool-output", "keep.txt")
234
+ yield* fs.ensureDir(path.join(root, "tool-output"))
235
+ yield* fs.writeFileString(old, "old")
236
+ yield* fs.writeFileString(recent, "recent")
237
+ yield* fs.writeFileString(unrelated, "keep")
238
+ const expired = new Date(Date.now() - 8 * 24 * 60 * 60 * 1_000)
239
+ yield* fs.utimes(old, expired, expired)
240
+ yield* store.cleanup()
241
+ expect(yield* fs.exists(old)).toBe(false)
242
+ expect(yield* fs.exists(recent)).toBe(true)
243
+ expect(yield* fs.exists(unrelated)).toBe(true)
244
+ }),
245
+ ),
246
+ )
247
+ })