@openchamber/web 1.24.2 → 2.0.1

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 (387) hide show
  1. package/bin/lib/commands-connect-url.js +3 -8
  2. package/bin/lib/commands-tunnel.js +3 -0
  3. package/dist/assets/{CodeMirrorCommentWidgets-B_vBPQYm.js → CodeMirrorCommentWidgets-zm3C1FvM.js} +1 -1
  4. package/dist/assets/DiffView-DNExNi1z.js +4 -0
  5. package/dist/assets/FilesView-DUCLmHBi.js +17 -0
  6. package/dist/assets/{GitView-k0hUF8KB.js → GitView-Bz9z6gZA.js} +4 -4
  7. package/dist/assets/{GuestAttachDialog-DIf2U85Z.js → GuestAttachDialog-UGp4KDlK.js} +1 -1
  8. package/dist/assets/GuestSurfacePane-B3pdB_2u.js +1 -0
  9. package/dist/assets/{JsonTreeView-4AnJ04Pw.js → JsonTreeView-7lVecnZl.js} +1 -1
  10. package/dist/assets/LinearIssuesView-CTGRS9Vq.js +1 -0
  11. package/dist/assets/MarkdownImageGallery-DQk5adUs.js +1 -0
  12. package/dist/assets/MarkdownRendererImpl-DPF8fZpX.js +12 -0
  13. package/dist/assets/OnboardingScreen-CBx6cXPP.js +1 -0
  14. package/dist/assets/{PatchDiff-DpGmHRnV.js → PatchDiff-D7VVpR_l.js} +1 -1
  15. package/dist/assets/{PierreDiffViewer-CgLl_tp7.js → PierreDiffViewer-Gbfks1pk.js} +3 -3
  16. package/dist/assets/PlanView-CPSK0x97.js +5 -0
  17. package/dist/assets/PluginPane-BIGsUx69.js +3 -0
  18. package/dist/assets/SettingsView-Dql7z6Ww.js +30 -0
  19. package/dist/assets/SettingsWindow-D6oi-UmV.js +1 -0
  20. package/dist/assets/SubmoduleDiffSummary-BXA0FAWj.js +1 -0
  21. package/dist/assets/ToolOutputDialog-BQJsSbDm.js +15 -0
  22. package/dist/assets/ToolPartDiffPreview-FY9w0TVT.js +8 -0
  23. package/dist/assets/{VirtualizedFileDiff-BK4aU5qJ.js → VirtualizedFileDiff-B9YhAya5.js} +4 -4
  24. package/dist/assets/{WalkthroughView-Bk6TPNFw.js → WalkthroughView-CmFgOUFN.js} +2 -2
  25. package/dist/assets/appThemeRegistry-BebxalUt.js +1 -0
  26. package/dist/assets/changesTree-CePHbFcj.js +1 -0
  27. package/dist/assets/commitAndPush-Wfxng_IK.js +1 -0
  28. package/dist/assets/{computeVirtualFileMetrics-BVTujWSX.js → computeVirtualFileMetrics-BCOqgixN.js} +2 -2
  29. package/dist/assets/de-CMA45TC-.js +10 -0
  30. package/dist/assets/es-DPL4fBtl.js +16 -0
  31. package/dist/assets/fr-OHBKBseP.js +14 -0
  32. package/dist/assets/index-3TiDNtfN.js +1 -0
  33. package/dist/assets/index-BLUZa5u0.js +41 -0
  34. package/dist/assets/index-Cm2rrq69.css +1 -0
  35. package/dist/assets/{isDiffPlainText-D3yX_vx4.js → isDiffPlainText-DnDYQmWK.js} +1 -1
  36. package/dist/assets/{isFilePlainText-CZR9TcHV.js → isFilePlainText-BA_AHX7d.js} +1 -1
  37. package/dist/assets/ja-DvX4WSRf.js +16 -0
  38. package/dist/assets/ko-BUcLd8YZ.js +16 -0
  39. package/dist/assets/main-B_jri4i-.js +896 -0
  40. package/dist/assets/main-DtUmJp9B.js +2 -0
  41. package/dist/assets/{markdown-shiki.worker-CahLvHIq.js → markdown-shiki.worker-Bg8SoAJJ.js} +8 -5
  42. package/dist/assets/markdownCore-BSnlUXBf.js +7 -0
  43. package/dist/assets/miniChat-BYfLUnDK.js +2 -0
  44. package/dist/assets/mobile-DH3hI6gd.js +2 -0
  45. package/dist/assets/patchFileDiff--L7lt_GZ.js +13 -0
  46. package/dist/assets/pl-BkI_xHqz.js +16 -0
  47. package/dist/assets/pt-BR-7wFtQlV9.js +16 -0
  48. package/dist/assets/renderElectronMiniChatApp-C7kpNW_-.js +2 -0
  49. package/dist/assets/renderMobileApp-i0nq7Dwy.js +25 -0
  50. package/dist/assets/runtimeEndpointReset-CfEYbcCc.js +27 -0
  51. package/dist/assets/scheduledTasksApi-Cy7uZCaI.js +1 -0
  52. package/dist/assets/{shikiHighlight-BfjuB3CD.js → shikiHighlight-D4vxipfr.js} +1 -1
  53. package/dist/assets/{textMateThemeFromAppTheme-BP60t9SX.js → textMateThemeFromAppTheme-BYAHtJwQ.js} +1 -1
  54. package/dist/assets/tr-TsD-AqEH.js +7 -0
  55. package/dist/assets/uk-B-qspCmD.js +16 -0
  56. package/dist/assets/useAppFontEffects-DHZ9-L30.js +7338 -0
  57. package/dist/assets/useInlineCommentController-CvpOMK-R.js +2 -0
  58. package/dist/assets/useRootScrollLock-DzNFi-fn.js +2 -0
  59. package/dist/assets/{vendor-codemirror-language-data-BFm1Ju2w.js → vendor-codemirror-language-data-j3fhlwUM.js} +2 -2
  60. package/dist/assets/vendor-cron-parser-CjvYVigk.js +2 -0
  61. package/dist/assets/vendor-opencode-client-DYdsLbCM.js +12 -0
  62. package/dist/assets/{vendor-remixicon-react-BDmGmFCA.js → vendor-remixicon-react-D6dZ0UwF.js} +1 -1
  63. package/dist/assets/vendor-zod-BSoePkpP.js +39 -0
  64. package/dist/assets/{web-components-2vo9YsZc.js → web-components-BvHNFSEG.js} +2 -2
  65. package/dist/assets/zh-CN-DYuPJV5i.js +16 -0
  66. package/dist/assets/zh-TW-BX_2D_lV.js +16 -0
  67. package/dist/index.html +13 -7
  68. package/dist/mini-chat.html +5 -5
  69. package/dist/mobile.html +5 -5
  70. package/package.json +6 -5
  71. package/server/index.d.ts +1 -0
  72. package/server/index.js +264 -91
  73. package/server/lib/agent-tool/DOCUMENTATION.md +38 -16
  74. package/server/lib/agent-tool/runtime.js +167 -58
  75. package/server/lib/agent-tool/runtime.test.js +170 -87
  76. package/server/lib/browser-control/DOCUMENTATION.md +51 -4
  77. package/server/lib/browser-control/provider.js +217 -0
  78. package/server/lib/browser-control/provider.test.js +251 -0
  79. package/server/lib/context-obligatory/runtime.js +61 -50
  80. package/server/lib/context-obligatory/runtime.test.js +62 -162
  81. package/server/lib/event-stream/DOCUMENTATION.md +12 -1
  82. package/server/lib/event-stream/delta-coalescer.js +0 -0
  83. package/server/lib/event-stream/delta-coalescer.test.js +68 -57
  84. package/server/lib/event-stream/directory-ws-bridge.js +1 -1
  85. package/server/lib/event-stream/global-hub.js +10 -1
  86. package/server/lib/event-stream/global-hub.test.js +27 -26
  87. package/server/lib/event-stream/index.js +6 -0
  88. package/server/lib/event-stream/protocol.js +26 -19
  89. package/server/lib/event-stream/protocol.test.js +18 -7
  90. package/server/lib/event-stream/rebind.test.js +5 -5
  91. package/server/lib/event-stream/runtime.test.js +17 -15
  92. package/server/lib/event-stream/translate-v2.js +313 -0
  93. package/server/lib/event-stream/translate-v2.test.js +209 -0
  94. package/server/lib/event-stream/upstream-reader.test.js +16 -16
  95. package/server/lib/fs/DOCUMENTATION.md +4 -2
  96. package/server/lib/fs/byte-range.js +35 -0
  97. package/server/lib/fs/byte-range.test.js +31 -0
  98. package/server/lib/fs/routes.js +47 -42
  99. package/server/lib/fs/routes.test.js +123 -18
  100. package/server/lib/git/DOCUMENTATION.md +1 -1
  101. package/server/lib/git/service.js +34 -0
  102. package/server/lib/git/service.test.js +8 -0
  103. package/server/lib/github/DOCUMENTATION.md +1 -1
  104. package/server/lib/github/pr-status.js +22 -2
  105. package/server/lib/github/pr-status.test.js +27 -14
  106. package/server/lib/guests/DOCUMENTATION.md +16 -2
  107. package/server/lib/guests/catalog.js +31 -1
  108. package/server/lib/guests/catalog.test.js +55 -0
  109. package/server/lib/guests/html-styles.js +5 -3
  110. package/server/lib/guests/html-styles.test.js +3 -1
  111. package/server/lib/guests/routes.js +21 -4
  112. package/server/lib/guests/service.js +197 -14
  113. package/server/lib/guests/service.test.js +201 -1
  114. package/server/lib/guests/surface.js +676 -0
  115. package/server/lib/guests/surface.test.js +536 -0
  116. package/server/lib/markdown-image-grants/routes.js +18 -5
  117. package/server/lib/markdown-image-grants/routes.test.js +9 -6
  118. package/server/lib/message-queue/DOCUMENTATION.md +33 -22
  119. package/server/lib/message-queue/runtime.js +155 -100
  120. package/server/lib/message-queue/runtime.test.js +168 -82
  121. package/server/lib/notifications/DOCUMENTATION.md +38 -0
  122. package/server/lib/notifications/control-stream.http.test.js +68 -0
  123. package/server/lib/notifications/emit-route.js +118 -0
  124. package/server/lib/notifications/emit-route.test.js +112 -0
  125. package/server/lib/notifications/emitter-runtime.js +15 -0
  126. package/server/lib/notifications/emitter-runtime.test.js +32 -0
  127. package/server/lib/notifications/push-runtime.js +5 -1
  128. package/server/lib/notifications/push-runtime.test.js +2 -2
  129. package/server/lib/notifications/routes.js +1 -1
  130. package/server/lib/notifications/runtime.js +115 -26
  131. package/server/lib/notifications/template-runtime.js +13 -15
  132. package/server/lib/notifications/template-runtime.test.js +16 -9
  133. package/server/lib/notifications/trigger-runtime.test.js +187 -0
  134. package/server/lib/openchamber-control/DOCUMENTATION.md +10 -0
  135. package/server/lib/openchamber-control/actions.js +19 -4
  136. package/server/lib/openchamber-control/error.js +1 -1
  137. package/server/lib/openchamber-control/file-open.js +59 -0
  138. package/server/lib/openchamber-control/file-open.test.js +57 -0
  139. package/server/lib/openchamber-control/routes.test.js +12 -0
  140. package/server/lib/openchamber-control/service.js +125 -49
  141. package/server/lib/openchamber-control/service.test.js +115 -44
  142. package/server/lib/openchamber-sessions/archive-store.js +224 -0
  143. package/server/lib/openchamber-sessions/archive-store.test.js +187 -0
  144. package/server/lib/openchamber-sessions/fork-inheritance.js +103 -0
  145. package/server/lib/openchamber-sessions/fork-inheritance.test.js +69 -0
  146. package/server/lib/openchamber-sessions/opencode-client.js +22 -0
  147. package/server/lib/openchamber-sessions/routes.js +409 -328
  148. package/server/lib/openchamber-sessions/routes.test.js +795 -740
  149. package/server/lib/openchamber-sessions/session-metadata-store.js +285 -0
  150. package/server/lib/openchamber-sessions/session-metadata-store.test.js +259 -0
  151. package/server/lib/opencode/DOCUMENTATION.md +458 -29
  152. package/server/lib/opencode/agents.js +233 -327
  153. package/server/lib/opencode/auth.js +41 -44
  154. package/server/lib/opencode/auth.test.js +92 -0
  155. package/server/lib/opencode/bootstrap-runtime.js +12 -0
  156. package/server/lib/opencode/cli-upgrade.d.ts +4 -0
  157. package/server/lib/opencode/cli-upgrade.js +18 -0
  158. package/server/lib/opencode/cli-upgrade.test.js +36 -0
  159. package/server/lib/opencode/commands.js +164 -145
  160. package/server/lib/opencode/compatibility.d.ts +16 -0
  161. package/server/lib/opencode/compatibility.js +91 -0
  162. package/server/lib/opencode/compatibility.test.js +70 -0
  163. package/server/lib/opencode/config-entity-routes.js +58 -29
  164. package/server/lib/opencode/config-entity-v2.test.js +290 -0
  165. package/server/lib/opencode/config-mutation-response.js +17 -7
  166. package/server/lib/opencode/config-mutation-response.test.js +4 -7
  167. package/server/lib/opencode/config-paths.test.js +2 -2
  168. package/server/lib/opencode/config-v2.d.ts +185 -0
  169. package/server/lib/opencode/config-v2.js +843 -0
  170. package/server/lib/opencode/config-v2.test.js +483 -0
  171. package/server/lib/opencode/core-routes.js +3 -0
  172. package/server/lib/opencode/core-routes.test.js +15 -0
  173. package/server/lib/opencode/credential-db.js +144 -0
  174. package/server/lib/opencode/credential-db.test.js +104 -0
  175. package/server/lib/opencode/env-runtime.js +47 -15
  176. package/server/lib/opencode/env-runtime.test.js +45 -0
  177. package/server/lib/opencode/feature-routes-runtime.js +16 -5
  178. package/server/lib/opencode/lifecycle-process.test.js +7 -4
  179. package/server/lib/opencode/lifecycle.js +113 -30
  180. package/server/lib/opencode/lifecycle.test.js +107 -8
  181. package/server/lib/opencode/login-shell-env.js +27 -0
  182. package/server/lib/opencode/managed-config-file.js +131 -0
  183. package/server/lib/opencode/managed-config-file.test.js +168 -0
  184. package/server/lib/opencode/managed-plugin-config.js +33 -13
  185. package/server/lib/opencode/mcp.js +43 -149
  186. package/server/lib/opencode/network-runtime.js +6 -7
  187. package/server/lib/opencode/openchamber-routes.js +29 -11
  188. package/server/lib/opencode/openchamber-routes.test.js +18 -1
  189. package/server/lib/opencode/plugin-routes.js +3 -3
  190. package/server/lib/opencode/plugin-routes.test.js +6 -24
  191. package/server/lib/opencode/plugins.js +91 -40
  192. package/server/lib/opencode/plugins.test.js +28 -15
  193. package/server/lib/opencode/provider-source-route.test.js +59 -0
  194. package/server/lib/opencode/providers.js +66 -83
  195. package/server/lib/opencode/providers.test.js +190 -59
  196. package/server/lib/opencode/proxy-agent-wiring.test.js +4 -2
  197. package/server/lib/opencode/proxy.js +179 -129
  198. package/server/lib/opencode/pwa-manifest-routes.js +4 -2
  199. package/server/lib/opencode/pwa-manifest-routes.test.js +3 -2
  200. package/server/lib/opencode/response-envelope.js +14 -0
  201. package/server/lib/opencode/response-envelope.test.js +23 -0
  202. package/server/lib/opencode/routes-upgrade.test.js +73 -116
  203. package/server/lib/opencode/routes.js +138 -428
  204. package/server/lib/opencode/server-utils-runtime.js +10 -4
  205. package/server/lib/opencode/session-activity.js +78 -0
  206. package/server/lib/opencode/session-runtime.js +21 -10
  207. package/server/lib/opencode/session-runtime.test.js +9 -9
  208. package/server/lib/opencode/settings-helpers.js +15 -8
  209. package/server/lib/opencode/settings-helpers.test.js +7 -12
  210. package/server/lib/opencode/settings-registry.json +20 -8
  211. package/server/lib/opencode/settings-runtime.js +19 -1
  212. package/server/lib/opencode/settings-runtime.test.js +31 -2
  213. package/server/lib/opencode/shared.js +86 -24
  214. package/server/lib/opencode/shared.test.js +87 -5
  215. package/server/lib/opencode/shutdown-runtime.js +54 -7
  216. package/server/lib/opencode/shutdown-runtime.test.js +224 -30
  217. package/server/lib/opencode/skill-routes.js +51 -36
  218. package/server/lib/opencode/skill-routes.test.js +121 -1
  219. package/server/lib/opencode/skills.js +7 -5
  220. package/server/lib/opencode/tunnel-wiring-runtime.js +2 -1
  221. package/server/lib/opencode/upgrade-capability.js +0 -14
  222. package/server/lib/opencode/upgrade-capability.test.js +1 -1
  223. package/server/lib/opencode/v1-migration-topup.js +294 -0
  224. package/server/lib/opencode/v1-migration-topup.test.js +274 -0
  225. package/server/lib/opencode/v2-install.d.ts +9 -0
  226. package/server/lib/opencode/v2-install.js +159 -0
  227. package/server/lib/opencode/v2-install.test.js +133 -0
  228. package/server/lib/opencode/watcher.js +10 -3
  229. package/server/lib/opencode/watcher.test.js +17 -21
  230. package/server/lib/opencode/websearch-config.js +78 -0
  231. package/server/lib/permission-auto-accept/runtime.js +38 -22
  232. package/server/lib/permission-auto-accept/runtime.test.js +39 -17
  233. package/server/lib/quota/DOCUMENTATION.md +4 -0
  234. package/server/lib/quota/providers/kimi.js +1 -1
  235. package/server/lib/quota/providers/xai.js +4 -4
  236. package/server/lib/relay/tunnel-host.js +4 -1
  237. package/server/lib/relay/tunnel-host.test.js +7 -0
  238. package/server/lib/routing/DOCUMENTATION.md +52 -21
  239. package/server/lib/routing/defaults.js +23 -6
  240. package/server/lib/routing/jev.js +17 -7
  241. package/server/lib/routing/routes.http.test.js +68 -33
  242. package/server/lib/routing/routes.js +65 -22
  243. package/server/lib/routing/runtime.js +145 -48
  244. package/server/lib/routing/runtime.test.js +79 -55
  245. package/server/lib/scheduled-tasks/DOCUMENTATION.md +4 -0
  246. package/server/lib/scheduled-tasks/issue-2710-double-execution.test.js +51 -46
  247. package/server/lib/scheduled-tasks/runtime.js +81 -74
  248. package/server/lib/scheduled-tasks/runtime.test.js +53 -1
  249. package/server/lib/session-assist/DOCUMENTATION.md +25 -8
  250. package/server/lib/session-assist/context.js +122 -46
  251. package/server/lib/session-assist/context.test.js +117 -49
  252. package/server/lib/session-assist/runtime.js +71 -24
  253. package/server/lib/session-assist/runtime.test.js +153 -173
  254. package/server/lib/session-goal/DOCUMENTATION.md +34 -15
  255. package/server/lib/session-goal/create.js +9 -12
  256. package/server/lib/session-goal/create.test.js +27 -28
  257. package/server/lib/session-goal/runtime.js +164 -77
  258. package/server/lib/session-goal/runtime.test.js +271 -519
  259. package/server/lib/session-knowledge/DOCUMENTATION.md +5 -0
  260. package/server/lib/session-knowledge/runtime.js +59 -41
  261. package/server/lib/session-knowledge/runtime.test.js +90 -20
  262. package/server/lib/small-model/DOCUMENTATION.md +154 -208
  263. package/server/lib/small-model/client.js +113 -0
  264. package/server/lib/small-model/index.js +296 -158
  265. package/server/lib/small-model/index.test.js +423 -256
  266. package/server/lib/small-model/routes.js +1 -1
  267. package/server/lib/spaces/DOCUMENTATION.md +807 -0
  268. package/server/lib/spaces/code-in-bait.js +185 -0
  269. package/server/lib/spaces/code-in.js +641 -0
  270. package/server/lib/spaces/code-in.test.js +1048 -0
  271. package/server/lib/spaces/errors.js +8 -0
  272. package/server/lib/spaces/exec-http.js +94 -0
  273. package/server/lib/spaces/gatekeeper-channel.js +202 -0
  274. package/server/lib/spaces/gatekeeper-channel.test.js +215 -0
  275. package/server/lib/spaces/gatekeeper-program.cjs +914 -0
  276. package/server/lib/spaces/gatekeeper-program.test.js +1391 -0
  277. package/server/lib/spaces/hardening.js +457 -0
  278. package/server/lib/spaces/hardening.test.js +368 -0
  279. package/server/lib/spaces/host-git.js +127 -0
  280. package/server/lib/spaces/host-git.test.js +137 -0
  281. package/server/lib/spaces/labels.js +234 -0
  282. package/server/lib/spaces/labels.test.js +219 -0
  283. package/server/lib/spaces/layout.js +184 -0
  284. package/server/lib/spaces/layout.test.js +30 -0
  285. package/server/lib/spaces/manager.js +82 -0
  286. package/server/lib/spaces/manager.test.js +114 -0
  287. package/server/lib/spaces/places/code-in.docker.live.test.js +216 -0
  288. package/server/lib/spaces/places/contract-suite.js +156 -0
  289. package/server/lib/spaces/places/contract.docker.live.test.js +7 -0
  290. package/server/lib/spaces/places/contract.test.js +6 -0
  291. package/server/lib/spaces/places/docker-engine.js +126 -0
  292. package/server/lib/spaces/places/docker-live-support.js +202 -0
  293. package/server/lib/spaces/places/docker-tools.js +186 -0
  294. package/server/lib/spaces/places/docker.js +587 -0
  295. package/server/lib/spaces/places/docker.test.js +1610 -0
  296. package/server/lib/spaces/places/escape-suite.js +1018 -0
  297. package/server/lib/spaces/places/escape.docker.live.test.js +7 -0
  298. package/server/lib/spaces/places/fake-docker.js +375 -0
  299. package/server/lib/spaces/places/memory-place.js +103 -0
  300. package/server/lib/spaces/places/packed.docker.live.test.js +77 -0
  301. package/server/lib/spaces/places/registry.js +43 -0
  302. package/server/lib/spaces/places/registry.test.js +50 -0
  303. package/server/lib/spaces/places/server.docker.live.test.js +225 -0
  304. package/server/lib/spaces/run-command.js +261 -0
  305. package/server/lib/spaces/run-command.test.js +396 -0
  306. package/server/lib/spaces/space-server.js +190 -0
  307. package/server/lib/spaces/space-server.test.js +335 -0
  308. package/server/lib/spaces/tools-filler.js +82 -0
  309. package/server/lib/spaces/tools-filler.test.js +148 -0
  310. package/server/lib/spaces/tools-pack.js +49 -0
  311. package/server/lib/spaces/tools-pack.test.js +57 -0
  312. package/server/lib/spaces/tools.js +137 -0
  313. package/server/lib/spaces/tools.test.js +153 -0
  314. package/server/lib/tts/openai-sdk.js +11 -0
  315. package/server/lib/tts/service.js +7 -5
  316. package/server/lib/tts/stt.js +3 -2
  317. package/server/lib/tunnels/DOCUMENTATION.md +2 -0
  318. package/server/lib/tunnels/routes.js +7 -0
  319. package/server/lib/tunnels/routes.test.js +55 -0
  320. package/server/lib/ui-auth/ui-auth.js +38 -2
  321. package/server/lib/ui-auth/ui-auth.test.js +42 -0
  322. package/server/lib/ui-auth/ui-passkeys.js +12 -10
  323. package/server/lib/walkthrough/DOCUMENTATION.md +10 -1
  324. package/server/lib/walkthrough/pull-request.js +61 -8
  325. package/server/lib/walkthrough/pull-request.test.js +54 -1
  326. package/server/lib/walkthrough/routes.js +20 -0
  327. package/server/lib/walkthrough/routes.test.js +19 -0
  328. package/server/opencode-proxy.test.js +190 -166
  329. package/server/opencode-worktree-readiness.test.js +5 -4
  330. package/dist/assets/DiffView-Ce0oBXXQ.js +0 -4
  331. package/dist/assets/FilesView-DtXueAWP.js +0 -13
  332. package/dist/assets/LinearIssuesView-z_9p2GuO.js +0 -1
  333. package/dist/assets/MarkdownImageGallery-BC-BNN-s.js +0 -1
  334. package/dist/assets/MarkdownRendererImpl-DyaBTUbH.js +0 -12
  335. package/dist/assets/OnboardingScreen-DKU_yTb6.js +0 -1
  336. package/dist/assets/PlanView-CrfB4qqY.js +0 -5
  337. package/dist/assets/PluginPane-B5cn-jPy.js +0 -3
  338. package/dist/assets/SettingsView-DMKKwezx.js +0 -29
  339. package/dist/assets/SettingsWindow-DwbnVzOC.js +0 -1
  340. package/dist/assets/SubmoduleDiffSummary-hkGcvs0E.js +0 -1
  341. package/dist/assets/ToolOutputDialog-DuoIOc0j.js +0 -15
  342. package/dist/assets/ToolPartDiffPreview-t1Bvq_2Y.js +0 -8
  343. package/dist/assets/appThemeRegistry-DnOVbJjF.js +0 -1
  344. package/dist/assets/commitAndPush-DLWNZkkY.js +0 -1
  345. package/dist/assets/de-zEHaAIi3.js +0 -10
  346. package/dist/assets/es-CBDgEzgk.js +0 -16
  347. package/dist/assets/fr-DjiTptT_.js +0 -14
  348. package/dist/assets/index-AgOdanig.css +0 -1
  349. package/dist/assets/index-B-2_X4DD.js +0 -40
  350. package/dist/assets/index-CkA4p2IK.js +0 -1
  351. package/dist/assets/ja-CerMgj3r.js +0 -16
  352. package/dist/assets/ko-DHYDAze5.js +0 -16
  353. package/dist/assets/main-BDka4W43.js +0 -896
  354. package/dist/assets/main-Dl7Dyge_.js +0 -2
  355. package/dist/assets/markdownCore-DFmr0rUR.js +0 -5
  356. package/dist/assets/miniChat-CLKQPPpO.js +0 -2
  357. package/dist/assets/mobile--giD2Q1L.js +0 -2
  358. package/dist/assets/patchFileDiff-DRh-AQvd.js +0 -13
  359. package/dist/assets/pl-BTB_93bq.js +0 -16
  360. package/dist/assets/pt-BR-BwA3oyCK.js +0 -16
  361. package/dist/assets/renderElectronMiniChatApp-DmB7zpVK.js +0 -2
  362. package/dist/assets/renderMobileApp-pMfOuQfl.js +0 -25
  363. package/dist/assets/runtimeEndpointReset-Gqhmkm3U.js +0 -25
  364. package/dist/assets/scheduledTasksApi-CeRAIUmW.js +0 -1
  365. package/dist/assets/tr-CcPsJoNM.js +0 -7
  366. package/dist/assets/uk-B68WibXi.js +0 -16
  367. package/dist/assets/useAppFontEffects-DcdrFv2Z.js +0 -7333
  368. package/dist/assets/useInlineCommentController-Cq4SUjsA.js +0 -2
  369. package/dist/assets/useRootScrollLock-CSdR6Wnm.js +0 -2
  370. package/dist/assets/vendor-cron-parser-CUcP7OfX.js +0 -2
  371. package/dist/assets/vendor-opencode-sdk-BJ73u-bH.js +0 -7
  372. package/dist/assets/vendor-zod-CgAdXWZO.js +0 -39
  373. package/dist/assets/zh-CN-DbFHYXwP.js +0 -16
  374. package/dist/assets/zh-TW-DmXAwdty.js +0 -16
  375. package/server/lib/opencode/mcp-oauth-callback.test.js +0 -111
  376. package/server/lib/routing/feature-flag.js +0 -11
  377. package/server/lib/small-model/call.js +0 -851
  378. package/server/lib/small-model/call.test.js +0 -1292
  379. package/server/lib/small-model/catalog.js +0 -13
  380. package/server/lib/small-model/resolve.js +0 -131
  381. package/server/lib/small-model/resolve.test.js +0 -197
  382. package/server/lib/small-model/runtime-providers.js +0 -164
  383. package/server/lib/small-model/runtime-providers.test.js +0 -118
  384. package/server/lib/system-prompt/DOCUMENTATION.md +0 -36
  385. package/server/lib/system-prompt/runtime.js +0 -49
  386. package/server/lib/system-prompt/runtime.test.js +0 -76
  387. package/server/lib/walkthrough/reproduce-2607.test.js +0 -148
@@ -0,0 +1,676 @@
1
+ /**
2
+ * Shared surface host: shows viewers what an extension's service is drawing
3
+ * and carries their input back, one controller at a time.
4
+ *
5
+ * One session per extension while at least one viewer is attached. A pump
6
+ * pulls frames from the service (`GET /surface/frame?after=<seq>`, held by
7
+ * the service until something changed) and hands each viewer the newest
8
+ * frame it has not seen, one at a time: a viewer gets the next frame only
9
+ * after acknowledging the previous one, so a slow connection skips frames
10
+ * instead of queueing them. The service is held running for the life of the
11
+ * session and returns to its idle window when the last viewer leaves.
12
+ *
13
+ * Control is owned here, not by the service or the panel. The user takes
14
+ * it by acting (any input from a viewer while nobody, or the agent, holds
15
+ * it); the agent counts as holding it for `SURFACE_AGENT_HOLD_MS` after its
16
+ * last action; a user hands it back with an explicit release. Every change
17
+ * is broadcast to viewers (with `mine` computed per connection) and posted
18
+ * to the service so its own automation can pause. A second viewer sees who
19
+ * holds control and cannot take it away; a viewer that disconnects while
20
+ * holding it releases it.
21
+ */
22
+
23
+ import { randomUUID } from 'node:crypto';
24
+
25
+ import { WebSocketServer } from 'ws';
26
+
27
+ import {
28
+ SURFACE_AGENT_ACTIVE_HEADER,
29
+ SURFACE_AGENT_HOLD_MS,
30
+ SURFACE_CLIPBOARD_PATH,
31
+ SURFACE_CONTROL_PATH,
32
+ SURFACE_FRAME_MAX_BYTES,
33
+ SURFACE_FRAME_MIMES,
34
+ SURFACE_FRAME_PATH,
35
+ SURFACE_FRAME_SEQ_HEADER,
36
+ SURFACE_FRAME_WAIT_MS,
37
+ SURFACE_HEIGHT_HEADER,
38
+ SURFACE_INPUT_PATH,
39
+ SURFACE_RESIZE_PATH,
40
+ SURFACE_SEQ_HEADER,
41
+ SURFACE_TITLE_HEADER,
42
+ SURFACE_TITLE_MAX,
43
+ SURFACE_VIEWER_CONTROLS_HEADER,
44
+ SURFACE_VIEWER_HEADER,
45
+ SURFACE_WIDTH_HEADER,
46
+ isGuestApproved,
47
+ requestedGuestCapabilities,
48
+ } from '@openchamber/sdk';
49
+ import {
50
+ surfaceClipboardAnswerSchema,
51
+ surfaceResizeAnswerSchema,
52
+ surfaceViewerMessageSchema,
53
+ } from '@openchamber/sdk/schemas';
54
+
55
+ import { GuestServiceError, holdGuestService, openGuestServiceRequest } from './service.js';
56
+
57
+ const SURFACE_WS_PATH = /^\/api\/guests\/([a-z][a-z0-9-]*)\/surface\/ws$/;
58
+ /** Input batches and clipboard text; frames never travel viewer → host. */
59
+ const VIEWER_MESSAGE_MAX_BYTES = 256 * 1024;
60
+ const QUICK_REQUEST_TIMEOUT_MS = 10_000;
61
+ const FRAME_MIMES = new Set(SURFACE_FRAME_MIMES);
62
+
63
+ /** Whether this catalog row can show a surface right now. */
64
+ export const isSurfaceGuest = (guest) => (
65
+ Boolean(guest)
66
+ && guest.enabled !== false
67
+ && guest.service?.surface === true
68
+ && isGuestApproved({
69
+ requested: requestedGuestCapabilities(guest),
70
+ granted: Array.isArray(guest.capabilityGrants) ? guest.capabilityGrants : [],
71
+ })
72
+ );
73
+
74
+ const readDimension = (value) => {
75
+ const number = Number(value);
76
+ return Number.isInteger(number) && number > 0 ? number : null;
77
+ };
78
+
79
+ /**
80
+ * @param {{
81
+ * server: import('node:http').Server,
82
+ * uiAuthController: { enabled?: boolean, ensureSessionToken?: Function } | null,
83
+ * isRequestOriginAllowed: (req: import('node:http').IncomingMessage) => Promise<boolean>,
84
+ * rejectWebSocketUpgrade: (socket: import('node:stream').Duplex, status: number, message: string) => void,
85
+ * persistPath: string,
86
+ * findGuest: (id: string) => Promise<object | null>,
87
+ * idleStopMs: number,
88
+ * openServiceRequest?: typeof openGuestServiceRequest,
89
+ * holdService?: typeof holdGuestService,
90
+ * createViewerId?: () => string,
91
+ * setTimer?: typeof setTimeout,
92
+ * clearTimer?: typeof clearTimeout,
93
+ * }} deps
94
+ */
95
+ export const createGuestSurfaceRuntime = ({
96
+ server,
97
+ uiAuthController,
98
+ isRequestOriginAllowed,
99
+ rejectWebSocketUpgrade,
100
+ persistPath,
101
+ findGuest,
102
+ idleStopMs,
103
+ openServiceRequest = openGuestServiceRequest,
104
+ holdService = holdGuestService,
105
+ // Unguessable: a page call that names a viewer is told whether that viewer
106
+ // holds control, so the id works as the viewer's lease.
107
+ createViewerId = () => `viewer-${randomUUID()}`,
108
+ setTimer = setTimeout,
109
+ clearTimer = clearTimeout,
110
+ }) => {
111
+ /** @type {Map<string, Session>} */
112
+ const sessions = new Map();
113
+
114
+ /**
115
+ * @typedef {{
116
+ * id: string,
117
+ * ws: import('ws').WebSocket,
118
+ * sentSeq: number,
119
+ * sentServiceSeq: number,
120
+ * shownServiceSeq: number,
121
+ * awaitingAck: boolean,
122
+ * }} Viewer
123
+ * @typedef {{
124
+ * guestId: string,
125
+ * guest: object,
126
+ * viewers: Map<string, Viewer>,
127
+ * latest: { seq: number, serviceSeq: number, width: number, height: number, mime: string, title?: string, agentActive: boolean, bytes: Buffer } | null,
128
+ * controller: 'none' | 'agent' | string,
129
+ * agentTimer: ReturnType<typeof setTimeout> | null,
130
+ * pumpAbort: AbortController | null,
131
+ * releaseHold: (() => void) | null,
132
+ * ended: boolean,
133
+ * }} Session
134
+ */
135
+
136
+ const send = (viewer, message) => {
137
+ if (viewer.ws.readyState !== 1) return;
138
+ try {
139
+ viewer.ws.send(JSON.stringify(message));
140
+ } catch {
141
+ // The close handler takes the viewer out of the session.
142
+ }
143
+ };
144
+
145
+ const controllerKind = (session) => (
146
+ session.controller === 'none' || session.controller === 'agent' ? session.controller : 'user'
147
+ );
148
+
149
+ const serviceRequest = (session, params) => openServiceRequest({
150
+ guestId: session.guestId,
151
+ guestName: session.guest.name,
152
+ packageRoot: session.guest.packageRoot,
153
+ service: session.guest.service,
154
+ granted: session.guest.capabilityGrants,
155
+ persistPath,
156
+ idleStopMs,
157
+ ...params,
158
+ });
159
+
160
+ /**
161
+ * Service calls that must land in order (input, control, resize, clipboard)
162
+ * run one after another per session: the socket delivers messages in
163
+ * order, and turning them into parallel HTTP requests would let a later
164
+ * batch reach the service before an earlier one. Work queued for an ended
165
+ * session is dropped, so closing a panel never starts the service again.
166
+ */
167
+ const enqueue = (session, task) => {
168
+ const run = session.queue.then(async () => {
169
+ if (session.ended) return;
170
+ await task();
171
+ }).catch(() => undefined);
172
+ session.queue = run;
173
+ return run;
174
+ };
175
+
176
+ const notifyService = async (session, controller, viewerId) => {
177
+ if (session.ended) return;
178
+ try {
179
+ const { response, finished } = await serviceRequest(session, {
180
+ method: 'POST',
181
+ path: SURFACE_CONTROL_PATH,
182
+ body: JSON.stringify(controller === 'user' && viewerId ? { controller, viewer: viewerId } : { controller }),
183
+ timeoutMs: QUICK_REQUEST_TIMEOUT_MS,
184
+ });
185
+ await response.arrayBuffer().catch(() => undefined);
186
+ finished();
187
+ } catch {
188
+ // Advisory: the service pausing its automation is a courtesy, not a
189
+ // gate; the host refuses the browser provider's actions itself.
190
+ }
191
+ };
192
+
193
+ const broadcastControl = (session) => {
194
+ const kind = controllerKind(session);
195
+ for (const viewer of session.viewers.values()) {
196
+ send(viewer, { type: 'control', controller: kind, mine: session.controller === viewer.id });
197
+ }
198
+ const holder = kind === 'user' ? session.controller : undefined;
199
+ void enqueue(session, () => notifyService(session, kind, holder));
200
+ };
201
+
202
+ const clearAgentTimer = (session) => {
203
+ if (session.agentTimer) {
204
+ clearTimer(session.agentTimer);
205
+ session.agentTimer = null;
206
+ }
207
+ };
208
+
209
+ const setController = (session, controller) => {
210
+ if (session.controller === controller) return;
211
+ session.controller = controller;
212
+ clearAgentTimer(session);
213
+ broadcastControl(session);
214
+ };
215
+
216
+ const deliverLatest = (session, viewer) => {
217
+ const frame = session.latest;
218
+ if (!frame || viewer.awaitingAck || viewer.sentSeq >= frame.seq || viewer.ws.readyState !== 1) return;
219
+ viewer.awaitingAck = true;
220
+ viewer.sentSeq = frame.seq;
221
+ viewer.sentServiceSeq = frame.serviceSeq;
222
+ const meta = {
223
+ type: 'frame',
224
+ seq: frame.seq,
225
+ width: frame.width,
226
+ height: frame.height,
227
+ mime: frame.mime,
228
+ bytes: frame.bytes.length,
229
+ agentActive: frame.agentActive,
230
+ };
231
+ if (frame.title) meta.title = frame.title;
232
+ send(viewer, meta);
233
+ try {
234
+ viewer.ws.send(frame.bytes, { binary: true });
235
+ } catch {
236
+ // close handler cleans up
237
+ }
238
+ };
239
+
240
+ const endSession = (session, reason) => {
241
+ if (session.ended) return;
242
+ session.ended = true;
243
+ sessions.delete(session.guestId);
244
+ clearAgentTimer(session);
245
+ session.pumpAbort?.abort();
246
+ session.pumpAbort = null;
247
+ session.releaseHold?.();
248
+ session.releaseHold = null;
249
+ for (const viewer of session.viewers.values()) {
250
+ send(viewer, { type: 'ended', reason });
251
+ try {
252
+ viewer.ws.close(1000, reason);
253
+ } catch {
254
+ // already gone
255
+ }
256
+ }
257
+ session.viewers.clear();
258
+ };
259
+
260
+ const readFrame = async (response) => {
261
+ const declared = Number(response.headers.get('content-length'));
262
+ if (Number.isFinite(declared) && declared > SURFACE_FRAME_MAX_BYTES) return null;
263
+ const mime = (response.headers.get('content-type') || '').split(';')[0].trim();
264
+ if (!FRAME_MIMES.has(mime)) return null;
265
+ const seq = readDimension(response.headers.get(SURFACE_SEQ_HEADER));
266
+ const width = readDimension(response.headers.get(SURFACE_WIDTH_HEADER));
267
+ const height = readDimension(response.headers.get(SURFACE_HEIGHT_HEADER));
268
+ if (seq === null || width === null || height === null) return null;
269
+ const bytes = Buffer.from(await response.arrayBuffer());
270
+ if (bytes.length === 0 || bytes.length > SURFACE_FRAME_MAX_BYTES) return null;
271
+ const title = (response.headers.get(SURFACE_TITLE_HEADER) || '').slice(0, SURFACE_TITLE_MAX);
272
+ const frame = {
273
+ seq,
274
+ // The service's own number, kept when `seq` is bumped below: input is
275
+ // stamped with it, and only the service knows which view it belongs to.
276
+ serviceSeq: seq,
277
+ width,
278
+ height,
279
+ mime,
280
+ bytes,
281
+ agentActive: response.headers.get(SURFACE_AGENT_ACTIVE_HEADER) === '1',
282
+ };
283
+ if (title) frame.title = title;
284
+ return frame;
285
+ };
286
+
287
+ const runPump = async (session) => {
288
+ const abort = new AbortController();
289
+ session.pumpAbort = abort;
290
+ while (!abort.signal.aborted && session.viewers.size > 0) {
291
+ const after = session.latest?.seq ?? 0;
292
+ let opened;
293
+ try {
294
+ opened = await serviceRequest(session, {
295
+ method: 'GET',
296
+ path: SURFACE_FRAME_PATH,
297
+ query: { after: String(after), wait: String(SURFACE_FRAME_WAIT_MS) },
298
+ accept: SURFACE_FRAME_MIMES.join(', '),
299
+ timeoutMs: SURFACE_FRAME_WAIT_MS + QUICK_REQUEST_TIMEOUT_MS,
300
+ signal: abort.signal,
301
+ });
302
+ } catch (error) {
303
+ if (abort.signal.aborted) return;
304
+ const code = error instanceof GuestServiceError ? error.code : 'SERVICE_FAILED';
305
+ endSession(session, code === 'DISABLED' || code === 'NO_SERVICE' ? 'extension-unavailable' : 'service-stopped');
306
+ return;
307
+ }
308
+ const { response, finished } = opened;
309
+ if (response.status === 204) {
310
+ await response.arrayBuffer().catch(() => undefined);
311
+ finished();
312
+ continue;
313
+ }
314
+ if (response.status !== 200) {
315
+ await response.arrayBuffer().catch(() => undefined);
316
+ finished();
317
+ endSession(session, 'service-stopped');
318
+ return;
319
+ }
320
+ let frame;
321
+ try {
322
+ frame = await readFrame(response);
323
+ } catch {
324
+ frame = null;
325
+ }
326
+ finished();
327
+ if (abort.signal.aborted) return;
328
+ if (!frame) {
329
+ endSession(session, 'service-stopped');
330
+ return;
331
+ }
332
+ // A stale or repeated sequence is the service's bug, not a new picture;
333
+ // asking again with the same `after` would spin, so treat it as newer.
334
+ if (frame.seq <= after) frame.seq = after + 1;
335
+ session.latest = frame;
336
+ for (const viewer of session.viewers.values()) deliverLatest(session, viewer);
337
+ }
338
+ };
339
+
340
+ const ensureSession = (guestId, guest) => {
341
+ let session = sessions.get(guestId);
342
+ if (session) {
343
+ session.guest = guest;
344
+ return session;
345
+ }
346
+ session = {
347
+ guestId,
348
+ guest,
349
+ viewers: new Map(),
350
+ latest: null,
351
+ controller: 'none',
352
+ agentTimer: null,
353
+ pumpAbort: null,
354
+ releaseHold: holdService(guestId),
355
+ ended: false,
356
+ queue: Promise.resolve(),
357
+ handoffs: 0,
358
+ };
359
+ sessions.set(guestId, session);
360
+ return session;
361
+ };
362
+
363
+ /** Moving the pointer over the picture is looking, not acting. */
364
+ const isDeliberate = (events) => events.some((event) => (
365
+ event.type !== 'pointer' || event.action !== 'move' || event.buttons !== 0
366
+ ));
367
+
368
+ /**
369
+ * `handoff` is the session's hand-off counter as it was when the batch
370
+ * arrived. A batch that predates a release or a disconnect must not take
371
+ * control back: the user already let go, and re-taking it from a queued
372
+ * click would lock the agent out with nobody to press the button.
373
+ */
374
+ const handleInput = async (session, viewer, events, handoff, frameSeq) => {
375
+ if (viewer.gone) return;
376
+ if (session.controller !== viewer.id) {
377
+ if (session.controller !== 'none' && session.controller !== 'agent') {
378
+ // Someone else is in; say so instead of clicking under them.
379
+ send(viewer, { type: 'control', controller: 'user', mine: false });
380
+ return;
381
+ }
382
+ if (!isDeliberate(events) || handoff !== session.handoffs) return;
383
+ setController(session, viewer.id);
384
+ }
385
+ try {
386
+ const { response, finished } = await serviceRequest(session, {
387
+ method: 'POST',
388
+ path: SURFACE_INPUT_PATH,
389
+ body: JSON.stringify({ events }),
390
+ headers: {
391
+ [SURFACE_VIEWER_HEADER]: viewer.id,
392
+ [SURFACE_FRAME_SEQ_HEADER]: String(frameSeq),
393
+ },
394
+ timeoutMs: QUICK_REQUEST_TIMEOUT_MS,
395
+ });
396
+ await response.arrayBuffer().catch(() => undefined);
397
+ finished();
398
+ // 409: made on a picture the service no longer shows. Nothing reached
399
+ // the page, and the next frame shows the viewer what is there now.
400
+ if (response.status === 409) {
401
+ send(viewer, { type: 'error', code: 'INPUT_STALE', message: 'The picture changed before this input arrived; it was not applied.' });
402
+ return;
403
+ }
404
+ if (response.status < 200 || response.status >= 300) {
405
+ send(viewer, { type: 'error', code: 'INPUT_REJECTED', message: `The extension refused this input (HTTP ${response.status}).` });
406
+ }
407
+ } catch (error) {
408
+ send(viewer, { type: 'error', code: 'INPUT_FAILED', message: error instanceof GuestServiceError ? error.message : 'The input could not be delivered.' });
409
+ }
410
+ };
411
+
412
+ const handleResize = async (session, viewer, width, height) => {
413
+ // The person in control decides the size; when nobody is, the last
414
+ // request wins, which is what a lone viewer expects.
415
+ if (session.controller !== viewer.id && session.controller !== 'none' && session.controller !== 'agent') return;
416
+ try {
417
+ const { response, finished } = await serviceRequest(session, {
418
+ method: 'POST',
419
+ path: SURFACE_RESIZE_PATH,
420
+ body: JSON.stringify({ width, height }),
421
+ timeoutMs: QUICK_REQUEST_TIMEOUT_MS,
422
+ });
423
+ const text = await response.text().catch(() => '');
424
+ finished();
425
+ if (response.status !== 200) return;
426
+ let parsed;
427
+ try {
428
+ parsed = surfaceResizeAnswerSchema.safeParse(JSON.parse(text));
429
+ } catch {
430
+ parsed = { success: false };
431
+ }
432
+ if (parsed.success) send(viewer, { type: 'resized', width: parsed.data.width, height: parsed.data.height });
433
+ } catch {
434
+ // The next frame carries whatever size the service kept.
435
+ }
436
+ };
437
+
438
+ const handleClipboardRead = async (session, viewer, id) => {
439
+ // What was copied inside the surface belongs to whoever is driving it;
440
+ // a viewer that only watches gets nothing, like every other input path.
441
+ if (session.controller !== viewer.id) {
442
+ send(viewer, { type: 'error', code: 'NOT_CONTROLLING', message: 'Take control of the surface to copy from it.' });
443
+ return;
444
+ }
445
+ try {
446
+ const { response, finished } = await serviceRequest(session, {
447
+ method: 'GET',
448
+ path: SURFACE_CLIPBOARD_PATH,
449
+ timeoutMs: QUICK_REQUEST_TIMEOUT_MS,
450
+ });
451
+ const text = await response.text().catch(() => '');
452
+ finished();
453
+ let parsed;
454
+ try {
455
+ parsed = response.status === 200 ? surfaceClipboardAnswerSchema.safeParse(JSON.parse(text)) : { success: false };
456
+ } catch {
457
+ parsed = { success: false };
458
+ }
459
+ if (!parsed.success) {
460
+ send(viewer, { type: 'error', code: 'CLIPBOARD_UNAVAILABLE', message: 'The extension did not provide clipboard text.' });
461
+ return;
462
+ }
463
+ send(viewer, { type: 'clipboard', id, text: parsed.data.text });
464
+ } catch {
465
+ send(viewer, { type: 'error', code: 'CLIPBOARD_UNAVAILABLE', message: 'The extension did not provide clipboard text.' });
466
+ }
467
+ };
468
+
469
+ const handleViewerMessage = (session, viewer, raw) => {
470
+ let parsed;
471
+ try {
472
+ // Node's `ws` delivers a Buffer, Bun's a Uint8Array; both decode here.
473
+ parsed = surfaceViewerMessageSchema.safeParse(JSON.parse(Buffer.from(raw).toString('utf8')));
474
+ } catch {
475
+ parsed = { success: false };
476
+ }
477
+ if (!parsed.success) {
478
+ send(viewer, { type: 'error', code: 'BAD_MESSAGE', message: 'Not a surface message.' });
479
+ return;
480
+ }
481
+ const message = parsed.data;
482
+ switch (message.type) {
483
+ case 'ack':
484
+ if (message.seq === viewer.sentSeq) {
485
+ viewer.awaitingAck = false;
486
+ // Acknowledged after drawing: this is the picture its next input is made on.
487
+ viewer.shownServiceSeq = viewer.sentServiceSeq;
488
+ deliverLatest(session, viewer);
489
+ }
490
+ return;
491
+ case 'input': {
492
+ const handoff = session.handoffs;
493
+ // Read on arrival, not when the queue reaches the batch: the socket
494
+ // delivers acks and input in the order the viewer drew and acted.
495
+ const frameSeq = viewer.shownServiceSeq;
496
+ void enqueue(session, () => handleInput(session, viewer, message.events, handoff, frameSeq));
497
+ return;
498
+ }
499
+ case 'release':
500
+ if (session.controller === viewer.id) {
501
+ session.handoffs += 1;
502
+ setController(session, 'none');
503
+ }
504
+ return;
505
+ case 'resize':
506
+ void enqueue(session, () => handleResize(session, viewer, message.width, message.height));
507
+ return;
508
+ case 'clipboard-read':
509
+ // Queued behind the copy chord that preceded it, so the service has
510
+ // already handled the copy when it is asked what was copied.
511
+ void enqueue(session, () => handleClipboardRead(session, viewer, message.id));
512
+ return;
513
+ }
514
+ };
515
+
516
+ const attachViewer = (guestId, guest, ws) => {
517
+ const session = ensureSession(guestId, guest);
518
+ const viewer = { id: createViewerId(), ws, sentSeq: 0, sentServiceSeq: 0, shownServiceSeq: 0, awaitingAck: false, gone: false };
519
+ session.viewers.set(viewer.id, viewer);
520
+ // Started with the first viewer in place: the pump's loop condition is
521
+ // the viewer count, and it is checked before the first await.
522
+ if (!session.pumpAbort) void runPump(session);
523
+ send(viewer, { type: 'hello', viewerId: viewer.id });
524
+ send(viewer, { type: 'control', controller: controllerKind(session), mine: false });
525
+ deliverLatest(session, viewer);
526
+
527
+ ws.on('message', (raw, isBinary) => {
528
+ if (isBinary) return;
529
+ handleViewerMessage(session, viewer, raw);
530
+ });
531
+ ws.on('close', () => {
532
+ viewer.gone = true;
533
+ session.viewers.delete(viewer.id);
534
+ // An ended session (pause, removal, withdrawn approval, service gone)
535
+ // must not talk to the service again: that would start it back up
536
+ // with the authorization this session was opened under.
537
+ if (session.ended) return;
538
+ const held = session.controller === viewer.id;
539
+ if (held) {
540
+ session.handoffs += 1;
541
+ setController(session, 'none');
542
+ }
543
+ if (session.viewers.size > 0) return;
544
+ // Nobody is watching: stop pulling frames. The session stays
545
+ // registered until its queue (including the final "none" above) has
546
+ // drained, so a deactivation in the meantime still finds it and
547
+ // cancels that work instead of letting it restart the service.
548
+ clearAgentTimer(session);
549
+ session.pumpAbort?.abort();
550
+ session.pumpAbort = null;
551
+ void session.queue.then(() => {
552
+ if (session.ended || session.viewers.size > 0) return;
553
+ session.ended = true;
554
+ sessions.delete(guestId);
555
+ session.releaseHold?.();
556
+ session.releaseHold = null;
557
+ });
558
+ });
559
+ ws.on('error', () => {
560
+ try {
561
+ ws.close();
562
+ } catch {
563
+ // ignore
564
+ }
565
+ });
566
+ };
567
+
568
+ const wsServer = new WebSocketServer({ noServer: true, maxPayload: VIEWER_MESSAGE_MAX_BYTES });
569
+
570
+ const upgradeHandler = (req, socket, head) => {
571
+ let pathname = '';
572
+ try {
573
+ pathname = new URL(req.url || '/', 'http://localhost').pathname;
574
+ } catch {
575
+ return;
576
+ }
577
+ const match = SURFACE_WS_PATH.exec(pathname);
578
+ if (!match) return;
579
+ const guestId = match[1];
580
+
581
+ const handleUpgrade = async () => {
582
+ try {
583
+ if (uiAuthController?.enabled) {
584
+ const sessionToken = await uiAuthController.ensureSessionToken?.(req, null);
585
+ if (!sessionToken) {
586
+ rejectWebSocketUpgrade(socket, 401, 'UI authentication required');
587
+ return;
588
+ }
589
+ if (!await isRequestOriginAllowed(req)) {
590
+ rejectWebSocketUpgrade(socket, 403, 'Invalid origin');
591
+ return;
592
+ }
593
+ }
594
+ const guest = await findGuest(guestId).catch(() => null);
595
+ if (!isSurfaceGuest(guest)) {
596
+ rejectWebSocketUpgrade(socket, 404, 'No surface for this extension');
597
+ return;
598
+ }
599
+ wsServer.handleUpgrade(req, socket, head, (ws) => {
600
+ attachViewer(guestId, guest, ws);
601
+ });
602
+ } catch {
603
+ rejectWebSocketUpgrade(socket, 500, 'Upgrade failed');
604
+ }
605
+ };
606
+ void handleUpgrade();
607
+ };
608
+
609
+ server.on('upgrade', upgradeHandler);
610
+
611
+ return {
612
+ /**
613
+ * Read by the browser provider before an action: a user holding the
614
+ * surface must not have the agent clicking under their hands.
615
+ */
616
+ userControls(guestId) {
617
+ const session = sessions.get(guestId);
618
+ return Boolean(session) && session.controller !== 'none' && session.controller !== 'agent';
619
+ },
620
+
621
+ /** The host ran an agent action against this extension's surface. */
622
+ noteAgentActivity(guestId) {
623
+ const session = sessions.get(guestId);
624
+ if (!session || (session.controller !== 'none' && session.controller !== 'agent')) return;
625
+ const first = session.controller !== 'agent';
626
+ session.controller = 'agent';
627
+ clearAgentTimer(session);
628
+ session.agentTimer = setTimer(() => {
629
+ session.agentTimer = null;
630
+ if (session.controller === 'agent') setController(session, 'none');
631
+ }, SURFACE_AGENT_HOLD_MS);
632
+ session.agentTimer.unref?.();
633
+ if (first) broadcastControl(session);
634
+ },
635
+
636
+ /** Pause, removal, or withdrawn approval: viewers are told and dropped. */
637
+ endForGuest(guestId) {
638
+ const session = sessions.get(guestId);
639
+ if (session) endSession(session, 'extension-unavailable');
640
+ },
641
+
642
+ /**
643
+ * Headers for a page `serviceRequest` made from the window that holds
644
+ * `viewerId`, or null when that id is not a live viewer of this
645
+ * extension (then the request goes out without any).
646
+ */
647
+ viewerHeaders(guestId, viewerId) {
648
+ const session = sessions.get(guestId);
649
+ const viewer = session && !session.ended ? session.viewers.get(viewerId) : undefined;
650
+ if (!viewer || viewer.gone) return null;
651
+ return {
652
+ [SURFACE_VIEWER_HEADER]: viewer.id,
653
+ [SURFACE_VIEWER_CONTROLS_HEADER]: session.controller === viewer.id ? '1' : '0',
654
+ [SURFACE_FRAME_SEQ_HEADER]: String(viewer.shownServiceSeq),
655
+ };
656
+ },
657
+
658
+ /** Test seam. */
659
+ sessionOf(guestId) {
660
+ return sessions.get(guestId) ?? null;
661
+ },
662
+
663
+ stop() {
664
+ server.off('upgrade', upgradeHandler);
665
+ for (const session of [...sessions.values()]) endSession(session, 'host-shutdown');
666
+ for (const client of wsServer.clients) {
667
+ try {
668
+ client.close(1001, 'server shutting down');
669
+ } catch {
670
+ // ignore
671
+ }
672
+ }
673
+ wsServer.close();
674
+ },
675
+ };
676
+ };