@opencode-ai/server 0.0.0-dev-18198 → 0.0.0-dev-18202

package/dist/api.d.ts

@@ -4469,6 +4469,150 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
             ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
         };
     }>;
+}, import("effect/Schema").Struct<{
+    readonly id: import("effect/Schema").brand<import("effect/Schema").String, "Event.ID"> & {
+        create: () => string & import("effect/Brand").Brand<"Event.ID">;
+    };
+    readonly created: import("effect/Schema").Finite;
+    readonly metadata: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>>, import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>, never, never>;
+    readonly type: import("effect/Schema").Literal<"persistent-pty.added">;
+    readonly location: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").Struct<{
+        readonly directory: import("effect/Schema").brand<import("effect/Schema").String, "AbsolutePath">;
+        readonly workspaceID: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>>, import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>, never, never>;
+    }>>>, import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+        readonly directory: import("effect/Schema").brand<import("effect/Schema").String, "AbsolutePath">;
+        readonly workspaceID: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>>, import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>, never, never>;
+    }>>, never, never>;
+    readonly data: import("effect/Schema").Struct<{
+        readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+            create: () => string & import("effect/Brand").Brand<"SessionID">;
+            descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+        };
+        readonly terminal: import("effect/Schema").Struct<{
+            readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+                create: () => string & import("effect/Brand").Brand<"SessionID">;
+                descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+            };
+            readonly foregroundProcess: import("effect/Schema").NullOr<import("effect/Schema").String>;
+            readonly size: import("effect/Schema").Struct<{
+                readonly cols: import("effect/Schema").Int;
+                readonly rows: import("effect/Schema").Int;
+            }>;
+            readonly output: import("effect/Schema").Struct<{
+                readonly head: import("effect/Schema").Int;
+                readonly tail: import("effect/Schema").Int;
+            }>;
+            readonly id: import("effect/Schema").brand<import("effect/Schema").String, "PtyID"> & {
+                create: () => string & import("effect/Brand").Brand<"PtyID">;
+                ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+            };
+            readonly title: import("effect/Schema").String;
+            readonly command: import("effect/Schema").String;
+            readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
+            readonly cwd: import("effect/Schema").String;
+            readonly status: import("effect/Schema").Literals<readonly ["running", "exited"]>;
+            readonly pid: import("effect/Schema").Int;
+            readonly exitCode: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").Int>>, import("effect/Schema").optionalKey<import("effect/Schema").Int>, never, never>;
+        }>;
+    }>;
+}> & {
+    type: "persistent-pty.added";
+    durability: "ephemeral";
+    durable: undefined;
+    data: import("effect/Schema").Struct<{
+        readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+            create: () => string & import("effect/Brand").Brand<"SessionID">;
+            descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+        };
+        readonly terminal: import("effect/Schema").Struct<{
+            readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+                create: () => string & import("effect/Brand").Brand<"SessionID">;
+                descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+            };
+            readonly foregroundProcess: import("effect/Schema").NullOr<import("effect/Schema").String>;
+            readonly size: import("effect/Schema").Struct<{
+                readonly cols: import("effect/Schema").Int;
+                readonly rows: import("effect/Schema").Int;
+            }>;
+            readonly output: import("effect/Schema").Struct<{
+                readonly head: import("effect/Schema").Int;
+                readonly tail: import("effect/Schema").Int;
+            }>;
+            readonly id: import("effect/Schema").brand<import("effect/Schema").String, "PtyID"> & {
+                create: () => string & import("effect/Brand").Brand<"PtyID">;
+                ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+            };
+            readonly title: import("effect/Schema").String;
+            readonly command: import("effect/Schema").String;
+            readonly args: import("effect/Schema").$Array<import("effect/Schema").String>;
+            readonly cwd: import("effect/Schema").String;
+            readonly status: import("effect/Schema").Literals<readonly ["running", "exited"]>;
+            readonly pid: import("effect/Schema").Int;
+            readonly exitCode: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").Int>>, import("effect/Schema").optionalKey<import("effect/Schema").Int>, never, never>;
+        }>;
+    }>;
+}, import("effect/Schema").Struct<{
+    readonly id: import("effect/Schema").brand<import("effect/Schema").String, "Event.ID"> & {
+        create: () => string & import("effect/Brand").Brand<"Event.ID">;
+    };
+    readonly created: import("effect/Schema").Finite;
+    readonly metadata: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>>, import("effect/Schema").optionalKey<import("effect/Schema").$Record<import("effect/Schema").String, import("effect/Schema").Unknown>>, never, never>;
+    readonly type: import("effect/Schema").Literal<"persistent-pty.removed">;
+    readonly location: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").Struct<{
+        readonly directory: import("effect/Schema").brand<import("effect/Schema").String, "AbsolutePath">;
+        readonly workspaceID: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>>, import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>, never, never>;
+    }>>>, import("effect/Schema").optionalKey<import("effect/Schema").Struct<{
+        readonly directory: import("effect/Schema").brand<import("effect/Schema").String, "AbsolutePath">;
+        readonly workspaceID: import("effect/Schema").decodeTo<import("effect/Schema").optional<import("effect/Schema").toType<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>>, import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Workspace.ID"> & {
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"Workspace.ID">;
+            create: () => string & import("effect/Brand").Brand<"Workspace.ID">;
+        }>, never, never>;
+    }>>, never, never>;
+    readonly data: import("effect/Schema").Struct<{
+        readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+            create: () => string & import("effect/Brand").Brand<"SessionID">;
+            descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+        };
+        readonly ptyID: import("effect/Schema").brand<import("effect/Schema").String, "PtyID"> & {
+            create: () => string & import("effect/Brand").Brand<"PtyID">;
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+        };
+    }>;
+}> & {
+    type: "persistent-pty.removed";
+    durability: "ephemeral";
+    durable: undefined;
+    data: import("effect/Schema").Struct<{
+        readonly sessionID: import("effect/Schema").brand<import("effect/Schema").String, "SessionID"> & {
+            create: () => string & import("effect/Brand").Brand<"SessionID">;
+            descending: (id?: string) => string & import("effect/Brand").Brand<"SessionID">;
+        };
+        readonly ptyID: import("effect/Schema").brand<import("effect/Schema").String, "PtyID"> & {
+            create: () => string & import("effect/Brand").Brand<"PtyID">;
+            ascending: (id?: string) => string & import("effect/Brand").Brand<"PtyID">;
+        };
+    }>;
 }, import("effect/Schema").Struct<{
     readonly id: import("effect/Schema").brand<import("effect/Schema").String, "Event.ID"> & {
         create: () => string & import("effect/Brand").Brand<"Event.ID">;
@@ -7285,21 +7429,18 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
 } | {
     readonly id: string & import("effect/Brand").Brand<"Event.ID">;
     readonly data: {
-        readonly id: string & import("effect/Brand").Brand<"Plugin.ID">;
+        readonly info: {
+            readonly id: string & import("effect/Brand").Brand<"PtyID">;
+            readonly command: string;
+            readonly title: string;
+            readonly status: "running" | "exited";
+            readonly pid: number;
+            readonly cwd: string;
+            readonly args: readonly string[];
+            readonly exitCode?: number | undefined;
+        };
     };
-    readonly type: "plugin.added";
-    readonly created: number;
-    readonly location?: {
-        readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
-        readonly workspaceID?: (string & import("effect/Brand").Brand<"Workspace.ID">) | undefined;
-    } | undefined;
-    readonly metadata?: {
-        readonly [x: string]: unknown;
-    } | undefined;
-} | {
-    readonly id: string & import("effect/Brand").Brand<"Event.ID">;
-    readonly data: {};
-    readonly type: "plugin.updated";
+    readonly type: "pty.created";
     readonly created: number;
     readonly location?: {
         readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
@@ -7322,7 +7463,7 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
             readonly exitCode?: number | undefined;
         };
     };
-    readonly type: "pty.created";
+    readonly type: "pty.updated";
     readonly created: number;
     readonly location?: {
         readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
@@ -7334,18 +7475,58 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
 } | {
     readonly id: string & import("effect/Brand").Brand<"Event.ID">;
     readonly data: {
-        readonly info: {
+        readonly id: string & import("effect/Brand").Brand<"PtyID">;
+        readonly exitCode: number;
+    };
+    readonly type: "pty.exited";
+    readonly created: number;
+    readonly location?: {
+        readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
+        readonly workspaceID?: (string & import("effect/Brand").Brand<"Workspace.ID">) | undefined;
+    } | undefined;
+    readonly metadata?: {
+        readonly [x: string]: unknown;
+    } | undefined;
+} | {
+    readonly id: string & import("effect/Brand").Brand<"Event.ID">;
+    readonly data: {
+        readonly id: string & import("effect/Brand").Brand<"PtyID">;
+    };
+    readonly type: "pty.deleted";
+    readonly created: number;
+    readonly location?: {
+        readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
+        readonly workspaceID?: (string & import("effect/Brand").Brand<"Workspace.ID">) | undefined;
+    } | undefined;
+    readonly metadata?: {
+        readonly [x: string]: unknown;
+    } | undefined;
+} | {
+    readonly id: string & import("effect/Brand").Brand<"Event.ID">;
+    readonly data: {
+        readonly sessionID: string & import("effect/Brand").Brand<"SessionID">;
+        readonly terminal: {
             readonly id: string & import("effect/Brand").Brand<"PtyID">;
+            readonly size: {
+                readonly cols: number;
+                readonly rows: number;
+            };
+            readonly sessionID: string & import("effect/Brand").Brand<"SessionID">;
             readonly command: string;
             readonly title: string;
             readonly status: "running" | "exited";
+            readonly output: {
+                readonly head: number;
+                readonly tail: number;
+            };
             readonly pid: number;
             readonly cwd: string;
             readonly args: readonly string[];
+            readonly foregroundProcess: string | null;
             readonly exitCode?: number | undefined;
         };
     };
-    readonly type: "pty.updated";
+    readonly type: "persistent-pty.added";
     readonly created: number;
     readonly location?: {
         readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
@@ -7357,10 +7538,10 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
 } | {
     readonly id: string & import("effect/Brand").Brand<"Event.ID">;
     readonly data: {
-        readonly id: string & import("effect/Brand").Brand<"PtyID">;
-        readonly exitCode: number;
+        readonly sessionID: string & import("effect/Brand").Brand<"SessionID">;
+        readonly ptyID: string & import("effect/Brand").Brand<"PtyID">;
     };
-    readonly type: "pty.exited";
+    readonly type: "persistent-pty.removed";
     readonly created: number;
     readonly location?: {
         readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
@@ -7372,9 +7553,21 @@ export declare const Api: import("@opencode-ai/protocol/api").Api<LocationMiddle
 } | {
     readonly id: string & import("effect/Brand").Brand<"Event.ID">;
     readonly data: {
-        readonly id: string & import("effect/Brand").Brand<"PtyID">;
+        readonly id: string & import("effect/Brand").Brand<"Plugin.ID">;
     };
-    readonly type: "pty.deleted";
+    readonly type: "plugin.added";
+    readonly created: number;
+    readonly location?: {
+        readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;
+        readonly workspaceID?: (string & import("effect/Brand").Brand<"Workspace.ID">) | undefined;
+    } | undefined;
+    readonly metadata?: {
+        readonly [x: string]: unknown;
+    } | undefined;
+} | {
+    readonly id: string & import("effect/Brand").Brand<"Event.ID">;
+    readonly data: {};
+    readonly type: "plugin.updated";
     readonly created: number;
     readonly location?: {
         readonly directory: string & import("effect/Brand").Brand<"AbsolutePath">;

package/dist/handlers/persistent-pty.d.ts

@@ -0,0 +1,3 @@
+import { PersistentPty } from "@opencode-ai/core/persistent-pty";
+import { PtyTicket } from "@opencode-ai/core/pty/ticket";
+export declare const PersistentPtyHandler: import("effect/Layer").Layer<import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.experimental">, never, PtyTicket.Service | PersistentPty.Service | (import("@opencode-ai/protocol/middleware/schema-error").SchemaErrorMiddleware | import("@opencode-ai/protocol/middleware/authorization").Authorization)>;

package/dist/handlers/persistent-pty.js

@@ -0,0 +1,126 @@
+import { PersistentPty } from "@opencode-ai/core/persistent-pty";
+import { PtyTicket } from "@opencode-ai/core/pty/ticket";
+import { ForbiddenError, PtyNotFoundError, ServiceUnavailableError } from "@opencode-ai/protocol/errors";
+import {
+  PTY_CONNECT_TICKET_QUERY,
+  PTY_CONNECT_TOKEN_HEADER,
+  PTY_CONNECT_TOKEN_HEADER_VALUE
+} from "@opencode-ai/protocol/groups/persistent-pty";
+import { Effect, Queue, Semaphore } from "effect";
+import { HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
+import { HttpApiBuilder, HttpApiSchema } from "effect/unstable/httpapi";
+import { Socket } from "effect/unstable/socket";
+import { Api } from "../api";
+import { CorsConfig, isAllowedRequestOrigin } from "../cors";
+export const PersistentPtyHandler = HttpApiBuilder.group(Api, "server.experimental", (handlers) => Effect.gen(function* () {
+  const tickets = yield* PtyTicket.Service, cors = yield* CorsConfig, pty = yield* PersistentPty.Service;
+  return handlers.handle("persistentPty.list", Effect.fn(function* (ctx) {
+    return { data: yield* pty.list(ctx.params.sessionID).pipe(mapUnavailable) };
+  })).handle("persistentPty.create", Effect.fn(function* (ctx) {
+    return {
+      data: yield* pty.create(ctx.params.sessionID, {
+        command: ctx.payload.command,
+        args: ctx.payload.args,
+        cwd: ctx.payload.cwd,
+        title: ctx.payload.title,
+        env: ctx.payload.env,
+        cols: ctx.payload.size?.cols,
+        rows: ctx.payload.size?.rows
+      }).pipe(Effect.catchTag("PersistentPty.UnavailableError", unavailable))
+    };
+  })).handle("persistentPty.shutdown", Effect.fn(function* () {
+    yield* pty.shutdown().pipe(mapUnavailable);
+    return HttpApiSchema.NoContent.make();
+  })).handle("persistentPty.get", Effect.fn(function* (ctx) {
+    return { data: yield* pty.get(ctx.params.ptyID).pipe(mapTerminalError) };
+  })).handle("persistentPty.update", Effect.fn(function* (ctx) {
+    yield* pty.resize(ctx.params.ptyID, ctx.payload.size.cols, ctx.payload.size.rows, ctx.payload.attachmentID).pipe(mapTerminalError);
+    return { data: yield* pty.get(ctx.params.ptyID).pipe(mapTerminalError) };
+  })).handle("persistentPty.snapshot", Effect.fn(function* (ctx) {
+    return { data: yield* pty.snapshot(ctx.params.ptyID).pipe(mapTerminalError) };
+  })).handle("persistentPty.remove", Effect.fn(function* (ctx) {
+    yield* pty.remove(ctx.params.ptyID).pipe(mapTerminalError);
+    return HttpApiSchema.NoContent.make();
+  })).handle("persistentPty.connectToken", Effect.fn(function* (ctx) {
+    const request = yield* HttpServerRequest.HttpServerRequest;
+    if (request.headers[PTY_CONNECT_TOKEN_HEADER] !== PTY_CONNECT_TOKEN_HEADER_VALUE || !isAllowedRequestOrigin(request.headers.origin, request.headers.host, cors))
+      return yield* new ForbiddenError({ message: "Invalid persistent PTY connect token request" });
+    yield* pty.get(ctx.params.ptyID).pipe(mapTerminalError);
+    return { data: yield* tickets.issue({ ptyID: ctx.params.ptyID }) };
+  })).handleRaw("persistentPty.connect", Effect.fn("PersistentPtyHandler.connect")(function* (ctx) {
+    if (!(yield* pty.get(ctx.params.ptyID).pipe(Effect.as(!0), Effect.catchTag("PersistentPty.NotFoundError", () => Effect.succeed(!1)), Effect.catchTag("PersistentPty.UnavailableError", () => Effect.succeed(!1)))))
+      return HttpServerResponse.empty({ status: 404 });
+    const url = new URL(ctx.request.url, "http://localhost"), ticket = url.searchParams.get(PTY_CONNECT_TICKET_QUERY);
+    if (ticket) {
+      if (!(isAllowedRequestOrigin(ctx.request.headers.origin, ctx.request.headers.host, cors) ? yield* tickets.consume({ ticket, ptyID: ctx.params.ptyID }) : !1))
+        return HttpServerResponse.empty({ status: 403 });
+    }
+    const cursor = Number(url.searchParams.get("cursor") ?? "0"), role = url.searchParams.get("role") === "observer" ? "observer" : "controller", framedInput = url.searchParams.get("input_protocol") === "1", attachmentID = url.searchParams.get("attachment_id") ?? crypto.randomUUID();
+    if (!Number.isSafeInteger(cursor) || cursor < 0)
+      return HttpServerResponse.empty({ status: 400 });
+    const socket = yield* Effect.orDie(ctx.request.upgrade), write = yield* socket.writer, outbox = yield* Queue.unbounded(), input = yield* Semaphore.make(1), attachment = yield* pty.attach(ctx.params.ptyID, {
+      cursor,
+      attachmentID,
+      role,
+      takeover: url.searchParams.get("takeover") === "true",
+      onEvent: (event) => {
+        if (event.type === "output")
+          Queue.offerUnsafe(outbox, event.data);
+        if (event.type === "resized")
+          Queue.offerUnsafe(outbox, JSON.stringify({ ...event, checkpoint: Buffer.from(event.checkpoint).toString("base64") }));
+        if (event.type !== "output" && event.type !== "resized")
+          Queue.offerUnsafe(outbox, JSON.stringify(event));
+      },
+      onEnd: () => Queue.offerUnsafe(outbox, new Socket.CloseEvent(1000))
+    }).pipe(Effect.catchTags({
+      "PersistentPty.NotFoundError": () => Effect.succeed(void 0),
+      "PersistentPty.UnavailableError": () => Effect.succeed(void 0)
+    }));
+    if (!attachment)
+      return HttpServerResponse.empty({ status: 404 });
+    Queue.offerUnsafe(outbox, JSON.stringify({
+      type: "attached",
+      attachmentID,
+      inputProtocol: framedInput ? 1 : 0,
+      info: attachment.info,
+      role: attachment.role,
+      generation: attachment.generation,
+      replay: {
+        requestedOffset: attachment.replay.requestedOffset,
+        availableOffset: attachment.replay.availableOffset,
+        endOffset: attachment.replay.endOffset,
+        truncated: attachment.replay.truncated
+      }
+    }));
+    if (attachment.replay.data.length > 0)
+      Queue.offerUnsafe(outbox, attachment.replay.data);
+    Queue.offerUnsafe(outbox, JSON.stringify({ type: "replay_complete", endOffset: attachment.replay.endOffset }));
+    attachment.activate();
+    const drain = Effect.gen(function* () {
+      while (!0) {
+        const item = yield* Queue.take(outbox);
+        yield* write(item);
+        if (item instanceof Socket.CloseEvent)
+          return;
+      }
+    });
+    yield* Effect.race(drain, socket.runRaw((message) => input.withPermit(Effect.suspend(() => {
+      const data = typeof message === "string" ? Buffer.from(message) : message;
+      if (!framedInput)
+        return pty.input(ctx.params.ptyID, attachmentID, attachment.info.size.cols, attachment.info.size.rows, data).pipe(Effect.ignore);
+      if (data.byteLength < 5)
+        return Effect.void;
+      const view = new DataView(data.buffer, data.byteOffset, data.byteLength), type = data[0], cols = view.getUint16(1), rows = view.getUint16(3);
+      if (type !== 0 && type !== 1 || cols === 0 || rows === 0)
+        return Effect.void;
+      if (type === 0)
+        return pty.control(ctx.params.ptyID, attachmentID, cols, rows).pipe(Effect.ignore);
+      return pty.input(ctx.params.ptyID, attachmentID, cols, rows, data.subarray(5)).pipe(Effect.ignore);
+    })))).pipe(Effect.catchReason("SocketError", "SocketCloseError", () => Effect.void), Effect.ensuring(Effect.sync(() => attachment.detach())), Effect.orDie);
+    return HttpServerResponse.empty();
+  }));
+}));
+const mapUnavailable = (effect) => effect.pipe(Effect.catchTag("PersistentPty.UnavailableError", unavailable)), mapTerminalError = (effect) => effect.pipe(Effect.catchTags({
+  "PersistentPty.NotFoundError": (error) => new PtyNotFoundError({ ptyID: error.ptyID, message: `PTY session not found: ${error.ptyID}` }),
+  "PersistentPty.UnavailableError": unavailable
+})), unavailable = (error) => new ServiceUnavailableError({ message: error.message, service: "opencode-pty" });

package/dist/handlers.d.ts

@@ -1,2 +1,2 @@
 import { Layer } from "effect";
-export declare const handlers: Layer.Layer<import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.generate"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.message"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.model"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.provider"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.session"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.permission"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.fs"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.form"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.command"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.skill"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.event"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.agent"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.plugin"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.health"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.server"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.debug"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.pty"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.shell"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.reference"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.location"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.integration"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.websearch"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.mcp"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.credential"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.project"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.worktree"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.vcs"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.migration"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.config"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.workspace">, never, import("@opencode-ai/protocol/middleware/schema-error").SchemaErrorMiddleware | import("@opencode-ai/protocol/middleware/authorization").Authorization | import("@opencode-ai/util/global").Service | import("@opencode-ai/core/bus").Service | import("@opencode-ai/core/workspace").Service | import("@opencode-ai/core/location-service-map").Service | import("@opencode-ai/core/worktree").Service | import("@opencode-ai/core/session").Service | import("./location").LocationMiddleware | import("./middleware/form-location").FormLocationMiddleware | import("./middleware/session-location").SessionLocationMiddleware | import("@opencode-ai/core/pty/ticket").Service | import("@opencode-ai/core/session/transfer").Service | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/database/database").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/permission/saved").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("./server-info").Service> | import("./pty-environment").Service | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/wellknown").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/project").Service>>;
+export declare const handlers: Layer.Layer<import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.generate"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.message"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.model"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.provider"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.session"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.permission"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.fs"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.form"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.command"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.skill"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.event"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.agent"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.plugin"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.health"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.server"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.debug"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.pty"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.experimental"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.shell"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.reference"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.location"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.integration"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.websearch"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.mcp"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.credential"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.project"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.worktree"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.vcs"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.migration"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.config"> | import("effect/unstable/httpapi/HttpApiGroup").Service<"server", "server.workspace">, never, import("@opencode-ai/protocol/middleware/schema-error").SchemaErrorMiddleware | import("@opencode-ai/protocol/middleware/authorization").Authorization | import("@opencode-ai/util/global").Service | import("@opencode-ai/core/bus").Service | import("@opencode-ai/core/workspace").Service | import("@opencode-ai/core/location-service-map").Service | import("@opencode-ai/core/worktree").Service | import("@opencode-ai/core/session").Service | import("./location").LocationMiddleware | import("./middleware/form-location").FormLocationMiddleware | import("./middleware/session-location").SessionLocationMiddleware | import("@opencode-ai/core/pty/ticket").Service | import("@opencode-ai/core/persistent-pty/index").Service | import("@opencode-ai/core/session/transfer").Service | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/database/database").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/permission/saved").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("./server-info").Service> | import("./pty-environment").Service | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/wellknown").Service> | import("effect/unstable/http/HttpRouter").Request<"Requires", import("@opencode-ai/core/project").Service>>;

package/dist/handlers.js

@@ -16,6 +16,7 @@ import { HealthHandler } from "./handlers/health";
 import { ServerHandler } from "./handlers/server";
 import { DebugHandler } from "./handlers/debug";
 import { PtyHandler } from "./handlers/pty";
+import { PersistentPtyHandler } from "./handlers/persistent-pty";
 import { ShellHandler } from "./handlers/shell";
 import { ReferenceHandler } from "./handlers/reference";
 import { LocationHandler } from "./handlers/location";
@@ -30,4 +31,4 @@ import { EventFeed } from "./event-feed";
 import { MigrationHandler } from "./handlers/migration";
 import { ConfigHandler } from "./handlers/config";
 import { WorkspaceHandler } from "./handlers/workspace";
-export const handlers = Layer.mergeAll(HealthHandler, ServerHandler, DebugHandler, MigrationHandler, LocationHandler, AgentHandler, PluginHandler, SessionHandler, MessageHandler, ModelHandler, GenerateHandler, ProviderHandler, IntegrationHandler, WebSearchHandler, McpHandler, CredentialHandler, ProjectHandler, FormHandler, PermissionHandler, FileSystemHandler, CommandHandler, SkillHandler, EventHandler.pipe(Layer.provide(EventFeed.layer)), PtyHandler, ShellHandler, ReferenceHandler, WorktreeHandler, WorkspaceHandler, VcsHandler, ConfigHandler);
+export const handlers = Layer.mergeAll(HealthHandler, ServerHandler, DebugHandler, MigrationHandler, LocationHandler, AgentHandler, PluginHandler, SessionHandler, MessageHandler, ModelHandler, GenerateHandler, ProviderHandler, IntegrationHandler, WebSearchHandler, McpHandler, CredentialHandler, ProjectHandler, FormHandler, PermissionHandler, FileSystemHandler, CommandHandler, SkillHandler, EventHandler.pipe(Layer.provide(EventFeed.layer)), PtyHandler, PersistentPtyHandler, ShellHandler, ReferenceHandler, WorktreeHandler, WorkspaceHandler, VcsHandler, ConfigHandler);

package/dist/middleware/authorization.js

@@ -3,6 +3,7 @@ import { UnauthorizedError } from "@opencode-ai/protocol/errors";
 import { Authorization } from "@opencode-ai/protocol/middleware/authorization";
 export { Authorization } from "@opencode-ai/protocol/middleware/authorization";
 import { hasPtyConnectTicketURL } from "@opencode-ai/protocol/groups/pty";
+import { hasPersistentPtyConnectTicketURL } from "@opencode-ai/protocol/groups/persistent-pty";
 import { Effect, Encoding, Layer, Redacted } from "effect";
 import { HttpEffect, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 const AUTH_TOKEN_QUERY = "auth_token", WWW_AUTHENTICATE = 'Basic realm="Secure Area"';
@@ -37,8 +38,8 @@ export const authorizationLayer = Layer.effect(Authorization, Effect.gen(functio
   if (!ServerAuth.required(config))
     return Authorization.of((effect) => effect);
   return Authorization.of((effect) => Effect.gen(function* () {
-    const request = yield* HttpServerRequest.HttpServerRequest;
-    if (hasPtyConnectTicketURL(new URL(request.url, "http://localhost")))
+    const request = yield* HttpServerRequest.HttpServerRequest, url = new URL(request.url, "http://localhost");
+    if (hasPtyConnectTicketURL(url) || hasPersistentPtyConnectTicketURL(url))
       return yield* effect;
     if (yield* authorizedRequest(request, config))
       return yield* effect;

package/dist/process.js

@@ -2,6 +2,7 @@ export * as ServerProcess from "./process";
 import { NodeHttpServer } from "@effect/platform-node";
 import { SessionRestart } from "@opencode-ai/core/session/execution/restart";
 import { hasPtyConnectTicketURL } from "@opencode-ai/protocol/groups/pty";
+import { hasPersistentPtyConnectTicketURL } from "@opencode-ai/protocol/groups/persistent-pty";
 import { Cause, Context, Effect, Exit, Latch, Layer, Option, Ref, Scope } from "effect";
 import {
   HttpMiddleware,
@@ -88,7 +89,7 @@ function dispatch(password, status, application, version) {
       return yield* healthResponse(status, version);
     }
     const state = yield* status.current, app = yield* Ref.get(application), ready = state.type === "ready" && Option.isSome(app);
-    if ((!ready || !hasPtyConnectTicketURL(url)) && !(yield* authorizedRequest(request, auth)))
+    if ((!ready || !hasPtyConnectTicketURL(url) && !hasPersistentPtyConnectTicketURL(url)) && !(yield* authorizedRequest(request, auth)))
       return unauthorized();
     if (ready)
       return yield* app.value;

package/dist/routes.d.ts

@@ -4,6 +4,7 @@ import { Bus } from "@opencode-ai/core/bus";
 import { Credential } from "@opencode-ai/core/credential";
 import { PermissionSaved } from "@opencode-ai/core/permission/saved";
 import { PtyTicket } from "@opencode-ai/core/pty/ticket";
+import { PersistentPty } from "@opencode-ai/core/persistent-pty";
 import { Project } from "@opencode-ai/core/project";
 import { Session } from "@opencode-ai/core/session";
 import { SessionTransfer } from "@opencode-ai/core/session/transfer";
@@ -20,5 +21,5 @@ import { HttpRouter } from "effect/unstable/http";
 import { Layer } from "effect";
 import { PtyEnvironment } from "./pty-environment";
 import type { ServerOptions } from "./options";
-export declare function createRoutes(options?: ServerOptions, serviceURLs?: () => ReadonlyArray<string>, overrides?: LayerNode.Replacements): Layer.Layer<Global.Service | Database.Service | Bus.Service | import("effect/unstable/http/HttpClient").HttpClient | Project.Service | Credential.Service | WellKnown.Service | Workspace.Service | Job.Service | LocationServiceMap.Service | SdkPlugins.Service | PermissionSaved.Service | Worktree.Service | Session.Service | SessionRestart.Service | PtyTicket.Service | SessionTransfer.Service | LocationActivity.Service | PtyEnvironment.Service | HttpRouter.HttpRouter, Error, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/unstable/http/Etag").Generator | import("effect/unstable/http/HttpPlatform").HttpPlatform>;
-export declare function createEmbeddedRoutes(options?: ServerOptions, overrides?: LayerNode.Replacements): Layer.Layer<Global.Service | Database.Service | Bus.Service | import("effect/unstable/http/HttpClient").HttpClient | Project.Service | Credential.Service | WellKnown.Service | Workspace.Service | Job.Service | LocationServiceMap.Service | SdkPlugins.Service | PermissionSaved.Service | Worktree.Service | Session.Service | SessionRestart.Service | PtyTicket.Service | SessionTransfer.Service | LocationActivity.Service | PtyEnvironment.Service | HttpRouter.HttpRouter, Error, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/unstable/http/Etag").Generator | import("effect/unstable/http/HttpPlatform").HttpPlatform>;
+export declare function createRoutes(options?: ServerOptions, serviceURLs?: () => ReadonlyArray<string>, overrides?: LayerNode.Replacements): Layer.Layer<Global.Service | Database.Service | Bus.Service | import("effect/unstable/http/HttpClient").HttpClient | Project.Service | Credential.Service | WellKnown.Service | Workspace.Service | Job.Service | LocationServiceMap.Service | SdkPlugins.Service | PermissionSaved.Service | Worktree.Service | Session.Service | SessionRestart.Service | PtyTicket.Service | PersistentPty.Service | SessionTransfer.Service | LocationActivity.Service | PtyEnvironment.Service | HttpRouter.HttpRouter, Error, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/unstable/http/Etag").Generator | import("effect/unstable/http/HttpPlatform").HttpPlatform>;
+export declare function createEmbeddedRoutes(options?: ServerOptions, overrides?: LayerNode.Replacements): Layer.Layer<Global.Service | Database.Service | Bus.Service | import("effect/unstable/http/HttpClient").HttpClient | Project.Service | Credential.Service | WellKnown.Service | Workspace.Service | Job.Service | LocationServiceMap.Service | SdkPlugins.Service | PermissionSaved.Service | Worktree.Service | Session.Service | SessionRestart.Service | PtyTicket.Service | PersistentPty.Service | SessionTransfer.Service | LocationActivity.Service | PtyEnvironment.Service | HttpRouter.HttpRouter, Error, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/unstable/http/Etag").Generator | import("effect/unstable/http/HttpPlatform").HttpPlatform>;

package/dist/routes.js

@@ -11,6 +11,7 @@ import { Credential } from "@opencode-ai/core/credential";
 import { Config } from "@opencode-ai/core/config";
 import { PermissionSaved } from "@opencode-ai/core/permission/saved";
 import { PtyTicket } from "@opencode-ai/core/pty/ticket";
+import { PersistentPty } from "@opencode-ai/core/persistent-pty";
 import { Project } from "@opencode-ai/core/project";
 import { Session } from "@opencode-ai/core/session";
 import { SessionTransfer } from "@opencode-ai/core/session/transfer";
@@ -57,6 +58,7 @@ const applicationServiceNodes = [
   SdkPlugins.node,
   PermissionSaved.node,
   PtyTicket.node,
+  PersistentPty.node,
   Credential.node,
   WellKnown.node,
   PtyEnvironment.node,

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode-ai/server",
-  "version": "0.0.0-dev-18198",
+  "version": "0.0.0-dev-18202",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -29,11 +29,11 @@
   },
   "dependencies": {
     "@effect/platform-node": "4.0.0-rc.111",
-    "@opencode-ai/core": "0.0.0-dev-18198",
-    "@opencode-ai/protocol": "0.0.0-dev-18198",
-    "@opencode-ai/schema": "0.0.0-dev-18198",
-    "@opencode-ai/simulation": "0.0.0-dev-18198",
-    "@opencode-ai/util": "0.0.0-dev-18198",
+    "@opencode-ai/core": "0.0.0-dev-18202",
+    "@opencode-ai/protocol": "0.0.0-dev-18202",
+    "@opencode-ai/schema": "0.0.0-dev-18202",
+    "@opencode-ai/simulation": "0.0.0-dev-18202",
+    "@opencode-ai/util": "0.0.0-dev-18202",
     "drizzle-orm": "1.0.0-rc.5-169397b",
     "effect": "4.0.0-rc.111"
   },