@opencode/client 0.0.0-dev-20627 → 0.0.0-dev-20628

package/dist/chunks/{shared-events-ve21qz3j.js → pty-handoff-02j88w0z.js}

@@ -1,6 +1,6 @@
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/pty-handoff.ts
 var exports_pty_handoff = {};

package/dist/chunks/{shared-events-1y4a697q.js → pty-handoff-1y4a697q.js}

@@ -1,7 +1,7 @@
 import {
   isRpcError2,
   isRpcInternalError2
-} from "./shared-events-vt9jbch8.js";
+} from "./pty-handoff-vt9jbch8.js";
 
 // src/promise/rpc.ts
 function makeRpc2(raw, events) {

package/dist/chunks/{shared-events-ank0d71z.js → pty-handoff-2ny4vxct.js}

@@ -1,10 +1,27 @@
 import {
   defaultEnsureTiming2
-} from "./shared-events-xgnj2w4v.js";
+} from "./pty-handoff-xgnj2w4v.js";
+import {
+  matchesVersion2
+} from "./pty-handoff-sxt88q69.js";
 
 // src/service-probe.ts
 import { homedir } from "node:os";
 import { join } from "node:path";
+function decide2(service, options) {
+  if (!matchesVersion2(service.version, options))
+    return { _tag: "replace", pty: service.state === "ready" ? "handoff" : "clear" };
+  if (!service.compatible)
+    return fail("Background service uses an incompatible health protocol. Update this client or explicitly restart the service.");
+  if (service.state === "ready")
+    return { _tag: "reuse" };
+  if (service.state === "failed")
+    return fail("Background service failed to start");
+  return { _tag: "wait" };
+}
+function fail(message) {
+  return { _tag: "fail", error: new Error(message) };
+}
 function fallback2() {
   return join(process.env["XDG_STATE_HOME"] ?? join(homedir(), ".local", "state"), "opencode", "service.json");
 }
@@ -72,4 +89,4 @@ function decodeInfo(input) {
   return { version: input.version, pid: input.pid };
 }
 
-export { fallback2, same2, probeResult2, headers2 };
+export { decide2, fallback2, same2, probeResult2, headers2 };

package/dist/chunks/{shared-events-d59rj3hx.js → pty-handoff-ajnk5b9f.js}

@@ -1,23 +1,23 @@
 import {
   ClientApi2
-} from "./shared-events-vmytr4q8.js";
+} from "./pty-handoff-vmytr4q8.js";
 import {
-  ClientError3
-} from "./shared-events-7f0py9js.js";
+  ClientError2
+} from "./pty-handoff-y2etg5bs.js";
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/effect/generated/client.ts
-var exports_client4 = {};
-__export(exports_client4, {
-  make: () => make6
+var exports_client2 = {};
+__export(exports_client2, {
+  make: () => make3
 });
 import { Effect, Stream, Schema } from "effect";
 import { Sse } from "effect/unstable/encoding";
 import { HttpClientError } from "effect/unstable/http";
 import { HttpApiClient } from "effect/unstable/httpapi";
-var mapClientError = (error) => HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error) ? new ClientError3({ cause: error }) : error;
+var mapClientError = (error) => HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error) ? new ClientError2({ cause: error }) : error;
 var preserveEffect = () => (effect) => effect;
 var preserveStream = () => (stream) => stream;
 var EndpointServerInfo = (raw) => () => preserveEffect()(raw["server.info"]({}).pipe(Effect.mapError(mapClientError)));
@@ -613,6 +613,6 @@ var adaptClient = (raw) => ({
   websearch: adaptGroupWebsearch(raw["server.websearch"]),
   config: adaptGroupConfig(raw["server.config"])
 });
-var make6 = (options) => HttpApiClient.make(ClientApi2, options).pipe(Effect.map(adaptClient));
+var make3 = (options) => HttpApiClient.make(ClientApi2, options).pipe(Effect.map(adaptClient));
 
-export { make6, exports_client4 };
+export { make3, exports_client2 };

package/dist/chunks/{shared-events-ngdbvg6m.js → pty-handoff-cn5fa9bt.js}

@@ -1,25 +1,25 @@
 import {
   make7
-} from "./shared-events-frbwqjmf.js";
+} from "./pty-handoff-frbwqjmf.js";
 import {
-  ClientError3
-} from "./shared-events-7f0py9js.js";
+  ClientError2
+} from "./pty-handoff-y2etg5bs.js";
 import {
-  make6
-} from "./shared-events-d59rj3hx.js";
+  make3
+} from "./pty-handoff-ajnk5b9f.js";
 import {
-  make5,
+  make4,
   aborted2
-} from "./shared-events-mnyft54j.js";
+} from "./pty-handoff-z6qdwcsf.js";
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/effect/client.ts
-var exports_client3 = {};
-__export(exports_client3, {
-  OpenCode: () => exports_client3,
-  make: () => make4
+var exports_client = {};
+__export(exports_client, {
+  OpenCode: () => exports_client,
+  make: () => make2
 });
 import { Cause, Context, Effect, Stream } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
@@ -28,9 +28,9 @@ var CurrentHeaders = Context.Reference("@opencode/client/effect/rpc/headers", {
     return;
   }
 });
-var make4 = Effect.fn("OpenCode.make")(function* (options) {
+var make2 = Effect.fn("OpenCode.make")(function* (options) {
   const httpClient = yield* HttpClient.HttpClient;
-  const raw = yield* make6(options).pipe(Effect.provideService(HttpClient.HttpClient, HttpClient.mapRequestEffect(httpClient, (request) => Effect.map(CurrentHeaders, (headers) => headers ? HttpClientRequest.setHeaders(request, new Headers(headers)) : request))));
+  const raw = yield* make3(options).pipe(Effect.provideService(HttpClient.HttpClient, HttpClient.mapRequestEffect(httpClient, (request) => Effect.map(CurrentHeaders, (headers) => headers ? HttpClientRequest.setHeaders(request, new Headers(headers)) : request))));
   const context = yield* Effect.context();
   const native = raw.event.subscribe();
 
@@ -41,12 +41,12 @@ var make4 = Effect.fn("OpenCode.make")(function* (options) {
     }
   }
   const shared = make7((signal) => Stream.toAsyncIterableWith(native.pipe(Stream.interruptWhen(aborted2(signal)), Stream.catchCause((cause) => Stream.fail(new EventFailure(cause)))), context));
-  const subscribe = () => Stream.fromAsyncIterable(shared.subscribe(), (error) => error).pipe(Stream.catch((error) => Stream.failCause(error instanceof EventFailure ? error.cause : Cause.fail(new ClientError3({ cause: error })))));
+  const subscribe = () => Stream.fromAsyncIterable(shared.subscribe(), (error) => error).pipe(Stream.catch((error) => Stream.failCause(error instanceof EventFailure ? error.cause : Cause.fail(new ClientError2({ cause: error })))));
   return {
     ...raw,
     event: { ...raw.event, subscribe },
-    rpc: Object.assign(make5((input, options) => raw.rpc.call(input).pipe(Effect.provideService(CurrentHeaders, options?.headers)), subscribe), raw.rpc)
+    rpc: Object.assign(make4((input, options) => raw.rpc.call(input).pipe(Effect.provideService(CurrentHeaders, options?.headers)), subscribe), raw.rpc)
   };
 });
 
-export { make4, exports_client3 };
+export { make2, exports_client };

package/dist/chunks/{shared-events-frbwqjmf.js → pty-handoff-frbwqjmf.js}

@@ -1,6 +1,6 @@
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/shared-events.ts
 var exports_shared_events = {};

package/dist/chunks/pty-handoff-gah0fg5v.js

@@ -0,0 +1,30 @@
+import {
+  make7
+} from "./pty-handoff-frbwqjmf.js";
+import {
+  make6
+} from "./pty-handoff-nyqggzs9.js";
+import {
+  makeRpc2
+} from "./pty-handoff-1y4a697q.js";
+import {
+  __export
+} from "./pty-handoff-9rqn6x4v.js";
+
+// src/promise/client.ts
+var exports_client3 = {};
+__export(exports_client3, {
+  OpenCode: () => exports_client3,
+  make: () => make5
+});
+function make5(options) {
+  const raw = make6(options);
+  const events = make7((signal, onActivity) => raw.event.subscribe({ signal, onActivity }));
+  return {
+    ...raw,
+    rpc: Object.assign(makeRpc2(raw, events), raw.rpc),
+    event: events
+  };
+}
+
+export { make5, exports_client3 };

package/dist/chunks/{shared-events-js54wxgp.js → pty-handoff-nwcpakzx.js}

@@ -1,5 +1,5 @@
 // src/promise/generated/client-error.ts
-class ClientError2 extends Error {
+class ClientError3 extends Error {
   reason;
   name = "ClientError";
   constructor(reason, options) {
@@ -9,4 +9,4 @@ class ClientError2 extends Error {
   }
 }
 
-export { ClientError2 };
+export { ClientError3 };

package/dist/chunks/{shared-events-qzsnm4q8.js → pty-handoff-nyqggzs9.js}

@@ -1,17 +1,17 @@
 import {
-  ClientError2
-} from "./shared-events-js54wxgp.js";
+  ClientError3
+} from "./pty-handoff-nwcpakzx.js";
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/promise/generated/client.ts
-var exports_client2 = {};
-__export(exports_client2, {
-  make: () => make3
+var exports_client4 = {};
+__export(exports_client4, {
+  make: () => make6
 });
 var maxSseEventBytes = 16 * 1024 * 1024;
-function make3(options) {
+function make6(options) {
   const fetch = options.fetch ?? globalThis.fetch;
   const prepare = (descriptor, requestOptions) => {
     const baseUrl = new URL(options.baseUrl);
@@ -44,7 +44,7 @@ function make3(options) {
       const prepared = prepare(descriptor, requestOptions);
       return await fetch(prepared.url, prepared.init);
     } catch (cause) {
-      throw new ClientError2("Transport", { cause });
+      throw new ClientError3("Transport", { cause });
     }
   };
   const responseError = async (response, descriptor) => {
@@ -53,7 +53,7 @@ function make3(options) {
     try {
       await response.body?.cancel();
     } catch {}
-    throw new ClientError2("UnexpectedStatus", { cause: { status: response.status }, detail: String(response.status) });
+    throw new ClientError3("UnexpectedStatus", { cause: { status: response.status }, detail: String(response.status) });
   };
   const request = async (descriptor, requestOptions) => {
     const response = await execute(descriptor, requestOptions);
@@ -78,10 +78,10 @@ function make3(options) {
         try {
           await response.body?.cancel();
         } catch {}
-        throw new ClientError2("UnsupportedContentType", { detail: response.headers.get("content-type") });
+        throw new ClientError3("UnsupportedContentType", { detail: response.headers.get("content-type") });
       }
       if (response.body === null)
-        throw new ClientError2("MalformedResponse");
+        throw new ClientError3("MalformedResponse");
       const reader = response.body.getReader();
       const decoder = new TextDecoder;
       let buffer = "";
@@ -91,13 +91,13 @@ function make3(options) {
           try {
             next = await reader.read();
           } catch (cause) {
-            throw new ClientError2("Transport", { cause });
+            throw new ClientError3("Transport", { cause });
           }
           if (!next.done)
             requestOptions?.onActivity?.();
           buffer += decoder.decode(next.value, { stream: !next.done });
           if (buffer.length > maxSseEventBytes)
-            throw new ClientError2("SseEventTooLarge");
+            throw new ClientError3("SseEventTooLarge");
           const trailingCarriageReturn = !next.done && buffer.endsWith("\r");
           if (trailingCarriageReturn)
             buffer = buffer.slice(0, -1);
@@ -124,7 +124,7 @@ function make3(options) {
               try {
                 yield JSON.parse(data);
               } catch (cause) {
-                throw new ClientError2("MalformedResponse", { cause });
+                throw new ClientError3("MalformedResponse", { cause });
               }
             }
             boundary = buffer.indexOf(`
@@ -1421,20 +1421,20 @@ async function json(response) {
     try {
       await response.body?.cancel();
     } catch {}
-    throw new ClientError2("UnsupportedContentType", { detail: response.headers.get("content-type") });
+    throw new ClientError3("UnsupportedContentType", { detail: response.headers.get("content-type") });
   }
   let text;
   try {
     text = await response.text();
   } catch (cause) {
-    throw new ClientError2("Transport", { cause });
+    throw new ClientError3("Transport", { cause });
   }
   if (text === "")
-    throw new ClientError2("MalformedResponse");
+    throw new ClientError3("MalformedResponse");
   try {
     return JSON.parse(text);
   } catch (cause) {
-    throw new ClientError2("MalformedResponse", { cause });
+    throw new ClientError3("MalformedResponse", { cause });
   }
 }
 function declared(body) {
@@ -1447,4 +1447,4 @@ function isContentType(response, expected) {
   return response.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() === expected;
 }
 
-export { make3, exports_client2 };
+export { make6, exports_client4 };

package/dist/chunks/{shared-events-src6by76.js → pty-handoff-src6by76.js}

@@ -2,7 +2,7 @@ import {
   isFormNotFoundError2,
   isFormAlreadySettledError2,
   isPermissionNotFoundError2
-} from "./shared-events-vt9jbch8.js";
+} from "./pty-handoff-vt9jbch8.js";
 
 // src/solid/data.ts
 import { Worktree } from "@opencode/schema/worktree";

package/dist/chunks/{shared-events-t1xa31vm.js → pty-handoff-t1xa31vm.js}

@@ -1,6 +1,6 @@
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/rpc-runtime.ts
 var exports_rpc_runtime = {};

package/dist/chunks/{shared-events-7f0py9js.js → pty-handoff-y2etg5bs.js}

@@ -1,9 +1,9 @@
 // src/effect/generated/client-error.ts
 import { Schema } from "effect";
 
-class ClientError3 extends Schema.TaggedError()("ClientError", {
+class ClientError2 extends Schema.TaggedError()("ClientError", {
   cause: Schema.Defect()
 }) {
 }
 
-export { ClientError3 };
+export { ClientError2 };

package/dist/chunks/{shared-events-mnyft54j.js → pty-handoff-z6qdwcsf.js}

@@ -3,20 +3,20 @@ import {
   readError2,
   event2,
   eventType2
-} from "./shared-events-t1xa31vm.js";
+} from "./pty-handoff-t1xa31vm.js";
 import {
   __export
-} from "./shared-events-9rqn6x4v.js";
+} from "./pty-handoff-9rqn6x4v.js";
 
 // src/effect/rpc.ts
 var exports_rpc = {};
 __export(exports_rpc, {
   RpcClientRuntime: () => exports_rpc,
   aborted: () => aborted2,
-  make: () => make5
+  make: () => make4
 });
 import { Effect, Stream } from "effect";
-function make5(call, subscribe) {
+function make4(call, subscribe) {
   return (definition) => {
     const methods = Object.fromEntries(Object.entries(definition.methods).map(([name, method]) => [
       name,
@@ -59,4 +59,4 @@ function aborted2(signal) {
   });
 }
 
-export { make5, aborted2, exports_rpc };
+export { make4, aborted2, exports_rpc };

package/dist/contract.js

@@ -3,7 +3,7 @@ import {
   effectOmitEndpoints2,
   groupNames2,
   promiseOmitEndpoints2
-} from "./chunks/shared-events-vmytr4q8.js";
+} from "./chunks/pty-handoff-vmytr4q8.js";
 export {
   ClientApi2 as ClientApi,
   effectOmitEndpoints2 as effectOmitEndpoints,

package/dist/effect/client.js

@@ -1,15 +1,15 @@
 import {
-  make4,
-  exports_client3
-} from "../chunks/shared-events-ngdbvg6m.js";
-import"../chunks/shared-events-mnyft54j.js";
-import"../chunks/shared-events-t1xa31vm.js";
-import"../chunks/shared-events-6mptkzbc.js";
-import"../chunks/shared-events-d59rj3hx.js";
-import"../chunks/shared-events-7f0py9js.js";
-import"../chunks/shared-events-frbwqjmf.js";
-import"../chunks/shared-events-vmytr4q8.js";
+  make2,
+  exports_client
+} from "../chunks/pty-handoff-cn5fa9bt.js";
+import"../chunks/pty-handoff-6mptkzbc.js";
+import"../chunks/pty-handoff-ajnk5b9f.js";
+import"../chunks/pty-handoff-y2etg5bs.js";
+import"../chunks/pty-handoff-z6qdwcsf.js";
+import"../chunks/pty-handoff-vmytr4q8.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
+import"../chunks/pty-handoff-t1xa31vm.js";
 export {
-  exports_client3 as OpenCode,
-  make4 as make
+  exports_client as OpenCode,
+  make2 as make
 };

package/dist/effect/generated/client-error.js

@@ -1,6 +1,6 @@
 import {
-  ClientError3
-} from "../../chunks/shared-events-7f0py9js.js";
+  ClientError2
+} from "../../chunks/pty-handoff-y2etg5bs.js";
 export {
-  ClientError3 as ClientError
+  ClientError2 as ClientError
 };

package/dist/effect/generated/client.js

@@ -1,8 +1,8 @@
 import {
-  make6
-} from "../../chunks/shared-events-d59rj3hx.js";
-import"../../chunks/shared-events-7f0py9js.js";
-import"../../chunks/shared-events-vmytr4q8.js";
+  make3
+} from "../../chunks/pty-handoff-ajnk5b9f.js";
+import"../../chunks/pty-handoff-y2etg5bs.js";
+import"../../chunks/pty-handoff-vmytr4q8.js";
 export {
-  make6 as make
+  make3 as make
 };

package/dist/effect/generated/index.js

@@ -1,12 +1,12 @@
-import"../../chunks/shared-events-6mptkzbc.js";
+import"../../chunks/pty-handoff-6mptkzbc.js";
 import {
-  exports_client4
-} from "../../chunks/shared-events-d59rj3hx.js";
+  exports_client2
+} from "../../chunks/pty-handoff-ajnk5b9f.js";
 import {
-  ClientError3
-} from "../../chunks/shared-events-7f0py9js.js";
-import"../../chunks/shared-events-vmytr4q8.js";
+  ClientError2
+} from "../../chunks/pty-handoff-y2etg5bs.js";
+import"../../chunks/pty-handoff-vmytr4q8.js";
 export {
-  ClientError3 as ClientError,
-  exports_client4 as OpenCode
+  ClientError2 as ClientError,
+  exports_client2 as OpenCode
 };

package/dist/effect/index.js

@@ -1,15 +1,15 @@
 import {
-  ClientError3
-} from "../chunks/shared-events-7f0py9js.js";
-import"../chunks/shared-events-vmytr4q8.js";
-import"../chunks/shared-events-d59rj3hx.js";
-import"../chunks/shared-events-6mptkzbc.js";
-import"../chunks/shared-events-frbwqjmf.js";
-import"../chunks/shared-events-t1xa31vm.js";
-import"../chunks/shared-events-mnyft54j.js";
+  ClientError2
+} from "../chunks/pty-handoff-y2etg5bs.js";
+import"../chunks/pty-handoff-vmytr4q8.js";
+import"../chunks/pty-handoff-ajnk5b9f.js";
+import"../chunks/pty-handoff-6mptkzbc.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
+import"../chunks/pty-handoff-t1xa31vm.js";
+import"../chunks/pty-handoff-z6qdwcsf.js";
 import {
-  exports_client3
-} from "../chunks/shared-events-ngdbvg6m.js";
+  exports_client
+} from "../chunks/pty-handoff-cn5fa9bt.js";
 
 // src/effect/index.ts
 import { Agent } from "@opencode/schema/agent";
@@ -43,7 +43,7 @@ import { PromptInput } from "@opencode/schema/prompt-input";
 export {
   AbsolutePath,
   Agent,
-  ClientError3 as ClientError,
+  ClientError2 as ClientError,
   Command,
   Config,
   Credential,
@@ -54,7 +54,7 @@ export {
   Integration,
   Location,
   Model,
-  exports_client3 as OpenCode,
+  exports_client as OpenCode,
   Permission,
   PermissionSaved,
   Project,

package/dist/effect/rpc.js

@@ -1,11 +1,11 @@
 import {
-  make5,
+  make4,
   aborted2,
   exports_rpc
-} from "../chunks/shared-events-mnyft54j.js";
-import"../chunks/shared-events-t1xa31vm.js";
+} from "../chunks/pty-handoff-z6qdwcsf.js";
+import"../chunks/pty-handoff-t1xa31vm.js";
 export {
   exports_rpc as RpcClientRuntime,
   aborted2 as aborted,
-  make5 as make
+  make4 as make
 };

package/dist/effect/service.d.ts

@@ -29,7 +29,14 @@ export declare const incumbent: (options: DiscoverOptions & {
     state: "failed" | "ready" | "waiting";
 } | undefined, never, FileSystem.FileSystem>;
 /** Ensure a healthy, compatible local service is running. */
-export declare const ensure: (options?: EnsureOptions | undefined) => Effect.Effect<import("./service.js").Endpoint, Error, FileSystem.FileSystem>;
+export declare const ensure: (options?: EnsureOptions | undefined) => Effect.Effect<{
+    url: string;
+    auth: {
+        type: "basic";
+        username: string;
+        password: string;
+    } | undefined;
+}, Error, FileSystem.FileSystem>;
 /** Stop the registered local service. */
 export declare const stop: (options?: StopOptions | undefined) => Effect.Effect<void, Error, FileSystem.FileSystem>;
 /** Schema for the local service registration file. */
@@ -63,7 +70,14 @@ export declare const Service: {
         };
         state: "failed" | "ready" | "waiting";
     } | undefined, never, FileSystem.FileSystem>;
-    ensure: (options?: EnsureOptions | undefined) => Effect.Effect<import("./service.js").Endpoint, Error, FileSystem.FileSystem>;
+    ensure: (options?: EnsureOptions | undefined) => Effect.Effect<{
+        url: string;
+        auth: {
+            type: "basic";
+            username: string;
+            password: string;
+        } | undefined;
+    }, Error, FileSystem.FileSystem>;
     stop: (options?: StopOptions | undefined) => Effect.Effect<void, Error, FileSystem.FileSystem>;
     headers: typeof headers;
     Info: Schema.Struct<{

package/dist/effect/service.js

@@ -1,27 +1,28 @@
 import {
   spawnServiceContender2,
   contenderPool2
-} from "../chunks/shared-events-ve4aws36.js";
+} from "../chunks/pty-handoff-ve4aws36.js";
 import {
   defaultEnsureTiming2,
   ensureTiming2
-} from "../chunks/shared-events-xgnj2w4v.js";
+} from "../chunks/pty-handoff-xgnj2w4v.js";
 import {
   matchesVersion2
-} from "../chunks/shared-events-sxt88q69.js";
+} from "../chunks/pty-handoff-sxt88q69.js";
 import {
   prepare2,
   environment2,
   complete2,
   clear2
-} from "../chunks/shared-events-ve21qz3j.js";
+} from "../chunks/pty-handoff-02j88w0z.js";
 import {
+  decide2,
   fallback2,
   same2,
   probeResult2,
   headers2
-} from "../chunks/shared-events-ank0d71z.js";
-import"../chunks/shared-events-qav6mfdz.js";
+} from "../chunks/pty-handoff-2ny4vxct.js";
+import"../chunks/pty-handoff-qav6mfdz.js";
 
 // src/effect/service.ts
 import { Effect, FileSystem, Option, Schedule, Schema } from "effect";
@@ -91,26 +92,20 @@ var ensure = Effect.fn("service.ensure")(function* (options = {}) {
       timeouts = undefined;
     if (service2 !== undefined) {
       pool.serviceAnswered();
-      const versionMatches = matchesVersion2(service2.version, options);
-      const compatible = service2.compatible && versionMatches;
-      if (!service2.compatible && versionMatches)
-        return yield* Effect.fail(new Error("Background service uses an incompatible health protocol. Update this client or explicitly restart the service."));
-      if (compatible && service2.state === "ready") {
+      const decision = decide2(service2, options);
+      if (decision._tag === "fail")
+        return yield* Effect.fail(decision.error);
+      if (decision._tag === "reuse") {
         yield* Effect.tryPromise(() => complete2(options.file ?? fallback2(), service2.info));
         return Option.some(service2);
       }
-      if (compatible && service2.state === "failed")
-        return yield* Effect.fail(new Error("Background service failed to start"));
-      if (compatible)
-        return Option.none();
-      yield* announce("version-mismatch", service2.version);
-      if (service2.state !== "ready")
-        yield* Effect.logWarning("Background service is not ready; replacement cannot preserve persistent terminals");
-      yield* stop({
-        file: options.file,
-        pty: service2.state === "ready" ? "handoff" : "clear"
-      }).pipe(Effect.ignore);
-      pool.evict(service2.info.pid);
+      if (decision._tag === "replace") {
+        yield* announce("version-mismatch", service2.version);
+        if (service2.state !== "ready")
+          yield* Effect.logWarning("Background service is not ready; replacement cannot preserve persistent terminals");
+        yield* stop({ file: options.file, pty: decision.pty }).pipe(Effect.ignore);
+        pool.evict(service2.info.pid);
+      }
       return Option.none();
     }
     const failed = pool.reap();

package/dist/promise/client.js

@@ -1,14 +1,14 @@
 import {
-  make2,
-  exports_client
-} from "../chunks/shared-events-mdvk8mfx.js";
-import"../chunks/shared-events-1y4a697q.js";
-import"../chunks/shared-events-vyas3vgt.js";
-import"../chunks/shared-events-vt9jbch8.js";
-import"../chunks/shared-events-qzsnm4q8.js";
-import"../chunks/shared-events-js54wxgp.js";
-import"../chunks/shared-events-frbwqjmf.js";
+  make5,
+  exports_client3
+} from "../chunks/pty-handoff-gah0fg5v.js";
+import"../chunks/pty-handoff-vyas3vgt.js";
+import"../chunks/pty-handoff-nyqggzs9.js";
+import"../chunks/pty-handoff-nwcpakzx.js";
+import"../chunks/pty-handoff-1y4a697q.js";
+import"../chunks/pty-handoff-vt9jbch8.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
 export {
-  exports_client as OpenCode,
-  make2 as make
+  exports_client3 as OpenCode,
+  make5 as make
 };

package/dist/promise/generated/client-error.js

@@ -1,6 +1,6 @@
 import {
-  ClientError2
-} from "../../chunks/shared-events-js54wxgp.js";
+  ClientError3
+} from "../../chunks/pty-handoff-nwcpakzx.js";
 export {
-  ClientError2 as ClientError
+  ClientError3 as ClientError
 };

package/dist/promise/generated/client.js

@@ -1,7 +1,7 @@
 import {
-  make3
-} from "../../chunks/shared-events-qzsnm4q8.js";
-import"../../chunks/shared-events-js54wxgp.js";
+  make6
+} from "../../chunks/pty-handoff-nyqggzs9.js";
+import"../../chunks/pty-handoff-nwcpakzx.js";
 export {
-  make3 as make
+  make6 as make
 };

package/dist/promise/generated/index.js

@@ -1,4 +1,10 @@
-import"../../chunks/shared-events-vyas3vgt.js";
+import"../../chunks/pty-handoff-vyas3vgt.js";
+import {
+  exports_client4
+} from "../../chunks/pty-handoff-nyqggzs9.js";
+import {
+  ClientError3
+} from "../../chunks/pty-handoff-nwcpakzx.js";
 import {
   isInvalidRequestError2,
   isUnauthorizedError2,
@@ -33,16 +39,10 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../../chunks/shared-events-vt9jbch8.js";
-import {
-  exports_client2
-} from "../../chunks/shared-events-qzsnm4q8.js";
-import {
-  ClientError2
-} from "../../chunks/shared-events-js54wxgp.js";
+} from "../../chunks/pty-handoff-vt9jbch8.js";
 export {
-  ClientError2 as ClientError,
-  exports_client2 as OpenCode,
+  ClientError3 as ClientError,
+  exports_client4 as OpenCode,
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,
   isCommandNotFoundError2 as isCommandNotFoundError,

package/dist/promise/generated/types.js

@@ -32,7 +32,7 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../../chunks/shared-events-vt9jbch8.js";
+} from "../../chunks/pty-handoff-vt9jbch8.js";
 export {
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,

package/dist/promise/index.js

@@ -1,9 +1,13 @@
-import"../chunks/shared-events-m2eywc8w.js";
+import"../chunks/pty-handoff-m2eywc8w.js";
 import {
-  exports_client
-} from "../chunks/shared-events-mdvk8mfx.js";
-import"../chunks/shared-events-1y4a697q.js";
-import"../chunks/shared-events-vyas3vgt.js";
+  exports_client3
+} from "../chunks/pty-handoff-gah0fg5v.js";
+import"../chunks/pty-handoff-vyas3vgt.js";
+import"../chunks/pty-handoff-nyqggzs9.js";
+import {
+  ClientError3
+} from "../chunks/pty-handoff-nwcpakzx.js";
+import"../chunks/pty-handoff-1y4a697q.js";
 import {
   isInvalidRequestError2,
   isUnauthorizedError2,
@@ -38,15 +42,11 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../chunks/shared-events-vt9jbch8.js";
-import"../chunks/shared-events-qzsnm4q8.js";
-import {
-  ClientError2
-} from "../chunks/shared-events-js54wxgp.js";
-import"../chunks/shared-events-frbwqjmf.js";
+} from "../chunks/pty-handoff-vt9jbch8.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
 export {
-  ClientError2 as ClientError,
-  exports_client as OpenCode,
+  ClientError3 as ClientError,
+  exports_client3 as OpenCode,
   isAgentNotFoundError2 as isAgentNotFoundError,
   isCommandExecutionError2 as isCommandExecutionError,
   isCommandNotFoundError2 as isCommandNotFoundError,

package/dist/promise/rpc.js

@@ -1,7 +1,7 @@
 import {
   makeRpc2
-} from "../chunks/shared-events-1y4a697q.js";
-import"../chunks/shared-events-vt9jbch8.js";
+} from "../chunks/pty-handoff-1y4a697q.js";
+import"../chunks/pty-handoff-vt9jbch8.js";
 export {
   makeRpc2 as makeRpc
 };

package/dist/promise/service.js

@@ -1,27 +1,28 @@
 import {
   spawnServiceContender2,
   contenderPool2
-} from "../chunks/shared-events-ve4aws36.js";
+} from "../chunks/pty-handoff-ve4aws36.js";
 import {
   defaultEnsureTiming2,
   ensureTiming2
-} from "../chunks/shared-events-xgnj2w4v.js";
+} from "../chunks/pty-handoff-xgnj2w4v.js";
 import {
   matchesVersion2
-} from "../chunks/shared-events-sxt88q69.js";
+} from "../chunks/pty-handoff-sxt88q69.js";
 import {
   prepare2,
   environment2,
   complete2,
   clear2
-} from "../chunks/shared-events-ve21qz3j.js";
+} from "../chunks/pty-handoff-02j88w0z.js";
 import {
+  decide2,
   fallback2,
   same2,
   probeResult2,
   headers2
-} from "../chunks/shared-events-ank0d71z.js";
-import"../chunks/shared-events-qav6mfdz.js";
+} from "../chunks/pty-handoff-2ny4vxct.js";
+import"../chunks/pty-handoff-qav6mfdz.js";
 
 // src/promise/service.ts
 import { readFile, rm } from "node:fs/promises";
@@ -81,24 +82,18 @@ async function ensure(options = {}) {
       if (registration.service !== undefined) {
         pool.serviceAnswered();
         const service2 = registration.service;
-        const versionMatches = matchesVersion2(service2.version, options);
-        const compatible = service2.compatible && versionMatches;
-        if (!service2.compatible && versionMatches)
-          throw new Error("Background service uses an incompatible health protocol. Update this client or explicitly restart the service.");
-        if (compatible && service2.state === "ready") {
+        const decision = decide2(service2, options);
+        if (decision._tag === "fail")
+          throw decision.error;
+        if (decision._tag === "reuse") {
           await complete2(options.file ?? fallback2(), service2.info);
           return service2.endpoint;
         }
-        if (compatible && service2.state === "failed")
-          throw new Error("Background service failed to start");
-        if (!compatible) {
+        if (decision._tag === "replace") {
           announce("version-mismatch", service2.version);
           if (service2.state !== "ready")
             console.warn("Background service is not ready; replacement cannot preserve persistent terminals");
-          await stop({
-            file: options.file,
-            pty: service2.state === "ready" ? "handoff" : "clear"
-          }).catch(() => {
+          await stop({ file: options.file, pty: decision.pty }).catch(() => {
             return;
           });
           pool.evict(service2.info.pid);

package/dist/pty-handoff.js

@@ -4,7 +4,7 @@ import {
   complete2,
   clear2,
   exports_pty_handoff
-} from "./chunks/shared-events-ve21qz3j.js";
+} from "./chunks/pty-handoff-02j88w0z.js";
 export {
   exports_pty_handoff as PtyHandoff,
   clear2 as clear,

package/dist/rpc-runtime.js

@@ -4,7 +4,7 @@ import {
   event2,
   eventType2,
   exports_rpc_runtime
-} from "./chunks/shared-events-t1xa31vm.js";
+} from "./chunks/pty-handoff-t1xa31vm.js";
 export {
   exports_rpc_runtime as RpcRuntime,
   event2 as event,

package/dist/service-contender.js

@@ -2,7 +2,7 @@ import {
   spawnServiceContender2,
   contenderPool2,
   contenderFinished2
-} from "./chunks/shared-events-ve4aws36.js";
+} from "./chunks/pty-handoff-ve4aws36.js";
 export {
   contenderFinished2 as contenderFinished,
   contenderPool2 as contenderPool,

package/dist/service-probe.d.ts

@@ -1,4 +1,4 @@
-import type { Endpoint, Info } from "./service.js";
+import type { DiscoverOptions, Endpoint, Info } from "./service.js";
 export type LocalService = {
     readonly info: Info;
     readonly endpoint: Endpoint;
@@ -6,6 +6,23 @@ export type LocalService = {
     readonly state: "ready" | "waiting" | "failed";
     readonly compatible: boolean;
 };
+/**
+ * What `ensure()` does with a registered service that answered: return it, keep polling while
+ * it starts, replace it because its version does not meet the requirement, or fail.
+ */
+export declare function decide(service: LocalService, options: DiscoverOptions): {
+    _tag: "fail";
+    error: Error;
+} | {
+    readonly _tag: "replace";
+    readonly pty: "clear" | "handoff";
+} | {
+    readonly _tag: "reuse";
+    readonly pty?: undefined;
+} | {
+    readonly _tag: "wait";
+    readonly pty?: undefined;
+};
 /** The default registration file. */
 export declare function fallback(): string;
 /** Whether two registrations describe the same service instance. */

package/dist/service-probe.js

@@ -1,11 +1,14 @@
 import {
+  decide2,
   fallback2,
   same2,
   probeResult2,
   headers2
-} from "./chunks/shared-events-ank0d71z.js";
-import"./chunks/shared-events-xgnj2w4v.js";
+} from "./chunks/pty-handoff-2ny4vxct.js";
+import"./chunks/pty-handoff-sxt88q69.js";
+import"./chunks/pty-handoff-xgnj2w4v.js";
 export {
+  decide2 as decide,
   fallback2 as fallback,
   headers2 as headers,
   probeResult2 as probeResult,

package/dist/service-timing.js

@@ -2,7 +2,7 @@ import {
   defaultEnsureTiming2,
   ensureTiming2,
   withEnsureTiming2
-} from "./chunks/shared-events-xgnj2w4v.js";
+} from "./chunks/pty-handoff-xgnj2w4v.js";
 export {
   defaultEnsureTiming2 as defaultEnsureTiming,
   ensureTiming2 as ensureTiming,

package/dist/service-version.js

@@ -1,6 +1,6 @@
 import {
   matchesVersion2
-} from "./chunks/shared-events-sxt88q69.js";
+} from "./chunks/pty-handoff-sxt88q69.js";
 export {
   matchesVersion2 as matchesVersion
 };

package/dist/service.js

@@ -1 +1 @@
-import"./chunks/shared-events-qav6mfdz.js";
+import"./chunks/pty-handoff-qav6mfdz.js";

package/dist/shared-events.js

@@ -1,7 +1,7 @@
 import {
   make7,
   exports_shared_events
-} from "./chunks/shared-events-frbwqjmf.js";
+} from "./chunks/pty-handoff-frbwqjmf.js";
 export {
   exports_shared_events as SharedEvents,
   make7 as make

package/dist/solid/connection.js

@@ -2,7 +2,7 @@ import {
   defaultIdleTimeout2,
   foregroundIdleThreshold2,
   createClientConnection2
-} from "../chunks/shared-events-ydhz1zrh.js";
+} from "../chunks/pty-handoff-ydhz1zrh.js";
 export {
   createClientConnection2 as createClientConnection,
   defaultIdleTimeout2 as defaultIdleTimeout,

package/dist/solid/data.js

@@ -2,15 +2,15 @@ import {
   settleMs2,
   locationKey2,
   createData2
-} from "../chunks/shared-events-src6by76.js";
-import"../chunks/shared-events-m2eywc8w.js";
-import"../chunks/shared-events-mdvk8mfx.js";
-import"../chunks/shared-events-1y4a697q.js";
-import"../chunks/shared-events-vyas3vgt.js";
-import"../chunks/shared-events-vt9jbch8.js";
-import"../chunks/shared-events-qzsnm4q8.js";
-import"../chunks/shared-events-js54wxgp.js";
-import"../chunks/shared-events-frbwqjmf.js";
+} from "../chunks/pty-handoff-src6by76.js";
+import"../chunks/pty-handoff-m2eywc8w.js";
+import"../chunks/pty-handoff-gah0fg5v.js";
+import"../chunks/pty-handoff-vyas3vgt.js";
+import"../chunks/pty-handoff-nyqggzs9.js";
+import"../chunks/pty-handoff-nwcpakzx.js";
+import"../chunks/pty-handoff-1y4a697q.js";
+import"../chunks/pty-handoff-vt9jbch8.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
 export {
   createData2 as createData,
   locationKey2 as locationKey,

package/dist/solid/index.js

@@ -1,25 +1,25 @@
-import"../chunks/shared-events-js54wxgp.js";
-import"../chunks/shared-events-qzsnm4q8.js";
-import"../chunks/shared-events-vt9jbch8.js";
-import"../chunks/shared-events-vyas3vgt.js";
-import"../chunks/shared-events-frbwqjmf.js";
-import"../chunks/shared-events-1y4a697q.js";
-import"../chunks/shared-events-mdvk8mfx.js";
-import"../chunks/shared-events-m2eywc8w.js";
+import"../chunks/pty-handoff-nwcpakzx.js";
+import"../chunks/pty-handoff-nyqggzs9.js";
+import"../chunks/pty-handoff-vt9jbch8.js";
+import"../chunks/pty-handoff-vyas3vgt.js";
+import"../chunks/pty-handoff-frbwqjmf.js";
+import"../chunks/pty-handoff-1y4a697q.js";
+import"../chunks/pty-handoff-gah0fg5v.js";
+import"../chunks/pty-handoff-m2eywc8w.js";
 import {
   settleMs2,
   locationKey2,
   createData2
-} from "../chunks/shared-events-src6by76.js";
+} from "../chunks/pty-handoff-src6by76.js";
 import {
   defaultIdleTimeout2,
   foregroundIdleThreshold2,
   createClientConnection2
-} from "../chunks/shared-events-ydhz1zrh.js";
+} from "../chunks/pty-handoff-ydhz1zrh.js";
 import {
   createPtyClient2,
   createPersistentPtyClient2
-} from "../chunks/shared-events-gne7h7mq.js";
+} from "../chunks/pty-handoff-gne7h7mq.js";
 export {
   createClientConnection2 as createClientConnection,
   createData2 as createData,

package/dist/solid/pty.js

@@ -1,7 +1,7 @@
 import {
   createPtyClient2,
   createPersistentPtyClient2
-} from "../chunks/shared-events-gne7h7mq.js";
+} from "../chunks/pty-handoff-gne7h7mq.js";
 export {
   createPersistentPtyClient2 as createPersistentPtyClient,
   createPtyClient2 as createPtyClient

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode/client",
-  "version": "0.0.0-dev-20627",
+  "version": "0.0.0-dev-20628",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -57,8 +57,8 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@opencode/schema": "0.0.0-dev-20627",
-    "@opencode/protocol": "0.0.0-dev-20627"
+    "@opencode/schema": "0.0.0-dev-20628",
+    "@opencode/protocol": "0.0.0-dev-20628"
   },
   "peerDependencies": {
     "effect": "4.0.0-rc.112",
@@ -74,7 +74,7 @@
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.112",
-    "@opencode/httpapi-codegen": "0.0.0-dev-20627",
+    "@opencode/httpapi-codegen": "0.0.0-dev-20628",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.4.0",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",

package/dist/chunks/shared-events-mdvk8mfx.js

@@ -1,30 +0,0 @@
-import {
-  make7
-} from "./shared-events-frbwqjmf.js";
-import {
-  make3
-} from "./shared-events-qzsnm4q8.js";
-import {
-  makeRpc2
-} from "./shared-events-1y4a697q.js";
-import {
-  __export
-} from "./shared-events-9rqn6x4v.js";
-
-// src/promise/client.ts
-var exports_client = {};
-__export(exports_client, {
-  OpenCode: () => exports_client,
-  make: () => make2
-});
-function make2(options) {
-  const raw = make3(options);
-  const events = make7((signal, onActivity) => raw.event.subscribe({ signal, onActivity }));
-  return {
-    ...raw,
-    rpc: Object.assign(makeRpc2(raw, events), raw.rpc),
-    event: events
-  };
-}
-
-export { make2, exports_client };