import { createHash } from "node:crypto" import { afterEach, describe, expect, test } from "bun:test" import { Flag } from "@opencode-ai/core/flag/flag" import * as Log from "@opencode-ai/core/util/log" import { ConfigProvider, Effect, Layer } from "effect" import { HttpClient, HttpClientRequest, HttpClientResponse, HttpRouter, HttpServer, HttpServerRequest, HttpServerResponse, } from "effect/unstable/http" import { AppFileSystem } from "@opencode-ai/core/filesystem" import { ServerAuth } from "../../src/server/auth" import { authorizationRouterMiddleware } from "../../src/server/routes/instance/httpapi/middleware/authorization" import { ExperimentalHttpApiServer } from "../../src/server/routes/instance/httpapi/server" import { serveEmbeddedUIEffect, serveUIEffect } from "../../src/server/shared/ui" import { Server } from "../../src/server/server" void Log.init({ print: false }) const original = { OPENCODE_EXPERIMENTAL_HTTPAPI: Flag.OPENCODE_EXPERIMENTAL_HTTPAPI, OPENCODE_DISABLE_EMBEDDED_WEB_UI: Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI, OPENCODE_SERVER_PASSWORD: Flag.OPENCODE_SERVER_PASSWORD, OPENCODE_SERVER_USERNAME: Flag.OPENCODE_SERVER_USERNAME, envPassword: process.env.OPENCODE_SERVER_PASSWORD, envUsername: process.env.OPENCODE_SERVER_USERNAME, } afterEach(() => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = original.OPENCODE_EXPERIMENTAL_HTTPAPI Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = original.OPENCODE_DISABLE_EMBEDDED_WEB_UI Flag.OPENCODE_SERVER_PASSWORD = original.OPENCODE_SERVER_PASSWORD Flag.OPENCODE_SERVER_USERNAME = original.OPENCODE_SERVER_USERNAME restoreEnv("OPENCODE_SERVER_PASSWORD", original.envPassword) restoreEnv("OPENCODE_SERVER_USERNAME", original.envUsername) }) function restoreEnv(key: string, value: string | undefined) { if (value === undefined) { delete process.env[key] return } process.env[key] = value } function app(input?: { password?: string; username?: string }) { const handler = HttpRouter.toWebHandler( ExperimentalHttpApiServer.routes.pipe( Layer.provide( ConfigProvider.layer( ConfigProvider.fromUnknown({ OPENCODE_SERVER_PASSWORD: input?.password, OPENCODE_SERVER_USERNAME: input?.username, }), ), ), ), { disableLogger: true }, ).handler return { request(input: string | URL | Request, init?: RequestInit) { return handler( input instanceof Request ? input : new Request(new URL(input, "http://localhost"), init), ExperimentalHttpApiServer.context, ) }, } } function uiApp(input?: { password?: string; username?: string; client?: Layer.Layer }) { const handler = HttpRouter.toWebHandler( HttpRouter.use((router) => Effect.gen(function* () { const fs = yield* AppFileSystem.Service const client = yield* HttpClient.HttpClient yield* router.add("*", "/*", (request) => serveUIEffect(request, { fs, client })) }), ).pipe( Layer.provide(authorizationRouterMiddleware.layer.pipe(Layer.provide(ServerAuth.Config.defaultLayer))), Layer.provide([ AppFileSystem.defaultLayer, input?.client ?? httpClient(new Response("ui")), HttpServer.layerServices, ConfigProvider.layer( ConfigProvider.fromUnknown({ OPENCODE_SERVER_PASSWORD: input?.password, OPENCODE_SERVER_USERNAME: input?.username, }), ), ]), ), { disableLogger: true }, ).handler return { request(input: string | URL | Request, init?: RequestInit) { return handler( input instanceof Request ? input : new Request(new URL(input, "http://localhost"), init), ExperimentalHttpApiServer.context, ) }, } } function httpClient(response: Response, onRequest?: (request: HttpClientRequest.HttpClientRequest) => void) { return Layer.succeed( HttpClient.HttpClient, HttpClient.make((request) => { onRequest?.(request) return Effect.succeed(HttpClientResponse.fromWeb(request, response)) }), ) } describe("HttpApi UI fallback", () => { test("serves the web UI through the experimental backend", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true let proxiedUrl: string | undefined const response = await uiApp({ client: httpClient( new Response("opencode", { headers: { "content-type": "text/html" } }), (request) => { proxiedUrl = request.url }, ), }).request("/") expect(response.status).toBe(200) expect(response.headers.get("content-type")).toContain("text/html") expect(await response.text()).toBe("opencode") expect(proxiedUrl).toBe("https://app.opencode.ai/") }) test("strips upstream transfer encoding headers from proxied assets", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true let proxiedUrl: string | undefined const response = await Effect.runPromise( Effect.gen(function* () { const fs = yield* AppFileSystem.Service const client = yield* HttpClient.HttpClient return yield* serveUIEffect(HttpServerRequest.fromWeb(new Request("http://localhost/assets/app.js")), { fs, client, }) }).pipe( Effect.provide( Layer.mergeAll( AppFileSystem.defaultLayer, Layer.succeed( HttpClient.HttpClient, HttpClient.make((request) => { proxiedUrl = request.url return Effect.succeed( HttpClientResponse.fromWeb( request, new Response("console.log('ok')", { headers: { "content-encoding": "br", "content-length": "999", "content-type": "text/javascript", }, }), ), ) }), ), ), ), Effect.map(HttpServerResponse.toWeb), ), ) expect(response.status).toBe(200) expect(proxiedUrl).toBe("https://app.opencode.ai/assets/app.js") expect(response.headers.get("content-encoding")).toBeNull() expect(response.headers.get("content-length")).not.toBe("999") expect(response.headers.get("content-type")).toContain("text/javascript") expect(await response.text()).toBe("console.log('ok')") }) // Regression for #25698 (Ope): upstream `transfer-encoding: chunked` was // forwarded through the proxy while the proxy itself re-frames the body, // causing browsers to fail with `ERR_INVALID_CHUNKED_ENCODING`. test("strips upstream transfer-encoding header from proxied assets", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true const response = await Effect.runPromise( Effect.gen(function* () { const fs = yield* AppFileSystem.Service const client = yield* HttpClient.HttpClient return yield* serveUIEffect(HttpServerRequest.fromWeb(new Request("http://localhost/")), { fs, client, }) }).pipe( Effect.provide( Layer.mergeAll( AppFileSystem.defaultLayer, Layer.succeed( HttpClient.HttpClient, HttpClient.make((request) => Effect.succeed( HttpClientResponse.fromWeb( request, new Response("opencode", { headers: { "transfer-encoding": "chunked", "content-type": "text/html", }, }), ), ), ), ), ), ), Effect.map(HttpServerResponse.toWeb), ), ) expect(response.status).toBe(200) expect(response.headers.get("transfer-encoding")).toBeNull() expect(await response.text()).toBe("opencode") }) test("serves embedded UI assets when Bun can read them but access reports missing", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true let readPath: string | undefined const response = await Effect.runPromise( Effect.gen(function* () { const fs = yield* AppFileSystem.Service return yield* serveEmbeddedUIEffect( "/assets/app.js", { ...fs, existsSafe: () => Effect.die("embedded UI should not rely on filesystem access checks"), readFile: (path) => { readPath = path return path === "/$bunfs/root/assets/app.js" ? Effect.succeed(new TextEncoder().encode("console.log('embedded')")) : Effect.die(`unexpected embedded UI path: ${path}`) }, }, { "assets/app.js": "/$bunfs/root/assets/app.js" }, ) }).pipe(Effect.provide(AppFileSystem.defaultLayer), Effect.map(HttpServerResponse.toWeb)), ) expect(response.status).toBe(200) expect(readPath).toBe("/$bunfs/root/assets/app.js") expect(response.headers.get("content-type")).toContain("text/javascript") expect(await response.text()).toBe("console.log('embedded')") }) test("allows embedded UI terminal wasm and theme preload CSP", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true const script = 'document.documentElement.dataset.theme = "dark"' const response = await Effect.runPromise( Effect.gen(function* () { const fs = yield* AppFileSystem.Service return yield* serveEmbeddedUIEffect( "/", { ...fs, readFile: (path) => { return path === "/$bunfs/root/index.html" ? Effect.succeed( new TextEncoder().encode( ``, ), ) : Effect.die(`unexpected embedded UI path: ${path}`) }, }, { "index.html": "/$bunfs/root/index.html" }, ) }).pipe(Effect.provide(AppFileSystem.defaultLayer), Effect.map(HttpServerResponse.toWeb)), ) const csp = response.headers.get("content-security-policy") ?? "" expect(csp).toContain("script-src 'self' 'wasm-unsafe-eval'") expect(csp).toContain(`'sha256-${createHash("sha256").update(script).digest("base64")}'`) expect(csp).toContain("connect-src * data:") }) test("keeps matched API routes ahead of the UI fallback", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true const response = await Server.Default().app.request("/session/nope") expect(response.status).toBe(404) }) test("requires server password for the web UI", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true const response = await uiApp({ password: "secret", username: "opencode" }).request("/") expect(response.status).toBe(401) expect(response.headers.get("www-authenticate")).toBe('Basic realm="Secure Area"') }) test("accepts auth token for the web UI", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true const response = await uiApp({ password: "secret", username: "opencode", client: httpClient(new Response("opencode", { headers: { "content-type": "text/html" } })), }).request(`/?auth_token=${btoa("opencode:secret")}`) expect(response.status).toBe(200) expect(await response.text()).toBe("opencode") }) test("accepts basic auth for the web UI", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true const response = await uiApp({ password: "secret", username: "opencode" }).request("/", { headers: { authorization: `Basic ${btoa("opencode:secret")}` }, }) expect(response.status).toBe(200) }) // Regression for #25698 (Ope): the browser fetches the PWA manifest and // its icons via flows that don't carry app-managed credentials (the // `` request is not under page-auth control), so the // server returning 401 breaks PWA install. These specific public assets // should bypass auth. test("serves the PWA manifest without auth even when a server password is set", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true Flag.OPENCODE_DISABLE_EMBEDDED_WEB_UI = true for (const path of ["/site.webmanifest", "/web-app-manifest-192x192.png", "/web-app-manifest-512x512.png"]) { const response = await uiApp({ password: "secret", username: "opencode", client: httpClient(new Response("ok")), }).request(path) expect(response.status).not.toBe(401) } }) test("allows web UI preflight without auth", async () => { Flag.OPENCODE_EXPERIMENTAL_HTTPAPI = true const response = await app({ password: "secret", username: "opencode" }).request("/", { method: "OPTIONS", headers: { origin: "http://localhost:3000", "access-control-request-method": "GET", }, }) expect(response.status).toBe(204) expect(response.headers.get("access-control-allow-origin")).toBe("http://localhost:3000") }) })