@sealant/sdk 0.20.0 → 0.21.0

package/dist/effect/api-client.d.ts

@@ -758,6 +758,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -783,6 +784,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                 readonly cols?: number | undefined;
                 readonly rows?: number | undefined;
                 readonly term?: string | undefined;
+                readonly mode?: "pipe" | "pty" | undefined;
                 readonly metadata?: {
                     readonly [x: string]: unknown;
                 } | undefined;
@@ -798,6 +800,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -829,6 +832,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -883,6 +887,7 @@ declare const buildControlPlaneClient: (config: SealantInternalConfig) => Effect
                 readonly cwd?: string | undefined;
                 readonly cols: number;
                 readonly rows: number;
+                readonly mode?: "pipe" | "pty" | undefined;
                 readonly exitCode?: number | undefined;
                 readonly exitSignal?: number | undefined;
                 readonly errorMessage?: string | undefined;
@@ -2079,6 +2084,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -2104,6 +2110,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                 readonly cols?: number | undefined;
                 readonly rows?: number | undefined;
                 readonly term?: string | undefined;
+                readonly mode?: "pipe" | "pty" | undefined;
                 readonly metadata?: {
                     readonly [x: string]: unknown;
                 } | undefined;
@@ -2119,6 +2126,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -2150,6 +2158,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
             readonly cwd?: string | undefined;
             readonly cols: number;
             readonly rows: number;
+            readonly mode?: "pipe" | "pty" | undefined;
             readonly exitCode?: number | undefined;
             readonly exitSignal?: number | undefined;
             readonly errorMessage?: string | undefined;
@@ -2204,6 +2213,7 @@ declare const SealantApiClient_base: Context.ServiceClass<SealantApiClient, "@se
                 readonly cwd?: string | undefined;
                 readonly cols: number;
                 readonly rows: number;
+                readonly mode?: "pipe" | "pty" | undefined;
                 readonly exitCode?: number | undefined;
                 readonly exitSignal?: number | undefined;
                 readonly errorMessage?: string | undefined;

package/dist/effect/operations.d.ts

@@ -345,6 +345,7 @@ export declare const createSessionOp: (payload: {
     readonly cols?: number | undefined;
     readonly rows?: number | undefined;
     readonly term?: string | undefined;
+    readonly mode?: "pipe" | "pty" | undefined;
     readonly metadata?: {
         readonly [x: string]: unknown;
     } | undefined;
@@ -358,6 +359,7 @@ export declare const createSessionOp: (payload: {
     readonly cwd?: string | undefined;
     readonly cols: number;
     readonly rows: number;
+    readonly mode?: "pipe" | "pty" | undefined;
     readonly exitCode?: number | undefined;
     readonly exitSignal?: number | undefined;
     readonly errorMessage?: string | undefined;
@@ -378,6 +380,7 @@ export declare const getSessionOp: (sessionId: string, ownerUserId?: string | un
     readonly cwd?: string | undefined;
     readonly cols: number;
     readonly rows: number;
+    readonly mode?: "pipe" | "pty" | undefined;
     readonly exitCode?: number | undefined;
     readonly exitSignal?: number | undefined;
     readonly errorMessage?: string | undefined;
@@ -404,6 +407,7 @@ export declare const listSessionsOp: (query: {
         readonly cwd?: string | undefined;
         readonly cols: number;
         readonly rows: number;
+        readonly mode?: "pipe" | "pty" | undefined;
         readonly exitCode?: number | undefined;
         readonly exitSignal?: number | undefined;
         readonly errorMessage?: string | undefined;
@@ -459,6 +463,7 @@ export declare const closeSessionOp: (sessionId: string, payload: {
     readonly cwd?: string | undefined;
     readonly cols: number;
     readonly rows: number;
+    readonly mode?: "pipe" | "pty" | undefined;
     readonly exitCode?: number | undefined;
     readonly exitSignal?: number | undefined;
     readonly errorMessage?: string | undefined;

package/dist/facade/session.d.ts

@@ -10,6 +10,7 @@ export declare const makeInteractiveSession: (ctx: SdkContext, wire: {
     readonly cwd?: string | undefined;
     readonly cols: number;
     readonly rows: number;
+    readonly mode?: "pipe" | "pty" | undefined;
     readonly exitCode?: number | undefined;
     readonly exitSignal?: number | undefined;
     readonly errorMessage?: string | undefined;

package/dist/facade/session.js

@@ -202,6 +202,7 @@ export const makeInteractiveSession = (ctx, wire) => {
         id: sessionId,
         workspaceId: wire.workspaceId,
         runId: wire.runId,
+        mode: wire.mode ?? "pty",
         send: async (input) => {
             const bytes = typeof input === "string" ? new TextEncoder().encode(input) : input;
             await ctx.runtime.run(sendSessionInputOp(sessionId, {

package/dist/facade/workspace.js

@@ -34,6 +34,7 @@ export const makeWorkspace = (ctx, init) => {
             ...(options?.cols === undefined ? {} : { cols: options.cols }),
             ...(options?.rows === undefined ? {} : { rows: options.rows }),
             ...(options?.term === undefined ? {} : { term: options.term }),
+            ...(options?.mode === undefined ? {} : { mode: options.mode }),
             ...(options?.metadata === undefined ? {} : { metadata: { ...options.metadata } }),
         }));
         return makeInteractiveSession(ctx, created);

package/dist/types.d.ts

@@ -367,14 +367,24 @@ export interface RunOptions {
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
 /** Options for opening an interactive PTY session. */
+/**
+ * How a session's leader is wired. `pty` (default) allocates a pseudoterminal — interactive
+ * shells and TUIs. `pipe` gives the leader plain stdio pipes and no tty — the shape for processes
+ * that speak a byte protocol over stdin/stdout (JSON-RPC / NDJSON servers such as
+ * `codex app-server`): `send` feeds stdin, `output`/`attach` carry stdout byte-exact, stderr is
+ * recorded as diagnostics only, and `resize` is rejected.
+ */
+export type SessionMode = "pty" | "pipe";
 export interface SessionOptions {
     /** Working directory inside the workspace (defaults to the repository root). */
     readonly cwd?: string;
-    /** Extra environment for the PTY process (not for secrets — use `credentials`). */
+    /** Extra environment for the session process (not for secrets — use `credentials`). */
     readonly env?: Readonly<Record<string, string>>;
     readonly cols?: number;
     readonly rows?: number;
     readonly term?: string;
+    /** Leader wiring; defaults to `pty`. `cols`/`rows`/`term` are ignored for `pipe`. */
+    readonly mode?: SessionMode;
     /** Opaque correlation bag, stored verbatim and echoed on reads. */
     readonly metadata?: Readonly<Record<string, unknown>>;
 }
@@ -705,7 +715,9 @@ export interface InteractiveSession {
     readonly workspaceId: string;
     /** The run recording this session — its record is the durable, replayable evidence. */
     readonly runId: string;
-    /** Send keystrokes. Strings are UTF-8-encoded; bytes pass through untouched. */
+    /** Leader wiring: a pseudoterminal or plain stdio pipes. */
+    readonly mode: SessionMode;
+    /** Send input: keystrokes to a PTY, bytes to a pipe leader's stdin. Strings are UTF-8-encoded. */
     send(input: string | Uint8Array): Promise<void>;
     /**
      * Byte-exact output as a RESUMABLE stream: recorded history from `from` (inclusive; default the
@@ -716,7 +728,7 @@ export interface InteractiveSession {
         readonly from?: bigint;
         readonly signal?: AbortSignal;
     }): AsyncIterable<SessionOutputChunk>;
-    /** Resize the PTY. */
+    /** Resize the PTY. Rejected for `pipe` sessions, which have no terminal. */
     resize(cols: number, rows: number): Promise<void>;
     /** Deliver a POSIX signal to the session's process (e.g. 2 = SIGINT). */
     signal(signal: number): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sealant/sdk",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "The fluent public SDK for Sealant — create a workspace, run a harness, replay the record.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@sealant/api-contracts": "^0.20.0"
+    "@sealant/api-contracts": "^0.21.0"
   },
   "devDependencies": {
     "@effect/vitest": "4.0.0-beta.85",