@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.
- package/bin/lib/commands-connect-url.js +3 -8
- package/bin/lib/commands-tunnel.js +3 -0
- package/dist/assets/{CodeMirrorCommentWidgets-B_vBPQYm.js → CodeMirrorCommentWidgets-zm3C1FvM.js} +1 -1
- package/dist/assets/DiffView-DNExNi1z.js +4 -0
- package/dist/assets/FilesView-DUCLmHBi.js +17 -0
- package/dist/assets/{GitView-k0hUF8KB.js → GitView-Bz9z6gZA.js} +4 -4
- package/dist/assets/{GuestAttachDialog-DIf2U85Z.js → GuestAttachDialog-UGp4KDlK.js} +1 -1
- package/dist/assets/GuestSurfacePane-B3pdB_2u.js +1 -0
- package/dist/assets/{JsonTreeView-4AnJ04Pw.js → JsonTreeView-7lVecnZl.js} +1 -1
- package/dist/assets/LinearIssuesView-CTGRS9Vq.js +1 -0
- package/dist/assets/MarkdownImageGallery-DQk5adUs.js +1 -0
- package/dist/assets/MarkdownRendererImpl-DPF8fZpX.js +12 -0
- package/dist/assets/OnboardingScreen-CBx6cXPP.js +1 -0
- package/dist/assets/{PatchDiff-DpGmHRnV.js → PatchDiff-D7VVpR_l.js} +1 -1
- package/dist/assets/{PierreDiffViewer-CgLl_tp7.js → PierreDiffViewer-Gbfks1pk.js} +3 -3
- package/dist/assets/PlanView-CPSK0x97.js +5 -0
- package/dist/assets/PluginPane-BIGsUx69.js +3 -0
- package/dist/assets/SettingsView-Dql7z6Ww.js +30 -0
- package/dist/assets/SettingsWindow-D6oi-UmV.js +1 -0
- package/dist/assets/SubmoduleDiffSummary-BXA0FAWj.js +1 -0
- package/dist/assets/ToolOutputDialog-BQJsSbDm.js +15 -0
- package/dist/assets/ToolPartDiffPreview-FY9w0TVT.js +8 -0
- package/dist/assets/{VirtualizedFileDiff-BK4aU5qJ.js → VirtualizedFileDiff-B9YhAya5.js} +4 -4
- package/dist/assets/{WalkthroughView-Bk6TPNFw.js → WalkthroughView-CmFgOUFN.js} +2 -2
- package/dist/assets/appThemeRegistry-BebxalUt.js +1 -0
- package/dist/assets/changesTree-CePHbFcj.js +1 -0
- package/dist/assets/commitAndPush-Wfxng_IK.js +1 -0
- package/dist/assets/{computeVirtualFileMetrics-BVTujWSX.js → computeVirtualFileMetrics-BCOqgixN.js} +2 -2
- package/dist/assets/de-CMA45TC-.js +10 -0
- package/dist/assets/es-DPL4fBtl.js +16 -0
- package/dist/assets/fr-OHBKBseP.js +14 -0
- package/dist/assets/index-3TiDNtfN.js +1 -0
- package/dist/assets/index-BLUZa5u0.js +41 -0
- package/dist/assets/index-Cm2rrq69.css +1 -0
- package/dist/assets/{isDiffPlainText-D3yX_vx4.js → isDiffPlainText-DnDYQmWK.js} +1 -1
- package/dist/assets/{isFilePlainText-CZR9TcHV.js → isFilePlainText-BA_AHX7d.js} +1 -1
- package/dist/assets/ja-DvX4WSRf.js +16 -0
- package/dist/assets/ko-BUcLd8YZ.js +16 -0
- package/dist/assets/main-B_jri4i-.js +896 -0
- package/dist/assets/main-DtUmJp9B.js +2 -0
- package/dist/assets/{markdown-shiki.worker-CahLvHIq.js → markdown-shiki.worker-Bg8SoAJJ.js} +8 -5
- package/dist/assets/markdownCore-BSnlUXBf.js +7 -0
- package/dist/assets/miniChat-BYfLUnDK.js +2 -0
- package/dist/assets/mobile-DH3hI6gd.js +2 -0
- package/dist/assets/patchFileDiff--L7lt_GZ.js +13 -0
- package/dist/assets/pl-BkI_xHqz.js +16 -0
- package/dist/assets/pt-BR-7wFtQlV9.js +16 -0
- package/dist/assets/renderElectronMiniChatApp-C7kpNW_-.js +2 -0
- package/dist/assets/renderMobileApp-i0nq7Dwy.js +25 -0
- package/dist/assets/runtimeEndpointReset-CfEYbcCc.js +27 -0
- package/dist/assets/scheduledTasksApi-Cy7uZCaI.js +1 -0
- package/dist/assets/{shikiHighlight-BfjuB3CD.js → shikiHighlight-D4vxipfr.js} +1 -1
- package/dist/assets/{textMateThemeFromAppTheme-BP60t9SX.js → textMateThemeFromAppTheme-BYAHtJwQ.js} +1 -1
- package/dist/assets/tr-TsD-AqEH.js +7 -0
- package/dist/assets/uk-B-qspCmD.js +16 -0
- package/dist/assets/useAppFontEffects-DHZ9-L30.js +7338 -0
- package/dist/assets/useInlineCommentController-CvpOMK-R.js +2 -0
- package/dist/assets/useRootScrollLock-DzNFi-fn.js +2 -0
- package/dist/assets/{vendor-codemirror-language-data-BFm1Ju2w.js → vendor-codemirror-language-data-j3fhlwUM.js} +2 -2
- package/dist/assets/vendor-cron-parser-CjvYVigk.js +2 -0
- package/dist/assets/vendor-opencode-client-DYdsLbCM.js +12 -0
- package/dist/assets/{vendor-remixicon-react-BDmGmFCA.js → vendor-remixicon-react-D6dZ0UwF.js} +1 -1
- package/dist/assets/vendor-zod-BSoePkpP.js +39 -0
- package/dist/assets/{web-components-2vo9YsZc.js → web-components-BvHNFSEG.js} +2 -2
- package/dist/assets/zh-CN-DYuPJV5i.js +16 -0
- package/dist/assets/zh-TW-BX_2D_lV.js +16 -0
- package/dist/index.html +13 -7
- package/dist/mini-chat.html +5 -5
- package/dist/mobile.html +5 -5
- package/package.json +6 -5
- package/server/index.d.ts +1 -0
- package/server/index.js +264 -91
- package/server/lib/agent-tool/DOCUMENTATION.md +38 -16
- package/server/lib/agent-tool/runtime.js +167 -58
- package/server/lib/agent-tool/runtime.test.js +170 -87
- package/server/lib/browser-control/DOCUMENTATION.md +51 -4
- package/server/lib/browser-control/provider.js +217 -0
- package/server/lib/browser-control/provider.test.js +251 -0
- package/server/lib/context-obligatory/runtime.js +61 -50
- package/server/lib/context-obligatory/runtime.test.js +62 -162
- package/server/lib/event-stream/DOCUMENTATION.md +12 -1
- package/server/lib/event-stream/delta-coalescer.js +0 -0
- package/server/lib/event-stream/delta-coalescer.test.js +68 -57
- package/server/lib/event-stream/directory-ws-bridge.js +1 -1
- package/server/lib/event-stream/global-hub.js +10 -1
- package/server/lib/event-stream/global-hub.test.js +27 -26
- package/server/lib/event-stream/index.js +6 -0
- package/server/lib/event-stream/protocol.js +26 -19
- package/server/lib/event-stream/protocol.test.js +18 -7
- package/server/lib/event-stream/rebind.test.js +5 -5
- package/server/lib/event-stream/runtime.test.js +17 -15
- package/server/lib/event-stream/translate-v2.js +313 -0
- package/server/lib/event-stream/translate-v2.test.js +209 -0
- package/server/lib/event-stream/upstream-reader.test.js +16 -16
- package/server/lib/fs/DOCUMENTATION.md +4 -2
- package/server/lib/fs/byte-range.js +35 -0
- package/server/lib/fs/byte-range.test.js +31 -0
- package/server/lib/fs/routes.js +47 -42
- package/server/lib/fs/routes.test.js +123 -18
- package/server/lib/git/DOCUMENTATION.md +1 -1
- package/server/lib/git/service.js +34 -0
- package/server/lib/git/service.test.js +8 -0
- package/server/lib/github/DOCUMENTATION.md +1 -1
- package/server/lib/github/pr-status.js +22 -2
- package/server/lib/github/pr-status.test.js +27 -14
- package/server/lib/guests/DOCUMENTATION.md +16 -2
- package/server/lib/guests/catalog.js +31 -1
- package/server/lib/guests/catalog.test.js +55 -0
- package/server/lib/guests/html-styles.js +5 -3
- package/server/lib/guests/html-styles.test.js +3 -1
- package/server/lib/guests/routes.js +21 -4
- package/server/lib/guests/service.js +197 -14
- package/server/lib/guests/service.test.js +201 -1
- package/server/lib/guests/surface.js +676 -0
- package/server/lib/guests/surface.test.js +536 -0
- package/server/lib/markdown-image-grants/routes.js +18 -5
- package/server/lib/markdown-image-grants/routes.test.js +9 -6
- package/server/lib/message-queue/DOCUMENTATION.md +33 -22
- package/server/lib/message-queue/runtime.js +155 -100
- package/server/lib/message-queue/runtime.test.js +168 -82
- package/server/lib/notifications/DOCUMENTATION.md +38 -0
- package/server/lib/notifications/control-stream.http.test.js +68 -0
- package/server/lib/notifications/emit-route.js +118 -0
- package/server/lib/notifications/emit-route.test.js +112 -0
- package/server/lib/notifications/emitter-runtime.js +15 -0
- package/server/lib/notifications/emitter-runtime.test.js +32 -0
- package/server/lib/notifications/push-runtime.js +5 -1
- package/server/lib/notifications/push-runtime.test.js +2 -2
- package/server/lib/notifications/routes.js +1 -1
- package/server/lib/notifications/runtime.js +115 -26
- package/server/lib/notifications/template-runtime.js +13 -15
- package/server/lib/notifications/template-runtime.test.js +16 -9
- package/server/lib/notifications/trigger-runtime.test.js +187 -0
- package/server/lib/openchamber-control/DOCUMENTATION.md +10 -0
- package/server/lib/openchamber-control/actions.js +19 -4
- package/server/lib/openchamber-control/error.js +1 -1
- package/server/lib/openchamber-control/file-open.js +59 -0
- package/server/lib/openchamber-control/file-open.test.js +57 -0
- package/server/lib/openchamber-control/routes.test.js +12 -0
- package/server/lib/openchamber-control/service.js +125 -49
- package/server/lib/openchamber-control/service.test.js +115 -44
- package/server/lib/openchamber-sessions/archive-store.js +224 -0
- package/server/lib/openchamber-sessions/archive-store.test.js +187 -0
- package/server/lib/openchamber-sessions/fork-inheritance.js +103 -0
- package/server/lib/openchamber-sessions/fork-inheritance.test.js +69 -0
- package/server/lib/openchamber-sessions/opencode-client.js +22 -0
- package/server/lib/openchamber-sessions/routes.js +409 -328
- package/server/lib/openchamber-sessions/routes.test.js +795 -740
- package/server/lib/openchamber-sessions/session-metadata-store.js +285 -0
- package/server/lib/openchamber-sessions/session-metadata-store.test.js +259 -0
- package/server/lib/opencode/DOCUMENTATION.md +458 -29
- package/server/lib/opencode/agents.js +233 -327
- package/server/lib/opencode/auth.js +41 -44
- package/server/lib/opencode/auth.test.js +92 -0
- package/server/lib/opencode/bootstrap-runtime.js +12 -0
- package/server/lib/opencode/cli-upgrade.d.ts +4 -0
- package/server/lib/opencode/cli-upgrade.js +18 -0
- package/server/lib/opencode/cli-upgrade.test.js +36 -0
- package/server/lib/opencode/commands.js +164 -145
- package/server/lib/opencode/compatibility.d.ts +16 -0
- package/server/lib/opencode/compatibility.js +91 -0
- package/server/lib/opencode/compatibility.test.js +70 -0
- package/server/lib/opencode/config-entity-routes.js +58 -29
- package/server/lib/opencode/config-entity-v2.test.js +290 -0
- package/server/lib/opencode/config-mutation-response.js +17 -7
- package/server/lib/opencode/config-mutation-response.test.js +4 -7
- package/server/lib/opencode/config-paths.test.js +2 -2
- package/server/lib/opencode/config-v2.d.ts +185 -0
- package/server/lib/opencode/config-v2.js +843 -0
- package/server/lib/opencode/config-v2.test.js +483 -0
- package/server/lib/opencode/core-routes.js +3 -0
- package/server/lib/opencode/core-routes.test.js +15 -0
- package/server/lib/opencode/credential-db.js +144 -0
- package/server/lib/opencode/credential-db.test.js +104 -0
- package/server/lib/opencode/env-runtime.js +47 -15
- package/server/lib/opencode/env-runtime.test.js +45 -0
- package/server/lib/opencode/feature-routes-runtime.js +16 -5
- package/server/lib/opencode/lifecycle-process.test.js +7 -4
- package/server/lib/opencode/lifecycle.js +113 -30
- package/server/lib/opencode/lifecycle.test.js +107 -8
- package/server/lib/opencode/login-shell-env.js +27 -0
- package/server/lib/opencode/managed-config-file.js +131 -0
- package/server/lib/opencode/managed-config-file.test.js +168 -0
- package/server/lib/opencode/managed-plugin-config.js +33 -13
- package/server/lib/opencode/mcp.js +43 -149
- package/server/lib/opencode/network-runtime.js +6 -7
- package/server/lib/opencode/openchamber-routes.js +29 -11
- package/server/lib/opencode/openchamber-routes.test.js +18 -1
- package/server/lib/opencode/plugin-routes.js +3 -3
- package/server/lib/opencode/plugin-routes.test.js +6 -24
- package/server/lib/opencode/plugins.js +91 -40
- package/server/lib/opencode/plugins.test.js +28 -15
- package/server/lib/opencode/provider-source-route.test.js +59 -0
- package/server/lib/opencode/providers.js +66 -83
- package/server/lib/opencode/providers.test.js +190 -59
- package/server/lib/opencode/proxy-agent-wiring.test.js +4 -2
- package/server/lib/opencode/proxy.js +179 -129
- package/server/lib/opencode/pwa-manifest-routes.js +4 -2
- package/server/lib/opencode/pwa-manifest-routes.test.js +3 -2
- package/server/lib/opencode/response-envelope.js +14 -0
- package/server/lib/opencode/response-envelope.test.js +23 -0
- package/server/lib/opencode/routes-upgrade.test.js +73 -116
- package/server/lib/opencode/routes.js +138 -428
- package/server/lib/opencode/server-utils-runtime.js +10 -4
- package/server/lib/opencode/session-activity.js +78 -0
- package/server/lib/opencode/session-runtime.js +21 -10
- package/server/lib/opencode/session-runtime.test.js +9 -9
- package/server/lib/opencode/settings-helpers.js +15 -8
- package/server/lib/opencode/settings-helpers.test.js +7 -12
- package/server/lib/opencode/settings-registry.json +20 -8
- package/server/lib/opencode/settings-runtime.js +19 -1
- package/server/lib/opencode/settings-runtime.test.js +31 -2
- package/server/lib/opencode/shared.js +86 -24
- package/server/lib/opencode/shared.test.js +87 -5
- package/server/lib/opencode/shutdown-runtime.js +54 -7
- package/server/lib/opencode/shutdown-runtime.test.js +224 -30
- package/server/lib/opencode/skill-routes.js +51 -36
- package/server/lib/opencode/skill-routes.test.js +121 -1
- package/server/lib/opencode/skills.js +7 -5
- package/server/lib/opencode/tunnel-wiring-runtime.js +2 -1
- package/server/lib/opencode/upgrade-capability.js +0 -14
- package/server/lib/opencode/upgrade-capability.test.js +1 -1
- package/server/lib/opencode/v1-migration-topup.js +294 -0
- package/server/lib/opencode/v1-migration-topup.test.js +274 -0
- package/server/lib/opencode/v2-install.d.ts +9 -0
- package/server/lib/opencode/v2-install.js +159 -0
- package/server/lib/opencode/v2-install.test.js +133 -0
- package/server/lib/opencode/watcher.js +10 -3
- package/server/lib/opencode/watcher.test.js +17 -21
- package/server/lib/opencode/websearch-config.js +78 -0
- package/server/lib/permission-auto-accept/runtime.js +38 -22
- package/server/lib/permission-auto-accept/runtime.test.js +39 -17
- package/server/lib/quota/DOCUMENTATION.md +4 -0
- package/server/lib/quota/providers/kimi.js +1 -1
- package/server/lib/quota/providers/xai.js +4 -4
- package/server/lib/relay/tunnel-host.js +4 -1
- package/server/lib/relay/tunnel-host.test.js +7 -0
- package/server/lib/routing/DOCUMENTATION.md +52 -21
- package/server/lib/routing/defaults.js +23 -6
- package/server/lib/routing/jev.js +17 -7
- package/server/lib/routing/routes.http.test.js +68 -33
- package/server/lib/routing/routes.js +65 -22
- package/server/lib/routing/runtime.js +145 -48
- package/server/lib/routing/runtime.test.js +79 -55
- package/server/lib/scheduled-tasks/DOCUMENTATION.md +4 -0
- package/server/lib/scheduled-tasks/issue-2710-double-execution.test.js +51 -46
- package/server/lib/scheduled-tasks/runtime.js +81 -74
- package/server/lib/scheduled-tasks/runtime.test.js +53 -1
- package/server/lib/session-assist/DOCUMENTATION.md +25 -8
- package/server/lib/session-assist/context.js +122 -46
- package/server/lib/session-assist/context.test.js +117 -49
- package/server/lib/session-assist/runtime.js +71 -24
- package/server/lib/session-assist/runtime.test.js +153 -173
- package/server/lib/session-goal/DOCUMENTATION.md +34 -15
- package/server/lib/session-goal/create.js +9 -12
- package/server/lib/session-goal/create.test.js +27 -28
- package/server/lib/session-goal/runtime.js +164 -77
- package/server/lib/session-goal/runtime.test.js +271 -519
- package/server/lib/session-knowledge/DOCUMENTATION.md +5 -0
- package/server/lib/session-knowledge/runtime.js +59 -41
- package/server/lib/session-knowledge/runtime.test.js +90 -20
- package/server/lib/small-model/DOCUMENTATION.md +154 -208
- package/server/lib/small-model/client.js +113 -0
- package/server/lib/small-model/index.js +296 -158
- package/server/lib/small-model/index.test.js +423 -256
- package/server/lib/small-model/routes.js +1 -1
- package/server/lib/spaces/DOCUMENTATION.md +807 -0
- package/server/lib/spaces/code-in-bait.js +185 -0
- package/server/lib/spaces/code-in.js +641 -0
- package/server/lib/spaces/code-in.test.js +1048 -0
- package/server/lib/spaces/errors.js +8 -0
- package/server/lib/spaces/exec-http.js +94 -0
- package/server/lib/spaces/gatekeeper-channel.js +202 -0
- package/server/lib/spaces/gatekeeper-channel.test.js +215 -0
- package/server/lib/spaces/gatekeeper-program.cjs +914 -0
- package/server/lib/spaces/gatekeeper-program.test.js +1391 -0
- package/server/lib/spaces/hardening.js +457 -0
- package/server/lib/spaces/hardening.test.js +368 -0
- package/server/lib/spaces/host-git.js +127 -0
- package/server/lib/spaces/host-git.test.js +137 -0
- package/server/lib/spaces/labels.js +234 -0
- package/server/lib/spaces/labels.test.js +219 -0
- package/server/lib/spaces/layout.js +184 -0
- package/server/lib/spaces/layout.test.js +30 -0
- package/server/lib/spaces/manager.js +82 -0
- package/server/lib/spaces/manager.test.js +114 -0
- package/server/lib/spaces/places/code-in.docker.live.test.js +216 -0
- package/server/lib/spaces/places/contract-suite.js +156 -0
- package/server/lib/spaces/places/contract.docker.live.test.js +7 -0
- package/server/lib/spaces/places/contract.test.js +6 -0
- package/server/lib/spaces/places/docker-engine.js +126 -0
- package/server/lib/spaces/places/docker-live-support.js +202 -0
- package/server/lib/spaces/places/docker-tools.js +186 -0
- package/server/lib/spaces/places/docker.js +587 -0
- package/server/lib/spaces/places/docker.test.js +1610 -0
- package/server/lib/spaces/places/escape-suite.js +1018 -0
- package/server/lib/spaces/places/escape.docker.live.test.js +7 -0
- package/server/lib/spaces/places/fake-docker.js +375 -0
- package/server/lib/spaces/places/memory-place.js +103 -0
- package/server/lib/spaces/places/packed.docker.live.test.js +77 -0
- package/server/lib/spaces/places/registry.js +43 -0
- package/server/lib/spaces/places/registry.test.js +50 -0
- package/server/lib/spaces/places/server.docker.live.test.js +225 -0
- package/server/lib/spaces/run-command.js +261 -0
- package/server/lib/spaces/run-command.test.js +396 -0
- package/server/lib/spaces/space-server.js +190 -0
- package/server/lib/spaces/space-server.test.js +335 -0
- package/server/lib/spaces/tools-filler.js +82 -0
- package/server/lib/spaces/tools-filler.test.js +148 -0
- package/server/lib/spaces/tools-pack.js +49 -0
- package/server/lib/spaces/tools-pack.test.js +57 -0
- package/server/lib/spaces/tools.js +137 -0
- package/server/lib/spaces/tools.test.js +153 -0
- package/server/lib/tts/openai-sdk.js +11 -0
- package/server/lib/tts/service.js +7 -5
- package/server/lib/tts/stt.js +3 -2
- package/server/lib/tunnels/DOCUMENTATION.md +2 -0
- package/server/lib/tunnels/routes.js +7 -0
- package/server/lib/tunnels/routes.test.js +55 -0
- package/server/lib/ui-auth/ui-auth.js +38 -2
- package/server/lib/ui-auth/ui-auth.test.js +42 -0
- package/server/lib/ui-auth/ui-passkeys.js +12 -10
- package/server/lib/walkthrough/DOCUMENTATION.md +10 -1
- package/server/lib/walkthrough/pull-request.js +61 -8
- package/server/lib/walkthrough/pull-request.test.js +54 -1
- package/server/lib/walkthrough/routes.js +20 -0
- package/server/lib/walkthrough/routes.test.js +19 -0
- package/server/opencode-proxy.test.js +190 -166
- package/server/opencode-worktree-readiness.test.js +5 -4
- package/dist/assets/DiffView-Ce0oBXXQ.js +0 -4
- package/dist/assets/FilesView-DtXueAWP.js +0 -13
- package/dist/assets/LinearIssuesView-z_9p2GuO.js +0 -1
- package/dist/assets/MarkdownImageGallery-BC-BNN-s.js +0 -1
- package/dist/assets/MarkdownRendererImpl-DyaBTUbH.js +0 -12
- package/dist/assets/OnboardingScreen-DKU_yTb6.js +0 -1
- package/dist/assets/PlanView-CrfB4qqY.js +0 -5
- package/dist/assets/PluginPane-B5cn-jPy.js +0 -3
- package/dist/assets/SettingsView-DMKKwezx.js +0 -29
- package/dist/assets/SettingsWindow-DwbnVzOC.js +0 -1
- package/dist/assets/SubmoduleDiffSummary-hkGcvs0E.js +0 -1
- package/dist/assets/ToolOutputDialog-DuoIOc0j.js +0 -15
- package/dist/assets/ToolPartDiffPreview-t1Bvq_2Y.js +0 -8
- package/dist/assets/appThemeRegistry-DnOVbJjF.js +0 -1
- package/dist/assets/commitAndPush-DLWNZkkY.js +0 -1
- package/dist/assets/de-zEHaAIi3.js +0 -10
- package/dist/assets/es-CBDgEzgk.js +0 -16
- package/dist/assets/fr-DjiTptT_.js +0 -14
- package/dist/assets/index-AgOdanig.css +0 -1
- package/dist/assets/index-B-2_X4DD.js +0 -40
- package/dist/assets/index-CkA4p2IK.js +0 -1
- package/dist/assets/ja-CerMgj3r.js +0 -16
- package/dist/assets/ko-DHYDAze5.js +0 -16
- package/dist/assets/main-BDka4W43.js +0 -896
- package/dist/assets/main-Dl7Dyge_.js +0 -2
- package/dist/assets/markdownCore-DFmr0rUR.js +0 -5
- package/dist/assets/miniChat-CLKQPPpO.js +0 -2
- package/dist/assets/mobile--giD2Q1L.js +0 -2
- package/dist/assets/patchFileDiff-DRh-AQvd.js +0 -13
- package/dist/assets/pl-BTB_93bq.js +0 -16
- package/dist/assets/pt-BR-BwA3oyCK.js +0 -16
- package/dist/assets/renderElectronMiniChatApp-DmB7zpVK.js +0 -2
- package/dist/assets/renderMobileApp-pMfOuQfl.js +0 -25
- package/dist/assets/runtimeEndpointReset-Gqhmkm3U.js +0 -25
- package/dist/assets/scheduledTasksApi-CeRAIUmW.js +0 -1
- package/dist/assets/tr-CcPsJoNM.js +0 -7
- package/dist/assets/uk-B68WibXi.js +0 -16
- package/dist/assets/useAppFontEffects-DcdrFv2Z.js +0 -7333
- package/dist/assets/useInlineCommentController-Cq4SUjsA.js +0 -2
- package/dist/assets/useRootScrollLock-CSdR6Wnm.js +0 -2
- package/dist/assets/vendor-cron-parser-CUcP7OfX.js +0 -2
- package/dist/assets/vendor-opencode-sdk-BJ73u-bH.js +0 -7
- package/dist/assets/vendor-zod-CgAdXWZO.js +0 -39
- package/dist/assets/zh-CN-DbFHYXwP.js +0 -16
- package/dist/assets/zh-TW-DmXAwdty.js +0 -16
- package/server/lib/opencode/mcp-oauth-callback.test.js +0 -111
- package/server/lib/routing/feature-flag.js +0 -11
- package/server/lib/small-model/call.js +0 -851
- package/server/lib/small-model/call.test.js +0 -1292
- package/server/lib/small-model/catalog.js +0 -13
- package/server/lib/small-model/resolve.js +0 -131
- package/server/lib/small-model/resolve.test.js +0 -197
- package/server/lib/small-model/runtime-providers.js +0 -164
- package/server/lib/small-model/runtime-providers.test.js +0 -118
- package/server/lib/system-prompt/DOCUMENTATION.md +0 -36
- package/server/lib/system-prompt/runtime.js +0 -49
- package/server/lib/system-prompt/runtime.test.js +0 -76
- 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
|
+
};
|