@opencode/protocol 2.1.2 → 2.1.3

package/dist/groups/permission.d.ts

@@ -1,33 +1,7 @@
 import { Context, Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSchema } from "effect/http-api";
 import { ConflictError, LocationNotFoundError, PermissionNotFoundError, PermissionSavedNotFoundError, SessionNotFoundError } from "../errors.js";
-export declare const makePermissionGroup: <LocationId extends HttpApiMiddleware.AnyId, LocationService, SessionLocationId extends HttpApiMiddleware.AnyId, SessionLocationService>(locationMiddleware: Context.Key<LocationId, LocationService>, sessionLocationMiddleware: Context.Key<SessionLocationId, SessionLocationService>) => HttpApiGroup.HttpApiGroup<"server.permission", HttpApiEndpoint.HttpApiEndpoint<"permission.saved.remove", "DELETE", "/api/permission/saved/:id", Schema.toCodecStringTree<Schema.Struct<{
-    id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
-        create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
-    };
-}>>, never, never, never, Schema.toCodecJson<HttpApiSchema.NoContent>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"permission.saved.update", "PATCH", "/api/permission/saved/:id", Schema.toCodecStringTree<Schema.Struct<{
-    id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
-        create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
-    };
-}>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly action: Schema.optional<Schema.String>;
-    readonly resource: Schema.optional<Schema.String>;
-}>>, never, Schema.toCodecJson<Schema.Struct<{
-    readonly data: Schema.Struct<{
-        readonly id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
-            create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
-        };
-        readonly projectID: Schema.brand<Schema.String, "Project.ID"> & {
-            global: string & import("effect/Brand").Brand<"Project.ID">;
-        };
-        readonly action: Schema.String;
-        readonly resource: Schema.String;
-        readonly time: Schema.Struct<{
-            readonly created: Schema.decodeTo<Schema.DateTimeUtc, Schema.Finite, never, never>;
-            readonly updated: Schema.decodeTo<Schema.DateTimeUtc, Schema.Finite, never, never>;
-        }>;
-    }>;
-}>>, Schema.toCodecJson<typeof ConflictError | typeof PermissionSavedNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"permission.request.list", "GET", "/api/permission/request", never, Schema.toCodecStringTree<Schema.Struct<{
+export declare const makePermissionGroup: <LocationId extends HttpApiMiddleware.AnyId, LocationService, SessionLocationId extends HttpApiMiddleware.AnyId, SessionLocationService>(locationMiddleware: Context.Key<LocationId, LocationService>, sessionLocationMiddleware: Context.Key<SessionLocationId, SessionLocationService>) => HttpApiGroup.HttpApiGroup<"server.permission", HttpApiEndpoint.HttpApiEndpoint<"permission.request.list", "GET", "/api/permission/request", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
     }>>;
@@ -77,7 +51,33 @@ export declare const makePermissionGroup: <LocationId extends HttpApiMiddleware.
             readonly updated: Schema.decodeTo<Schema.DateTimeUtc, Schema.Finite, never, never>;
         }>;
     }>>;
-}>>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"session.permission.create", "POST", "/api/session/:sessionID/permission", Schema.toCodecStringTree<Schema.Struct<{
+}>>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"permission.saved.update", "PATCH", "/api/permission/saved/:id", Schema.toCodecStringTree<Schema.Struct<{
+    id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
+        create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
+    };
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly action: Schema.optional<Schema.String>;
+    readonly resource: Schema.optional<Schema.String>;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly data: Schema.Struct<{
+        readonly id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
+            create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
+        };
+        readonly projectID: Schema.brand<Schema.String, "Project.ID"> & {
+            global: string & import("effect/Brand").Brand<"Project.ID">;
+        };
+        readonly action: Schema.String;
+        readonly resource: Schema.String;
+        readonly time: Schema.Struct<{
+            readonly created: Schema.decodeTo<Schema.DateTimeUtc, Schema.Finite, never, never>;
+            readonly updated: Schema.decodeTo<Schema.DateTimeUtc, Schema.Finite, never, never>;
+        }>;
+    }>;
+}>>, Schema.toCodecJson<typeof ConflictError | typeof PermissionSavedNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"permission.saved.remove", "DELETE", "/api/permission/saved/:id", Schema.toCodecStringTree<Schema.Struct<{
+    id: Schema.brand<Schema.String, "PermissionSaved.ID"> & {
+        create: () => string & import("effect/Brand").Brand<"PermissionSaved.ID">;
+    };
+}>>, never, never, never, Schema.toCodecJson<HttpApiSchema.NoContent>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"session.permission.create", "POST", "/api/session/:sessionID/permission", Schema.toCodecStringTree<Schema.Struct<{
     sessionID: Schema.brand<Schema.String, "SessionID"> & {
         create: () => string & import("effect/Brand").Brand<"SessionID">;
         descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;

package/dist/groups/pty.d.ts

@@ -6,7 +6,7 @@ export declare const PTY_CONNECT_TOKEN_HEADER = "x-opencode-ticket";
 export declare const PTY_CONNECT_TOKEN_HEADER_VALUE = "1";
 export declare const PTY_CONNECT_PATH = "/api/pty/:ptyID/connect";
 export declare function hasPtyConnectTicketURL(url: URL): boolean;
-export declare const makePtyGroup: <LocationId extends HttpApiMiddleware.AnyId, LocationService>(locationMiddleware: Context.Key<LocationId, LocationService>) => HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEndpoint.HttpApiEndpoint<"pty.remove", "DELETE", "/api/pty/:ptyID", Schema.toCodecStringTree<Schema.Struct<{
+export declare const makePtyGroup: <LocationId extends HttpApiMiddleware.AnyId, LocationService>(locationMiddleware: Context.Key<LocationId, LocationService>) => HttpApiGroup.HttpApiGroup<"server.pty", HttpApiEndpoint.HttpApiEndpoint<"pty.connectToken", "POST", "/api/pty/:ptyID/connect-token", Schema.toCodecStringTree<Schema.Struct<{
     ptyID: Schema.brand<Schema.String, "PtyID"> & {
         create: () => string & import("effect/Brand").Brand<"PtyID">;
         ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
@@ -15,28 +15,17 @@ export declare const makePtyGroup: <LocationId extends HttpApiMiddleware.AnyId,
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
     }>>;
-}>>, never, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.list", "GET", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
-    readonly location: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.String>;
-    }>>;
-}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+}>>, never, Schema.toCodecStringTree<Schema.Struct<{
+    readonly "x-opencode-ticket": Schema.optional<Schema.String>;
+}>>, Schema.toCodecJson<Schema.Struct<{
     readonly location: Schema.Struct<{
         readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
     }>;
-    readonly data: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.brand<Schema.String, "PtyID"> & {
-            create: () => string & import("effect/Brand").Brand<"PtyID">;
-            ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
-        };
-        readonly title: Schema.String;
-        readonly command: Schema.String;
-        readonly args: Schema.$Array<Schema.String>;
-        readonly cwd: Schema.String;
-        readonly status: Schema.Literals<readonly ["running", "exited"]>;
-        readonly pid: Schema.Int;
-        readonly exitCode: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Int>>, Schema.optionalKey<Schema.Int>, never, never>;
-    }>>;
-}>>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.create", "POST", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
+    readonly data: Schema.Struct<{
+        readonly ticket: Schema.String;
+        readonly expires_in: Schema.Int;
+    }>;
+}>>, Schema.toCodecJson<typeof ForbiddenError | typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.create", "POST", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
     }>>;
@@ -89,7 +78,37 @@ export declare const makePtyGroup: <LocationId extends HttpApiMiddleware.AnyId,
         readonly pid: Schema.Int;
         readonly exitCode: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Int>>, Schema.optionalKey<Schema.Int>, never, never>;
     }>;
-}>>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.update", "PUT", "/api/pty/:ptyID", Schema.toCodecStringTree<Schema.Struct<{
+}>>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.list", "GET", "/api/pty", never, Schema.toCodecStringTree<Schema.Struct<{
+    readonly location: Schema.optional<Schema.Struct<{
+        readonly directory: Schema.optional<Schema.String>;
+    }>>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly location: Schema.Struct<{
+        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
+    }>;
+    readonly data: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.brand<Schema.String, "PtyID"> & {
+            create: () => string & import("effect/Brand").Brand<"PtyID">;
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+        };
+        readonly title: Schema.String;
+        readonly command: Schema.String;
+        readonly args: Schema.$Array<Schema.String>;
+        readonly cwd: Schema.String;
+        readonly status: Schema.Literals<readonly ["running", "exited"]>;
+        readonly pid: Schema.Int;
+        readonly exitCode: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Int>>, Schema.optionalKey<Schema.Int>, never, never>;
+    }>>;
+}>>, never, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.remove", "DELETE", "/api/pty/:ptyID", Schema.toCodecStringTree<Schema.Struct<{
+    ptyID: Schema.brand<Schema.String, "PtyID"> & {
+        create: () => string & import("effect/Brand").Brand<"PtyID">;
+        ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+    };
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly location: Schema.optional<Schema.Struct<{
+        readonly directory: Schema.optional<Schema.String>;
+    }>>;
+}>>, never, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.update", "PUT", "/api/pty/:ptyID", Schema.toCodecStringTree<Schema.Struct<{
     ptyID: Schema.brand<Schema.String, "PtyID"> & {
         create: () => string & import("effect/Brand").Brand<"PtyID">;
         ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
@@ -124,26 +143,7 @@ export declare const makePtyGroup: <LocationId extends HttpApiMiddleware.AnyId,
         readonly pid: Schema.Int;
         readonly exitCode: Schema.decodeTo<Schema.optional<Schema.toType<Schema.Int>>, Schema.optionalKey<Schema.Int>, never, never>;
     }>;
-}>>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.connectToken", "POST", "/api/pty/:ptyID/connect-token", Schema.toCodecStringTree<Schema.Struct<{
-    ptyID: Schema.brand<Schema.String, "PtyID"> & {
-        create: () => string & import("effect/Brand").Brand<"PtyID">;
-        ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
-    };
-}>>, Schema.toCodecStringTree<Schema.Struct<{
-    readonly location: Schema.optional<Schema.Struct<{
-        readonly directory: Schema.optional<Schema.String>;
-    }>>;
-}>>, never, Schema.toCodecStringTree<Schema.Struct<{
-    readonly "x-opencode-ticket": Schema.optional<Schema.String>;
-}>>, Schema.toCodecJson<Schema.Struct<{
-    readonly location: Schema.Struct<{
-        readonly directory: Schema.brand<Schema.String, "AbsolutePath">;
-    }>;
-    readonly data: Schema.Struct<{
-        readonly ticket: Schema.String;
-        readonly expires_in: Schema.Int;
-    }>;
-}>>, Schema.toCodecJson<typeof ForbiddenError | typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.connect", "GET", "/api/pty/:ptyID/connect", Schema.toCodecStringTree<Schema.Struct<{
+}>>, Schema.toCodecJson<typeof PtyNotFoundError>, LocationId, HttpApiMiddleware.Requires<LocationId>> | HttpApiEndpoint.HttpApiEndpoint<"pty.connect", "GET", "/api/pty/:ptyID/connect", Schema.toCodecStringTree<Schema.Struct<{
     ptyID: Schema.brand<Schema.String, "PtyID"> & {
         create: () => string & import("effect/Brand").Brand<"PtyID">;
         ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;

package/dist/groups/session.d.ts

@@ -4779,7 +4779,7 @@ export declare const makeSessionGroup: <I extends HttpApiMiddleware.AnyId, S, Fo
 }>>, Schema.toCodecStringTree<Schema.Struct<{
     after: Schema.optional<Schema.compose<Schema.brand<Schema.Int, "Event.Seq">, Schema.NumberFromString>>;
     follow: Schema.optional<Schema.decodeTo<Schema.Boolean, Schema.Literals<readonly ["true", "false"]>, never, never>>;
-}>>, never, never, HttpApiSchema.StreamSse<HttpApiSchema.SseEventFromData<Schema.Union<readonly [Schema.Union<readonly [...((Schema.Struct<{
+}>>, never, never, HttpApiSchema.StreamSse<HttpApiSchema.SseEventFromData<Schema.Union<readonly [Schema.toTaggedUnion<"type", readonly [...((Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "Event.ID"> & {
         create: () => string & import("effect/Brand").Brand<"Event.ID">;
     };

package/dist/groups/voice.d.ts

@@ -1,6 +1,17 @@
 import { Schema } from "effect";
-import { HttpApiEndpoint, HttpApiGroup } from "effect/http-api";
+import { HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/http-api";
 import { InvalidRequestError, LocationNotFoundError, ServiceUnavailableError } from "../errors.js";
+export declare const VoiceTransportType: Schema.Literals<readonly ["webrtc", "websocket"]>;
+export declare const VoiceModel: Schema.Struct<{
+    readonly model: Schema.String;
+    readonly provider: Schema.String;
+    readonly transports: Schema.$Array<Schema.Literals<readonly ["webrtc", "websocket"]>>;
+    readonly available: Schema.Boolean;
+    /** The integration whose connection starts its sessions: the provider's stored key, or `opencode` when the connected OpenCode Console hosts it. */
+    readonly integration: Schema.optional<Schema.String>;
+    /** The OpenCode Console workspace a hosted model's sessions bill to. */
+    readonly workspace: Schema.optional<Schema.String>;
+}>;
 export declare const VoiceWebRTCTransportInput: Schema.Struct<{
     readonly type: Schema.Literal<"webrtc">;
     readonly sdp: Schema.String;
@@ -35,7 +46,25 @@ export declare const VoiceTransport: Schema.Union<readonly [Schema.Struct<{
     readonly token: Schema.String;
     readonly expiresAt: Schema.Number;
 }>]>;
-export declare const VoiceGroup: HttpApiGroup.HttpApiGroup<"server.voice", HttpApiEndpoint.HttpApiEndpoint<"voice.session", "POST", "/api/experimental/voice/session", never, never, Schema.toCodecJson<Schema.Struct<{
+export declare const VoiceGroup: HttpApiGroup.HttpApiGroup<"server.voice", HttpApiEndpoint.HttpApiEndpoint<"voice.instructions", "POST", "/api/experimental/voice/session/:sessionID/instructions", Schema.toCodecStringTree<Schema.Struct<{
+    sessionID: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly instructions: Schema.String;
+}>>, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof LocationNotFoundError | typeof InvalidRequestError | typeof ServiceUnavailableError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"voice.models", "GET", "/api/experimental/voice/models", never, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly data: Schema.Struct<{
+        readonly models: Schema.$Array<Schema.Struct<{
+            readonly model: Schema.String;
+            readonly provider: Schema.String;
+            readonly transports: Schema.$Array<Schema.Literals<readonly ["webrtc", "websocket"]>>;
+            readonly available: Schema.Boolean;
+            /** The integration whose connection starts its sessions: the provider's stored key, or `opencode` when the connected OpenCode Console hosts it. */
+            readonly integration: Schema.optional<Schema.String>;
+            /** The OpenCode Console workspace a hosted model's sessions bill to. */
+            readonly workspace: Schema.optional<Schema.String>;
+        }>>;
+        readonly default: Schema.optional<Schema.String>;
+    }>;
+}>>, Schema.toCodecJson<typeof LocationNotFoundError | typeof ServiceUnavailableError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"voice.session", "POST", "/api/experimental/voice/session", never, never, Schema.toCodecJson<Schema.Struct<{
     readonly model: Schema.String;
     readonly session: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
     readonly transport: Schema.Union<readonly [Schema.Struct<{
@@ -56,5 +85,9 @@ export declare const VoiceGroup: HttpApiGroup.HttpApiGroup<"server.voice", HttpA
             readonly token: Schema.String;
             readonly expiresAt: Schema.Number;
         }>]>;
+        /** A hosted session's ID, for `voice.instructions`. */
+        readonly session: Schema.optional<Schema.Struct<{
+            readonly id: Schema.String;
+        }>>;
     }>;
 }>>, Schema.toCodecJson<typeof LocationNotFoundError | typeof InvalidRequestError | typeof ServiceUnavailableError>, never, never>, false>;

package/dist/groups/voice.js

@@ -1,6 +1,19 @@
 import { Schema } from "effect";
-import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/http-api";
+import { HttpApiEndpoint, HttpApiGroup, HttpApiSchema, OpenApi } from "effect/http-api";
 import { InvalidRequestError, LocationNotFoundError, ServiceUnavailableError } from "../errors.js";
+export const VoiceTransportType = Schema.Literals(["webrtc", "websocket"]).annotate({
+    identifier: "VoiceTransportType",
+});
+export const VoiceModel = Schema.Struct({
+    model: Schema.String,
+    provider: Schema.String,
+    transports: Schema.Array(VoiceTransportType),
+    available: Schema.Boolean,
+    /** The integration whose connection starts its sessions: the provider's stored key, or `opencode` when the connected OpenCode Console hosts it. */
+    integration: Schema.optional(Schema.String),
+    /** The OpenCode Console workspace a hosted model's sessions bill to. */
+    workspace: Schema.optional(Schema.String),
+}).annotate({ identifier: "VoiceModel" });
 export const VoiceWebRTCTransportInput = Schema.Struct({
     type: Schema.Literal("webrtc"),
     sdp: Schema.String,
@@ -28,6 +41,19 @@ export const VoiceTransport = Schema.Union([
     VoiceWebSocketTransport,
 ]).annotate({ identifier: "VoiceTransport" });
 export const VoiceGroup = HttpApiGroup.make("server.voice")
+    .add(HttpApiEndpoint.get("voice.models", "/api/experimental/voice/models", {
+    success: Schema.Struct({
+        data: Schema.Struct({
+            models: Schema.Array(VoiceModel),
+            default: Schema.optional(Schema.String),
+        }),
+    }).annotate({ identifier: "VoiceModelsResponse" }),
+    error: [ServiceUnavailableError, LocationNotFoundError],
+}).annotateMerge(OpenApi.annotations({
+    identifier: "experimental.voice.models",
+    summary: "List voice models",
+    description: "List supported voice models, their transports, whether the server has a usable API key for each provider or the connected OpenCode Console hosts the model, and the Console workspace a hosted model bills to.",
+})))
     .add(HttpApiEndpoint.post("voice.session", "/api/experimental/voice/session", {
     payload: Schema.Struct({
         model: Schema.String,
@@ -37,13 +63,25 @@ export const VoiceGroup = HttpApiGroup.make("server.voice")
     success: Schema.Struct({
         data: Schema.Struct({
             transport: VoiceTransport,
+            /** A hosted session's ID, for `voice.instructions`. */
+            session: Schema.optional(Schema.Struct({ id: Schema.String })),
         }),
     }).annotate({ identifier: "VoiceSessionResponse" }),
     error: [InvalidRequestError, ServiceUnavailableError, LocationNotFoundError],
 }).annotateMerge(OpenApi.annotations({
     identifier: "experimental.voice.session",
     summary: "Create voice session",
-    description: "Create a server-brokered voice session using the server's configured provider credentials and return the WebRTC SDP answer or WebSocket ephemeral token.",
+    description: "Create a server-brokered voice session using the server's configured provider credentials, or the connected OpenCode Console when it hosts the model, and return the WebRTC SDP answer or WebSocket ephemeral token.",
+})))
+    .add(HttpApiEndpoint.post("voice.instructions", "/api/experimental/voice/session/:sessionID/instructions", {
+    params: { sessionID: Schema.String },
+    payload: Schema.Struct({ instructions: Schema.String }),
+    success: HttpApiSchema.NoContent,
+    error: [InvalidRequestError, ServiceUnavailableError, LocationNotFoundError],
+}).annotateMerge(OpenApi.annotations({
+    identifier: "experimental.voice.instructions",
+    summary: "Replace voice session instructions",
+    description: "Replace the backend instructions of a running session the connected OpenCode Console hosts, whose data channel can't change them.",
 })))
     .annotateMerge(OpenApi.annotations({
     title: "voice",

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode/protocol",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -33,12 +33,12 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode/schema": "2.1.2",
+    "@opencode/schema": "2.1.3",
     "effect": "4.0.1"
   },
   "devDependencies": {
     "@tsconfig/bun": "1.0.9",
-    "@types/bun": "1.4.0",
+    "@types/bun": "1.4.3",
     "@typescript/native": "npm:typescript@7.0.2",
     "prettier": "3.6.2",
     "typescript": "npm:@typescript/typescript6@6.0.2"