@opencode/client 2.0.23 → 2.0.25

package/dist/promise/index.js

@@ -1,13 +1,9 @@
-import"../chunks/service-version-m2eywc8w.js";
+import"../chunks/service-probe-m2eywc8w.js";
 import {
   exports_client3
-} from "../chunks/service-version-gah0fg5v.js";
-import"../chunks/service-version-vyas3vgt.js";
-import"../chunks/service-version-nyqggzs9.js";
-import {
-  ClientError3
-} from "../chunks/service-version-nwcpakzx.js";
-import"../chunks/service-version-1y4a697q.js";
+} from "../chunks/service-probe-z1hcmzxa.js";
+import"../chunks/service-probe-vyas3vgt.js";
+import"../chunks/service-probe-1y4a697q.js";
 import {
   isInvalidRequestError2,
   isUnauthorizedError2,
@@ -42,8 +38,12 @@ import {
   isShellNotFoundError2,
   isWorktreeError2,
   isVcsInitNotSupportedError2
-} from "../chunks/service-version-vt9jbch8.js";
-import"../chunks/service-version-frbwqjmf.js";
+} from "../chunks/service-probe-vt9jbch8.js";
+import"../chunks/service-probe-9h52wrcy.js";
+import {
+  ClientError3
+} from "../chunks/service-probe-nwcpakzx.js";
+import"../chunks/service-probe-frbwqjmf.js";
 export {
   ClientError3 as ClientError,
   exports_client3 as OpenCode,

package/dist/promise/rpc.js

@@ -1,7 +1,7 @@
 import {
   makeRpc2
-} from "../chunks/service-version-1y4a697q.js";
-import"../chunks/service-version-vt9jbch8.js";
+} from "../chunks/service-probe-1y4a697q.js";
+import"../chunks/service-probe-vt9jbch8.js";
 export {
   makeRpc2 as makeRpc
 };

package/dist/promise/service.d.ts

@@ -1,5 +1,7 @@
 import type { DiscoverOptions, Endpoint, EnsureOptions, StopOptions } from "../service.js";
+import { headers } from "../service-probe.js";
 export * from "../service.js";
+export { headers };
 /** Discover a healthy, compatible local service without starting one. */
 export declare function discover(options?: DiscoverOptions): Promise<{
     url: string;
@@ -13,10 +15,6 @@ export declare function discover(options?: DiscoverOptions): Promise<{
 export declare function ensure(options?: EnsureOptions): Promise<Endpoint>;
 /** Stop the registered local service. */
 export declare function stop(options?: StopOptions): Promise<void>;
-/** Create HTTP authentication headers for a service endpoint. */
-export declare function headers(endpoint: Endpoint): {
-    authorization: string;
-} | undefined;
 /** Promise-based local service lifecycle operations. */
 export declare const Service: {
     discover: typeof discover;

package/dist/promise/service.js

@@ -1,27 +1,31 @@
 import {
   spawnServiceContender2,
-  contenderFailure2,
-  contenderFinished2
-} from "../chunks/service-version-6f43cgzz.js";
+  contenderPool2
+} from "../chunks/service-probe-ve4aws36.js";
 import {
   defaultEnsureTiming2,
   ensureTiming2
-} from "../chunks/service-version-xgnj2w4v.js";
+} from "../chunks/service-probe-xgnj2w4v.js";
 import {
   matchesVersion2
-} from "../chunks/service-version-sxt88q69.js";
+} from "../chunks/service-probe-sxt88q69.js";
 import {
   prepare2,
   environment2,
   complete2,
   clear2
-} from "../chunks/service-version-02j88w0z.js";
-import"../chunks/service-version-qav6mfdz.js";
+} from "../chunks/service-probe-1thtawyv.js";
+import {
+  decide2,
+  fallback2,
+  same2,
+  probeResult2,
+  headers2
+} from "../chunks/service-probe-2ny4vxct.js";
+import"../chunks/service-probe-qav6mfdz.js";
 
 // src/promise/service.ts
 import { readFile, rm } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
 async function discover(options = {}) {
   const found = (await registered(options.file)).service;
   if (found?.state !== "ready")
@@ -35,12 +39,9 @@ async function discover(options = {}) {
 async function ensure(options = {}) {
   const timing = ensureTiming2(options);
   const deadline = Date.now() + timing.promiseTimeout;
-  const contenders = new Set;
+  const pool = contenderPool2(timing);
   let timeouts;
   let announced = false;
-  let lastSpawn = 0;
-  let spawnDelay = timing.spawnDelay;
-  let failure;
   const announce = (reason, previousVersion) => {
     if (announced)
       return;
@@ -52,7 +53,7 @@ async function ensure(options = {}) {
     if (command === undefined)
       throw new Error("Missing service command");
     try {
-      return spawnServiceContender2(command, args, await environment2(options.file ?? fallback(), options.env));
+      return spawnServiceContender2(command, args, await environment2(options.file ?? fallback2(), options.env));
     } catch (cause) {
       throw new Error("Failed to start server", { cause });
     }
@@ -60,103 +61,66 @@ async function ensure(options = {}) {
   try {
     while (true) {
       if (Date.now() >= deadline)
-        throw failure ?? new Error("Timed out waiting for the background service to start");
+        throw pool.failure() ?? new Error("Timed out waiting for the background service to start");
       const registration = await registered(options.file, timing.requestTimeout);
       if (registration.timedOut && registration.info !== undefined) {
         timeouts = {
           info: registration.info,
-          count: timeouts !== undefined && same(timeouts.info, registration.info) ? timeouts.count + 1 : 1
+          count: timeouts !== undefined && same2(timeouts.info, registration.info) ? timeouts.count + 1 : 1
         };
         if (timeouts.count >= 3) {
           announce("missing");
           console.warn("Background service is unresponsive; recovery cannot preserve persistent terminals");
-          await clear2(options.file ?? fallback());
+          await clear2(options.file ?? fallback2());
           await terminate(registration.info, options, timing);
-          for (const item of contenders) {
-            if (item.child.pid === registration.info.pid || contenderFinished2(item)) {
-              item.release();
-              contenders.delete(item);
-            }
-          }
-          failure = undefined;
+          pool.evict(registration.info.pid);
+          pool.recruitNow();
           timeouts = undefined;
-          lastSpawn = Date.now() - spawnDelay;
         }
       } else
         timeouts = undefined;
       if (registration.service !== undefined) {
-        spawnDelay = timing.spawnDelay;
+        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") {
-          await complete2(options.file ?? fallback(), service2.info);
+        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;
           });
-          for (const item of contenders) {
-            if (item.child.pid === service2.info.pid || contenderFinished2(item)) {
-              item.release();
-              contenders.delete(item);
-            }
-          }
-          failure = undefined;
-          lastSpawn = 0;
+          pool.evict(service2.info.pid);
         }
       } else {
-        if (lastSpawn === 0 && registration.info !== undefined)
-          lastSpawn = Date.now();
-        const finished = [...contenders].filter(contenderFinished2);
-        failure ??= finished.map(contenderFailure2).find((error) => error !== undefined);
-        if (finished.some((item) => item.child.exitCode === 0)) {
-          spawnDelay = Math.min(spawnDelay * 2, timing.maxSpawnDelay);
-        }
-        finished.forEach((item) => contenders.delete(item));
-        if (failure !== undefined && contenders.size === 0)
-          throw failure;
-        if (failure === undefined && contenders.size < 2 && Date.now() - lastSpawn >= spawnDelay) {
+        const failed = pool.reap();
+        if (failed !== undefined)
+          throw failed;
+        if (pool.shouldRecruit(registration.info !== undefined)) {
           announce("missing");
-          contenders.add(await spawnContender());
-          lastSpawn = Date.now();
+          pool.add(await spawnContender());
         }
       }
       await delay(timing.pollInterval);
     }
   } finally {
-    contenders.forEach((contender) => contender.release());
+    pool.releaseAll();
   }
 }
 async function stop(options = {}) {
   const info = await read(options.file);
-  await (options.pty === "handoff" && info !== undefined ? prepare2(options.file ?? fallback(), info, defaultEnsureTiming2.requestTimeout) : clear2(options.file ?? fallback())).catch((cause) => console.warn("Failed to prepare persistent terminals for replacement", cause));
+  await (options.pty === "handoff" && info !== undefined ? prepare2(options.file ?? fallback2(), info, defaultEnsureTiming2.requestTimeout) : clear2(options.file ?? fallback2())).catch((cause) => console.warn("Failed to prepare persistent terminals for replacement", cause));
   if (info !== undefined)
     await terminate(info, options, ensureTiming2(options));
 }
-function fallback() {
-  return join(process.env["XDG_STATE_HOME"] ?? join(homedir(), ".local", "state"), "opencode", "service.json");
-}
-function headers(endpoint) {
-  if (endpoint.auth === undefined)
-    return;
-  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(() => {
+  const text = await readFile(file ?? fallback2(), "utf8").catch(() => {
     return;
   });
   if (text === undefined)
@@ -167,63 +131,11 @@ async function read(file) {
     return;
   }
 }
-async function probeResult(info, timeout = defaultEnsureTiming2.requestTimeout) {
-  const endpoint = {
-    url: info.url,
-    auth: info.password === undefined ? undefined : { type: "basic", username: "opencode", password: info.password }
-  };
-  const signal = AbortSignal.timeout(timeout);
-  const result = await fetch(new URL("/api/info", info.url), { headers: headers(endpoint), signal }).then(async (response) => ({
-    response,
-    body: response.status === 404 ? undefined : await response.json()
-  })).then((value) => ({ value }), (cause) => ({ cause }));
-  if ("cause" in result)
-    return { service: undefined, timedOut: signal.aborted };
-  const response = result.value.response;
-  if (response.status === 404)
-    return {
-      service: {
-        info,
-        endpoint,
-        version: info.version,
-        state: "ready",
-        compatible: false
-      },
-      timedOut: false
-    };
-  const serverInfo = decodeInfo(result.value.body);
-  if (serverInfo !== undefined) {
-    if (serverInfo.pid !== info.pid)
-      return { service: undefined, timedOut: false };
-    if (info.version !== undefined && serverInfo.version !== info.version)
-      return { service: undefined, timedOut: false };
-    return {
-      service: {
-        info,
-        endpoint,
-        version: serverInfo.version,
-        state: response.ok ? "ready" : response.status === 500 ? "failed" : "waiting",
-        compatible: true
-      },
-      timedOut: false
-    };
-  }
-  return { service: undefined, timedOut: false };
-}
-function decodeInfo(input) {
-  if (typeof input !== "object" || input === null)
-    return;
-  if (!("version" in input) || typeof input.version !== "string")
-    return;
-  if (!("pid" in input) || typeof input.pid !== "number" || !Number.isInteger(input.pid) || input.pid < 0)
-    return;
-  return { version: input.version, pid: input.pid };
-}
 async function registered(file, timeout) {
   const info = await read(file);
   if (info === undefined)
     return { info: undefined, service: undefined, timedOut: false };
-  return { info, ...await probeResult(info, timeout) };
+  return { info, ...await probeResult2(info, timeout) };
 }
 function signal(pid, name) {
   try {
@@ -247,12 +159,9 @@ async function waitUntilStopped(pid, timing) {
   }
   return false;
 }
-function same(left, right) {
-  return left.id === right.id && left.version === right.version && left.url === right.url && left.pid === right.pid;
-}
 async function terminate(info, options, timing) {
   const current = await read(options.file);
-  if (current === undefined || !same(current, info))
+  if (current === undefined || !same2(current, info))
     return;
   signal(info.pid, "SIGTERM");
   if (!await waitUntilStopped(info.pid, timing)) {
@@ -261,18 +170,18 @@ async function terminate(info, options, timing) {
       throw new Error(`Server process ${info.pid} is still running`);
   }
   const latest = await read(options.file);
-  if (latest === undefined || !same(latest, info))
+  if (latest === undefined || !same2(latest, info))
     return;
-  await rm(options.file ?? fallback(), { force: true });
+  await rm(options.file ?? fallback2(), { force: true });
 }
 function delay(milliseconds) {
   return new Promise((resolve) => setTimeout(resolve, milliseconds));
 }
-var Service = { discover, ensure, stop, headers };
+var Service = { discover, ensure, stop, headers: headers2 };
 export {
   Service,
   discover,
   ensure,
-  headers,
+  headers2 as headers,
   stop
 };

package/dist/pty-handoff.js

@@ -4,7 +4,7 @@ import {
   complete2,
   clear2,
   exports_pty_handoff
-} from "./chunks/service-version-02j88w0z.js";
+} from "./chunks/service-probe-1thtawyv.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/service-version-t1xa31vm.js";
+} from "./chunks/service-probe-t1xa31vm.js";
 export {
   exports_rpc_runtime as RpcRuntime,
   event2 as event,

package/dist/service-contender.d.ts

@@ -1,4 +1,5 @@
 import { type ChildProcess } from "node:child_process";
+import type { EnsureTiming } from "./service-timing.js";
 export type ServiceContender = {
     readonly child: ChildProcess;
     readonly error: () => Error | undefined;
@@ -7,5 +8,30 @@ export type ServiceContender = {
     readonly release: () => void;
 };
 export declare function spawnServiceContender(command: string, args: ReadonlyArray<string>, env?: Readonly<Record<string, string | undefined>>): ServiceContender;
-export declare function contenderFailure(contender: ServiceContender): Error | undefined;
+/**
+ * The startup attempts of one `ensure()` call. It keeps at most two attempts alive, remembers
+ * the first startup failure, and backs off when attempts exit cleanly because another one won.
+ */
+export declare function contenderPool(timing: EnsureTiming): {
+    /** The first startup failure seen since the last eviction. */
+    failure: () => Error | undefined;
+    /** A registered service answered, so the next attempt waits the base delay again. */
+    serviceAnswered(): void;
+    /**
+     * The owner `pid` was replaced. Drop its attempt and any finished ones, forget their
+     * failure, and restart the spawn clock.
+     */
+    evict(pid: number): void;
+    /** Let the next attempt start without waiting a spawn delay. */
+    recruitNow(): void;
+    /** Collect finished attempts. Returns the startup failure once no attempt is left alive. */
+    reap(): Error | undefined;
+    /**
+     * Whether to start another attempt now. A registration that has not answered yet gets one
+     * spawn delay before an attempt competes with it.
+     */
+    shouldRecruit(registered: boolean): boolean;
+    add(contender: ServiceContender): void;
+    releaseAll(): void;
+};
 export declare function contenderFinished(contender: ServiceContender): boolean;

package/dist/service-contender.js

@@ -1,10 +1,10 @@
 import {
   spawnServiceContender2,
-  contenderFailure2,
+  contenderPool2,
   contenderFinished2
-} from "./chunks/service-version-6f43cgzz.js";
+} from "./chunks/service-probe-ve4aws36.js";
 export {
-  contenderFailure2 as contenderFailure,
   contenderFinished2 as contenderFinished,
+  contenderPool2 as contenderPool,
   spawnServiceContender2 as spawnServiceContender
 };

package/dist/service-probe.d.ts

@@ -0,0 +1,70 @@
+import type { DiscoverOptions, Endpoint, Info } from "./service.js";
+export type LocalService = {
+    readonly info: Info;
+    readonly endpoint: Endpoint;
+    readonly version?: string;
+    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. */
+export declare function same(left: Info, right: Info): boolean;
+/** Ask a registered owner for its health and classify the answer. */
+export declare function probeResult(info: Info, timeout?: number): Promise<{
+    service: undefined;
+    timedOut: boolean;
+} | {
+    service: {
+        info: Info;
+        endpoint: {
+            url: string;
+            auth: {
+                type: "basic";
+                username: string;
+                password: string;
+            } | undefined;
+        };
+        version: string | undefined;
+        state: "ready";
+        compatible: false;
+    };
+    timedOut: boolean;
+} | {
+    service: {
+        info: Info;
+        endpoint: {
+            url: string;
+            auth: {
+                type: "basic";
+                username: string;
+                password: string;
+            } | undefined;
+        };
+        version: string;
+        state: "failed" | "ready" | "waiting";
+        compatible: true;
+    };
+    timedOut: boolean;
+}>;
+/** Create HTTP authentication headers for a service endpoint. */
+export declare function headers(endpoint: Endpoint): {
+    authorization: string;
+} | undefined;

package/dist/service-probe.js

@@ -0,0 +1,16 @@
+import {
+  decide2,
+  fallback2,
+  same2,
+  probeResult2,
+  headers2
+} from "./chunks/service-probe-2ny4vxct.js";
+import"./chunks/service-probe-sxt88q69.js";
+import"./chunks/service-probe-xgnj2w4v.js";
+export {
+  decide2 as decide,
+  fallback2 as fallback,
+  headers2 as headers,
+  probeResult2 as probeResult,
+  same2 as same
+};

package/dist/service-timing.js

@@ -2,7 +2,7 @@ import {
   defaultEnsureTiming2,
   ensureTiming2,
   withEnsureTiming2
-} from "./chunks/service-version-xgnj2w4v.js";
+} from "./chunks/service-probe-xgnj2w4v.js";
 export {
   defaultEnsureTiming2 as defaultEnsureTiming,
   ensureTiming2 as ensureTiming,

package/dist/service-version.js

@@ -1,6 +1,6 @@
 import {
   matchesVersion2
-} from "./chunks/service-version-sxt88q69.js";
+} from "./chunks/service-probe-sxt88q69.js";
 export {
   matchesVersion2 as matchesVersion
 };

package/dist/service.js

@@ -1 +1 @@
-import"./chunks/service-version-qav6mfdz.js";
+import"./chunks/service-probe-qav6mfdz.js";

package/dist/shared-events.js

@@ -1,7 +1,7 @@
 import {
   make7,
   exports_shared_events
-} from "./chunks/service-version-frbwqjmf.js";
+} from "./chunks/service-probe-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/service-version-ydhz1zrh.js";
+} from "../chunks/service-probe-ydhz1zrh.js";
 export {
   createClientConnection2 as createClientConnection,
   defaultIdleTimeout2 as defaultIdleTimeout,

package/dist/solid/data.d.ts

@@ -1,6 +1,12 @@
 import type { AgentInfo, CommandInfo, ConfigEntry, SessionFormCancelInput, FormInfo, SessionFormReplyInput, IntegrationInfo, LocationRef, McpResource, McpServer, ModelInfo, ModelRef, PermissionSavedInfo, PermissionRequest, PermissionReplyInput, Project, ProviderInfo, ReferenceInfo, SessionMessageInfo, SessionInfo, SessionInboxInfo, SessionInboxCompaction, ShellInfo, SkillInfo, VcsInfo, OpenCodeEvent, OpenCodeClient, WebSearchProvider } from "../promise";
 import { type SessionPromptInput } from "../promise";
 export type DataSessionStatus = "idle" | "running";
+/**
+ * Where a pending user prompt stands relative to the runner: `starting` is promoted at the next idle boundary,
+ * `steering` waits for the next step boundary of an execution that already delivered input, `stranded` outlived an
+ * execution that ended without delivering it, and `queued` waits for every steer to drain.
+ */
+export type DataPendingStatus = "starting" | "steering" | "stranded" | "queued";
 type OpenCodeEventMap = {
     [Type in OpenCodeEvent["type"]]: Extract<OpenCodeEvent, {
         type: Type;
@@ -50,12 +56,14 @@ export declare function createData(config: CreateDataInput): {
         evict(sessionID: string): void;
         cost(sessionID: string): number;
         status(sessionID: string): DataSessionStatus;
+        active(): string[];
         input: {
             list(sessionID: string): string[];
             has(sessionID: string, inboxID: string): boolean;
         };
         pending: {
             list(sessionID: string): SessionInboxInfo[];
+            status(sessionID: string, inboxID: string): DataPendingStatus | undefined;
             sync(sessionID: string): Promise<void>;
             invalidate(sessionID: string): void;
         };
@@ -98,12 +106,14 @@ export declare function createData(config: CreateDataInput): {
         };
         permission: {
             list(sessionID: string): PermissionRequest[];
+            sessions(): string[];
             sync(sessionID: string): Promise<void>;
             invalidate(sessionID: string): void;
             reply(input: PermissionReplyInput): Promise<void>;
         };
         form: {
             list(sessionID: string, ref?: LocationRef): FormWithLocation[] | undefined;
+            sessions(): string[];
             sync(sessionID: string, ref?: LocationRef): Promise<void>;
             invalidate(sessionID: string, ref?: LocationRef): void;
             reply(input: SessionFormReplyInput, ref?: LocationRef): Promise<void>;

package/dist/solid/data.js

@@ -2,15 +2,15 @@ import {
   settleMs2,
   locationKey2,
   createData2
-} from "../chunks/service-version-e5ea35j7.js";
-import"../chunks/service-version-m2eywc8w.js";
-import"../chunks/service-version-gah0fg5v.js";
-import"../chunks/service-version-vyas3vgt.js";
-import"../chunks/service-version-nyqggzs9.js";
-import"../chunks/service-version-nwcpakzx.js";
-import"../chunks/service-version-1y4a697q.js";
-import"../chunks/service-version-vt9jbch8.js";
-import"../chunks/service-version-frbwqjmf.js";
+} from "../chunks/service-probe-trz7kcxd.js";
+import"../chunks/service-probe-m2eywc8w.js";
+import"../chunks/service-probe-z1hcmzxa.js";
+import"../chunks/service-probe-vyas3vgt.js";
+import"../chunks/service-probe-1y4a697q.js";
+import"../chunks/service-probe-vt9jbch8.js";
+import"../chunks/service-probe-9h52wrcy.js";
+import"../chunks/service-probe-nwcpakzx.js";
+import"../chunks/service-probe-frbwqjmf.js";
 export {
   createData2 as createData,
   locationKey2 as locationKey,