@opencode-ai/client 0.0.0-next-17255 → 0.0.0-next-17268

package/dist/effect/service.js

@@ -1,10 +1,17 @@
 import { ServiceStatus } from "@opencode-ai/protocol/groups/health";
 import { Effect, FileSystem, Option, Schedule, Schema } from "effect";
-import { spawn } from "node:child_process";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { contenderFailure, contenderFinished, spawnServiceContender, } from "../service-contender.js";
 import { defaultEnsureTiming, ensureTiming } from "../service-timing.js";
 export * from "../service.js";
+// Find, start, and stop the local opencode background service.
+//
+// The service daemon advertises itself through a registration file in the
+// user's state directory: url, pid, version, and the private password, with
+// 0600 permissions. That file is the complete discovery contract — reading it
+// is all a client needs to connect. The daemon's own configuration (port,
+// persisted password) is CLI-owned and never read here.
 // Read-only lookup: registration file plus health check and version gate.
 // Never spawns; escalation to ensure() is the caller's policy.
 /** Discover a healthy, compatible local service without starting one. */
@@ -52,13 +59,7 @@ export const ensure = Effect.fn("service.ensure")(function* (options = {}) {
             return yield* Effect.fail(new Error("Missing service command"));
         return yield* Effect.try({
             try: () => {
-                const child = spawn(command, args, { detached: true, stdio: "ignore" });
-                let error;
-                child.once("error", (cause) => {
-                    error = new Error("Failed to start server", { cause });
-                });
-                child.unref();
-                return { child, error: () => error };
+                return spawnServiceContender(command, args);
             },
             catch: (cause) => new Error("Failed to start server", { cause }),
         });
@@ -115,24 +116,11 @@ export const ensure = Effect.fn("service.ensure")(function* (options = {}) {
     }).pipe(Effect.repeat({
         until: Option.isSome,
         schedule: Schedule.max([Schedule.spaced(timing.pollInterval), Schedule.recurs(timing.attempts)]),
-    }));
+    }), Effect.ensuring(Effect.sync(() => contenders.forEach((contender) => contender.release()))));
     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();
-    if (error !== undefined)
-        return error;
-    if (contender.child.exitCode !== null && contender.child.exitCode !== 0)
-        return new Error(`Server process exited with code ${contender.child.exitCode}`);
-    if (contender.child.signalCode !== null)
-        return new Error(`Server process terminated by ${contender.child.signalCode}`);
-    return undefined;
-}
-function contenderFinished(contender) {
-    return contender.error() !== undefined || contender.child.exitCode !== null || contender.child.signalCode !== null;
-}
 /** Stop the registered local service. */
 export const stop = Effect.fn("service.stop")(function* (options = {}) {
     const existing = yield* find(options);

package/dist/promise/generated/client.d.ts

@@ -73,7 +73,7 @@ export declare function make(options: ClientOptions): {
         log: (input: SessionLogInput, requestOptions?: RequestOptions) => AsyncIterable<SessionLogOutput>;
         interrupt: (input: SessionInterruptInput, requestOptions?: RequestOptions) => Promise<void>;
         background: (input: SessionBackgroundInput, requestOptions?: RequestOptions) => Promise<void>;
-        message: (input: SessionMessageInput, requestOptions?: RequestOptions) => Promise<import("./types.js").SessionMessageAgentSelected | import("./types.js").SessionMessageSynthetic | import("./types.js").SessionMessageSystem | import("./types.js").SessionMessageSkill | import("./types.js").SessionMessageShell | import("./types.js").SessionMessageCompactionRunning | import("./types.js").SessionMessageCompactionCompleted | import("./types.js").SessionMessageModelSelected | import("./types.js").SessionMessageCompactionFailed | import("./types.js").SessionMessageUser | import("./types.js").SessionMessageAssistant>;
+        message: (input: SessionMessageInput, requestOptions?: RequestOptions) => Promise<import("./types.js").SessionMessageAgentSelected | import("./types.js").SessionMessageSynthetic | import("./types.js").SessionMessageSystem | import("./types.js").SessionMessageSkill | import("./types.js").SessionMessageShell | import("./types.js").SessionMessageCompactionRunning | import("./types.js").SessionMessageCompactionCompleted | import("./types.js").SessionMessageModelSelected | import("./types.js").SessionMessageLocationSwitched | import("./types.js").SessionMessageCompactionFailed | import("./types.js").SessionMessageUser | import("./types.js").SessionMessageAssistant>;
     };
     message: {
         list: (input: MessageListInput, requestOptions?: RequestOptions) => Promise<import("./types.js").SessionMessagesResponse>;

package/dist/promise/generated/types.d.ts

@@ -96,6 +96,7 @@ export type SessionMessageSystem = {
     };
     type: "system";
     text: string;
+    description?: string;
 };
 export type SessionMessageSkill = {
     id: string;
@@ -618,6 +619,24 @@ export type PermissionRule = {
     resource: string;
     effect: PermissionEffect;
 };
+export type SessionMessageLocationSwitched = {
+    id: string;
+    metadata?: {
+        [x: string]: JsonValue;
+    };
+    time: {
+        created: number;
+    };
+    type: "location-switched";
+    location: LocationRef;
+    projectID?: string;
+    subpath?: string;
+    previous?: {
+        location: LocationRef;
+        projectID?: string;
+        subpath?: string;
+    };
+};
 export type SessionCreated = {
     id: string;
     created: number;
@@ -2797,7 +2816,7 @@ export type SessionInputAdmitted = {
         input: SessionPendingMessage;
     };
 };
-export type SessionMessageInfo = SessionMessageAgentSelected | SessionMessageModelSelected | SessionMessageUser | SessionMessageSynthetic | SessionMessageSystem | SessionMessageSkill | SessionMessageShell | SessionMessageAssistant | SessionMessageCompaction;
+export type SessionMessageInfo = SessionMessageAgentSelected | SessionMessageModelSelected | SessionMessageLocationSwitched | SessionMessageUser | SessionMessageSynthetic | SessionMessageSystem | SessionMessageSkill | SessionMessageShell | SessionMessageAssistant | SessionMessageCompaction;
 export type IntegrationMethod = IntegrationOAuthMethod | IntegrationCommandMethod | IntegrationKeyMethod | IntegrationEnvMethod;
 export type FormCreated = {
     id: string;
@@ -3331,6 +3350,29 @@ export type SessionImportInput = {
                 readonly providerID: string;
                 readonly variant?: string;
             };
+        } | {
+            readonly id: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
+            readonly time: {
+                readonly created: number;
+            };
+            readonly type: "location-switched";
+            readonly location: {
+                readonly directory: string;
+                readonly workspaceID?: string;
+            };
+            readonly projectID?: string;
+            readonly subpath?: string;
+            readonly previous?: {
+                readonly location: {
+                    readonly directory: string;
+                    readonly workspaceID?: string;
+                };
+                readonly projectID?: string;
+                readonly subpath?: string;
+            };
         } | {
             readonly id: string;
             readonly metadata?: {
@@ -3397,6 +3439,7 @@ export type SessionImportInput = {
             };
             readonly type: "system";
             readonly text: string;
+            readonly description?: string;
         } | {
             readonly id: string;
             readonly metadata?: {
@@ -3714,6 +3757,29 @@ export type SessionImportInput = {
                 readonly providerID: string;
                 readonly variant?: string;
             };
+        } | {
+            readonly id: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
+            readonly time: {
+                readonly created: number;
+            };
+            readonly type: "location-switched";
+            readonly location: {
+                readonly directory: string;
+                readonly workspaceID?: string;
+            };
+            readonly projectID?: string;
+            readonly subpath?: string;
+            readonly previous?: {
+                readonly location: {
+                    readonly directory: string;
+                    readonly workspaceID?: string;
+                };
+                readonly projectID?: string;
+                readonly subpath?: string;
+            };
         } | {
             readonly id: string;
             readonly metadata?: {
@@ -3780,6 +3846,7 @@ export type SessionImportInput = {
             };
             readonly type: "system";
             readonly text: string;
+            readonly description?: string;
         } | {
             readonly id: string;
             readonly metadata?: {
@@ -4097,6 +4164,29 @@ export type SessionImportInput = {
                 readonly providerID: string;
                 readonly variant?: string;
             };
+        } | {
+            readonly id: string;
+            readonly metadata?: {
+                readonly [x: string]: JsonValue;
+            };
+            readonly time: {
+                readonly created: number;
+            };
+            readonly type: "location-switched";
+            readonly location: {
+                readonly directory: string;
+                readonly workspaceID?: string;
+            };
+            readonly projectID?: string;
+            readonly subpath?: string;
+            readonly previous?: {
+                readonly location: {
+                    readonly directory: string;
+                    readonly workspaceID?: string;
+                };
+                readonly projectID?: string;
+                readonly subpath?: string;
+            };
         } | {
             readonly id: string;
             readonly metadata?: {
@@ -4163,6 +4253,7 @@ export type SessionImportInput = {
             };
             readonly type: "system";
             readonly text: string;
+            readonly description?: string;
         } | {
             readonly id: string;
             readonly metadata?: {

package/dist/promise/service.js

@@ -1,9 +1,14 @@
 import { readFile } from "node:fs/promises";
-import { spawn } from "node:child_process";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { contenderFailure, contenderFinished, spawnServiceContender, } from "../service-contender.js";
 import { defaultEnsureTiming, ensureTiming } from "../service-timing.js";
 export * from "../service.js";
+// Find, start, and stop the local opencode background service.
+//
+// The registration file is the complete discovery contract. This module is
+// intentionally implemented with Node APIs so Promise clients do not need
+// Effect or @effect/platform-node at runtime.
 /** Discover a healthy, compatible local service without starting one. */
 export async function discover(options = {}) {
     return (await discoverLocal(options))?.endpoint;
@@ -36,83 +41,69 @@ export async function ensure(options = {}) {
         if (command === undefined)
             throw new Error("Missing service command");
         try {
-            const child = spawn(command, args, { detached: true, stdio: "ignore" });
-            let error;
-            child.once("error", (cause) => {
-                error = new Error("Failed to start server", { cause });
-            });
-            child.unref();
-            return { child, error: () => error };
+            return spawnServiceContender(command, args);
         }
         catch (cause) {
             throw new Error("Failed to start server", { cause });
         }
     };
-    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, timing.requestTimeout);
-        if (registration.timedOut && registration.info !== undefined) {
-            timeouts = {
-                info: registration.info,
-                count: timeouts !== undefined && same(timeouts.info, registration.info) ? timeouts.count + 1 : 1,
-            };
-            if (timeouts.count >= 3) {
-                announce("missing");
-                await evict(registration.info, options, timing);
-                timeouts = undefined;
-                lastSpawn = Date.now() - spawnDelay;
-            }
-        }
-        else
-            timeouts = undefined;
-        if (registration.service !== undefined) {
-            spawnDelay = timing.spawnDelay;
-            const service = registration.service;
-            const compatible = !service.legacy && (options.version === undefined || service.version === options.version);
-            if (compatible && service.state === "ready")
-                return service.endpoint;
-            if (compatible && service.state === "failed")
-                throw new Error("Background service failed to start");
-            if (!compatible) {
-                announce("version-mismatch", service.version);
-                await kill(service, options, timing).catch(() => undefined);
-                lastSpawn = 0;
+    try {
+        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, timing.requestTimeout);
+            if (registration.timedOut && registration.info !== undefined) {
+                timeouts = {
+                    info: registration.info,
+                    count: timeouts !== undefined && same(timeouts.info, registration.info) ? timeouts.count + 1 : 1,
+                };
+                if (timeouts.count >= 3) {
+                    announce("missing");
+                    await evict(registration.info, options, timing);
+                    timeouts = undefined;
+                    lastSpawn = Date.now() - spawnDelay;
+                }
             }
-        }
-        else {
-            if (lastSpawn === 0 && registration.info !== undefined)
-                lastSpawn = Date.now();
-            const finished = [...contenders].filter(contenderFinished);
-            const failure = finished.map(contenderFailure).find((error) => error !== undefined);
-            if (finished.some((item) => item.child.exitCode === 0)) {
-                spawnDelay = Math.min(spawnDelay * 2, timing.maxSpawnDelay);
+            else
+                timeouts = undefined;
+            if (registration.service !== undefined) {
+                spawnDelay = timing.spawnDelay;
+                const service = registration.service;
+                const compatible = !service.legacy && (options.version === undefined || service.version === options.version);
+                if (compatible && service.state === "ready")
+                    return service.endpoint;
+                if (compatible && service.state === "failed")
+                    throw new Error("Background service failed to start");
+                if (!compatible) {
+                    announce("version-mismatch", service.version);
+                    await kill(service, options, timing).catch(() => undefined);
+                    lastSpawn = 0;
+                }
             }
-            finished.forEach((item) => contenders.delete(item));
-            if (failure !== undefined && contenders.size === 0)
-                throw failure;
-            // Keep one candidate plus one lock probe so a pre-lock stall cannot block recovery.
-            if (contenders.size < 2 && Date.now() - lastSpawn >= spawnDelay) {
-                announce("missing");
-                contenders.add(spawnContender());
-                lastSpawn = Date.now();
+            else {
+                if (lastSpawn === 0 && registration.info !== undefined)
+                    lastSpawn = Date.now();
+                const finished = [...contenders].filter(contenderFinished);
+                const failure = finished.map(contenderFailure).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;
+                // Keep one candidate plus one lock probe so a pre-lock stall cannot block recovery.
+                if (contenders.size < 2 && Date.now() - lastSpawn >= spawnDelay) {
+                    announce("missing");
+                    contenders.add(spawnContender());
+                    lastSpawn = Date.now();
+                }
             }
+            await delay(timing.pollInterval);
         }
-        await delay(timing.pollInterval);
     }
-}
-function contenderFailure(contender) {
-    const error = contender.error();
-    if (error !== undefined)
-        return error;
-    if (contender.child.exitCode !== null && contender.child.exitCode !== 0)
-        return new Error(`Server process exited with code ${contender.child.exitCode}`);
-    if (contender.child.signalCode !== null)
-        return new Error(`Server process terminated by ${contender.child.signalCode}`);
-    return undefined;
-}
-function contenderFinished(contender) {
-    return contender.error() !== undefined || contender.child.exitCode !== null || contender.child.signalCode !== null;
+    finally {
+        contenders.forEach((contender) => contender.release());
+    }
 }
 /** Stop the registered local service. */
 export async function stop(options = {}) {

package/dist/service-contender.d.ts

@@ -0,0 +1,11 @@
+import { type ChildProcess } from "node:child_process";
+export type ServiceContender = {
+    readonly child: ChildProcess;
+    readonly error: () => Error | undefined;
+    readonly closed: () => boolean;
+    readonly stderr: () => string;
+    readonly release: () => void;
+};
+export declare function spawnServiceContender(command: string, args: ReadonlyArray<string>): ServiceContender;
+export declare function contenderFailure(contender: ServiceContender): Error | undefined;
+export declare function contenderFinished(contender: ServiceContender): boolean;

package/dist/service-contender.js

@@ -0,0 +1,52 @@
+import { spawn } from "node:child_process";
+const stderrLimit = 8 * 1024;
+export function spawnServiceContender(command, args) {
+    const child = spawn(command, args, { detached: true, stdio: ["ignore", "ignore", "pipe"] });
+    let error;
+    let closed = false;
+    let stderr = Buffer.alloc(0);
+    const onStderr = (chunk) => {
+        const tail = chunk.subarray(-stderrLimit);
+        stderr =
+            tail.length === stderrLimit
+                ? Buffer.from(tail)
+                : Buffer.concat([stderr.subarray(-(stderrLimit - tail.length)), tail]);
+    };
+    child.stderr?.on("data", onStderr);
+    if (child.stderr !== null && "unref" in child.stderr && typeof child.stderr.unref === "function")
+        child.stderr.unref();
+    child.once("error", (cause) => {
+        error = new Error("Failed to start server", { cause });
+    });
+    child.once("close", () => {
+        closed = true;
+    });
+    child.unref();
+    return {
+        child,
+        error: () => error,
+        closed: () => closed,
+        stderr: () => stderr.toString("utf8").trim(),
+        release: () => {
+            child.stderr?.off("data", onStderr);
+            child.stderr?.resume();
+            stderr = Buffer.alloc(0);
+        },
+    };
+}
+export function contenderFailure(contender) {
+    const error = contender.error();
+    if (error !== undefined)
+        return error;
+    if (contender.child.exitCode !== null && contender.child.exitCode !== 0)
+        return startupError(`Server process exited with code ${contender.child.exitCode}`, contender.stderr());
+    if (contender.child.signalCode !== null)
+        return startupError(`Server process terminated by ${contender.child.signalCode}`, contender.stderr());
+    return undefined;
+}
+export function contenderFinished(contender) {
+    return contender.error() !== undefined || contender.closed();
+}
+function startupError(message, stderr) {
+    return new Error(stderr ? `${message}\n${stderr}` : message);
+}

package/package.json

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