@opencode-ai/protocol 0.0.0-dev-18560 → 0.0.0-dev-18562

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

@@ -4,7 +4,33 @@ import { ForbiddenError, InvalidRequestError, PtyNotFoundError, ServiceUnavailab
 import { PTY_CONNECT_TICKET_QUERY, PTY_CONNECT_TOKEN_HEADER, PTY_CONNECT_TOKEN_HEADER_VALUE } from "./pty.js";
 export { PTY_CONNECT_TICKET_QUERY, PTY_CONNECT_TOKEN_HEADER, PTY_CONNECT_TOKEN_HEADER_VALUE };
 export declare function hasPersistentPtyConnectTicketURL(url: URL): boolean;
-export declare const PersistentPtyGroup: HttpApiGroup.HttpApiGroup<"server.experimental", HttpApiEndpoint.HttpApiEndpoint<"persistentPty.list", "GET", "/api/experimental/session/:sessionID/terminal", Schema.toCodecStringTree<Schema.Struct<{
+export declare const PersistentPtyGroup: HttpApiGroup.HttpApiGroup<"server.experimental", HttpApiEndpoint.HttpApiEndpoint<"persistentPty.read", "GET", "/api/experimental/session/:sessionID/terminal/read", 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">;
+    };
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    lines: Schema.optional<Schema.compose<Schema.Int, Schema.NumberFromString>>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly data: Schema.NullOr<Schema.Struct<{
+        readonly ptyID: 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 cwd: Schema.String;
+        readonly foregroundProcess: Schema.NullOr<Schema.String>;
+        readonly screen: Schema.Struct<{
+            readonly text: Schema.String;
+            readonly cols: Schema.Int;
+            readonly rows: Schema.Int;
+            readonly cursor: Schema.Struct<{
+                readonly x: Schema.Int;
+                readonly y: Schema.Int;
+            }>;
+        }>;
+    }>>;
+}>>, Schema.toCodecJson<typeof ServiceUnavailableError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"persistentPty.list", "GET", "/api/experimental/session/:sessionID/terminal", 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/persistent-pty.js

@@ -14,6 +14,17 @@ export function hasPersistentPtyConnectTicketURL(url) {
 const errors = [InvalidRequestError, ServiceUnavailableError];
 const terminalErrors = [PtyNotFoundError, ServiceUnavailableError];
 export const PersistentPtyGroup = HttpApiGroup.make("server.experimental")
+    .add(HttpApiEndpoint.get("persistentPty.read", "/api/experimental/session/:sessionID/terminal/read", {
+    params: { sessionID: Session.ID },
+    query: {
+        lines: Schema.NumberFromString.pipe(Schema.decodeTo(PersistentPty.ReadLines), Schema.optional),
+    },
+    success: Schema.Struct({ data: Schema.NullOr(PersistentPty.ReadResult) }),
+    error: [ServiceUnavailableError],
+}).annotateMerge(OpenApi.annotations({
+    summary: "Read the session's most recently controlled terminal",
+    description: "Read the last physical rows without changing selection or taking control. Omitted lines uses the live terminal height; larger counts include retained history. Blank rows are preserved. Screen dimensions and cursor remain relative to the live screen. Returns null when no current terminal exists. Selection is server-local and resets on restart. Experimental: may change without compatibility guarantees.",
+})))
     .add(HttpApiEndpoint.get("persistentPty.list", "/api/experimental/session/:sessionID/terminal", {
     params: { sessionID: Session.ID },
     success: Schema.Struct({ data: Schema.Array(PersistentPty.Info) }),

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode-ai/protocol",
-  "version": "0.0.0-dev-18560",
+  "version": "0.0.0-dev-18562",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -32,7 +32,7 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/schema": "0.0.0-dev-18560",
+    "@opencode-ai/schema": "0.0.0-dev-18562",
     "effect": "4.0.0-rc.112"
   },
   "devDependencies": {