saeeol 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (545) hide show
  1. package/AGENTS.md +72 -0
  2. package/BUN_SHELL_MIGRATION_PLAN.md +136 -0
  3. package/Dockerfile +18 -0
  4. package/assets/saeeol.ico +0 -0
  5. package/bin/saeeol.cjs +3 -1
  6. package/bunfig.toml +7 -0
  7. package/database.db +0 -0
  8. package/drizzle.config.ts +10 -0
  9. package/git +0 -0
  10. package/migration/20260127222353_familiar_lady_ursula/migration.sql +90 -0
  11. package/migration/20260127222353_familiar_lady_ursula/snapshot.json +796 -0
  12. package/migration/20260211171708_add_project_commands/migration.sql +1 -0
  13. package/migration/20260211171708_add_project_commands/snapshot.json +806 -0
  14. package/migration/20260213144116_wakeful_the_professor/migration.sql +11 -0
  15. package/migration/20260213144116_wakeful_the_professor/snapshot.json +897 -0
  16. package/migration/20260225215848_workspace/migration.sql +7 -0
  17. package/migration/20260225215848_workspace/snapshot.json +959 -0
  18. package/migration/20260227213759_add_session_workspace_id/migration.sql +2 -0
  19. package/migration/20260227213759_add_session_workspace_id/snapshot.json +983 -0
  20. package/migration/20260228203230_blue_harpoon/migration.sql +17 -0
  21. package/migration/20260228203230_blue_harpoon/snapshot.json +1102 -0
  22. package/migration/20260303231226_add_workspace_fields/migration.sql +5 -0
  23. package/migration/20260303231226_add_workspace_fields/snapshot.json +1013 -0
  24. package/migration/20260309230000_move_org_to_state/migration.sql +3 -0
  25. package/migration/20260309230000_move_org_to_state/snapshot.json +1156 -0
  26. package/migration/20260312043431_session_message_cursor/migration.sql +4 -0
  27. package/migration/20260312043431_session_message_cursor/snapshot.json +1168 -0
  28. package/migration/20260323234822_events/migration.sql +13 -0
  29. package/migration/20260323234822_events/snapshot.json +1271 -0
  30. package/migration/20260410174513_workspace-name/migration.sql +16 -0
  31. package/migration/20260410174513_workspace-name/snapshot.json +1271 -0
  32. package/migration/20260413175956_chief_energizer/migration.sql +13 -0
  33. package/migration/20260413175956_chief_energizer/snapshot.json +1399 -0
  34. package/migration/20260423070820_add_icon_url_override/migration.sql +2 -0
  35. package/migration/20260423070820_add_icon_url_override/snapshot.json +1409 -0
  36. package/migration/20260428004200_add_session_path/migration.sql +1 -0
  37. package/migration/20260428004200_add_session_path/snapshot.json +1419 -0
  38. package/npm/bin/saeeol +42 -0
  39. package/npm/package.json +39 -0
  40. package/npm/postinstall.js +162 -0
  41. package/package.json +201 -207
  42. package/parsers-config.ts +289 -0
  43. package/script/build.ts +393 -0
  44. package/script/check-migrations.ts +16 -0
  45. package/script/fix-node-pty.ts +34 -0
  46. package/script/generate.ts +23 -0
  47. package/script/postinstall.mjs +189 -0
  48. package/script/publish.ts +200 -0
  49. package/script/run-workspace-server +106 -0
  50. package/script/schema.ts +63 -0
  51. package/script/test-runner.ts +420 -0
  52. package/script/time.ts +6 -0
  53. package/script/trace-imports.ts +153 -0
  54. package/script/upgrade-opentui.ts +64 -0
  55. package/scripts/diff-sdk-types.sh +52 -0
  56. package/specs/effect/facades.md +221 -0
  57. package/specs/effect/http-api.md +401 -0
  58. package/specs/effect/instance-context.md +309 -0
  59. package/specs/effect/loose-ends.md +34 -0
  60. package/specs/effect/migration.md +299 -0
  61. package/specs/effect/routes.md +64 -0
  62. package/specs/effect/schema.md +399 -0
  63. package/specs/effect/server-package.md +668 -0
  64. package/specs/effect/tools.md +90 -0
  65. package/specs/tui-plugins.md +433 -0
  66. package/specs/v2/api.ts +67 -0
  67. package/specs/v2/keymappings.md +10 -0
  68. package/specs/v2/message-shape.md +136 -0
  69. package/src/acp/agent-message.ts +1 -1
  70. package/src/acp/agent-utils.ts +1 -1
  71. package/src/boxes/ansi.ts +17 -0
  72. package/src/boxes/atomic-write.ts +35 -0
  73. package/src/boxes/b64.ts +58 -0
  74. package/src/boxes/bash-security.ts +129 -0
  75. package/src/boxes/bom.ts +18 -0
  76. package/src/boxes/cancel.ts +16 -0
  77. package/src/boxes/chop.ts +12 -0
  78. package/src/boxes/clamp.ts +3 -0
  79. package/src/boxes/compact.ts +9 -0
  80. package/src/boxes/cost-tracker.ts +116 -0
  81. package/src/boxes/dataurl.ts +29 -0
  82. package/src/boxes/delay.ts +27 -0
  83. package/src/boxes/diff-apply.ts +53 -0
  84. package/src/boxes/disposable.ts +13 -0
  85. package/src/boxes/err.ts +34 -0
  86. package/src/boxes/human.ts +47 -0
  87. package/src/boxes/iife.ts +9 -0
  88. package/src/boxes/latch.ts +8 -0
  89. package/src/boxes/memory.ts +198 -0
  90. package/src/boxes/net.ts +16 -0
  91. package/src/boxes/plural.ts +4 -0
  92. package/src/boxes/puny.ts +21 -0
  93. package/src/boxes/retry.ts +49 -0
  94. package/src/boxes/rwlock.ts +41 -0
  95. package/src/boxes/schedule.ts +71 -0
  96. package/src/boxes/scope.ts +21 -0
  97. package/src/boxes/tokens.ts +9 -0
  98. package/src/boxes/ttl-cache.ts +63 -0
  99. package/src/boxes/typed-event.ts +51 -0
  100. package/src/boxes/uid.ts +50 -0
  101. package/src/boxes/wave6.test.ts +296 -0
  102. package/src/boxes/wildcard.ts +58 -0
  103. package/src/bus/global.ts +1 -1
  104. package/src/cli/cmd/github-run-api.ts +2 -2
  105. package/src/cli/cmd/run-events.ts +2 -2
  106. package/src/cli/cmd/tui/component/logo.tsx +1 -1
  107. package/src/cli/cmd/tui/component/prompt/use-prompt-memos.ts +2 -2
  108. package/src/cli/cmd/tui/context/app/editor-zed.ts +1 -1
  109. package/src/cli/cmd/tui/context/app/editor.ts +1 -1
  110. package/src/cli/cmd/tui/context/app/theme.tsx +1 -1
  111. package/src/cli/cmd/tui/preflight.ts +138 -0
  112. package/src/cli/cmd/tui/thread.ts +20 -0
  113. package/src/cli/cmd/tui/util/revert-diff.ts +1 -1
  114. package/src/overlay/cli/cmd/roll-call-call.ts +1 -1
  115. package/src/overlay/cost-tracker/format.ts +1 -1
  116. package/src/overlay/cost-tracker/index.ts +4 -4
  117. package/src/overlay/cost-tracker/state.ts +2 -2
  118. package/src/overlay/cost-tracker/types.ts +2 -2
  119. package/src/overlay/memory/age.ts +1 -1
  120. package/src/overlay/memory/index.ts +4 -4
  121. package/src/overlay/memory/paths.ts +2 -2
  122. package/src/overlay/memory/scan.ts +1 -1
  123. package/src/overlay/memory/types.ts +2 -2
  124. package/src/overlay/tool/bash-security.ts +3 -3
  125. package/src/overlay/util/url.ts +1 -1
  126. package/src/plugin/codex-auth.ts +1 -1
  127. package/src/provider/model-cache.ts +2 -2
  128. package/src/provider/provider-resolve.ts +3 -3
  129. package/src/provider/transform-message.ts +1 -1
  130. package/src/server/routes/game.ts +284 -0
  131. package/src/server/server.ts +2 -0
  132. package/src/session/core/compaction/compaction-helpers.ts +1 -1
  133. package/src/session/core/compaction/compaction.ts +1 -1
  134. package/src/session/core/session.ts +2 -0
  135. package/src/sessions/ingest-queue.ts +2 -2
  136. package/src/sessions/remote-ws.ts +1 -1
  137. package/src/tool/workflow/question.ts +1 -1
  138. package/src/util/abort.ts +1 -1
  139. package/src/util/bom.ts +2 -2
  140. package/src/util/color.ts +1 -1
  141. package/src/util/data-url.ts +1 -1
  142. package/src/util/defer.ts +1 -1
  143. package/src/util/error.ts +2 -2
  144. package/src/util/filesystem.ts +2 -2
  145. package/src/util/format.ts +1 -1
  146. package/src/util/iife.ts +1 -1
  147. package/src/util/local-context.ts +1 -1
  148. package/src/util/locale.ts +2 -2
  149. package/src/util/lock.ts +1 -1
  150. package/src/util/network.ts +1 -1
  151. package/src/util/signal.ts +1 -1
  152. package/src/util/token.ts +1 -1
  153. package/src/util/wildcard.ts +1 -1
  154. package/sst-env.d.ts +10 -0
  155. package/test/AGENTS.md +133 -0
  156. package/test/account/repo.test.ts +352 -0
  157. package/test/account/service.test.ts +456 -0
  158. package/test/acp/agent-interface.test.ts +51 -0
  159. package/test/acp/event-subscription.test.ts +725 -0
  160. package/test/agent/agent.test.ts +890 -0
  161. package/test/auth/auth.test.ts +86 -0
  162. package/test/bun/registry.test.ts +75 -0
  163. package/test/bus/bus-effect.test.ts +161 -0
  164. package/test/bus/bus-integration.test.ts +87 -0
  165. package/test/bus/bus.test.ts +219 -0
  166. package/test/cli/account.test.ts +26 -0
  167. package/test/cli/auto-mode.test.ts +75 -0
  168. package/test/cli/bin-saeeol.test.ts +8 -0
  169. package/test/cli/cmd/tui/prompt-part.test.ts +47 -0
  170. package/test/cli/cmd/tui/prompt-traits.test.ts +38 -0
  171. package/test/cli/cmd/tui/sync.test.tsx +159 -0
  172. package/test/cli/error.test.ts +18 -0
  173. package/test/cli/github-action.test.ts +198 -0
  174. package/test/cli/github-remote.test.ts +85 -0
  175. package/test/cli/import.test.ts +97 -0
  176. package/test/cli/install-artifact.test.ts +72 -0
  177. package/test/cli/plugin-auth-picker.test.ts +120 -0
  178. package/test/cli/pr.test.ts +59 -0
  179. package/test/cli/tui/editor-context-zed.test.ts +356 -0
  180. package/test/cli/tui/editor-context.test.tsx +228 -0
  181. package/test/cli/tui/keybind-plugin.test.ts +90 -0
  182. package/test/cli/tui/markdown.test.ts +161 -0
  183. package/test/cli/tui/plugin-add.test.ts +111 -0
  184. package/test/cli/tui/plugin-install.test.ts +87 -0
  185. package/test/cli/tui/plugin-lifecycle.test.ts +224 -0
  186. package/test/cli/tui/plugin-loader-entrypoint.test.ts +484 -0
  187. package/test/cli/tui/plugin-loader-pure.test.ts +71 -0
  188. package/test/cli/tui/plugin-loader.test.ts +816 -0
  189. package/test/cli/tui/plugin-toggle.test.ts +157 -0
  190. package/test/cli/tui/revert-diff.test.ts +35 -0
  191. package/test/cli/tui/slot-replace.test.tsx +47 -0
  192. package/test/cli/tui/theme-store.test.ts +54 -0
  193. package/test/cli/tui/thread.test.ts +28 -0
  194. package/test/cli/tui/transcript.test.ts +426 -0
  195. package/test/cli/tui/usage.test.ts +60 -0
  196. package/test/cli/tui/use-event.test.tsx +175 -0
  197. package/test/config/agent-color.test.ts +67 -0
  198. package/test/config/config.test.ts +2544 -0
  199. package/test/config/fixtures/empty-frontmatter.md +4 -0
  200. package/test/config/fixtures/frontmatter.md +28 -0
  201. package/test/config/fixtures/markdown-header.md +11 -0
  202. package/test/config/fixtures/no-frontmatter.md +1 -0
  203. package/test/config/fixtures/weird-model-id.md +13 -0
  204. package/test/config/lsp.test.ts +87 -0
  205. package/test/config/markdown.test.ts +228 -0
  206. package/test/config/plugin.test.ts +0 -0
  207. package/test/config/tui.test.ts +624 -0
  208. package/test/control-plane/adapters.test.ts +71 -0
  209. package/test/control-plane/workspace.test.ts +1526 -0
  210. package/test/effect/app-runtime-logger.test.ts +98 -0
  211. package/test/effect/config-service.test.ts +65 -0
  212. package/test/effect/instance-state.test.ts +394 -0
  213. package/test/effect/run-service.test.ts +89 -0
  214. package/test/effect/runner.test.ts +523 -0
  215. package/test/fake/provider.ts +82 -0
  216. package/test/file/fsmonitor.test.ts +68 -0
  217. package/test/file/ignore.test.ts +10 -0
  218. package/test/file/index.test.ts +954 -0
  219. package/test/file/path-traversal.test.ts +205 -0
  220. package/test/file/ripgrep.test.ts +226 -0
  221. package/test/file/watcher.test.ts +249 -0
  222. package/test/filesystem/filesystem.test.ts +319 -0
  223. package/test/fixture/db.ts +11 -0
  224. package/test/fixture/fixture.test.ts +26 -0
  225. package/test/fixture/fixture.ts +175 -0
  226. package/test/fixture/flock-worker.ts +72 -0
  227. package/test/fixture/log-init-worker.ts +62 -0
  228. package/test/fixture/lsp/fake-lsp-server.js +249 -0
  229. package/test/fixture/plug-worker.ts +93 -0
  230. package/test/fixture/plugin-meta-worker.ts +19 -0
  231. package/test/fixture/skills/agents-sdk/SKILL.md +152 -0
  232. package/test/fixture/skills/cloudflare/SKILL.md +211 -0
  233. package/test/fixture/skills/index.json +6 -0
  234. package/test/fixture/tui-plugin.ts +323 -0
  235. package/test/fixture/tui-runtime.ts +31 -0
  236. package/test/format/format.test.ts +272 -0
  237. package/test/git/git.test.ts +128 -0
  238. package/test/ide/ide.test.ts +82 -0
  239. package/test/installation/installation.test.ts +168 -0
  240. package/test/keybind.test.ts +421 -0
  241. package/test/lib/effect.ts +53 -0
  242. package/test/lib/filesystem.ts +10 -0
  243. package/test/lib/llm-server.ts +778 -0
  244. package/test/lib/websocket.ts +46 -0
  245. package/test/lsp/client.test.ts +482 -0
  246. package/test/lsp/index.test.ts +160 -0
  247. package/test/lsp/launch.test.ts +22 -0
  248. package/test/lsp/lifecycle.test.ts +184 -0
  249. package/test/ltm/ltm.test.ts +230 -0
  250. package/test/mcp/headers.test.ts +178 -0
  251. package/test/mcp/lifecycle.test.ts +787 -0
  252. package/test/mcp/oauth-auto-connect.test.ts +311 -0
  253. package/test/mcp/oauth-browser.test.ts +276 -0
  254. package/test/mcp/oauth-callback.test.ts +34 -0
  255. package/test/memory/abort-leak-webfetch.ts +49 -0
  256. package/test/memory/abort-leak.test.ts +128 -0
  257. package/test/patch/patch.test.ts +348 -0
  258. package/test/permission/arity.test.ts +33 -0
  259. package/test/permission/next.test.ts +1227 -0
  260. package/test/permission/next.toConfig.test.ts +110 -0
  261. package/test/permission-task.test.ts +326 -0
  262. package/test/plugin/auth-override.test.ts +79 -0
  263. package/test/plugin/cloudflare.test.ts +68 -0
  264. package/test/plugin/codex.test.ts +123 -0
  265. package/test/plugin/github-copilot-models.test.ts +261 -0
  266. package/test/plugin/install-concurrency.test.ts +140 -0
  267. package/test/plugin/install.test.ts +570 -0
  268. package/test/plugin/loader-shared.test.ts +1169 -0
  269. package/test/plugin/meta.test.ts +137 -0
  270. package/test/plugin/plugin-contract.test.ts +291 -0
  271. package/test/plugin/shared.test.ts +88 -0
  272. package/test/plugin/trigger.test.ts +102 -0
  273. package/test/plugin/workspace-adapter.test.ts +109 -0
  274. package/test/preload.ts +77 -0
  275. package/test/project/instance.test.ts +276 -0
  276. package/test/project/migrate-global.test.ts +152 -0
  277. package/test/project/project.test.ts +600 -0
  278. package/test/project/vcs.test.ts +286 -0
  279. package/test/project/worktree-remove.test.ts +126 -0
  280. package/test/project/worktree.test.ts +223 -0
  281. package/test/provider/amazon-bedrock.test.ts +462 -0
  282. package/test/provider/copilot/convert-to-copilot-messages.test.ts +523 -0
  283. package/test/provider/copilot/copilot-chat-model.test.ts +592 -0
  284. package/test/provider/gitlab-duo.test.ts +413 -0
  285. package/test/provider/local.test.ts +208 -0
  286. package/test/provider/models.test.ts +261 -0
  287. package/test/provider/provider-category.test.ts +190 -0
  288. package/test/provider/provider.test.ts +2758 -0
  289. package/test/provider/transform.test.ts +3681 -0
  290. package/test/pty/pty-output-isolation.test.ts +147 -0
  291. package/test/pty/pty-session.test.ts +102 -0
  292. package/test/pty/pty-shell.test.ts +104 -0
  293. package/test/question/question.test.ts +490 -0
  294. package/test/saeeol/agent-global-config-dirs.test.ts +24 -0
  295. package/test/saeeol/agent-manager-tool.test.ts +71 -0
  296. package/test/saeeol/agent-permission-overrides.test.ts +75 -0
  297. package/test/saeeol/agent-skill-permissions.test.ts +37 -0
  298. package/test/saeeol/ask-agent-permissions.test.ts +303 -0
  299. package/test/saeeol/bash-hierarchy.test.ts +64 -0
  300. package/test/saeeol/bash-permission-metadata.test.ts +66 -0
  301. package/test/saeeol/bash-security-extended.test.ts +243 -0
  302. package/test/saeeol/bedrock-claude-empty-content.test.ts +138 -0
  303. package/test/saeeol/boxes-integration.test.ts +415 -0
  304. package/test/saeeol/builtin-skills.test.ts +75 -0
  305. package/test/saeeol/cleanup.ts +28 -0
  306. package/test/saeeol/cli/dev-setup.test.ts +74 -0
  307. package/test/saeeol/cli/roll-call.test.ts +161 -0
  308. package/test/saeeol/cli-run-auto-helper.test.ts +58 -0
  309. package/test/saeeol/codex-auth-refresh.test.ts +124 -0
  310. package/test/saeeol/commit-message/generate.test.ts +188 -0
  311. package/test/saeeol/commit-message/git-context.test.ts +303 -0
  312. package/test/saeeol/commit-message-windows.test.ts +38 -0
  313. package/test/saeeol/compaction-payload-recovery.test.ts +406 -0
  314. package/test/saeeol/compaction-preservation-audit.test.ts +122 -0
  315. package/test/saeeol/compaction-skip-guard.test.ts +224 -0
  316. package/test/saeeol/compaction-smart-select.test.ts +100 -0
  317. package/test/saeeol/config/config.test.ts +166 -0
  318. package/test/saeeol/config/indexing-default-plugin.test.ts +82 -0
  319. package/test/saeeol/config/opentelemetry-default.test.ts +29 -0
  320. package/test/saeeol/config-gitignore.test.ts +70 -0
  321. package/test/saeeol/config-injector.test.ts +305 -0
  322. package/test/saeeol/config-resilience.test.ts +234 -0
  323. package/test/saeeol/config-validation.test.ts +183 -0
  324. package/test/saeeol/cost-propagation.test.ts +94 -0
  325. package/test/saeeol/cost-tracker-extended.test.ts +141 -0
  326. package/test/saeeol/cost-tracker.test.ts +64 -0
  327. package/test/saeeol/custom-provider-delete.test.ts +149 -0
  328. package/test/saeeol/diff-full.test.ts +226 -0
  329. package/test/saeeol/edit-permission-filediff.test.ts +223 -0
  330. package/test/saeeol/encoding.test.ts +364 -0
  331. package/test/saeeol/enhance-prompt.test.ts +61 -0
  332. package/test/saeeol/ensure-plan-dir.test.ts +32 -0
  333. package/test/saeeol/errors.test.ts +144 -0
  334. package/test/saeeol/external-directory-boundary.test.ts +96 -0
  335. package/test/saeeol/gateway-headers.test.ts +88 -0
  336. package/test/saeeol/help.test.ts +191 -0
  337. package/test/saeeol/ignore-migrator.test.ts +308 -0
  338. package/test/saeeol/indexing-auth.test.ts +45 -0
  339. package/test/saeeol/indexing-feature.test.ts +44 -0
  340. package/test/saeeol/indexing-label.test.ts +70 -0
  341. package/test/saeeol/indexing-startup.test.ts +381 -0
  342. package/test/saeeol/indexing-worktree.test.ts +73 -0
  343. package/test/saeeol/instruction.test.ts +136 -0
  344. package/test/saeeol/lancedb-runtime.test.ts +116 -0
  345. package/test/saeeol/loader-auth.test.ts +168 -0
  346. package/test/saeeol/local-model.test.ts +621 -0
  347. package/test/saeeol/logo.test.ts +31 -0
  348. package/test/saeeol/lsp-typescript-lightweight.test.ts +89 -0
  349. package/test/saeeol/mcp-branding.test.ts +33 -0
  350. package/test/saeeol/mcp-docker-rm.test.ts +32 -0
  351. package/test/saeeol/mcp-migrator.test.ts +736 -0
  352. package/test/saeeol/mcp-oauth-callback.test.ts +33 -0
  353. package/test/saeeol/memory-io.test.ts +198 -0
  354. package/test/saeeol/memory-paths.test.ts +87 -0
  355. package/test/saeeol/memory-security.test.ts +166 -0
  356. package/test/saeeol/model-cache-org.test.ts +164 -0
  357. package/test/saeeol/model-info-panel-utils.test.ts +52 -0
  358. package/test/saeeol/model-info-panel.types.test.ts +7 -0
  359. package/test/saeeol/models-401-fallback.test.ts +52 -0
  360. package/test/saeeol/modes-migrator.test.ts +320 -0
  361. package/test/saeeol/nvidia-headers.test.ts +74 -0
  362. package/test/saeeol/patch-jsonc.test.ts +73 -0
  363. package/test/saeeol/patch.test.ts +172 -0
  364. package/test/saeeol/paths.test.ts +265 -0
  365. package/test/saeeol/permission/config-paths.test.ts +174 -0
  366. package/test/saeeol/permission/env-read.test.ts +149 -0
  367. package/test/saeeol/permission/external-directory-allow.test.ts +327 -0
  368. package/test/saeeol/permission/next.always-rules.test.ts +882 -0
  369. package/test/saeeol/permission/next.reply-http.test.ts +205 -0
  370. package/test/saeeol/permission/next.reply-routing.test.ts +184 -0
  371. package/test/saeeol/plan-exit-detection.test.ts +494 -0
  372. package/test/saeeol/plan-followup.test.ts +1376 -0
  373. package/test/saeeol/project-config-update.test.ts +120 -0
  374. package/test/saeeol/project-id.test.ts +455 -0
  375. package/test/saeeol/provider-cost.test.ts +171 -0
  376. package/test/saeeol/provider-list-failed-state.test.ts +100 -0
  377. package/test/saeeol/question-dismiss-all.test.ts +174 -0
  378. package/test/saeeol/read-directory.test.ts +116 -0
  379. package/test/saeeol/rules-migrator.test.ts +257 -0
  380. package/test/saeeol/run-auto.test.ts +176 -0
  381. package/test/saeeol/run-network.test.ts +224 -0
  382. package/test/saeeol/semantic-search.test.ts +186 -0
  383. package/test/saeeol/server/permission-allow-everything.test.ts +125 -0
  384. package/test/saeeol/session/instruction-substitution.test.ts +72 -0
  385. package/test/saeeol/session/platform-attribution.test.ts +118 -0
  386. package/test/saeeol/session/session.test.ts +105 -0
  387. package/test/saeeol/session-compaction-cap.test.ts +399 -0
  388. package/test/saeeol/session-compaction-chunks.test.ts +501 -0
  389. package/test/saeeol/session-compaction-safety.test.ts +481 -0
  390. package/test/saeeol/session-fork-remap.test.ts +251 -0
  391. package/test/saeeol/session-import-service.test.ts +114 -0
  392. package/test/saeeol/session-list.test.ts +47 -0
  393. package/test/saeeol/session-message-metadata.test.ts +128 -0
  394. package/test/saeeol/session-overflow.test.ts +78 -0
  395. package/test/saeeol/session-processor-empty-tool-calls.test.ts +571 -0
  396. package/test/saeeol/session-processor-network-offline.test.ts +204 -0
  397. package/test/saeeol/session-processor-retry-limit.test.ts +238 -0
  398. package/test/saeeol/session-processor-review-telemetry.test.ts +82 -0
  399. package/test/saeeol/session-prompt-compaction-safety.test.ts +517 -0
  400. package/test/saeeol/session-prompt-queue.test.ts +815 -0
  401. package/test/saeeol/sessions/inflight-cache.test.ts +157 -0
  402. package/test/saeeol/sessions/ingest-queue.test.ts +402 -0
  403. package/test/saeeol/sessions/remote-protocol.test.ts +258 -0
  404. package/test/saeeol/sessions/remote-sender.test.ts +1036 -0
  405. package/test/saeeol/sessions/remote-ws.test.ts +367 -0
  406. package/test/saeeol/sessions/sessions-enable-remote.test.disable +181 -0
  407. package/test/saeeol/slot-prop-reactivity.test.ts +142 -0
  408. package/test/saeeol/snapshot-cache.test.ts +84 -0
  409. package/test/saeeol/snapshot-freeze-repro.test.ts +100 -0
  410. package/test/saeeol/snapshot-track-timeout.test.ts +519 -0
  411. package/test/saeeol/stats-subagent-cost.test.ts +123 -0
  412. package/test/saeeol/suggestion/auto-dismiss.test.ts +65 -0
  413. package/test/saeeol/suggestion/suggestion.test.ts +145 -0
  414. package/test/saeeol/suggestion/tool.test.ts +298 -0
  415. package/test/saeeol/summary-file-diff.test.ts +28 -0
  416. package/test/saeeol/system-prompt.test.ts +142 -0
  417. package/test/saeeol/task-nesting.test.ts +193 -0
  418. package/test/saeeol/telemetry/feedback.test.ts +8 -0
  419. package/test/saeeol/todo-view.test.ts +57 -0
  420. package/test/saeeol/tool-encoding.test.ts +455 -0
  421. package/test/saeeol/tool-registry-indexing-import-failure.test.ts +49 -0
  422. package/test/saeeol/tool-registry-indexing.test.ts +236 -0
  423. package/test/saeeol/tool-registry-semantic-import-failure.test.ts +55 -0
  424. package/test/saeeol/tool-task-model.test.ts +352 -0
  425. package/test/saeeol/transform-opus-4.7.test.ts +89 -0
  426. package/test/saeeol/tui-diff.test.ts +91 -0
  427. package/test/saeeol/tui-sync.test.ts +80 -0
  428. package/test/saeeol/util/url.test.ts +141 -0
  429. package/test/saeeol/workflows-migrator.test.ts +261 -0
  430. package/test/saeeol/worktree-diff-summary.test.ts +64 -0
  431. package/test/saeeol/worktree-diff.test.ts +223 -0
  432. package/test/saeeol/worktree-remove-lock.test.ts +82 -0
  433. package/test/server/AGENTS.md +15 -0
  434. package/test/server/contract.test.ts +357 -0
  435. package/test/server/experimental-session-list.test.ts +157 -0
  436. package/test/server/global-session-list.test.ts +155 -0
  437. package/test/server/httpapi-authorization.test.ts +103 -0
  438. package/test/server/httpapi-bridge.test.ts +440 -0
  439. package/test/server/httpapi-config.test.ts +67 -0
  440. package/test/server/httpapi-cors.test.ts +89 -0
  441. package/test/server/httpapi-event.test.ts +57 -0
  442. package/test/server/httpapi-experimental.test.ts +219 -0
  443. package/test/server/httpapi-file.test.ts +79 -0
  444. package/test/server/httpapi-instance-context.test.ts +237 -0
  445. package/test/server/httpapi-instance.legacy.test.ts +140 -0
  446. package/test/server/httpapi-instance.test.ts +83 -0
  447. package/test/server/httpapi-json-parity.test.ts +263 -0
  448. package/test/server/httpapi-mcp-oauth.test.ts +76 -0
  449. package/test/server/httpapi-mcp.test.ts +189 -0
  450. package/test/server/httpapi-provider.test.ts +153 -0
  451. package/test/server/httpapi-pty-websocket.test.ts +16 -0
  452. package/test/server/httpapi-pty.test.ts +175 -0
  453. package/test/server/httpapi-raw-route-auth.test.ts +89 -0
  454. package/test/server/httpapi-sdk.test.ts +681 -0
  455. package/test/server/httpapi-session.test.ts +464 -0
  456. package/test/server/httpapi-sync.test.ts +130 -0
  457. package/test/server/httpapi-tui.test.ts +121 -0
  458. package/test/server/httpapi-workspace-routing.test.ts +471 -0
  459. package/test/server/httpapi-workspace.test.ts +427 -0
  460. package/test/server/lib/conformance.ts +88 -0
  461. package/test/server/lib/stateful.ts +112 -0
  462. package/test/server/project-init-git.test.ts +113 -0
  463. package/test/server/proxy-util.test.ts +113 -0
  464. package/test/server/session-actions.test.ts +49 -0
  465. package/test/server/session-list.test.ts +238 -0
  466. package/test/server/session-messages.test.ts +167 -0
  467. package/test/server/session-select.test.ts +100 -0
  468. package/test/server/trace-attributes.test.ts +76 -0
  469. package/test/server/workspace-proxy.test.ts +165 -0
  470. package/test/server/workspace-routing.test.ts +85 -0
  471. package/test/session/compaction.test.ts +2420 -0
  472. package/test/session/instruction.test.ts +247 -0
  473. package/test/session/llm.test.ts +1273 -0
  474. package/test/session/message-v2.test.ts +1291 -0
  475. package/test/session/messages-pagination.test.ts +1173 -0
  476. package/test/session/network.test.ts +249 -0
  477. package/test/session/processor-effect.test.ts +847 -0
  478. package/test/session/prompt.test.ts +2131 -0
  479. package/test/session/retry.test.ts +340 -0
  480. package/test/session/revert-compact.test.ts +639 -0
  481. package/test/session/schema-decoding.test.ts +311 -0
  482. package/test/session/session-entry-stepper.test.ts +917 -0
  483. package/test/session/session-schema.test.ts +76 -0
  484. package/test/session/snapshot-tool-race.test.ts +257 -0
  485. package/test/session/structured-output-integration.test.ts +265 -0
  486. package/test/session/structured-output.test.ts +381 -0
  487. package/test/session/system.test.ts +73 -0
  488. package/test/share/share-next.test.ts +333 -0
  489. package/test/shell/shell.test.ts +99 -0
  490. package/test/skill/discovery.test.ts +116 -0
  491. package/test/skill/skill.test.ts +393 -0
  492. package/test/smoke/.tui-debug-output.txt +1 -0
  493. package/test/smoke/.tui-debug-plain.txt +1 -0
  494. package/test/smoke/.tui-walkthrough-report.txt +122 -0
  495. package/test/smoke/smoke-tui-pty.test.ts +123 -0
  496. package/test/smoke/smoke-tui.mjs +83 -0
  497. package/test/smoke/tui-walkthrough.test.ts +520 -0
  498. package/test/snapshot/snapshot.test.ts +1531 -0
  499. package/test/storage/db.test.ts +23 -0
  500. package/test/storage/json-migration.test.ts +832 -0
  501. package/test/storage/storage.test.ts +293 -0
  502. package/test/suggestion/suggestion.test.ts +1 -0
  503. package/test/sync/index.test.ts +256 -0
  504. package/test/tool/__snapshots__/parameters.test.ts.snap +500 -0
  505. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  506. package/test/tool/apply_patch.test.ts +614 -0
  507. package/test/tool/bash.test.ts +1225 -0
  508. package/test/tool/diagnostics-filter.test.ts +55 -0
  509. package/test/tool/edit.test.ts +754 -0
  510. package/test/tool/external-directory.test.ts +169 -0
  511. package/test/tool/fixtures/large-image.png +0 -0
  512. package/test/tool/fixtures/models-api.json +65179 -0
  513. package/test/tool/glob.test.ts +107 -0
  514. package/test/tool/grep.test.ts +114 -0
  515. package/test/tool/lsp.test.ts +187 -0
  516. package/test/tool/parameters.test.ts +243 -0
  517. package/test/tool/question.test.ts +129 -0
  518. package/test/tool/read.test.ts +500 -0
  519. package/test/tool/recall.test.ts +151 -0
  520. package/test/tool/registry.test.ts +203 -0
  521. package/test/tool/skill.test.ts +135 -0
  522. package/test/tool/suggest.test.ts +1 -0
  523. package/test/tool/task.test.ts +612 -0
  524. package/test/tool/tool-define.test.ts +99 -0
  525. package/test/tool/truncation.test.ts +260 -0
  526. package/test/tool/webfetch.test.ts +103 -0
  527. package/test/tool/write.test.ts +291 -0
  528. package/test/util/data-url.test.ts +14 -0
  529. package/test/util/effect-zod.test.ts +754 -0
  530. package/test/util/error.test.ts +38 -0
  531. package/test/util/filesystem.test.ts +656 -0
  532. package/test/util/format.test.ts +59 -0
  533. package/test/util/glob.test.ts +164 -0
  534. package/test/util/iife.test.ts +36 -0
  535. package/test/util/lazy.test.ts +50 -0
  536. package/test/util/lock.test.ts +72 -0
  537. package/test/util/log.test.ts +86 -0
  538. package/test/util/module.test.ts +59 -0
  539. package/test/util/process.test.ts +128 -0
  540. package/test/util/timeout.test.ts +21 -0
  541. package/test/util/which.test.ts +100 -0
  542. package/test/util/wildcard.test.ts +90 -0
  543. package/test/workspace/workspace-restore.test.ts +296 -0
  544. package/src/provider/models-snapshot.d.ts +0 -2
  545. package/src/provider/models-snapshot.js +0 -3
@@ -0,0 +1,121 @@
1
+ import { afterEach, describe, expect, test } from "bun:test"
2
+ import type { Context } from "hono"
3
+ import { Flag } from "@saeeol/core/flag/flag"
4
+ import { GlobalBus } from "../../src/bus/global"
5
+ import { TuiEvent } from "../../src/cli/cmd/tui/event"
6
+ import { SessionID } from "../../src/session/schema"
7
+ import { Instance } from "../../src/project/instance"
8
+ import { TuiApi, TuiPaths } from "../../src/server/routes/instance/httpapi/groups/tui"
9
+ import { callTui } from "../../src/server/routes/instance/tui"
10
+ import { Server } from "../../src/server/server"
11
+ import * as Log from "@saeeol/core/util/log"
12
+ import { OpenApi } from "effect/unstable/httpapi"
13
+ import { resetDatabase } from "../fixture/db"
14
+ import { disposeAllInstances, tmpdir } from "../fixture/fixture"
15
+
16
+ void Log.init({ print: false })
17
+
18
+ const original = Flag.SAEEOL_EXPERIMENTAL_HTTPAPI
19
+
20
+ function app(experimental = true) {
21
+ Flag.SAEEOL_EXPERIMENTAL_HTTPAPI = experimental
22
+ return experimental ? Server.Default().app : Server.Legacy().app
23
+ }
24
+
25
+ function nextCommandExecute() {
26
+ return new Promise<unknown>((resolve) => {
27
+ const listener = (event: { payload: { type?: string; properties?: { command?: unknown } } }) => {
28
+ if (event.payload.type !== TuiEvent.CommandExecute.type) return
29
+ GlobalBus.off("event", listener)
30
+ resolve(event.payload.properties?.command)
31
+ }
32
+ GlobalBus.on("event", listener)
33
+ })
34
+ }
35
+
36
+ async function expectTrue(path: string, headers: Record<string, string>, body?: unknown) {
37
+ const response = await app().request(path, {
38
+ method: "POST",
39
+ headers: { ...headers, "content-type": "application/json" },
40
+ body: JSON.stringify(body ?? {}),
41
+ })
42
+ expect(response.status).toBe(200)
43
+ expect(await response.json()).toBe(true)
44
+ }
45
+
46
+ afterEach(async () => {
47
+ Flag.SAEEOL_EXPERIMENTAL_HTTPAPI = original
48
+ await disposeAllInstances()
49
+ await resetDatabase()
50
+ })
51
+
52
+ describe("tui HttpApi bridge", () => {
53
+ test("documents legacy bad request responses", async () => {
54
+ const legacy = await Server.openapi()
55
+ const effect = OpenApi.fromApi(TuiApi)
56
+ for (const path of [TuiPaths.appendPrompt, TuiPaths.executeCommand, TuiPaths.publish, TuiPaths.selectSession]) {
57
+ expect(legacy.paths[path].post?.responses?.[400]).toBeDefined()
58
+ expect(effect.paths[path].post?.responses?.[400]).toBeDefined()
59
+ }
60
+ })
61
+
62
+ test("serves TUI command and event routes through experimental Effect routes", async () => {
63
+ await using tmp = await tmpdir({ git: true, config: { formatter: false, lsp: false } })
64
+ const headers = { "x-saeeol-directory": tmp.path }
65
+
66
+ await expectTrue(TuiPaths.appendPrompt, headers, { text: "hello" })
67
+ await expectTrue(TuiPaths.openHelp, headers)
68
+ await expectTrue(TuiPaths.openSessions, headers)
69
+ await expectTrue(TuiPaths.openThemes, headers)
70
+ await expectTrue(TuiPaths.openModels, headers)
71
+ await expectTrue(TuiPaths.submitPrompt, headers)
72
+ await expectTrue(TuiPaths.clearPrompt, headers)
73
+ await expectTrue(TuiPaths.executeCommand, headers, { command: "agent_cycle" })
74
+ await expectTrue(TuiPaths.showToast, headers, { message: "Saved", variant: "success" })
75
+ await expectTrue(TuiPaths.publish, headers, {
76
+ type: "tui.prompt.append",
77
+ properties: { text: "from publish" },
78
+ })
79
+
80
+ const missing = await app().request(TuiPaths.selectSession, {
81
+ method: "POST",
82
+ headers: { ...headers, "content-type": "application/json" },
83
+ body: JSON.stringify({ sessionID: SessionID.descending() }),
84
+ })
85
+ expect(missing.status).toBe(404)
86
+ })
87
+
88
+ test("matches legacy unknown execute command behavior", async () => {
89
+ await using tmp = await tmpdir({ git: true, config: { formatter: false, lsp: false } })
90
+ const headers = { "x-saeeol-directory": tmp.path, "content-type": "application/json" }
91
+ const body = JSON.stringify({ command: "unknown_command" })
92
+
93
+ const legacyCommand = nextCommandExecute()
94
+ const legacy = await app(false).request(TuiPaths.executeCommand, { method: "POST", headers, body })
95
+ expect(legacy.status).toBe(200)
96
+ expect(await legacy.json()).toBe(true)
97
+
98
+ const effectCommand = nextCommandExecute()
99
+ const effect = await app().request(TuiPaths.executeCommand, { method: "POST", headers, body })
100
+ expect(effect.status).toBe(200)
101
+ expect(await effect.json()).toBe(true)
102
+
103
+ const legacyPublished = await legacyCommand
104
+ const effectPublished = await effectCommand
105
+ expect(effectPublished).toBe(legacyPublished)
106
+ expect(legacyPublished).toBeUndefined()
107
+ })
108
+
109
+ test("serves TUI control queue through experimental Effect routes", async () => {
110
+ await using tmp = await tmpdir({ git: true, config: { formatter: false, lsp: false } })
111
+ const pending = callTui({ req: { json: async () => ({ value: 1 }), path: "/demo" } } as unknown as Context)
112
+ const headers = { "x-saeeol-directory": tmp.path }
113
+
114
+ const next = await app().request(TuiPaths.controlNext, { headers })
115
+ expect(next.status).toBe(200)
116
+ expect(await next.json()).toEqual({ path: "/demo", body: { value: 1 } })
117
+
118
+ await expectTrue(TuiPaths.controlResponse, headers, { ok: true })
119
+ expect(await pending).toEqual({ ok: true })
120
+ })
121
+ })
@@ -0,0 +1,471 @@
1
+ import { NodeHttpServer, NodeServices } from "@effect/platform-node"
2
+ import { Flag } from "@saeeol/core/flag/flag"
3
+ import { describe, expect } from "bun:test"
4
+ import { Context, Effect, Layer, Queue } from "effect"
5
+ import {
6
+ FetchHttpClient,
7
+ HttpClient,
8
+ HttpClientRequest,
9
+ HttpRouter,
10
+ HttpServer,
11
+ HttpServerRequest,
12
+ HttpServerResponse,
13
+ } from "effect/unstable/http"
14
+ import * as Socket from "effect/unstable/socket/Socket"
15
+ import Http from "node:http"
16
+ import { mkdir } from "node:fs/promises"
17
+ import path from "node:path"
18
+ import { registerAdapter } from "../../src/control-plane/adapters"
19
+ import { WorkspaceID } from "../../src/control-plane/schema"
20
+ import type { WorkspaceAdapter } from "../../src/control-plane/types"
21
+ import { Workspace } from "../../src/control-plane/workspace"
22
+ import { WorkspaceTable } from "../../src/control-plane/workspace.sql"
23
+ import { Project } from "../../src/project/project"
24
+ import { WorkspacePaths } from "../../src/server/routes/instance/httpapi/groups/workspace"
25
+ import {
26
+ WorkspaceRouteContext,
27
+ workspaceRouterMiddleware,
28
+ } from "../../src/server/routes/instance/httpapi/middleware/workspace-routing"
29
+ import { Database } from "../../src/storage/db"
30
+ import { resetDatabase } from "../fixture/db"
31
+ import { tmpdirScoped } from "../fixture/fixture"
32
+ import { testEffect } from "../lib/effect"
33
+
34
+ const testStateLayer = Layer.effectDiscard(
35
+ Effect.gen(function* () {
36
+ const originalWorkspaces = Flag.SAEEOL_EXPERIMENTAL_WORKSPACES
37
+ yield* Effect.promise(() => resetDatabase())
38
+ Flag.SAEEOL_EXPERIMENTAL_WORKSPACES = true
39
+ yield* Effect.addFinalizer(() =>
40
+ Effect.promise(async () => {
41
+ Flag.SAEEOL_EXPERIMENTAL_WORKSPACES = originalWorkspaces
42
+ await resetDatabase()
43
+ }),
44
+ )
45
+ }),
46
+ )
47
+
48
+ const it = testEffect(
49
+ Layer.mergeAll(
50
+ testStateLayer,
51
+ NodeHttpServer.layerTest,
52
+ NodeServices.layer,
53
+ Project.defaultLayer,
54
+ Workspace.defaultLayer,
55
+ Socket.layerWebSocketConstructorGlobal,
56
+ ),
57
+ )
58
+
59
+ type ProxiedRequest = {
60
+ url: string
61
+ method: string
62
+ headers: Record<string, string>
63
+ }
64
+
65
+ type TestHandler<E, R> = (
66
+ request: HttpServerRequest.HttpServerRequest,
67
+ ) => Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>
68
+
69
+ const workspaceRoutingTestLayer = workspaceRouterMiddleware.layer.pipe(
70
+ Layer.provide([Socket.layerWebSocketConstructorGlobal, FetchHttpClient.layer]),
71
+ )
72
+
73
+ const serverUrl = HttpServer.HttpServer.use((server) => Effect.succeed(HttpServer.formatAddress(server.address)))
74
+
75
+ const requestURL = (request: { readonly url: string }) => new URL(request.url, "http://localhost")
76
+
77
+ const listenAdditionalServer = <E, R>(handler: TestHandler<E, R>) =>
78
+ Effect.gen(function* () {
79
+ const context = yield* Layer.build(NodeHttpServer.layer(Http.createServer, { host: "127.0.0.1", port: 0 }))
80
+ const server = Context.get(context, HttpServer.HttpServer)
81
+ yield* server.serve(HttpServerRequest.HttpServerRequest.use(handler))
82
+ return HttpServer.formatAddress(server.address)
83
+ })
84
+
85
+ const localAdapter = (directory: string): WorkspaceAdapter => ({
86
+ name: "Local Test",
87
+ description: "Create a local test workspace",
88
+ configure: (info) => ({ ...info, name: "local-test", directory }),
89
+ create: async () => {
90
+ await mkdir(directory, { recursive: true })
91
+ },
92
+ async remove() {},
93
+ target: () => ({ type: "local" as const, directory }),
94
+ })
95
+
96
+ const remoteAdapter = (directory: string, url: string, headers?: HeadersInit): WorkspaceAdapter => ({
97
+ name: "Remote Test",
98
+ description: "Create a remote test workspace",
99
+ configure: (info) => ({ ...info, name: "remote-test", directory }),
100
+ create: async () => {
101
+ await mkdir(directory, { recursive: true })
102
+ },
103
+ async remove() {},
104
+ target: () => ({ type: "remote" as const, url, headers }),
105
+ })
106
+
107
+ const eventStreamResponse = () =>
108
+ HttpServerResponse.text('data: {"payload":{"type":"server.connected","properties":{}}}\n\n', {
109
+ contentType: "text/event-stream",
110
+ })
111
+
112
+ const syncResponse = (request: HttpServerRequest.HttpServerRequest) => {
113
+ const url = requestURL(request)
114
+ if (url.pathname === "/base/global/event") return Effect.succeed(eventStreamResponse())
115
+ if (url.pathname === "/base/sync/history") return HttpServerResponse.json([])
116
+ return undefined
117
+ }
118
+
119
+ const createWorkspace = (input: { projectID: Project.Info["id"]; type: string; adapter: WorkspaceAdapter }) =>
120
+ Effect.acquireRelease(
121
+ Effect.gen(function* () {
122
+ registerAdapter(input.projectID, input.type, input.adapter)
123
+ const workspace = yield* Workspace.Service
124
+ return yield* workspace.create({
125
+ type: input.type,
126
+ branch: null,
127
+ extra: null,
128
+ projectID: input.projectID,
129
+ })
130
+ }),
131
+ (info) => Workspace.Service.use((workspace) => workspace.remove(info.id)).pipe(Effect.ignore),
132
+ )
133
+
134
+ const createRemoteWorkspace = (input: {
135
+ dir: string
136
+ projectID: Project.Info["id"]
137
+ type: string
138
+ url: string
139
+ headers?: HeadersInit
140
+ }) =>
141
+ // Workspace.create starts the remote sync loop. The test upstream exposes
142
+ // /global/event and /sync/history so middleware proxying sees the remote
143
+ // workspace as active, just like production would.
144
+ createWorkspace({
145
+ projectID: input.projectID,
146
+ type: input.type,
147
+ adapter: remoteAdapter(path.join(input.dir, `.${input.type}`), input.url, input.headers),
148
+ })
149
+
150
+ const createLocalWorkspace = (input: { projectID: Project.Info["id"]; type: string; directory: string }) =>
151
+ createWorkspace({
152
+ projectID: input.projectID,
153
+ type: input.type,
154
+ adapter: localAdapter(input.directory),
155
+ })
156
+
157
+ const insertRemoteWorkspaceWithoutSync = (input: {
158
+ dir: string
159
+ projectID: Project.Info["id"]
160
+ type: string
161
+ url: string
162
+ }) =>
163
+ Effect.sync(() => {
164
+ const id = WorkspaceID.ascending()
165
+ registerAdapter(input.projectID, input.type, remoteAdapter(path.join(input.dir, `.${input.type}`), input.url))
166
+ Database.use((db) => db.insert(WorkspaceTable).values({ id, type: input.type, project_id: input.projectID }).run())
167
+ return id
168
+ })
169
+
170
+ const startRemoteWorkspaceHttpServer = <E, R>(
171
+ handler: (request: ProxiedRequest) => Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>,
172
+ ) =>
173
+ listenAdditionalServer((request) =>
174
+ Effect.gen(function* () {
175
+ // Remote workspaces run a sync loop against their target server. These
176
+ // bootstrap routes make Workspace.isSyncing(...) true for proxy tests;
177
+ // everything else is the request being proxied by the middleware.
178
+ const sync = syncResponse(request)
179
+ if (sync) return yield* sync
180
+ return yield* handler({ url: request.url, method: request.method, headers: request.headers })
181
+ }),
182
+ )
183
+
184
+ const listenRemoteWebSocket = () =>
185
+ listenAdditionalServer((request) => {
186
+ const sync = syncResponse(request)
187
+ if (sync) return sync
188
+ if (requestURL(request).pathname !== "/base/probe") return Effect.succeed(HttpServerResponse.empty({ status: 404 }))
189
+ return echoWebSocket(request)
190
+ })
191
+
192
+ const echoWebSocket = (request: HttpServerRequest.HttpServerRequest) =>
193
+ Effect.gen(function* () {
194
+ const socket = yield* Effect.orDie(request.upgrade)
195
+ const write = yield* socket.writer
196
+ yield* socket
197
+ .runRaw((message) => write(`echo:${String(message)}`), {
198
+ onOpen: write(`protocol:${request.headers["sec-websocket-protocol"] ?? "none"}`).pipe(
199
+ Effect.catch(() => Effect.void),
200
+ ),
201
+ })
202
+ .pipe(Effect.catch(() => Effect.void))
203
+ return HttpServerResponse.empty()
204
+ })
205
+
206
+ const serveRouteContextProbe = HttpRouter.add(
207
+ "GET",
208
+ "/probe",
209
+ Effect.gen(function* () {
210
+ // The fake route exposes the context installed by the middleware, so tests
211
+ // can assert routing decisions without pulling in the production API tree.
212
+ const route = yield* WorkspaceRouteContext
213
+ return yield* HttpServerResponse.json({ directory: route.directory, workspaceID: route.workspaceID })
214
+ }),
215
+ ).pipe(Layer.provide(workspaceRoutingTestLayer), HttpRouter.serve, Layer.build)
216
+
217
+ describe("HttpApi workspace routing middleware", () => {
218
+ it.live("proxies remote workspace HTTP requests through the selected workspace target", () =>
219
+ Effect.gen(function* () {
220
+ const dir = yield* tmpdirScoped({ git: true })
221
+ const project = yield* Project.use.fromDirectory(dir)
222
+ let forwarded: ProxiedRequest | undefined
223
+
224
+ // This starts a second HTTP server that stands in for the saeeol server
225
+ // backing a remote workspace. The client below still calls the local test
226
+ // server; only the middleware should call this server.
227
+ const remoteUrl = yield* startRemoteWorkspaceHttpServer((request) => {
228
+ forwarded = request
229
+ const url = requestURL(request)
230
+ return HttpServerResponse.json(
231
+ {
232
+ proxied: true,
233
+ path: url.pathname,
234
+ keep: url.searchParams.get("keep"),
235
+ workspace: url.searchParams.get("workspace"),
236
+ },
237
+ { status: 201, headers: { "x-remote": "yes" } },
238
+ )
239
+ })
240
+ // The adapter target tells the middleware where to proxy selected remote
241
+ // workspace requests. Appending /probe to this base should produce
242
+ // `${remoteUrl}/base/probe` on the fake remote server above.
243
+ const workspace = yield* createRemoteWorkspace({
244
+ dir,
245
+ projectID: project.project.id,
246
+ type: "remote-http-target",
247
+ url: `${remoteUrl}/base`,
248
+ headers: { "x-target-auth": "secret" },
249
+ })
250
+
251
+ // The local /probe handler should not run. Selecting a remote workspace
252
+ // should make the middleware call HttpApiProxy.http instead.
253
+ yield* HttpRouter.add("PATCH", "/probe", HttpServerResponse.text("route called")).pipe(
254
+ Layer.provide(workspaceRoutingTestLayer),
255
+ HttpRouter.serve,
256
+ Layer.build,
257
+ )
258
+
259
+ const response = yield* HttpClientRequest.patch(`/probe?workspace=${workspace.id}&keep=yes`).pipe(
260
+ HttpClientRequest.setHeaders({
261
+ "content-type": "application/json",
262
+ "x-saeeol-directory": "/secret/path",
263
+ "x-saeeol-workspace": "internal",
264
+ }),
265
+ HttpClient.execute,
266
+ )
267
+
268
+ expect(response.status).toBe(201)
269
+ expect(response.headers["x-remote"]).toBe("yes")
270
+ expect(yield* response.json).toEqual({ proxied: true, path: "/base/probe", keep: "yes", workspace: null })
271
+ const forwardedURL = forwarded ? requestURL(forwarded) : undefined
272
+ // These assertions are the routing contract: append the original path to
273
+ // the remote base URL, preserve normal query params, and remove workspace.
274
+ expect(forwardedURL?.pathname).toBe("/base/probe")
275
+ expect(forwardedURL?.searchParams.get("keep")).toBe("yes")
276
+ expect(forwardedURL?.searchParams.get("workspace")).toBeNull()
277
+ expect(forwarded?.method).toBe("PATCH")
278
+ expect(forwarded?.headers["content-type"]).toBe("application/json")
279
+ expect(forwarded?.headers["x-target-auth"]).toBe("secret")
280
+ expect(forwarded?.headers["x-saeeol-directory"]).toBeUndefined()
281
+ expect(forwarded?.headers["x-saeeol-workspace"]).toBeUndefined()
282
+ }),
283
+ )
284
+
285
+ it.live("returns 503 when a remote workspace is not actively syncing", () =>
286
+ Effect.gen(function* () {
287
+ const dir = yield* tmpdirScoped({ git: true })
288
+ const project = yield* Project.use.fromDirectory(dir)
289
+ const workspaceID = yield* insertRemoteWorkspaceWithoutSync({
290
+ dir,
291
+ projectID: project.project.id,
292
+ type: "remote-not-syncing",
293
+ url: "http://127.0.0.1:1/base",
294
+ })
295
+
296
+ yield* HttpRouter.add("GET", "/probe", HttpServerResponse.text("route called")).pipe(
297
+ Layer.provide(workspaceRoutingTestLayer),
298
+ HttpRouter.serve,
299
+ Layer.build,
300
+ )
301
+
302
+ const response = yield* HttpClient.get(`/probe?workspace=${workspaceID}`)
303
+
304
+ expect(response.status).toBe(503)
305
+ expect(yield* response.text).toBe(`broken sync connection for workspace: ${workspaceID}`)
306
+ }),
307
+ )
308
+
309
+ it.live("proxies remote workspace WebSocket requests through the selected workspace target", () =>
310
+ Effect.gen(function* () {
311
+ const dir = yield* tmpdirScoped({ git: true })
312
+ const project = yield* Project.use.fromDirectory(dir)
313
+ const remoteUrl = yield* listenRemoteWebSocket()
314
+ const workspace = yield* createRemoteWorkspace({
315
+ dir,
316
+ projectID: project.project.id,
317
+ type: "remote-websocket-target",
318
+ url: `${remoteUrl}/base`,
319
+ })
320
+
321
+ // The client connects to the local test server. The middleware should
322
+ // detect the WebSocket upgrade and proxy it to the remote /base/probe.
323
+ yield* HttpRouter.add("GET", "/probe", HttpServerResponse.text("route called")).pipe(
324
+ Layer.provide(workspaceRoutingTestLayer),
325
+ HttpRouter.serve,
326
+ Layer.build,
327
+ )
328
+
329
+ const socket = yield* Socket.makeWebSocket(
330
+ `${(yield* serverUrl).replace(/^http/, "ws")}/probe?workspace=${workspace.id}`,
331
+ {
332
+ closeCodeIsError: () => false,
333
+ protocols: "chat",
334
+ },
335
+ )
336
+ const messages = yield* Queue.unbounded<string>()
337
+ yield* socket.runRaw((message) => Queue.offer(messages, String(message))).pipe(Effect.forkScoped)
338
+ const write = yield* socket.writer
339
+
340
+ expect(yield* Queue.take(messages)).toBe("protocol:chat")
341
+ yield* write("hello")
342
+ expect(yield* Queue.take(messages)).toBe("echo:hello")
343
+ }),
344
+ )
345
+
346
+ it.live("returns a missing workspace response for unknown workspace ids", () =>
347
+ Effect.gen(function* () {
348
+ const workspaceID = WorkspaceID.ascending("wrk_missing")
349
+ // If the middleware resolves the workspace first, this handler is never
350
+ // reached and the response should be the middleware error response.
351
+ yield* HttpRouter.add("GET", "/probe", HttpServerResponse.text("route called")).pipe(
352
+ Layer.provide(workspaceRoutingTestLayer),
353
+ HttpRouter.serve,
354
+ Layer.build,
355
+ )
356
+
357
+ const response = yield* HttpClient.get(`/probe?workspace=${workspaceID}`)
358
+
359
+ expect(response.status).toBe(500)
360
+ expect(yield* response.text).toBe(`Workspace not found: ${workspaceID}`)
361
+ }),
362
+ )
363
+
364
+ it.live("keeps control-plane routes local even when workspace is selected", () =>
365
+ Effect.gen(function* () {
366
+ const dir = yield* tmpdirScoped({ git: true })
367
+ const project = yield* Project.use.fromDirectory(dir)
368
+
369
+ const workspaceDir = path.join(dir, ".workspace-local")
370
+ const workspace = yield* createLocalWorkspace({
371
+ projectID: project.project.id,
372
+ type: "control-plane-target",
373
+ directory: workspaceDir,
374
+ })
375
+
376
+ // GET /session is a control-plane route: it lists sessions for the main
377
+ // process and should not be redirected into the selected workspace target.
378
+ yield* HttpRouter.add(
379
+ "GET",
380
+ "/session",
381
+ Effect.gen(function* () {
382
+ const route = yield* WorkspaceRouteContext
383
+ return yield* HttpServerResponse.json({ directory: route.directory, workspaceID: route.workspaceID })
384
+ }),
385
+ ).pipe(Layer.provide(workspaceRoutingTestLayer), HttpRouter.serve, Layer.build)
386
+
387
+ const response = yield* HttpClient.get(`/session?workspace=${workspace.id}`)
388
+
389
+ expect(response.status).toBe(200)
390
+ expect(yield* response.json).toEqual({ directory: process.cwd(), workspaceID: workspace.id })
391
+ }),
392
+ )
393
+
394
+ it.live("keeps workspace control routes local even when workspace is selected", () =>
395
+ Effect.gen(function* () {
396
+ const dir = yield* tmpdirScoped({ git: true })
397
+ const project = yield* Project.use.fromDirectory(dir)
398
+ const workspaceDir = path.join(dir, ".workspace-local")
399
+ const workspace = yield* createLocalWorkspace({
400
+ projectID: project.project.id,
401
+ type: "workspace-control-plane-target",
402
+ directory: workspaceDir,
403
+ })
404
+
405
+ // Workspace CRUD/status routes manage the control plane itself. Selecting
406
+ // a workspace should preserve the selected id for handlers, but must not
407
+ // swap the route context to the workspace target directory.
408
+ yield* HttpRouter.add(
409
+ "GET",
410
+ WorkspacePaths.list,
411
+ Effect.gen(function* () {
412
+ const route = yield* WorkspaceRouteContext
413
+ return yield* HttpServerResponse.json({ directory: route.directory, workspaceID: route.workspaceID })
414
+ }),
415
+ ).pipe(Layer.provide(workspaceRoutingTestLayer), HttpRouter.serve, Layer.build)
416
+
417
+ const response = yield* HttpClient.get(`${WorkspacePaths.list}?workspace=${workspace.id}`)
418
+
419
+ expect(response.status).toBe(200)
420
+ expect(yield* response.json).toEqual({ directory: process.cwd(), workspaceID: workspace.id })
421
+ }),
422
+ )
423
+
424
+ it.live("uses directory query/header fallback when no workspace is selected", () =>
425
+ Effect.gen(function* () {
426
+ const dir = yield* tmpdirScoped()
427
+ const queryDir = path.join(dir, "query-target")
428
+ const headerDir = path.join(dir, "header-target")
429
+ yield* serveRouteContextProbe
430
+
431
+ // Without a selected workspace, the middleware falls back to request
432
+ // directory hints before using the process cwd.
433
+ const queryResponse = yield* HttpClient.get(`/probe?directory=${encodeURIComponent(queryDir)}`)
434
+ const headerResponse = yield* HttpClientRequest.get("/probe").pipe(
435
+ HttpClientRequest.setHeader("x-saeeol-directory", headerDir),
436
+ HttpClient.execute,
437
+ )
438
+
439
+ expect(queryResponse.status).toBe(200)
440
+ expect(yield* queryResponse.json).toEqual({ directory: queryDir })
441
+ expect(headerResponse.status).toBe(200)
442
+ expect(yield* headerResponse.json).toEqual({ directory: headerDir })
443
+ }),
444
+ )
445
+
446
+ it.live("routes local workspace requests through WorkspaceRouteContext", () =>
447
+ Effect.gen(function* () {
448
+ const dir = yield* tmpdirScoped({ git: true })
449
+ const project = yield* Project.use.fromDirectory(dir)
450
+
451
+ const workspaceDir = path.join(dir, ".workspace-local")
452
+ const workspace = yield* createLocalWorkspace({
453
+ projectID: project.project.id,
454
+ type: "local-target",
455
+ directory: workspaceDir,
456
+ })
457
+
458
+ yield* serveRouteContextProbe
459
+
460
+ // /probe is not a control-plane route, so selecting a local workspace
461
+ // should swap the route context to the workspace target directory.
462
+ const response = yield* HttpClient.get(`/probe?workspace=${workspace.id}`)
463
+
464
+ expect(response.status).toBe(200)
465
+ expect(yield* response.json).toEqual({
466
+ directory: workspaceDir,
467
+ workspaceID: workspace.id,
468
+ })
469
+ }),
470
+ )
471
+ })