@vibesdotdev/terminal-client 0.0.0-stage → 1.0.0-rc.3

package/dist/schemas/terminal.d.ts

@@ -0,0 +1,296 @@
+/**
+ * Terminal Unified Tool Schemas
+ *
+ * Discriminated union (on `action`) for interactive PTY terminal control.
+ * Single source of truth: consumed by both the descriptor and the impl.
+ */
+import z from 'zod/v4';
+export declare const TerminalActions: readonly ["execute", "spawn", "session", "open", "list", "read", "write", "resize", "close", "wait", "capabilities"];
+export type TerminalAction = (typeof TerminalActions)[number];
+/** One-shot buffered execute() — not a PTY. */
+declare const executeAction: z.ZodObject<{
+    action: z.ZodLiteral<"execute">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Long-lived non-PTY spawn() — pipes, procId. */
+declare const spawnAction: z.ZodObject<{
+    action: z.ZodLiteral<"spawn">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    present: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Interactive PTY session() — the verb for a user-visible tty. */
+declare const sessionAction: z.ZodObject<{
+    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    cols: z.ZodDefault<z.ZodNumber>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    present: z.ZodOptional<z.ZodBoolean>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    action: z.ZodLiteral<"session">;
+}, z.core.$strip>;
+/** Alias of `session` (existing callers). */
+declare const openAction: z.ZodObject<{
+    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    cols: z.ZodDefault<z.ZodNumber>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    present: z.ZodOptional<z.ZodBoolean>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    action: z.ZodLiteral<"open">;
+}, z.core.$strip>;
+/**
+ * Read recent output from a session. Reuses the session backlog ring; pass the
+ * `cursor` returned by a prior read to get only newer output (incremental).
+ */
+declare const readAction: z.ZodObject<{
+    action: z.ZodLiteral<"read">;
+    sessionId: z.ZodString;
+    since: z.ZodOptional<z.ZodNumber>;
+    stripAnsi: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * Write to a session. `text` is sent verbatim; `keys` are named keys/chords
+ * (e.g. "Enter", "ArrowUp", "ctrl+c") resolved to byte sequences. `enter`
+ * appends a carriage return — defaults true with `text`, false with only `keys`.
+ */
+declare const writeAction: z.ZodObject<{
+    action: z.ZodLiteral<"write">;
+    sessionId: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enter: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Resize a session's PTY. */
+declare const resizeAction: z.ZodObject<{
+    action: z.ZodLiteral<"resize">;
+    sessionId: z.ZodString;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strip>;
+/** Close (kill, not detach) a session. */
+declare const closeAction: z.ZodObject<{
+    action: z.ZodLiteral<"close">;
+    sessionId: z.ZodString;
+}, z.core.$strip>;
+/** Wait for exit without killing a still-running session at the deadline. */
+declare const waitAction: z.ZodObject<{
+    action: z.ZodLiteral<"wait">;
+    sessionId: z.ZodString;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    since: z.ZodOptional<z.ZodNumber>;
+    stripAnsi: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export declare const TerminalInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"execute">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"spawn">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    present: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    cols: z.ZodDefault<z.ZodNumber>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    present: z.ZodOptional<z.ZodBoolean>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    action: z.ZodLiteral<"session">;
+}, z.core.$strip>, z.ZodObject<{
+    command: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    cols: z.ZodDefault<z.ZodNumber>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    present: z.ZodOptional<z.ZodBoolean>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    action: z.ZodLiteral<"open">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"read">;
+    sessionId: z.ZodString;
+    since: z.ZodOptional<z.ZodNumber>;
+    stripAnsi: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"write">;
+    sessionId: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enter: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"resize">;
+    sessionId: z.ZodString;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"close">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"wait">;
+    sessionId: z.ZodString;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    since: z.ZodOptional<z.ZodNumber>;
+    stripAnsi: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"capabilities">;
+}, z.core.$strip>], "action">;
+export type TerminalInput = z.infer<typeof TerminalInputSchema>;
+/** Session summary returned by `list`. */
+export declare const TerminalSessionInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    command: z.ZodString;
+    createdAt: z.ZodNumber;
+    status: z.ZodEnum<{
+        exited: "exited";
+        running: "running";
+    }>;
+}, z.core.$strip>;
+export type TerminalSessionInfo = z.infer<typeof TerminalSessionInfoSchema>;
+export declare const TerminalOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    capabilities: z.ZodObject<{
+        pty: z.ZodBoolean;
+        shell: z.ZodBoolean;
+        signals: z.ZodBoolean;
+        resize: z.ZodBoolean;
+        maxSessions: z.ZodNumber;
+    }, z.core.$strict>;
+    executionId: z.ZodString;
+    environmentId: z.ZodString;
+    pty: z.ZodBoolean;
+    shell: z.ZodBoolean;
+    action: z.ZodLiteral<"capabilities">;
+}, z.core.$strict>, z.ZodObject<{
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    durationMs: z.ZodNumber;
+    timedOut: z.ZodBoolean;
+    executionId: z.ZodString;
+    environmentId: z.ZodString;
+    pty: z.ZodBoolean;
+    shell: z.ZodBoolean;
+    action: z.ZodLiteral<"execute">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    procId: z.ZodString;
+    running: z.ZodBoolean;
+    present: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"terminal">;
+        sessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"log">;
+        procId: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    executionId: z.ZodString;
+    environmentId: z.ZodString;
+    pty: z.ZodBoolean;
+    shell: z.ZodBoolean;
+    action: z.ZodLiteral<"spawn">;
+    command: z.ZodArray<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    capabilities: z.ZodObject<{
+        pty: z.ZodBoolean;
+        shell: z.ZodBoolean;
+        signals: z.ZodBoolean;
+        resize: z.ZodBoolean;
+        maxSessions: z.ZodNumber;
+    }, z.core.$strict>;
+    present: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"terminal">;
+        sessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"log">;
+        procId: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    executionId: z.ZodString;
+    environmentId: z.ZodString;
+    pty: z.ZodBoolean;
+    shell: z.ZodBoolean;
+    sessionId: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    action: z.ZodLiteral<"session">;
+}, z.core.$strict>, z.ZodObject<{
+    capabilities: z.ZodObject<{
+        pty: z.ZodBoolean;
+        shell: z.ZodBoolean;
+        signals: z.ZodBoolean;
+        resize: z.ZodBoolean;
+        maxSessions: z.ZodNumber;
+    }, z.core.$strict>;
+    present: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"terminal">;
+        sessionId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"log">;
+        procId: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    executionId: z.ZodString;
+    environmentId: z.ZodString;
+    pty: z.ZodBoolean;
+    shell: z.ZodBoolean;
+    sessionId: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    action: z.ZodLiteral<"open">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        command: z.ZodString;
+        createdAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            exited: "exited";
+            running: "running";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"read">;
+    sessionId: z.ZodString;
+    output: z.ZodString;
+    cursor: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"write">;
+    sessionId: z.ZodString;
+    bytesWritten: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"resize">;
+    sessionId: z.ZodString;
+    resized: z.ZodLiteral<true>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"close">;
+    sessionId: z.ZodString;
+    closed: z.ZodLiteral<true>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"wait">;
+    sessionId: z.ZodString;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    timedOut: z.ZodBoolean;
+    output: z.ZodString;
+    cursor: z.ZodNumber;
+}, z.core.$strict>], "action">;
+export type TerminalOutput = z.infer<typeof TerminalOutputSchema>;
+export type TerminalOpenInput = z.infer<typeof openAction>;
+export type TerminalReadInput = z.infer<typeof readAction>;
+export type TerminalWriteInput = z.infer<typeof writeAction>;
+export type TerminalResizeInput = z.infer<typeof resizeAction>;
+export type TerminalCloseInput = z.infer<typeof closeAction>;
+export type TerminalWaitInput = z.infer<typeof waitAction>;
+export type TerminalExecuteInput = z.infer<typeof executeAction>;
+export type TerminalSpawnInput = z.infer<typeof spawnAction>;
+export type TerminalSessionOpenInput = z.infer<typeof sessionAction>;
+export {};
+//# sourceMappingURL=terminal.d.ts.map

package/dist/schemas/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/schemas/terminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAMvB,eAAO,MAAM,eAAe,sHAYlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAO9D,+CAA+C;AAC/C,QAAA,MAAM,aAAa;;;;;;iBAMjB,CAAC;AAEH,kDAAkD;AAClD,QAAA,MAAM,WAAW;;;;;;iBASf,CAAC;AAgBH,mEAAmE;AACnE,QAAA,MAAM,aAAa;;;;;;;;;iBAGjB,CAAC;AAEH,6CAA6C;AAC7C,QAAA,MAAM,UAAU;;;;;;;;;iBAGd,CAAC;AAWH;;;GAGG;AACH,QAAA,MAAM,UAAU;;;;;iBAcd,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,WAAW;;;;;;iBAYf,CAAC;AAEH,8BAA8B;AAC9B,QAAA,MAAM,YAAY;;;;;iBAKhB,CAAC;AAEH,0CAA0C;AAC1C,QAAA,MAAM,WAAW;;;iBAGf,CAAC;AAEH,6EAA6E;AAC7E,QAAA,MAAM,UAAU;;;;;;iBAkBd,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAY9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB;;;;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAsB5E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA0D/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC3D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC7D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC7D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/terminal.js

@@ -0,0 +1,243 @@
+/**
+ * Terminal Unified Tool Schemas
+ *
+ * Discriminated union (on `action`) for interactive PTY terminal control.
+ * Single source of truth: consumed by both the descriptor and the impl.
+ */
+import z from 'zod/v4';
+import { OpenTerminalOptionsSchema } from "./session.js";
+import { ExecutionCapabilitiesSchema } from '@vibesdotdev/kernel/execution';
+// Verbs match runtime/execution: execute / spawn / session. `open` is the
+// session-open alias. `run` (PTY one-shot) is gone — that is execute().
+export const TerminalActions = [
+    'execute',
+    'spawn',
+    'session',
+    'open',
+    'list',
+    'read',
+    'write',
+    'resize',
+    'close',
+    'wait',
+    'capabilities'
+];
+const argvCommand = z
+    .array(z.string().min(1))
+    .min(1)
+    .describe('Argv array, not a shell string. Example: ["bun","test"].');
+/** One-shot buffered execute() — not a PTY. */
+const executeAction = z.object({
+    action: z.literal('execute'),
+    command: argvCommand,
+    cwd: z.string().optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    timeoutMs: z.number().int().positive().max(600_000).optional()
+});
+/** Long-lived non-PTY spawn() — pipes, procId. */
+const spawnAction = z.object({
+    action: z.literal('spawn'),
+    command: argvCommand,
+    cwd: z.string().optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    present: z
+        .boolean()
+        .optional()
+        .describe('When true and pty is unavailable, attach a read-only log card (not xterm).')
+});
+const sessionOpenFields = {
+    ...OpenTerminalOptionsSchema.shape,
+    command: z
+        .union([z.string(), argvCommand])
+        .optional()
+        .describe('Command (or argv array) to run in the PTY. Defaults to the user shell ($SHELL or /bin/sh).'),
+    cols: OpenTerminalOptionsSchema.shape.cols.default(80),
+    rows: OpenTerminalOptionsSchema.shape.rows.default(24),
+    present: z
+        .boolean()
+        .optional()
+        .describe('When true (agent default), attach a live terminal card for this session.')
+};
+/** Interactive PTY session() — the verb for a user-visible tty. */
+const sessionAction = z.object({
+    action: z.literal('session'),
+    ...sessionOpenFields
+});
+/** Alias of `session` (existing callers). */
+const openAction = z.object({
+    action: z.literal('open'),
+    ...sessionOpenFields
+});
+const capabilitiesAction = z.object({
+    action: z.literal('capabilities')
+});
+/** List the caller's open sessions. */
+const listAction = z.object({
+    action: z.literal('list')
+});
+/**
+ * Read recent output from a session. Reuses the session backlog ring; pass the
+ * `cursor` returned by a prior read to get only newer output (incremental).
+ */
+const readAction = z.object({
+    action: z.literal('read'),
+    sessionId: z.string(),
+    since: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Cursor from a prior read; only output produced after it is returned.'),
+    stripAnsi: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Strip ANSI escape sequences from the returned text (default true).')
+});
+/**
+ * Write to a session. `text` is sent verbatim; `keys` are named keys/chords
+ * (e.g. "Enter", "ArrowUp", "ctrl+c") resolved to byte sequences. `enter`
+ * appends a carriage return — defaults true with `text`, false with only `keys`.
+ */
+const writeAction = z.object({
+    action: z.literal('write'),
+    sessionId: z.string(),
+    text: z.string().optional(),
+    keys: z
+        .array(z.string())
+        .optional()
+        .describe('Named keys or chords: "Enter", "ArrowUp", "ctrl+c", "alt+x", "shift+Tab".'),
+    enter: z
+        .boolean()
+        .optional()
+        .describe('Append Enter (CR). Defaults true when text is present, false when only keys.')
+});
+/** Resize a session's PTY. */
+const resizeAction = z.object({
+    action: z.literal('resize'),
+    sessionId: z.string(),
+    cols: z.number().int().positive(),
+    rows: z.number().int().positive()
+});
+/** Close (kill, not detach) a session. */
+const closeAction = z.object({
+    action: z.literal('close'),
+    sessionId: z.string()
+});
+/** Wait for exit without killing a still-running session at the deadline. */
+const waitAction = z.object({
+    action: z.literal('wait'),
+    sessionId: z.string(),
+    timeoutMs: z
+        .number()
+        .int()
+        .positive()
+        .max(300000)
+        .optional()
+        .default(30000)
+        .describe('Maximum wait in milliseconds (up to 5 minutes); timeout never kills the session.'),
+    since: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Cursor from an earlier read/wait; returns only newer output.'),
+    stripAnsi: z.boolean().optional().default(true)
+});
+export const TerminalInputSchema = z.discriminatedUnion('action', [
+    executeAction,
+    spawnAction,
+    sessionAction,
+    openAction,
+    listAction,
+    readAction,
+    writeAction,
+    resizeAction,
+    closeAction,
+    waitAction,
+    capabilitiesAction
+]);
+/** Session summary returned by `list`. */
+export const TerminalSessionInfoSchema = z.object({
+    id: z.string(),
+    command: z.string(),
+    createdAt: z.number(),
+    status: z.enum(['running', 'exited'])
+});
+const TerminalPresentationSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('terminal'), sessionId: z.string().min(1) }).strict(),
+    z.object({ kind: z.literal('log'), procId: z.string().min(1) }).strict()
+]);
+const executionOutputFields = {
+    executionId: z.string().min(1),
+    environmentId: z.string().min(1),
+    pty: z.boolean(),
+    shell: z.boolean()
+};
+const sessionOutputFields = {
+    sessionId: z.string().min(1),
+    cwd: z.string().optional(),
+    ...executionOutputFields,
+    capabilities: ExecutionCapabilitiesSchema,
+    present: TerminalPresentationSchema.optional()
+};
+export const TerminalOutputSchema = z.discriminatedUnion('action', [
+    z.object({
+        action: z.literal('capabilities'),
+        ...executionOutputFields,
+        capabilities: ExecutionCapabilitiesSchema
+    }).strict(),
+    z.object({
+        action: z.literal('execute'),
+        command: argvCommand,
+        cwd: z.string().optional(),
+        ...executionOutputFields,
+        exitCode: z.number().int().nullable(),
+        stdout: z.string(),
+        stderr: z.string(),
+        durationMs: z.number().nonnegative(),
+        timedOut: z.boolean()
+    }).strict(),
+    z.object({
+        action: z.literal('spawn'),
+        command: argvCommand,
+        cwd: z.string().optional(),
+        ...executionOutputFields,
+        procId: z.string().min(1),
+        running: z.boolean(),
+        present: TerminalPresentationSchema.optional()
+    }).strict(),
+    z.object({ action: z.literal('session'), ...sessionOutputFields }).strict(),
+    z.object({ action: z.literal('open'), ...sessionOutputFields }).strict(),
+    z.object({ action: z.literal('list'), sessions: z.array(TerminalSessionInfoSchema) }).strict(),
+    z.object({
+        action: z.literal('read'),
+        sessionId: z.string().min(1),
+        output: z.string(),
+        cursor: z.number().int().nonnegative()
+    }).strict(),
+    z.object({
+        action: z.literal('write'),
+        sessionId: z.string().min(1),
+        bytesWritten: z.number().int().nonnegative()
+    }).strict(),
+    z.object({
+        action: z.literal('resize'),
+        sessionId: z.string().min(1),
+        resized: z.literal(true)
+    }).strict(),
+    z.object({
+        action: z.literal('close'),
+        sessionId: z.string().min(1),
+        closed: z.literal(true)
+    }).strict(),
+    z.object({
+        action: z.literal('wait'),
+        sessionId: z.string().min(1),
+        exitCode: z.number().int().nullable(),
+        timedOut: z.boolean(),
+        output: z.string(),
+        cursor: z.number().int().nonnegative()
+    }).strict()
+]);
+//# sourceMappingURL=terminal.js.map

package/dist/schemas/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/schemas/terminal.ts"],"names":[],"mappings":"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"}

package/dist/server/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @vibesdotdev/terminal-client/server/session-store — server-side subpath.
+ *
+ * Re-exports the session store factory and the SSE stream builder that together
+ * implement the `/api/session/**` bridge endpoints.
+ */
+export { createTerminalSessionStore, SessionOpenOptionsSchema, TerminalSessionStoreOptionsSchema, type SessionOpener, type SessionOpenOptions, type SessionOpenError, type SessionMetadata, type StoredSession, type TerminalSessionStore, type TerminalSessionStoreOptions, type TerminalSessionStoreRuntime } from './session-store.ts';
+export { buildSseStream, toBase64, fromBase64, SSE_HEADERS } from './sse-stream.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,iBAAiB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,9 @@
+/**
+ * @vibesdotdev/terminal-client/server/session-store — server-side subpath.
+ *
+ * Re-exports the session store factory and the SSE stream builder that together
+ * implement the `/api/session/**` bridge endpoints.
+ */
+export { createTerminalSessionStore, SessionOpenOptionsSchema, TerminalSessionStoreOptionsSchema } from "./session-store.js";
+export { buildSseStream, toBase64, fromBase64, SSE_HEADERS } from "./sse-stream.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EASjC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,cAAc,EACd,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,iBAAiB,CAAC"}