@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,115 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { State } from "@neurocode-ai/core/state"
3
+ import { Deferred, Effect, Exit, Fiber, Layer, Scope } from "effect"
4
+ import { testEffect } from "./lib/effect"
5
+
6
+ const it = testEffect(Layer.empty)
7
+
8
+ describe("State", () => {
9
+ it.effect("commits a transform atomically when its updater is interrupted", () =>
10
+ Effect.gen(function* () {
11
+ const rebuilding = yield* Deferred.make<void>()
12
+ const release = yield* Deferred.make<void>()
13
+ let block = true
14
+ const state = State.create({
15
+ initial: () => ({ values: [] as string[] }),
16
+ draft: (draft) => ({ add: (value: string) => draft.values.push(value) }),
17
+ finalize: () =>
18
+ block ? Deferred.succeed(rebuilding, undefined).pipe(Effect.andThen(Deferred.await(release))) : Effect.void,
19
+ })
20
+ const scope = yield* Scope.make()
21
+ const fiber = yield* state
22
+ .transform((editor) => {
23
+ editor.add("registered")
24
+ })
25
+ .pipe(Scope.provide(scope), Effect.forkChild)
26
+ yield* Deferred.await(rebuilding)
27
+ const interruption = yield* Fiber.interrupt(fiber).pipe(Effect.forkChild)
28
+ block = false
29
+ yield* Deferred.succeed(release, undefined)
30
+ yield* Fiber.join(interruption)
31
+
32
+ expect(state.get().values).toEqual(["registered"])
33
+ yield* Scope.close(scope, Exit.void)
34
+ expect(state.get().values).toEqual([])
35
+ }),
36
+ )
37
+
38
+ it.effect("runs effectful transforms during every reload", () =>
39
+ Effect.gen(function* () {
40
+ let value = "first"
41
+ const state = State.create({
42
+ initial: () => ({ values: [] as string[] }),
43
+ draft: (draft) => ({ add: (item: string) => draft.values.push(item) }),
44
+ })
45
+
46
+ yield* state.transform((editor) =>
47
+ Effect.sync(() => {
48
+ editor.add(value)
49
+ }),
50
+ )
51
+ expect(state.get().values).toEqual(["first"])
52
+
53
+ value = "second"
54
+ yield* state.reload()
55
+ expect(state.get().values).toEqual(["second"])
56
+ }),
57
+ )
58
+
59
+ it.effect("disposes a transform once and rebuilds remaining state", () =>
60
+ Effect.gen(function* () {
61
+ const state = State.create({
62
+ initial: () => ({ values: [] as string[] }),
63
+ draft: (draft) => ({ add: (item: string) => draft.values.push(item) }),
64
+ })
65
+ yield* state.transform((editor) => {
66
+ editor.add("first")
67
+ })
68
+ const registration = yield* state.transform((editor) => {
69
+ editor.add("second")
70
+ })
71
+ expect(state.get().values).toEqual(["first", "second"])
72
+
73
+ yield* registration.dispose
74
+ expect(state.get().values).toEqual(["first"])
75
+
76
+ yield* registration.dispose
77
+ expect(state.get().values).toEqual(["first"])
78
+ }),
79
+ )
80
+
81
+ it.effect("batches automatic rebuilds", () =>
82
+ Effect.gen(function* () {
83
+ let finalized = 0
84
+ const first = State.create({
85
+ initial: () => ({ values: [] as string[] }),
86
+ draft: (draft) => ({ add: (item: string) => draft.values.push(item) }),
87
+ finalize: () => Effect.sync(() => finalized++),
88
+ })
89
+ const second = State.create({
90
+ initial: () => ({ values: [] as string[] }),
91
+ draft: (draft) => ({ add: (item: string) => draft.values.push(item) }),
92
+ finalize: () => Effect.sync(() => finalized++),
93
+ })
94
+
95
+ yield* State.batch(
96
+ Effect.gen(function* () {
97
+ yield* first.transform((draft) => {
98
+ draft.add("first")
99
+ })
100
+ yield* first.transform((draft) => {
101
+ draft.add("second")
102
+ })
103
+ yield* second.transform((draft) => {
104
+ draft.add("third")
105
+ })
106
+ expect(finalized).toBe(0)
107
+ }),
108
+ )
109
+
110
+ expect(first.get().values).toEqual(["first", "second"])
111
+ expect(second.get().values).toEqual(["third"])
112
+ expect(finalized).toBe(2)
113
+ }),
114
+ )
115
+ })
@@ -0,0 +1,129 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { Effect, Layer } from "effect"
3
+ import * as TestClock from "effect/testing/TestClock"
4
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
5
+ import { LayerNode } from "@neurocode-ai/core/effect/layer-node"
6
+ import { Location } from "@neurocode-ai/core/location"
7
+ import { FSUtil } from "@neurocode-ai/core/fs-util"
8
+ import { Global } from "@neurocode-ai/core/global"
9
+ import { AbsolutePath } from "@neurocode-ai/core/schema"
10
+ import { SystemContext } from "@neurocode-ai/core/system-context"
11
+ import { SystemContextBuiltIns } from "@neurocode-ai/core/system-context/builtins"
12
+ import { SystemContextRegistry } from "@neurocode-ai/core/system-context/registry"
13
+ import { location } from "../fixture/location"
14
+ import { testEffect } from "../lib/effect"
15
+
16
+ const directory = AbsolutePath.make(FSUtil.resolve("/repo/packages/core"))
17
+ const projectDirectory = AbsolutePath.make(FSUtil.resolve("/repo"))
18
+ const instructionFile = FSUtil.resolve("/repo/AGENTS.md")
19
+ const timestamp = Date.parse("2026-06-03T12:00:00.000Z")
20
+ const localDate = (time: number) => new Date(time).toDateString()
21
+ const locationLayer = Layer.succeed(
22
+ Location.Service,
23
+ Location.Service.of(
24
+ location(
25
+ { directory },
26
+ { projectDirectory, vcs: { type: "git", store: AbsolutePath.make(FSUtil.resolve("/repo/.git")) } },
27
+ ),
28
+ ),
29
+ )
30
+ const builtInsNode = LayerNode.group([SystemContextBuiltIns.node, SystemContextRegistry.node])
31
+ const it = testEffect(
32
+ AppNodeBuilder.build(builtInsNode, [
33
+ [Location.node, locationLayer],
34
+ [Global.node, Global.layerWith({ config: "/global" })],
35
+ ]),
36
+ )
37
+ const instructionFS = Layer.effect(
38
+ FSUtil.Service,
39
+ FSUtil.Service.pipe(
40
+ Effect.map((fs) =>
41
+ FSUtil.Service.of({
42
+ ...fs,
43
+ up: () => Effect.succeed([instructionFile]),
44
+ readFileStringSafe: (path) => Effect.succeed(path === instructionFile ? "Be precise." : undefined),
45
+ }),
46
+ ),
47
+ ),
48
+ ).pipe(Layer.provide(LayerNode.compile(FSUtil.node)))
49
+ const itWithInstructions = testEffect(
50
+ AppNodeBuilder.build(builtInsNode, [
51
+ [Location.node, locationLayer],
52
+ [FSUtil.node, instructionFS],
53
+ [Global.node, Global.layerWith({ config: "/global" })],
54
+ ]),
55
+ )
56
+
57
+ describe("SystemContextBuiltIns", () => {
58
+ it.effect("loads location-scoped environment and host-local date context", () =>
59
+ Effect.gen(function* () {
60
+ yield* TestClock.setTime(timestamp)
61
+ const context = yield* SystemContextRegistry.Service
62
+ const initialized = yield* SystemContext.initialize(yield* context.load())
63
+
64
+ expect(initialized.baseline).toBe(
65
+ [
66
+ "Here is some useful information about the environment you are running in:",
67
+ "<env>",
68
+ ` Working directory: ${directory}`,
69
+ ` Workspace root folder: ${projectDirectory}`,
70
+ " Is directory a git repo: yes",
71
+ ` Platform: ${process.platform}`,
72
+ "</env>",
73
+ "",
74
+ `Today's date: ${localDate(timestamp)}`,
75
+ ].join("\n"),
76
+ )
77
+ }),
78
+ )
79
+
80
+ it.effect("reconciles the date without repeating unchanged environment context", () =>
81
+ Effect.gen(function* () {
82
+ yield* TestClock.setTime(timestamp)
83
+ const context = yield* SystemContextRegistry.Service
84
+ const initialized = yield* SystemContext.initialize(yield* context.load())
85
+
86
+ yield* TestClock.setTime(timestamp + 24 * 60 * 60 * 1000)
87
+ const refreshed = yield* SystemContext.reconcile(yield* context.load(), initialized.snapshot)
88
+
89
+ expect(refreshed).toMatchObject({
90
+ _tag: "Updated",
91
+ text: `Today's date is now: ${localDate(timestamp + 24 * 60 * 60 * 1000)}`,
92
+ })
93
+ }),
94
+ )
95
+
96
+ it.effect("does not update again within the same local calendar day", () =>
97
+ Effect.gen(function* () {
98
+ yield* TestClock.setTime(timestamp)
99
+ const context = yield* SystemContextRegistry.Service
100
+ const initialized = yield* SystemContext.initialize(yield* context.load())
101
+
102
+ yield* TestClock.setTime(timestamp + 60 * 60 * 1000)
103
+ expect(yield* SystemContext.reconcile(yield* context.load(), initialized.snapshot)).toEqual({ _tag: "Unchanged" })
104
+ }),
105
+ )
106
+
107
+ itWithInstructions.effect("composes ambient instructions after built-in context", () =>
108
+ Effect.gen(function* () {
109
+ yield* TestClock.setTime(timestamp)
110
+ const context = yield* SystemContextRegistry.Service
111
+
112
+ expect((yield* SystemContext.initialize(yield* context.load())).baseline).toBe(
113
+ [
114
+ "Here is some useful information about the environment you are running in:",
115
+ "<env>",
116
+ ` Working directory: ${directory}`,
117
+ ` Workspace root folder: ${projectDirectory}`,
118
+ " Is directory a git repo: yes",
119
+ ` Platform: ${process.platform}`,
120
+ "</env>",
121
+ "",
122
+ `Today's date: ${localDate(timestamp)}`,
123
+ "",
124
+ `Instructions from: ${instructionFile}\nBe precise.`,
125
+ ].join("\n"),
126
+ )
127
+ }),
128
+ )
129
+ })
@@ -0,0 +1,307 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { Cause, Effect, Exit, Schema } from "effect"
3
+ import { SystemContext } from "@neurocode-ai/core/system-context"
4
+ import { it } from "../lib/effect"
5
+
6
+ const key = SystemContext.Key.make
7
+ const stringContext = (input: {
8
+ key: string
9
+ value: string | SystemContext.Unavailable
10
+ baseline?: (value: string) => string
11
+ update?: (previous: string, current: string) => string
12
+ removed?: (value: string) => string
13
+ }) =>
14
+ SystemContext.make({
15
+ key: key(input.key),
16
+ codec: Schema.toCodecJson(Schema.String),
17
+ load: Effect.succeed(input.value),
18
+ baseline: input.baseline ?? String,
19
+ update: input.update ?? ((_previous, current) => current),
20
+ removed: input.removed,
21
+ })
22
+
23
+ describe("SystemContext", () => {
24
+ it.effect("stores the canonical JSON encoding of the loaded value", () =>
25
+ Effect.gen(function* () {
26
+ const context = SystemContext.make({
27
+ key: key("core/date"),
28
+ codec: Schema.toCodecJson(Schema.DateFromString),
29
+ load: Effect.succeed(new Date("2026-06-03T12:00:00.000Z")),
30
+ baseline: (date) => date.toISOString(),
31
+ update: (_previous, date) => date.toISOString(),
32
+ removed: () => "Date removed",
33
+ })
34
+
35
+ expect((yield* SystemContext.initialize(context)).snapshot["core/date"].value).toBe("2026-06-03T12:00:00.000Z")
36
+ }),
37
+ )
38
+
39
+ it.effect("loads once and initializes a baseline with a structured snapshot", () =>
40
+ Effect.gen(function* () {
41
+ let loads = 0
42
+ const context = SystemContext.combine([
43
+ SystemContext.make({
44
+ key: key("core/date"),
45
+ codec: Schema.toCodecJson(Schema.String),
46
+ load: Effect.sync(() => {
47
+ loads++
48
+ return "2026-06-03"
49
+ }),
50
+ baseline: (date) => `Today's date is ${date}.`,
51
+ update: (previous, current) => `The date changed from ${previous} to ${current}.`,
52
+ removed: () => "The date was removed.",
53
+ }),
54
+ stringContext({ key: "core/location", value: "/repo", baseline: (value) => `Directory: ${value}` }),
55
+ ])
56
+
57
+ expect(yield* SystemContext.initialize(context)).toEqual({
58
+ baseline: "Today's date is 2026-06-03.\n\nDirectory: /repo",
59
+ snapshot: {
60
+ "core/date": { value: "2026-06-03", removed: "The date was removed." },
61
+ "core/location": { value: "/repo" },
62
+ },
63
+ })
64
+ expect(loads).toBe(1)
65
+ }),
66
+ )
67
+
68
+ it.effect("renders updates only after a structured value changes", () =>
69
+ Effect.gen(function* () {
70
+ const previous = {
71
+ "core/date": { value: "2026-06-03", removed: "The date was removed." },
72
+ "core/location": { value: "/repo", removed: "Removed: /repo" },
73
+ }
74
+ const changed = SystemContext.combine([
75
+ stringContext({
76
+ key: "core/date",
77
+ value: "2026-06-04",
78
+ update: (before, current) => `The date changed from ${before} to ${current}.`,
79
+ removed: () => "The date was removed.",
80
+ }),
81
+ stringContext({ key: "core/location", value: "/repo" }),
82
+ ])
83
+
84
+ expect(yield* SystemContext.reconcile(changed, previous)).toEqual({
85
+ _tag: "Updated",
86
+ text: "The date changed from 2026-06-03 to 2026-06-04.",
87
+ snapshot: {
88
+ "core/date": { value: "2026-06-04", removed: "The date was removed." },
89
+ "core/location": { value: "/repo", removed: "Removed: /repo" },
90
+ },
91
+ })
92
+
93
+ expect(
94
+ yield* SystemContext.reconcile(
95
+ SystemContext.combine([
96
+ stringContext({ key: "core/date", value: "2026-06-03", removed: () => "The date was removed." }),
97
+ stringContext({ key: "core/location", value: "/repo" }),
98
+ ]),
99
+ previous,
100
+ ),
101
+ ).toEqual({ _tag: "Unchanged" })
102
+ }),
103
+ )
104
+
105
+ it.effect("uses the baseline for a newly added source", () =>
106
+ Effect.gen(function* () {
107
+ const context = stringContext({
108
+ key: "core/skills",
109
+ value: "effect",
110
+ baseline: (skill) => `Available skill: ${skill}`,
111
+ })
112
+
113
+ expect(yield* SystemContext.reconcile(context, {})).toEqual({
114
+ _tag: "Updated",
115
+ text: "Available skill: effect",
116
+ snapshot: { "core/skills": { value: "effect" } },
117
+ })
118
+ }),
119
+ )
120
+
121
+ it.effect("retains admitted snapshots while a source is temporarily unavailable", () =>
122
+ Effect.gen(function* () {
123
+ const previous = { "core/remote": { value: "instructions", removed: "Instructions removed" } }
124
+ const context = stringContext({ key: "core/remote", value: SystemContext.unavailable })
125
+
126
+ expect(yield* SystemContext.reconcile(context, previous)).toEqual({ _tag: "Unchanged" })
127
+ expect(yield* SystemContext.replace(context, previous)).toEqual({ _tag: "ReplacementBlocked" })
128
+ expect(yield* SystemContext.replace(context, {})).toMatchObject({ _tag: "ReplacementReady" })
129
+ }),
130
+ )
131
+
132
+ it.effect("blocks initialization while a source is unavailable", () =>
133
+ Effect.gen(function* () {
134
+ const exit = yield* SystemContext.initialize(
135
+ stringContext({ key: "core/remote", value: SystemContext.unavailable }),
136
+ ).pipe(Effect.exit)
137
+
138
+ expect(Exit.isFailure(exit)).toBe(true)
139
+ if (Exit.isFailure(exit))
140
+ expect(Cause.squash(exit.cause)).toEqual(
141
+ new SystemContext.InitializationBlocked({ keys: [key("core/remote")] }),
142
+ )
143
+ }),
144
+ )
145
+
146
+ it.effect("emits the previously stored removal message", () =>
147
+ Effect.gen(function* () {
148
+ expect(
149
+ yield* SystemContext.reconcile(SystemContext.empty, {
150
+ "core/instructions": { value: "contents", removed: "Instructions removed; stop applying them." },
151
+ }),
152
+ ).toEqual({
153
+ _tag: "Updated",
154
+ text: "Instructions removed; stop applying them.",
155
+ snapshot: {},
156
+ })
157
+ }),
158
+ )
159
+
160
+ it.effect("requests replacement when a source without removal text disappears", () =>
161
+ Effect.gen(function* () {
162
+ expect(
163
+ yield* SystemContext.reconcile(SystemContext.empty, { "core/date": { value: "2026-06-04" } }),
164
+ ).toMatchObject({
165
+ _tag: "ReplacementReady",
166
+ })
167
+ }),
168
+ )
169
+
170
+ it.effect("renders multiple removals in stable key order", () =>
171
+ Effect.gen(function* () {
172
+ expect(
173
+ yield* SystemContext.reconcile(SystemContext.empty, {
174
+ "core/z": { value: "z", removed: "Removed z" },
175
+ "core/a": { value: "a", removed: "Removed a" },
176
+ }),
177
+ ).toMatchObject({ _tag: "Updated", text: "Removed a\n\nRemoved z" })
178
+ }),
179
+ )
180
+
181
+ it.effect("rejects empty model-visible renderings", () =>
182
+ Effect.gen(function* () {
183
+ const exit = yield* SystemContext.initialize(
184
+ stringContext({ key: "core/empty", value: "value", baseline: () => "" }),
185
+ ).pipe(Effect.exit)
186
+
187
+ expect(Exit.isFailure(exit)).toBe(true)
188
+ if (Exit.isFailure(exit)) expect(Cause.pretty(exit.cause)).toContain("rendered an empty baseline")
189
+ }),
190
+ )
191
+
192
+ it.effect("requests replacement when a stored value no longer decodes", () =>
193
+ Effect.gen(function* () {
194
+ expect(
195
+ yield* SystemContext.reconcile(stringContext({ key: "core/date", value: "2026-06-04" }), {
196
+ "core/date": { value: 42, removed: "Date removed" },
197
+ }),
198
+ ).toMatchObject({ _tag: "ReplacementReady" })
199
+ }),
200
+ )
201
+
202
+ it.effect("replaces from one coherent source observation", () =>
203
+ Effect.gen(function* () {
204
+ let loads = 0
205
+ const context = SystemContext.make({
206
+ key: key("core/date"),
207
+ codec: Schema.toCodecJson(Schema.String),
208
+ load: Effect.sync(() => {
209
+ loads++
210
+ return "2026-06-04"
211
+ }),
212
+ baseline: String,
213
+ update: (_previous, current) => current,
214
+ })
215
+
216
+ expect(yield* SystemContext.reconcile(context, { "core/date": { value: 42 } })).toMatchObject({
217
+ _tag: "ReplacementReady",
218
+ generation: { baseline: "2026-06-04" },
219
+ })
220
+ expect(loads).toBe(1)
221
+ }),
222
+ )
223
+
224
+ it.effect("does not render discarded updates while replacing", () =>
225
+ Effect.gen(function* () {
226
+ let updates = 0
227
+ const context = SystemContext.combine([
228
+ stringContext({
229
+ key: "core/date",
230
+ value: "2026-06-04",
231
+ update: () => {
232
+ updates++
233
+ return "updated"
234
+ },
235
+ }),
236
+ stringContext({ key: "core/location", value: "/repo" }),
237
+ ])
238
+
239
+ expect(
240
+ yield* SystemContext.reconcile(context, {
241
+ "core/date": { value: "2026-06-03" },
242
+ "core/location": { value: 42 },
243
+ }),
244
+ ).toMatchObject({ _tag: "ReplacementReady" })
245
+ expect(updates).toBe(0)
246
+ }),
247
+ )
248
+
249
+ it.effect("blocks an incompatible replacement while another admitted source is unavailable", () =>
250
+ Effect.gen(function* () {
251
+ const previous = {
252
+ "core/date": { value: 42, removed: "Date removed" },
253
+ "core/remote": { value: "instructions", removed: "Instructions removed" },
254
+ }
255
+ const context = SystemContext.combine([
256
+ stringContext({ key: "core/date", value: "2026-06-04" }),
257
+ stringContext({ key: "core/remote", value: SystemContext.unavailable }),
258
+ ])
259
+
260
+ expect(yield* SystemContext.reconcile(context, previous)).toEqual({ _tag: "ReplacementBlocked" })
261
+ expect(yield* SystemContext.replace(context, previous)).toEqual({ _tag: "ReplacementBlocked" })
262
+ }),
263
+ )
264
+
265
+ it.effect("rejects duplicate source keys", () =>
266
+ Effect.sync(() => {
267
+ expect(() =>
268
+ SystemContext.combine([
269
+ stringContext({ key: "core/date", value: "one" }),
270
+ stringContext({ key: "core/date", value: "two" }),
271
+ ]),
272
+ ).toThrow(new SystemContext.DuplicateKeyError({ key: key("core/date") }))
273
+ }),
274
+ )
275
+
276
+ it.effect("combines contexts in order", () =>
277
+ Effect.gen(function* () {
278
+ expect(
279
+ (yield* SystemContext.initialize(
280
+ SystemContext.combine([
281
+ stringContext({ key: "core/date", value: "date" }),
282
+ stringContext({ key: "core/location", value: "location" }),
283
+ ]),
284
+ )).baseline,
285
+ ).toBe("date\n\nlocation")
286
+ }),
287
+ )
288
+
289
+ it.effect("requires namespaced source keys", () =>
290
+ Effect.sync(() => {
291
+ const decodeKey = Schema.decodeUnknownSync(SystemContext.Key)
292
+
293
+ expect(decodeKey("core/date")).toBe(key("core/date"))
294
+ expect(() => decodeKey("date")).toThrow()
295
+ }),
296
+ )
297
+
298
+ it.effect("requires namespaced durable snapshot keys", () =>
299
+ Effect.sync(() => {
300
+ const decodeSnapshot = Schema.decodeUnknownSync(SystemContext.Snapshot)
301
+
302
+ expect(Object.keys(decodeSnapshot({ "core/date": { value: "date" } }))).toEqual(["core/date"])
303
+ expect(() => decodeSnapshot({ date: { value: "date" } })).toThrow()
304
+ expect(() => decodeSnapshot({ "core/date": { value: "date", removed: "" } })).toThrow()
305
+ }),
306
+ )
307
+ })
@@ -0,0 +1,114 @@
1
+ import { describe, expect } from "bun:test"
2
+ import { Cause, Effect, Exit, Schema, Scope } from "effect"
3
+ import { AppNodeBuilder } from "@neurocode-ai/core/effect/app-node-builder"
4
+ import { SystemContext } from "@neurocode-ai/core/system-context"
5
+ import { SystemContextRegistry } from "@neurocode-ai/core/system-context/registry"
6
+ import { testEffect } from "../lib/effect"
7
+
8
+ const entry = (key: string, text: string, sourceKey = key) => ({
9
+ key: SystemContext.Key.make(key),
10
+ load: Effect.succeed(
11
+ SystemContext.make({
12
+ key: SystemContext.Key.make(sourceKey),
13
+ codec: Schema.toCodecJson(Schema.String),
14
+ load: Effect.succeed(text),
15
+ baseline: String,
16
+ update: (_previous, current) => current,
17
+ }),
18
+ ),
19
+ })
20
+
21
+ const it = testEffect(AppNodeBuilder.build(SystemContextRegistry.node))
22
+
23
+ describe("SystemContextRegistry", () => {
24
+ it.effect("loads empty system context when there are no entries", () =>
25
+ Effect.gen(function* () {
26
+ const registry = yield* SystemContextRegistry.Service
27
+
28
+ expect(yield* SystemContext.initialize(yield* registry.load())).toEqual({ baseline: "", snapshot: {} })
29
+ }),
30
+ )
31
+
32
+ it.effect("loads scoped entries in stable key order", () =>
33
+ Effect.gen(function* () {
34
+ const registry = yield* SystemContextRegistry.Service
35
+ yield* registry.register(entry("test/second", "second"))
36
+ yield* registry.register(entry("test/first", "first"))
37
+
38
+ expect((yield* SystemContext.initialize(yield* registry.load())).baseline).toBe("first\n\nsecond")
39
+ }),
40
+ )
41
+
42
+ it.effect("re-evaluates entry producers on each load", () =>
43
+ Effect.gen(function* () {
44
+ const registry = yield* SystemContextRegistry.Service
45
+ let loads = 0
46
+ yield* registry.register({
47
+ key: SystemContext.Key.make("test/dynamic"),
48
+ load: Effect.sync(() => {
49
+ loads++
50
+ return SystemContext.empty
51
+ }),
52
+ })
53
+
54
+ yield* registry.load()
55
+ yield* registry.load()
56
+
57
+ expect(loads).toBe(2)
58
+ }),
59
+ )
60
+
61
+ it.effect("propagates entry producer failures", () =>
62
+ Effect.gen(function* () {
63
+ const registry = yield* SystemContextRegistry.Service
64
+ const failure = new Error("entry failed")
65
+ yield* registry.register({ key: SystemContext.Key.make("test/failure"), load: Effect.die(failure) })
66
+
67
+ const exit = yield* registry.load().pipe(Effect.exit)
68
+
69
+ expect(Exit.isFailure(exit)).toBe(true)
70
+ if (Exit.isFailure(exit)) expect(Cause.squash(exit.cause)).toBe(failure)
71
+ }),
72
+ )
73
+
74
+ it.effect("rejects duplicate source keys from separate entries", () =>
75
+ Effect.gen(function* () {
76
+ const registry = yield* SystemContextRegistry.Service
77
+ yield* registry.register(entry("test/first", "first", "test/duplicate"))
78
+ yield* registry.register(entry("test/second", "second", "test/duplicate"))
79
+
80
+ const exit = yield* registry.load().pipe(Effect.exit)
81
+
82
+ expect(Exit.isFailure(exit)).toBe(true)
83
+ if (Exit.isFailure(exit)) {
84
+ expect(Cause.squash(exit.cause)).toBeInstanceOf(SystemContext.DuplicateKeyError)
85
+ expect(Cause.squash(exit.cause)).toMatchObject({ key: SystemContext.Key.make("test/duplicate") })
86
+ }
87
+ }),
88
+ )
89
+
90
+ it.effect("rejects duplicate entry keys", () =>
91
+ Effect.gen(function* () {
92
+ const registry = yield* SystemContextRegistry.Service
93
+ yield* registry.register(entry("test/duplicate", "first"))
94
+
95
+ const exit = yield* registry.register(entry("test/duplicate", "second", "test/other")).pipe(Effect.exit)
96
+
97
+ expect(Exit.isFailure(exit)).toBe(true)
98
+ if (Exit.isFailure(exit)) expect(Cause.pretty(exit.cause)).toContain("Duplicate system context entry key")
99
+ }),
100
+ )
101
+
102
+ it.effect("removes an entry when its owning scope closes", () =>
103
+ Effect.gen(function* () {
104
+ const registry = yield* SystemContextRegistry.Service
105
+ const scope = yield* Scope.make()
106
+ yield* registry.register(entry("test/scoped", "scoped")).pipe(Scope.provide(scope))
107
+
108
+ expect((yield* SystemContext.initialize(yield* registry.load())).baseline).toBe("scoped")
109
+
110
+ yield* Scope.close(scope, Exit.void)
111
+ expect(yield* SystemContext.initialize(yield* registry.load())).toEqual({ baseline: "", snapshot: {} })
112
+ }),
113
+ )
114
+ })