@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,33 @@
1
+ export * as PermissionV1 from "./permission"
2
+
3
+ import { Schema } from "effect"
4
+ export * from "@neurocode-ai/schema/permission-v1"
5
+ import { ID } from "@neurocode-ai/schema/permission-v1"
6
+
7
+ export class RejectedError extends Schema.TaggedErrorClass<RejectedError>()("PermissionRejectedError", {}) {
8
+ override get message() {
9
+ return "The user rejected permission to use this specific tool call."
10
+ }
11
+ }
12
+
13
+ export class CorrectedError extends Schema.TaggedErrorClass<CorrectedError>()("PermissionCorrectedError", {
14
+ feedback: Schema.String,
15
+ }) {
16
+ override get message() {
17
+ return `The user rejected permission to use this specific tool call with the following feedback: ${this.feedback}`
18
+ }
19
+ }
20
+
21
+ export class DeniedError extends Schema.TaggedErrorClass<DeniedError>()("PermissionDeniedError", {
22
+ ruleset: Schema.Any,
23
+ }) {
24
+ override get message() {
25
+ return `The user has specified a rule which prevents you from using this specific tool call. Here are some of the relevant rules ${JSON.stringify(this.ruleset)}`
26
+ }
27
+ }
28
+
29
+ export class NotFoundError extends Schema.TaggedErrorClass<NotFoundError>()("Permission.NotFoundError", {
30
+ requestID: ID,
31
+ }) {}
32
+
33
+ export type Error = DeniedError | RejectedError | CorrectedError
@@ -0,0 +1,68 @@
1
+ export * as SessionV1 from "./session"
2
+
3
+ import { Schema } from "effect"
4
+ import { NonNegativeInt } from "../schema"
5
+ import { NamedError } from "../util/error"
6
+
7
+ export {
8
+ AgentPart,
9
+ AgentPartInput,
10
+ Assistant,
11
+ CompactionPart,
12
+ Event,
13
+ FilePart,
14
+ FilePartInput,
15
+ FilePartSource,
16
+ FileSource,
17
+ Format,
18
+ Info,
19
+ MessageID,
20
+ OutputFormatJsonSchema,
21
+ OutputFormatText,
22
+ Part,
23
+ PartID,
24
+ PatchPart,
25
+ Range,
26
+ ReasoningPart,
27
+ ResourceSource,
28
+ RetryPart,
29
+ SessionInfo,
30
+ SnapshotPart,
31
+ StepFinishPart,
32
+ StepStartPart,
33
+ SubtaskPart,
34
+ SubtaskPartInput,
35
+ SymbolSource,
36
+ TextPart,
37
+ TextPartInput,
38
+ ToolPart,
39
+ ToolState,
40
+ ToolStateCompleted,
41
+ ToolStateError,
42
+ ToolStatePending,
43
+ ToolStateRunning,
44
+ User,
45
+ WithParts,
46
+ } from "@neurocode-ai/schema/session-v1"
47
+
48
+ export const OutputLengthError = NamedError.create("MessageOutputLengthError", {})
49
+ export const AuthError = NamedError.create("ProviderAuthError", { providerID: Schema.String, message: Schema.String })
50
+ export const AbortedError = NamedError.create("MessageAbortedError", { message: Schema.String })
51
+ export const StructuredOutputError = NamedError.create("StructuredOutputError", {
52
+ message: Schema.String,
53
+ retries: NonNegativeInt,
54
+ })
55
+ export const APIError = NamedError.create("APIError", {
56
+ message: Schema.String,
57
+ statusCode: Schema.optional(NonNegativeInt),
58
+ isRetryable: Schema.Boolean,
59
+ responseHeaders: Schema.optional(Schema.Record(Schema.String, Schema.String)),
60
+ responseBody: Schema.optional(Schema.String),
61
+ metadata: Schema.optional(Schema.Record(Schema.String, Schema.String)),
62
+ })
63
+ export type APIError = Schema.Schema.Type<typeof APIError.Schema>
64
+ export const ContextOverflowError = NamedError.create("ContextOverflowError", {
65
+ message: Schema.String,
66
+ responseBody: Schema.optional(Schema.String),
67
+ })
68
+ export const ContentFilterError = NamedError.create("ContentFilterError", { message: Schema.String })
@@ -0,0 +1,3 @@
1
+ export * as V2Schema from "./v2-schema"
2
+
3
+ export { DateTimeUtcFromMillis } from "@neurocode-ai/schema/schema"
@@ -0,0 +1,6 @@
1
+ export * as WorkspaceV2 from "./workspace"
2
+
3
+ import { Workspace } from "@neurocode-ai/schema/workspace"
4
+
5
+ export const ID = Workspace.ID
6
+ export type ID = typeof ID.Type
package/sst-env.d.ts ADDED
@@ -0,0 +1,10 @@
1
+ /* This file is auto-generated by SST. Do not edit. */
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /* deno-fmt-ignore-file */
5
+ /* biome-ignore-all lint: auto-generated */
6
+
7
+ /// <reference path="../../sst-env.d.ts" />
8
+
9
+ import "sst"
10
+ export {}
@@ -0,0 +1,131 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { Effect, Exit, Scope } from "effect"
3
+ import { AgentV2 } from "@neurocode-ai/core/agent"
4
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
5
+ import { Location } from "@neurocode-ai/core/location"
6
+ import { AgentPlugin } from "@neurocode-ai/core/plugin/agent"
7
+ import { AbsolutePath } from "@neurocode-ai/core/schema"
8
+ import { location } from "./fixture/location"
9
+ import { testEffect } from "./lib/effect"
10
+ import { agentHost, host } from "./plugin/host"
11
+
12
+ const it = testEffect(AppNodeBuilder.build(AgentV2.node))
13
+
14
+ describe("AgentV2", () => {
15
+ it.effect("starts without agents", () =>
16
+ Effect.gen(function* () {
17
+ const agent = yield* AgentV2.Service
18
+
19
+ expect(yield* agent.all()).toEqual([])
20
+ expect(yield* agent.get(AgentV2.ID.make("build"))).toBeUndefined()
21
+ }),
22
+ )
23
+
24
+ it.effect("materializes replayable agent transforms", () =>
25
+ Effect.gen(function* () {
26
+ const agent = yield* AgentV2.Service
27
+ const id = AgentV2.ID.make("reviewer")
28
+ yield* agent.transform((editor) =>
29
+ editor.update(id, (info) => {
30
+ info.description = "Reviews code"
31
+ info.mode = "subagent"
32
+ }),
33
+ )
34
+
35
+ expect(yield* agent.get(id)).toMatchObject({ id, description: "Reviews code", mode: "subagent" })
36
+ expect((yield* agent.all()).map((info) => info.id)).toEqual([id])
37
+ }),
38
+ )
39
+
40
+ it.effect("rebuilds state when a transform is replaced", () =>
41
+ Effect.gen(function* () {
42
+ const agent = yield* AgentV2.Service
43
+ const id = AgentV2.ID.make("reviewer")
44
+ let description = "Old description"
45
+ let hidden = true
46
+ yield* agent.transform((editor) =>
47
+ editor.update(id, (info) => {
48
+ info.description = description
49
+ info.hidden = hidden
50
+ }),
51
+ )
52
+ description = "New description"
53
+ hidden = false
54
+ yield* agent.reload()
55
+
56
+ expect(yield* agent.get(id)).toMatchObject({ description: "New description", hidden: false })
57
+ }),
58
+ )
59
+
60
+ it.effect("removes a transform when its scope closes", () =>
61
+ Effect.gen(function* () {
62
+ const agent = yield* AgentV2.Service
63
+ const id = AgentV2.ID.make("scoped")
64
+ const scope = yield* Scope.make()
65
+ yield* agent.transform((editor) => editor.update(id, () => {})).pipe(Scope.provide(scope))
66
+ expect(yield* agent.get(id)).toBeDefined()
67
+
68
+ yield* Scope.close(scope, Exit.void)
69
+ expect(yield* agent.get(id)).toBeUndefined()
70
+ }),
71
+ )
72
+
73
+ it.effect("applies direct agent updates", () =>
74
+ Effect.gen(function* () {
75
+ const agent = yield* AgentV2.Service
76
+ const id = AgentV2.ID.make("build")
77
+
78
+ yield* agent.transform((editor) =>
79
+ editor.update(id, (info) => {
80
+ info.mode = "primary"
81
+ info.hidden = true
82
+ }),
83
+ )
84
+
85
+ expect(yield* agent.get(id)).toMatchObject({ id, mode: "primary", hidden: true })
86
+ }),
87
+ )
88
+
89
+ it.effect("creates agents with runtime defaults and supports direct removal", () =>
90
+ Effect.gen(function* () {
91
+ const agent = yield* AgentV2.Service
92
+ const id = AgentV2.ID.make("custom")
93
+
94
+ yield* agent.transform((editor) => editor.update(id, () => {}))
95
+ expect(yield* agent.get(id)).toEqual(AgentV2.Info.empty(id))
96
+
97
+ yield* agent.transform((editor) => editor.remove(id))
98
+ expect(yield* agent.get(id)).toBeUndefined()
99
+ }),
100
+ )
101
+
102
+ it.effect("does not ambiently opt built-in agents into bash", () =>
103
+ Effect.gen(function* () {
104
+ const agent = yield* AgentV2.Service
105
+ yield* AgentPlugin.Plugin.effect(
106
+ host({
107
+ agent: agentHost(agent),
108
+ }),
109
+ ).pipe(
110
+ Effect.provideService(
111
+ Location.Service,
112
+ Location.Service.of(location({ directory: AbsolutePath.make("/project") })),
113
+ ),
114
+ )
115
+
116
+ const agents = yield* agent.all()
117
+ expect(agents.map((item) => String(item.id)).sort()).toEqual([
118
+ "build",
119
+ "compaction",
120
+ "explore",
121
+ "general",
122
+ "plan",
123
+ "summary",
124
+ "title",
125
+ ])
126
+ for (const item of agents) {
127
+ expect(item.permissions.some((rule) => rule.action === "bash" && rule.effect !== "deny")).toBe(false)
128
+ }
129
+ }),
130
+ )
131
+ })
@@ -0,0 +1,287 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { Tool } from "@neurocode-ai/core/tool/tool"
3
+ import { ApplicationTools } from "@neurocode-ai/core/tool/application-tools"
4
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
5
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
6
+ import { SessionV2 } from "@neurocode-ai/core/session"
7
+ import { SessionMessage } from "@neurocode-ai/core/session/message"
8
+ import { AgentV2 } from "@neurocode-ai/core/agent"
9
+ import { ToolRegistry } from "@neurocode-ai/core/tool/registry"
10
+ import { executeTool, settleTool, toolDefinitions } from "./lib/tool"
11
+ import { ToolOutputStore } from "@neurocode-ai/core/tool-output-store"
12
+ import { Tools } from "@neurocode-ai/core/tool/tools"
13
+ import { Deferred, Effect, Exit, Fiber, Schema, Scope } from "effect"
14
+ import { testEffect } from "./lib/effect"
15
+
16
+ const it = testEffect(
17
+ AppNodeBuilder.build(LayerNode.group([ApplicationTools.node, ToolRegistry.node, ToolRegistry.toolsNode]), [
18
+ [ToolOutputStore.node, ToolOutputStore.nodeWithoutConfig],
19
+ ]),
20
+ )
21
+
22
+ const sessionID = SessionV2.ID.make("ses_application_tool")
23
+ const agent = AgentV2.ID.make("build")
24
+ const assistantMessageID = SessionMessage.ID.make("msg_application_tool")
25
+ const contextual = (contexts: Tool.Context[]) =>
26
+ Tool.make({
27
+ description: "Read application context",
28
+ input: Schema.Struct({ query: Schema.String }),
29
+ output: Schema.Struct({ answer: Schema.String }),
30
+ execute: ({ query }, context) =>
31
+ Effect.sync(() => {
32
+ contexts.push(context)
33
+ return { answer: query.toUpperCase() }
34
+ }),
35
+ toModelOutput: ({ output }) => [
36
+ { type: "text", text: output.answer },
37
+ { type: "file", data: "aGVsbG8=", mime: "image/png", name: "result.png" },
38
+ ],
39
+ })
40
+
41
+ describe("ApplicationTools", () => {
42
+ it.effect("keeps the Core carrier opaque and executes its single handler", () =>
43
+ Effect.gen(function* () {
44
+ const applications = yield* ApplicationTools.Service
45
+ const registry = yield* ToolRegistry.Service
46
+ const contexts: Tool.Context[] = []
47
+ const tool = contextual(contexts)
48
+ expect(Object.keys(tool)).toEqual([])
49
+
50
+ yield* applications.register({ opaque: tool })
51
+ expect(
52
+ yield* executeTool(registry, {
53
+ sessionID,
54
+ agent,
55
+ assistantMessageID,
56
+ call: { type: "tool-call", id: "call-opaque", name: "opaque", input: { query: "once" } },
57
+ }),
58
+ ).toEqual({
59
+ type: "content",
60
+ value: [
61
+ { type: "text", text: "ONCE" },
62
+ { type: "file", uri: "data:image/png;base64,aGVsbG8=", mime: "image/png", name: "result.png" },
63
+ ],
64
+ })
65
+ expect(contexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-opaque" }])
66
+ }),
67
+ )
68
+
69
+ it.effect("exposes narrow scoped Location registration and validates names", () =>
70
+ Effect.gen(function* () {
71
+ const tools: Tools.Interface = yield* Tools.Service
72
+ const registry = yield* ToolRegistry.Service
73
+ const scope = yield* Scope.make()
74
+
75
+ yield* tools.register({ location_tool: contextual([]) }).pipe(Scope.provide(scope))
76
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["location_tool"])
77
+ expect(yield* Effect.flip(tools.register({ "invalid name": contextual([]) }))).toBeInstanceOf(
78
+ Tool.RegistrationError,
79
+ )
80
+
81
+ yield* Scope.close(scope, Exit.void)
82
+ expect(yield* toolDefinitions(registry)).toEqual([])
83
+ }),
84
+ )
85
+
86
+ it.effect("filters an application tool by its name without adding execution authorization", () =>
87
+ Effect.gen(function* () {
88
+ const applications = yield* ApplicationTools.Service
89
+ const registry = yield* ToolRegistry.Service
90
+ const contexts: Tool.Context[] = []
91
+ yield* applications.register({ application_context: contextual(contexts) })
92
+
93
+ expect(
94
+ yield* toolDefinitions(registry, [{ action: "application_context", resource: "*", effect: "deny" }]),
95
+ ).toEqual([])
96
+ expect(
97
+ yield* settleTool(registry, {
98
+ sessionID,
99
+ agent,
100
+ assistantMessageID,
101
+ call: { type: "tool-call", id: "call-denied", name: "application_context", input: { query: "hello" } },
102
+ }),
103
+ ).toMatchObject({ result: { type: "content" } })
104
+ expect(contexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-denied" }])
105
+ }),
106
+ )
107
+
108
+ it.effect("advertises and executes a scoped application tool with Session context", () =>
109
+ Effect.gen(function* () {
110
+ const applications = yield* ApplicationTools.Service
111
+ const registry = yield* ToolRegistry.Service
112
+ const contexts: Tool.Context[] = []
113
+
114
+ yield* applications.register({ application_context: contextual(contexts) })
115
+
116
+ expect(yield* toolDefinitions(registry)).toMatchObject([
117
+ { name: "application_context", description: "Read application context" },
118
+ ])
119
+ expect(
120
+ yield* settleTool(registry, {
121
+ sessionID,
122
+ agent,
123
+ assistantMessageID,
124
+ call: { type: "tool-call", id: "call-context", name: "application_context", input: { query: "hello" } },
125
+ }),
126
+ ).toEqual({
127
+ result: {
128
+ type: "content",
129
+ value: [
130
+ { type: "text", text: "HELLO" },
131
+ { type: "file", uri: "data:image/png;base64,aGVsbG8=", mime: "image/png", name: "result.png" },
132
+ ],
133
+ },
134
+ output: {
135
+ structured: { answer: "HELLO" },
136
+ content: [
137
+ { type: "text", text: "HELLO" },
138
+ { type: "file", uri: "data:image/png;base64,aGVsbG8=", mime: "image/png", name: "result.png" },
139
+ ],
140
+ },
141
+ })
142
+ expect(contexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-context" }])
143
+ }),
144
+ )
145
+
146
+ it.effect("removes an application tool when its registration scope closes", () =>
147
+ Effect.gen(function* () {
148
+ const applications = yield* ApplicationTools.Service
149
+ const registry = yield* ToolRegistry.Service
150
+ const scope = yield* Scope.make()
151
+
152
+ yield* applications.register({ temporary: contextual([]) }).pipe(Scope.provide(scope))
153
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["temporary"])
154
+
155
+ yield* Scope.close(scope, Exit.void)
156
+ expect(yield* toolDefinitions(registry)).toEqual([])
157
+ }),
158
+ )
159
+
160
+ it.effect("removes a tool before settling a call produced from an earlier definition", () =>
161
+ Effect.gen(function* () {
162
+ const applications = yield* ApplicationTools.Service
163
+ const registry = yield* ToolRegistry.Service
164
+ const registrationScope = yield* Scope.make()
165
+ yield* applications.register({ contextual: contextual([]) }).pipe(Scope.provide(registrationScope))
166
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["contextual"])
167
+
168
+ yield* Scope.close(registrationScope, Exit.void)
169
+ expect(
170
+ yield* settleTool(registry, {
171
+ sessionID,
172
+ agent,
173
+ assistantMessageID,
174
+ call: { type: "tool-call", id: "call-removed", name: "contextual", input: { query: "hello" } },
175
+ }),
176
+ ).toEqual({ result: { type: "error", value: "Unknown tool: contextual" } })
177
+ }),
178
+ )
179
+
180
+ it.effect("does not leak a registration into an already closed scope", () =>
181
+ Effect.gen(function* () {
182
+ const applications = yield* ApplicationTools.Service
183
+ const registry = yield* ToolRegistry.Service
184
+ const scope = yield* Scope.make()
185
+ yield* Scope.close(scope, Exit.void)
186
+
187
+ yield* applications.register({ closed: contextual([]) }).pipe(Scope.provide(scope))
188
+
189
+ expect(yield* toolDefinitions(registry)).toEqual([])
190
+ }),
191
+ )
192
+
193
+ it.effect("preserves an interrupted application registration until its scope closes", () =>
194
+ Effect.gen(function* () {
195
+ const applications = yield* ApplicationTools.Service
196
+ const registry = yield* ToolRegistry.Service
197
+ const scope = yield* Scope.make()
198
+ const registered = yield* Deferred.make<void>()
199
+ const fiber = yield* applications
200
+ .register({ interrupted: contextual([]) })
201
+ .pipe(
202
+ Effect.andThen(Deferred.succeed(registered, undefined)),
203
+ Effect.andThen(Effect.never),
204
+ Scope.provide(scope),
205
+ Effect.forkChild,
206
+ )
207
+ yield* Deferred.await(registered)
208
+ yield* Fiber.interrupt(fiber)
209
+
210
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["interrupted"])
211
+ yield* Scope.close(scope, Exit.void)
212
+ expect(yield* toolDefinitions(registry)).toEqual([])
213
+ }),
214
+ )
215
+
216
+ it.effect("captures the registered record before later State rebuilds", () =>
217
+ Effect.gen(function* () {
218
+ const applications = yield* ApplicationTools.Service
219
+ const registry = yield* ToolRegistry.Service
220
+ const registered = { stable: contextual([]) }
221
+ yield* applications.register(registered)
222
+ Object.assign(registered, { late: contextual([]) })
223
+
224
+ yield* Effect.scoped(applications.register({ temporary: contextual([]) }))
225
+
226
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["stable"])
227
+ }),
228
+ )
229
+
230
+ it.effect("settles with the current same-name application tool and restores earlier registrations", () =>
231
+ Effect.gen(function* () {
232
+ const applications = yield* ApplicationTools.Service
233
+ const registry = yield* ToolRegistry.Service
234
+ const firstContexts: Tool.Context[] = []
235
+ const secondContexts: Tool.Context[] = []
236
+ const scope = yield* Scope.make()
237
+ yield* applications.register({ contextual: contextual(firstContexts) })
238
+ expect((yield* toolDefinitions(registry)).map((tool) => tool.name)).toEqual(["contextual"])
239
+ yield* applications.register({ contextual: contextual(secondContexts) }).pipe(Scope.provide(scope))
240
+
241
+ yield* settleTool(registry, {
242
+ sessionID,
243
+ agent,
244
+ assistantMessageID,
245
+ call: { type: "tool-call", id: "call-second", name: "contextual", input: { query: "second" } },
246
+ })
247
+ yield* Scope.close(scope, Exit.void)
248
+ yield* settleTool(registry, {
249
+ sessionID,
250
+ agent,
251
+ assistantMessageID,
252
+ call: { type: "tool-call", id: "call-first", name: "contextual", input: { query: "first" } },
253
+ })
254
+
255
+ expect(secondContexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-second" }])
256
+ expect(firstContexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-first" }])
257
+ }),
258
+ )
259
+
260
+ it.effect("keeps the Location tool when an application tool has the same name", () =>
261
+ Effect.gen(function* () {
262
+ const applications = yield* ApplicationTools.Service
263
+ const registry = yield* ToolRegistry.Service
264
+ const locationContexts: Tool.Context[] = []
265
+ const applicationContexts: Tool.Context[] = []
266
+ const location = contextual(locationContexts)
267
+ yield* registry.register({ shared: location })
268
+ yield* applications.register({ shared: contextual(applicationContexts) })
269
+
270
+ expect(
271
+ (yield* toolDefinitions(registry, [{ action: "shared", resource: "*", effect: "deny" }])).map(
272
+ (definition) => definition.name,
273
+ ),
274
+ ).toEqual([])
275
+ expect(
276
+ yield* settleTool(registry, {
277
+ sessionID,
278
+ agent,
279
+ assistantMessageID,
280
+ call: { type: "tool-call", id: "call-shared", name: "shared", input: { query: "location" } },
281
+ }),
282
+ ).toMatchObject({ result: { type: "content" } })
283
+ expect(locationContexts).toEqual([{ sessionID, agent, assistantMessageID, toolCallID: "call-shared" }])
284
+ expect(applicationContexts).toEqual([])
285
+ }),
286
+ )
287
+ })
@@ -0,0 +1,106 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { BackgroundJob } from "@neurocode-ai/core/background-job"
3
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
4
+ import { Deferred, Effect, Exit, Scope } from "effect"
5
+ import { it } from "./lib/effect"
6
+
7
+ const jobsLayer = LayerNode.compile(BackgroundJob.node)
8
+
9
+ describe("BackgroundJob", () => {
10
+ it.live("tracks process-local work through explicit observation", () =>
11
+ Effect.gen(function* () {
12
+ const jobs = yield* BackgroundJob.Service
13
+ const latch = yield* Deferred.make<void>()
14
+ const job = yield* jobs.start({
15
+ type: "test",
16
+ metadata: { durable: false },
17
+ run: Deferred.await(latch).pipe(Effect.as("done")),
18
+ })
19
+
20
+ expect(job).toMatchObject({ type: "test", status: "running", metadata: { durable: false } })
21
+ expect(yield* jobs.wait({ id: job.id, timeout: 0 })).toMatchObject({
22
+ timedOut: true,
23
+ info: { status: "running" },
24
+ })
25
+
26
+ yield* Deferred.succeed(latch, undefined)
27
+ expect(yield* jobs.wait({ id: job.id })).toMatchObject({
28
+ timedOut: false,
29
+ info: { status: "completed", output: "done" },
30
+ })
31
+ }).pipe(Effect.provide(jobsLayer)),
32
+ )
33
+
34
+ it.live("publishes jobs before starting immediately settling work", () =>
35
+ Effect.gen(function* () {
36
+ const jobs = yield* BackgroundJob.Service
37
+
38
+ yield* Effect.forEach(Array.from({ length: 100 }), (_, index) => {
39
+ const id = `job_immediate_start_${index}`
40
+ return Effect.gen(function* () {
41
+ const job = yield* jobs.start({
42
+ id,
43
+ type: "test",
44
+ run: jobs
45
+ .get(id)
46
+ .pipe(
47
+ Effect.flatMap((info) =>
48
+ info?.status === "running"
49
+ ? Effect.succeed(`done-${index}`)
50
+ : Effect.fail("job started before publish"),
51
+ ),
52
+ ),
53
+ })
54
+
55
+ expect(yield* jobs.wait({ id: job.id })).toMatchObject({
56
+ timedOut: false,
57
+ info: { status: "completed", output: `done-${index}` },
58
+ })
59
+ })
60
+ })
61
+ }).pipe(Effect.provide(jobsLayer)),
62
+ )
63
+
64
+ it.live("increments pending work before starting immediately settling extensions", () =>
65
+ Effect.gen(function* () {
66
+ const jobs = yield* BackgroundJob.Service
67
+
68
+ yield* Effect.forEach(Array.from({ length: 100 }), (_, index) =>
69
+ Effect.gen(function* () {
70
+ const first = yield* Deferred.make<void>()
71
+ const job = yield* jobs.start({
72
+ type: "test",
73
+ run: Deferred.await(first).pipe(Effect.as(`first-${index}`)),
74
+ })
75
+
76
+ expect(yield* jobs.extend({ id: job.id, run: Effect.succeed(`second-${index}`) })).toBe(true)
77
+ expect((yield* jobs.get(job.id))?.status).toBe("running")
78
+
79
+ yield* Deferred.succeed(first, undefined)
80
+ expect(yield* jobs.wait({ id: job.id })).toMatchObject({
81
+ timedOut: false,
82
+ info: { status: "completed", output: `second-${index}` },
83
+ })
84
+ }),
85
+ )
86
+ }).pipe(Effect.provide(jobsLayer)),
87
+ )
88
+
89
+ it.live("interrupts live work without promising settlement after the owning process-local scope closes", () =>
90
+ Effect.gen(function* () {
91
+ const scope = yield* Scope.make()
92
+ const interrupted = yield* Deferred.make<void>()
93
+ const jobs = yield* BackgroundJob.make.pipe(Scope.provide(scope))
94
+ const job = yield* jobs.start({
95
+ type: "test",
96
+ run: Effect.never.pipe(Effect.ensuring(Deferred.succeed(interrupted, undefined))),
97
+ })
98
+
99
+ yield* Scope.close(scope, Exit.void)
100
+
101
+ yield* Deferred.await(interrupted).pipe(Effect.timeout("1 second"))
102
+ // The abandoned in-memory registry is not a durable observation channel.
103
+ expect((yield* jobs.get(job.id))?.status).toBe("running")
104
+ }),
105
+ )
106
+ })