@lightningai/sdk 2026.5.6-post2 → 2026.5.15-post0

package/README.md

@@ -50,6 +50,96 @@ Environment variables read by the SDK:
 | ------------------- | --------------------------------------------------------- |
 | `LIGHTNING_API_KEY` | API key if not passed via `configure()` / request options |
 
+## PTY sessions
+
+For interactive shells (REPLs, build watchers, anything that needs `stdin`/window-resize/ANSI), use the `sandbox.process` namespace instead of `runCommand`. PTY sessions are bridged over a WebSocket from the controlplane down to the in-sandbox SSH server, with the same xterm wire protocol the Lightning UI's web terminal uses.
+
+PTY support requires Node 22+ (for the built-in `WebSocket` global).
+
+### Create a session
+
+```ts
+const pty = await sandbox.process.createPty({
+  sessionName: "build",
+  clusterId: sandbox.clusterId,
+  cwd: "/app",
+  cols: 120,
+  rows: 30,
+  envs: { TERM: "xterm-256color" },
+  onData: (chunk) => process.stdout.write(chunk),
+});
+
+await pty.waitForConnection();
+await pty.sendInput("npm test\n");
+await pty.sendInput("exit\n");
+
+const result = await pty.wait();
+console.log(`exit code: ${result.exitCode}`);
+```
+
+| Option        | Type                        | Description                                                            |
+| ------------- | --------------------------- | ---------------------------------------------------------------------- |
+| `sessionName` | `string`                    | Session identifier (used by `connectPty`)                              |
+| `clusterId`   | `string`                    | Cluster the sandbox runs on (`sandbox.clusterId`)                      |
+| `cwd`         | `string`                    | Initial working directory                                              |
+| `envs`        | `Record<string, string>`    | Environment variables exported into the session                        |
+| `cols`        | `number`                    | Initial terminal columns (default 80)                                  |
+| `rows`        | `number`                    | Initial terminal rows (default 24)                                     |
+| `onData`      | `(chunk: Uint8Array)=>void` | Callback for every chunk of shell output (defaults to `writeToStdout`) |
+
+If `onData` is omitted, the SDK uses the exported `writeToStdout` helper, which forwards raw shell bytes to `process.stdout`. Pass `onData: () => {}` to suppress.
+
+### Reconnect to a session
+
+```ts
+const pty = await sandbox.process.connectPty("build", sandbox.clusterId, {
+  onData: (chunk) => process.stdout.write(chunk),
+});
+```
+
+### List, inspect, and kill sessions
+
+```ts
+const sessions = await sandbox.process.listPtySessions();
+for (const s of sessions) {
+  console.log(s.id, s.active, s.cols, s.rows);
+}
+
+const info = await sandbox.process.getPtySessionInfo("build");
+await sandbox.process.killPtySession("build");
+```
+
+### Resize
+
+Resize from a handle (preferred — works without a server round-trip):
+
+```ts
+await pty.resize(150, 40);
+```
+
+Or via the namespace, which finds the live handle in this process:
+
+```ts
+await sandbox.process.resizePtySession("build", 150, 40);
+```
+
+### `PtyHandle` reference
+
+| Member                            | Description                                              |
+| --------------------------------- | -------------------------------------------------------- |
+| `sendInput(string \| Uint8Array)` | Send raw bytes to the shell (e.g. `"\u0003"` for Ctrl+C) |
+| `resize(cols, rows)`              | Send a resize control frame                              |
+| `wait()`                          | Resolve when the WebSocket closes; returns `PtyResult`   |
+| `waitForConnection(timeoutMs?)`   | Resolve when the WebSocket opens                         |
+| `kill()`                          | Send Ctrl+C and disconnect                               |
+| `disconnect()`                    | Close the WebSocket without killing the shell            |
+| `isConnected()`                   | Whether the WebSocket is OPEN                            |
+| `exitCode`                        | `0` on clean close, `-1` on abnormal, `null` while alive |
+| `error`                           | Termination reason on abnormal close, otherwise `null`   |
+| `size`                            | Most recent `{ cols, rows }`                             |
+
+> **Note on cross-process persistence.** Within a single SDK process, every PTY method works against an in-process registry. Reattaching from a *different* process to a session that's still running on the sandbox requires the runtime image to ship `screen` (or similar) and the in-sandbox SSH login shell to honor `LAI_TERM_SESSION_NAME` / `LAI_TERM_RESTORE` — both of which are tracked as a follow-up to this initial parity work. The API surface above does not change either way.
+
 ## License
 
 Apache-2.0

package/dist/command.d.ts

@@ -0,0 +1,63 @@
+import type { Sandbox } from "./sandbox.js";
+import type { CommandStatus, WaitForCommandOptions } from "./types.js";
+/**
+ * Handle for a command running (or finished) inside a sandbox.
+ *
+ * - When {@link Sandbox.runCommand} is awaited *without* `detached: true`, the
+ *   server has already waited for the process to exit, so `exitCode` is a
+ *   number and `running` is `false` immediately.
+ * - When `detached: true` is passed, the call returns immediately with
+ *   `exitCode === null` and `running === true`. Call {@link wait} to block
+ *   until the process exits, or {@link kill} to terminate it.
+ *
+ * ```ts
+ * const detachedCmd = await sandbox.runCommand({
+ *   cmd: "sleep",
+ *   args: ["5"],
+ *   detached: true,
+ * });
+ * const result = await detachedCmd.wait();
+ * if (result.exitCode !== 0) {
+ *   console.error("Something went wrong...");
+ * }
+ * ```
+ */
+export declare class Command {
+    readonly cmdId: string;
+    /** Captured combined stdout/stderr seen so far. Updated by {@link wait} and {@link getStatus}. */
+    output: string;
+    /** Exit code; `null` while the command is still running. */
+    exitCode: number | null;
+    protected readonly sandbox: Sandbox;
+    constructor(sandbox: Sandbox, data: {
+        cmdId: string;
+        output: string;
+        exitCode: number | null;
+    });
+    /** `true` while the command is still executing (i.e. {@link exitCode} is `null`). */
+    get running(): boolean;
+    /** Returns the captured combined stdout/stderr buffered on the handle. */
+    stdout(): string;
+    /** Alias for {@link stdout}; the API exposes a single combined output stream. */
+    stderr(): string;
+    /**
+     * Refresh status from the server, updating {@link output} and {@link exitCode}.
+     *
+     * The returned {@link CommandStatus} is the raw server response and is also
+     * useful for inspecting `running` directly.
+     */
+    getStatus(): Promise<CommandStatus>;
+    /**
+     * Block until the command exits, then return this handle with `exitCode`
+     * populated. Essential for detached commands where you need to know when
+     * execution completes; for non-detached commands, {@link Sandbox.runCommand}
+     * already waits automatically and `wait()` returns immediately.
+     *
+     * Resolves immediately if the command has already exited. Otherwise polls
+     * {@link Sandbox.getCommand} until `running` becomes `false`.
+     */
+    wait(opts?: WaitForCommandOptions): Promise<Command>;
+    /** Terminate the command (best effort) via {@link Sandbox.killCommand}. */
+    kill(): Promise<void>;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAGlC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAQlE,qFAAqF;IACrF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,0EAA0E;IAC1E,MAAM,IAAI,MAAM;IAIhB,iFAAiF;IACjF,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IASzC;;;;;;;;OAQG;IACG,IAAI,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9D,2EAA2E;IACrE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/command.js

@@ -0,0 +1,85 @@
+/**
+ * Handle for a command running (or finished) inside a sandbox.
+ *
+ * - When {@link Sandbox.runCommand} is awaited *without* `detached: true`, the
+ *   server has already waited for the process to exit, so `exitCode` is a
+ *   number and `running` is `false` immediately.
+ * - When `detached: true` is passed, the call returns immediately with
+ *   `exitCode === null` and `running === true`. Call {@link wait} to block
+ *   until the process exits, or {@link kill} to terminate it.
+ *
+ * ```ts
+ * const detachedCmd = await sandbox.runCommand({
+ *   cmd: "sleep",
+ *   args: ["5"],
+ *   detached: true,
+ * });
+ * const result = await detachedCmd.wait();
+ * if (result.exitCode !== 0) {
+ *   console.error("Something went wrong...");
+ * }
+ * ```
+ */
+export class Command {
+    cmdId;
+    /** Captured combined stdout/stderr seen so far. Updated by {@link wait} and {@link getStatus}. */
+    output;
+    /** Exit code; `null` while the command is still running. */
+    exitCode;
+    sandbox;
+    constructor(sandbox, data) {
+        this.sandbox = sandbox;
+        this.cmdId = data.cmdId;
+        this.output = data.output;
+        this.exitCode = data.exitCode;
+    }
+    /** `true` while the command is still executing (i.e. {@link exitCode} is `null`). */
+    get running() {
+        return this.exitCode === null;
+    }
+    /** Returns the captured combined stdout/stderr buffered on the handle. */
+    stdout() {
+        return this.output;
+    }
+    /** Alias for {@link stdout}; the API exposes a single combined output stream. */
+    stderr() {
+        return this.output;
+    }
+    /**
+     * Refresh status from the server, updating {@link output} and {@link exitCode}.
+     *
+     * The returned {@link CommandStatus} is the raw server response and is also
+     * useful for inspecting `running` directly.
+     */
+    async getStatus() {
+        const status = await this.sandbox.getCommand(this.cmdId);
+        this.output = status.output;
+        if (!status.running) {
+            this.exitCode = status.exitCode;
+        }
+        return status;
+    }
+    /**
+     * Block until the command exits, then return this handle with `exitCode`
+     * populated. Essential for detached commands where you need to know when
+     * execution completes; for non-detached commands, {@link Sandbox.runCommand}
+     * already waits automatically and `wait()` returns immediately.
+     *
+     * Resolves immediately if the command has already exited. Otherwise polls
+     * {@link Sandbox.getCommand} until `running` becomes `false`.
+     */
+    async wait(opts = {}) {
+        if (this.exitCode !== null) {
+            return this;
+        }
+        const final = await this.sandbox.waitForCommand(this.cmdId, opts);
+        this.output = final.output;
+        this.exitCode = final.exitCode;
+        return this;
+    }
+    /** Terminate the command (best effort) via {@link Sandbox.killCommand}. */
+    async kill() {
+        await this.sandbox.killCommand(this.cmdId);
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,OAAO;IACT,KAAK,CAAS;IACvB,kGAAkG;IAClG,MAAM,CAAS;IACf,4DAA4D;IAC5D,QAAQ,CAAgB;IAEL,OAAO,CAAU;IAEpC,YACE,OAAgB,EAChB,IAAgE;QAEhE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,qFAAqF;IACrF,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;IAChC,CAAC;IAED,0EAA0E;IAC1E,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,iFAAiF;IACjF,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,OAA8B,EAAE;QACzC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/filesystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAiB,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ3E,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3D"}
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQ5D,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiBrC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMxC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3D"}

package/dist/filesystem.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export { Sandbox } from "./sandbox.js";
 export { FileSystem } from "./filesystem.js";
-export type { SandboxConfig, SandboxData, CreateSandboxParams, GetSandboxParams, ListSandboxesParams, ListSandboxesResponse, RunCommandOpts, CommandResult, CommandStatus, CommandLog, WriteFileParams, ReadFileParams, CreateDirectoryParams, FileStat, } from "./types.js";
+export { Command } from "./command.js";
+export { SandboxProcess } from "./process.js";
+export { PtyHandle, writeToStdout } from "./pty.js";
+export type { SandboxConfig, SandboxData, CreateSandboxParams, GetSandboxParams, ListSandboxesParams, ListSandboxesResponse, RunCommandOpts, CommandStatus, CommandLog, WaitForCommandOptions, WriteFileParams, ReadFileParams, CreateDirectoryParams, FileStat, PtySize, PtyCreateOpts, PtyConnectOpts, PtyResult, PtySessionInfo, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,OAAO,EACP,aAAa,EACb,cAAc,EACd,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,6 @@
 export { Sandbox } from "./sandbox.js";
 export { FileSystem } from "./filesystem.js";
+export { Command } from "./command.js";
+export { SandboxProcess } from "./process.js";
+export { PtyHandle, writeToStdout } from "./pty.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/lightning_cloud/openapi/data-contracts.d.ts

@@ -191,6 +191,12 @@ export interface V1CreateSandboxRequest {
      * @format uint64
      */
     timeout?: string;
+    /**
+     * Network access policy for the sandbox. Controls which external hosts the
+     * sandbox can communicate with. When unset, the sandbox inherits the default
+     * network policy.
+     */
+    networkPolicy?: V1NetworkPolicy;
 }
 export type V1DeleteSandboxResponse = object;
 export type V1ExtendSandboxTimeoutResponse = object;
@@ -202,6 +208,7 @@ export interface V1GetSandboxCommandResponse {
     output?: string;
     /** @format int32 */
     exitCode?: number;
+    running?: boolean;
 }
 export interface V1GetSandboxFileResponse {
     content?: string;
@@ -218,6 +225,34 @@ export interface V1LogMessage {
     timestamp?: string;
     message?: string;
 }
+/** NetworkPolicy controls outbound network access for a sandbox. */
+export interface V1NetworkPolicy {
+    /**
+     * The network access policy mode.
+     * - "allow-all": permit all outbound traffic.
+     * - "deny-all": block all outbound traffic.
+     * - "custom": specify explicit allow/deny rules via the fields below.
+     * - "default-allow": allow all traffic except for explicit deny rules.
+     * - "default-deny": deny all traffic except for explicit allow rules.
+     */
+    mode?: string;
+    /**
+     * List of domain names the sandbox is allowed to connect to. Only applies
+     * when mode is "custom". Supports wildcard patterns (e.g., "*.example.com"
+     * matches all subdomains).
+     */
+    allowedDomains?: string[];
+    /**
+     * List of IP address ranges (in CIDR notation) the sandbox is allowed to
+     * connect to. Traffic to these addresses bypasses domain-based restrictions.
+     */
+    allowedCidrs?: string[];
+    /**
+     * List of IP address ranges (in CIDR notation) the sandbox is blocked from
+     * connecting to. These rules take precedence over all allowed rules.
+     */
+    deniedCidrs?: string[];
+}
 export interface V1RunSandboxCommandResponse {
     cmdId?: string;
     output?: string;

package/dist/lightning_cloud/openapi/data-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-contracts.d.ts","sourceRoot":"","sources":["../../../src/lightning_cloud/openapi/data-contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-contracts.d.ts","sourceRoot":"","sources":["../../../src/lightning_cloud/openapi/data-contracts.ts"],"names":[],"mappings":"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"}

package/dist/process.d.ts

@@ -0,0 +1,115 @@
+import type { Command } from "./command.js";
+import { PtyHandle } from "./pty.js";
+import type { PtyConnectOpts, PtyCreateOpts, PtySessionInfo, RunCommandOpts } from "./types.js";
+/**
+ * Runtime context the `Sandbox` passes into a `SandboxProcess` so that
+ * the PTY namespace can build URLs, authenticate, and shell out to
+ * `runCommand` for session bookkeeping without importing the `Sandbox`
+ * class directly (avoids a circular dependency).
+ *
+ * Internal — not part of the public API surface.
+ */
+export interface SandboxProcessContext {
+    sandboxId: string;
+    organizationId: string;
+    /**
+     * Returns the resolved API key. Mirrors the lazy lookup used by the
+     * REST request helpers so that `Sandbox.configure` calls made after
+     * the sandbox object was created are still honored.
+     */
+    getApiKey(): string;
+    /** Returns the resolved base URL (with no trailing slash). */
+    getBaseUrl(): string;
+    /** Forwards to `Sandbox.runCommand`. */
+    runCommand(opts: RunCommandOpts): Promise<Command>;
+}
+/**
+ * `sandbox.process` — interactive shell sessions on a sandbox.
+ *
+ * Mirrors the Daytona PTY surface so existing code shaped around it
+ * ports over with mechanical changes only. Under the hood, every method
+ * either opens a WebSocket against the controlplane's
+ * `/v1/clusters/{clusterId}/machines/{sandboxId}/attach` endpoint (which
+ * is bridged to the in-sandbox SSH server at port 2222) or shells out to
+ * `screen` via the existing `runCommand` REST API for session
+ * bookkeeping.
+ *
+ * Within a single SDK process every method works against a local
+ * registry. Cross-process session persistence (i.e. `connectPty` from
+ * a fresh process to a session created elsewhere) requires the sandbox
+ * runtime image to ship `screen` and the gliderlabs SSH login shell to
+ * honor `LAI_TERM_SESSION_NAME` / `LAI_TERM_RESTORE` — both of which
+ * are tracked as a follow-up to this initial parity work.
+ */
+export declare class SandboxProcess {
+    private readonly ctx;
+    /**
+     * Live handles bound to this `SandboxProcess`, keyed by their
+     * caller-chosen session name. Used by `connectPty` /
+     * `getPtySessionInfo` / `killPtySession` / `resizePtySession` to find
+     * an existing session before falling back to `screen -ls` over
+     * `runCommand`.
+     */
+    private readonly handles;
+    constructor(ctx: SandboxProcessContext);
+    /**
+     * Create a new PTY session on the sandbox.
+     *
+     * ```ts
+     * const pty = await sandbox.process.createPty({
+     *   sessionName: "build",
+     *   clusterId: sandbox.clusterId,
+     *   cols: 120,
+     *   rows: 30,
+     *   onData: (chunk) => process.stdout.write(chunk),
+     * });
+     * await pty.waitForConnection();
+     * await pty.sendInput("npm test\n");
+     * const result = await pty.wait();
+     * ```
+     */
+    createPty(opts: PtyCreateOpts): Promise<PtyHandle>;
+    /**
+     * Reattach to a PTY session that was previously created by `createPty`.
+     *
+     * ```ts
+     * const pty = await sandbox.process.connectPty("build", sandbox.clusterId, {
+     *   onData: (chunk) => process.stdout.write(chunk),
+     * });
+     * ```
+     */
+    connectPty(sessionName: string, clusterId: string, opts?: PtyConnectOpts): Promise<PtyHandle>;
+    /**
+     * List PTY sessions on the sandbox. Implemented as a `screen -ls`
+     * call via {@link runCommand} so no new server endpoint is required.
+     * Returns the union of locally-tracked handles and remote `screen`
+     * sessions; locally-tracked handles include live `cols`/`rows`.
+     */
+    listPtySessions(): Promise<PtySessionInfo[]>;
+    /**
+     * Look up a single PTY session.
+     *
+     * ```ts
+     * const info = await sandbox.process.getPtySessionInfo("build");
+     * console.log(info.active);
+     * ```
+     */
+    getPtySessionInfo(id: string): Promise<PtySessionInfo>;
+    /**
+     * Forcefully terminate a PTY session. Closes any live `PtyHandle` for
+     * the session within this SDK process and runs
+     * `screen -X -S {id} quit` on the sandbox so the remote screen
+     * session (when present) is also torn down.
+     */
+    killPtySession(id: string): Promise<void>;
+    /**
+     * Resize the terminal of an active PTY session. Requires the session
+     * to be currently attached in this SDK process; the existing wire
+     * protocol carries resize as a JSON control frame on the open
+     * WebSocket and offers no out-of-band REST equivalent.
+     */
+    resizePtySession(id: string, cols: number, rows: number): Promise<PtySessionInfo>;
+    /** Internal: builds the WebSocket URL and opens the connection. */
+    private openPty;
+}
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,SAAS,IAAI,MAAM,CAAC;IACpB,8DAA8D;IAC9D,UAAU,IAAI,MAAM,CAAC;IACrB,wCAAwC;IACxC,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,GAAG,EAAE,qBAAqB;IAItC;;;;;;;;;;;;;;;OAeG;IACG,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAIxD;;;;;;;;OAQG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,SAAS,CAAC;IASrB;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IA+BlD;;;;;;;OAOG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAS5D;;;;;OAKG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C;;;;;OAKG;IACG,gBAAgB,CACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC;IAU1B,mEAAmE;YACrD,OAAO;CAmEtB"}