@opencode-ai/client 0.0.0-next-15769 → 0.0.0-next-15778

package/dist/effect/service.d.ts

@@ -12,6 +12,20 @@ export declare const discover: (options?: DiscoverOptions | undefined) => Effect
         password: string;
     } | undefined;
 } | undefined, never, FileSystem.FileSystem>;
+/** Recognize an authenticated compatible service bound to an expected URL, including while it starts or fails. */
+export declare const incumbent: (options: DiscoverOptions & {
+    readonly url: string;
+}) => Effect.Effect<{
+    endpoint: {
+        url: string;
+        auth: {
+            type: "basic";
+            username: string;
+            password: string;
+        } | undefined;
+    };
+    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<Endpoint, Error, FileSystem.FileSystem>;
 /** Stop the registered local service. */
@@ -27,6 +41,7 @@ export declare const Info: Schema.Struct<{
     readonly url: Schema.String;
     readonly pid: Schema.Int;
     readonly password: Schema.optional<Schema.String>;
+    readonly startedAt: Schema.optional<Schema.Int>;
 }>;
 /** Effect-based local service lifecycle operations. */
 export declare const Service: {
@@ -38,6 +53,19 @@ export declare const Service: {
             password: string;
         } | undefined;
     } | undefined, never, FileSystem.FileSystem>;
+    incumbent: (options: DiscoverOptions & {
+        readonly url: string;
+    }) => Effect.Effect<{
+        endpoint: {
+            url: string;
+            auth: {
+                type: "basic";
+                username: string;
+                password: string;
+            } | undefined;
+        };
+        state: "failed" | "ready" | "waiting";
+    } | undefined, never, FileSystem.FileSystem>;
     ensure: (options?: EnsureOptions | undefined) => Effect.Effect<Endpoint, Error, FileSystem.FileSystem>;
     stop: (options?: StopOptions | undefined) => Effect.Effect<void, Error, FileSystem.FileSystem>;
     headers: typeof headers;
@@ -47,5 +75,6 @@ export declare const Service: {
         readonly url: Schema.String;
         readonly pid: Schema.Int;
         readonly password: Schema.optional<Schema.String>;
+        readonly startedAt: Schema.optional<Schema.Int>;
     }>;
 };

package/dist/effect/service.js

@@ -10,6 +10,16 @@ export * from "../service.js";
 export const discover = Effect.fn("service.discover")(function* (options = {}) {
     return (yield* discoverLocal(options))?.endpoint;
 });
+/** Recognize an authenticated compatible service bound to an expected URL, including while it starts or fails. */
+export const incumbent = Effect.fn("service.incumbent")(function* (options) {
+    const info = yield* read(options.file);
+    const found = info === undefined ? undefined : yield* probe({ ...info, url: options.url });
+    if (found === undefined || found.legacy)
+        return undefined;
+    if (options.version !== undefined && found.version !== options.version)
+        return undefined;
+    return { endpoint: found.endpoint, state: found.state };
+});
 const discoverLocal = Effect.fnUntraced(function* (options) {
     const found = (yield* registered(options.file)).service;
     if (found?.state !== "ready")
@@ -88,8 +98,13 @@ export const ensure = Effect.fn("service.ensure")(function* (options = {}) {
             lastSpawn = Date.now();
         }
         return Option.none();
-    }).pipe(Effect.repeat({ until: Option.isSome, schedule: Schedule.spaced("1 second") }));
-    return Option.getOrThrow(found).endpoint;
+    }).pipe(Effect.repeat({
+        until: Option.isSome,
+        schedule: Schedule.max([Schedule.spaced("1 second"), Schedule.recurs(120)]),
+    }));
+    if (Option.isNone(found))
+        return yield* Effect.fail(new Error("Timed out waiting for the background service to start"));
+    return found.value.endpoint;
 });
 function contenderFailure(contender) {
     const error = contender.error();
@@ -127,6 +142,7 @@ export const Info = Schema.Struct({
     url: Schema.String,
     pid: Schema.Int.check(Schema.isGreaterThan(0)),
     password: Schema.optional(Schema.String),
+    startedAt: Schema.optional(Schema.Int.check(Schema.isGreaterThan(0))),
 });
 const decode = Schema.decodeUnknownEffect(Schema.fromJsonString(Info));
 const decodeHealth = Schema.decodeUnknownOption(ServiceStatus.Health);
@@ -238,4 +254,4 @@ const requestStop = Effect.fnUntraced(function* (service) {
     return "accepted";
 });
 /** Effect-based local service lifecycle operations. */
-export const Service = { discover, ensure, stop, headers, Info };
+export const Service = { discover, incumbent, ensure, stop, headers, Info };

package/dist/promise/service.js

@@ -17,6 +17,7 @@ async function discoverLocal(options) {
 }
 /** Ensure a healthy, compatible local service is running. */
 export async function ensure(options = {}) {
+    const deadline = Date.now() + 120_000;
     const contenders = new Set();
     let announced = false;
     let lastSpawn = 0;
@@ -46,6 +47,8 @@ export async function ensure(options = {}) {
         }
     };
     while (true) {
+        if (Date.now() >= deadline)
+            throw new Error("Timed out waiting for the background service to start");
         const registration = await registered(options.file, true);
         if (registration.service !== undefined) {
             ownerHeld = false;
@@ -110,7 +113,9 @@ function fallback() {
 export function headers(endpoint) {
     if (endpoint.auth === undefined)
         return undefined;
-    return { authorization: "Basic " + Buffer.from(endpoint.auth.username + ":" + endpoint.auth.password).toString("base64") };
+    return {
+        authorization: "Basic " + Buffer.from(endpoint.auth.username + ":" + endpoint.auth.password).toString("base64"),
+    };
 }
 async function read(file) {
     const text = await readFile(file ?? fallback(), "utf8").catch(() => undefined);

package/dist/service.d.ts

@@ -45,4 +45,6 @@ export type Info = {
     readonly pid: number;
     /** Private service password, when authentication is enabled. */
     readonly password?: string;
+    /** Registration generation used to resolve owner write races. */
+    readonly startedAt?: number;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode-ai/client",
-  "version": "0.0.0-next-15769",
+  "version": "0.0.0-next-15778",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -53,8 +53,8 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/schema": "0.0.0-next-15769",
-    "@opencode-ai/protocol": "0.0.0-next-15769"
+    "@opencode-ai/schema": "0.0.0-next-15778",
+    "@opencode-ai/protocol": "0.0.0-next-15778"
   },
   "peerDependencies": {
     "effect": "4.0.0-beta.98"
@@ -66,7 +66,7 @@
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0-beta.98",
-    "@opencode-ai/httpapi-codegen": "0.0.0-next-15769",
+    "@opencode-ai/httpapi-codegen": "0.0.0-next-15778",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.3.13",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",