From 12c19d627d55120aab62d841e0df98be349f0a9c Mon Sep 17 00:00:00 2001
From: Dax Raad <d@ironbay.co>
Date: Sat, 16 May 2026 01:01:53 -0400
Subject: [PATCH] serve: expose socket listener url

---
 packages/opencode/src/server/server.ts               | 9 +++++++++
 packages/opencode/test/server/httpapi-listen.test.ts | 1 +
 2 files changed, 10 insertions(+)

diff --git a/packages/opencode/src/server/server.ts b/packages/opencode/src/server/server.ts
index e832cf286fb..78649bdda8a 100644
--- a/packages/opencode/src/server/server.ts
+++ b/packages/opencode/src/server/server.ts
@@ -30,6 +30,7 @@ export type TcpListener = {
 export type SocketListener = {
   type: "socket"
   socket: string
+  url: URL
   stop: (close?: boolean) => Promise<void>
 }
 
@@ -101,6 +102,7 @@ export async function listen(opts: ListenOptions): Promise<Listener> {
     return {
       type: "socket" as const,
       socket: listener.socket,
+      url: listener.url,
       stop,
     }
   }
@@ -117,9 +119,12 @@ const listenEffect: (opts: ListenOptions) => Effect.Effect<EffectListener, unkno
   function* (opts: ListenOptions) {
     const state = yield* startWithPortFallback(opts)
     if (opts.type === "socket") {
+      const listenerUrl = makeSocketURL(opts.socket)
+
       return {
         type: "socket" as const,
         socket: opts.socket,
+        url: listenerUrl,
         stop: yield* makeStop(state, Effect.void),
       }
     }
@@ -195,6 +200,10 @@ function makeURL(hostname: string, port?: number) {
   return result
 }
 
+function makeSocketURL(socket: string) {
+  return new URL(`socket:${encodeURIComponent(socket)}`)
+}
+
 function setupMdns(opts: TcpListenOptions, port: number, scope: Scope.Scope) {
   return Effect.gen(function* () {
     const publish =
diff --git a/packages/opencode/test/server/httpapi-listen.test.ts b/packages/opencode/test/server/httpapi-listen.test.ts
index f8b4e8baeea..f413ea216c4 100644
--- a/packages/opencode/test/server/httpapi-listen.test.ts
+++ b/packages/opencode/test/server/httpapi-listen.test.ts
@@ -297,6 +297,7 @@ describe("HttpApi Server.listen", () => {
     try {
       expect(listener.type).toBe("socket")
       expect(listener.socket).toBe(socket)
+      expect(listener.url.href).toBe(`socket:${encodeURIComponent(socket)}`)
 
       const response = await requestSocketRoot(socket)
       expect(response.statusCode).toBe(200)