@myrialabs/ptykit 0.0.1

package/dist/core/session.js

@@ -0,0 +1,264 @@
+/**
+ * A single PTY session: process handle + output pipeline + scrollback binding.
+ *
+ * Output pipeline (R5, R7a):
+ *  1. Persist every chunk to the headless terminal FIRST — even with zero
+ *     listeners — so scrollback stays accurate while clients are disconnected.
+ *  2. Micro-task batch high-frequency output (`queueMicrotask`).
+ *  3. Stamp a monotonic `seq` per flush for client-side dedup.
+ *  4. Fan out the batched chunk to every listener.
+ *
+ * Lifecycle: idle `\r` fallback after 350ms of silence (R18); kill = Ctrl+C
+ * then SIGKILL after 1s, or a direct signal (R19).
+ */
+import { buildPtyEnv } from './env.js';
+import { resolveShell } from './shell.js';
+import { silentLogger } from '../shared/index.js';
+export class Session {
+    sessionId;
+    namespace;
+    streamId;
+    createdAt = new Date();
+    cwd;
+    cols;
+    rows;
+    lastActivityAt = new Date();
+    status = 'active';
+    exitCode;
+    /** Monotonic sequence, incremented once per flushed batch (R5). */
+    outputSeq = 0;
+    handle;
+    buffers;
+    logger;
+    killGraceMs;
+    dataListeners = new Set();
+    exitListeners = new Set();
+    pendingOutput = '';
+    flushScheduled = false;
+    receivedInitialOutput = false;
+    dataSub;
+    exitSub;
+    idleTimer = null;
+    killTimer = null;
+    constructor(config) {
+        this.sessionId = config.sessionId;
+        this.namespace = config.namespace;
+        this.streamId = config.streamId;
+        this.cwd = config.cwd;
+        this.cols = config.cols;
+        this.rows = config.rows;
+        this.buffers = config.buffers;
+        this.logger = config.logger ?? silentLogger;
+        this.killGraceMs = config.killGraceMs ?? 1000;
+        const { shell, args } = resolveShell(config.shell);
+        const env = buildPtyEnv(config.env, { cols: this.cols, rows: this.rows });
+        this.handle = config.backend.spawn(shell, args, {
+            name: 'xterm-256color',
+            cols: this.cols,
+            rows: this.rows,
+            cwd: this.cwd,
+            env,
+        });
+        // Allocate scrollback up front so persist-first always has a target.
+        this.buffers.create(this.sessionId, this.cols, this.rows);
+        this.dataSub = this.handle.onData((data) => this.onData(data));
+        this.exitSub = this.handle.onExit((event) => this.onExit(event));
+        // Some shells do not paint the first prompt until they receive input.
+        // Only nudge if the PTY stayed completely silent after spawn; otherwise
+        // it duplicates the initial prompt on normal shells (R18).
+        const idleFallbackMs = config.idleFallbackMs ?? 350;
+        this.idleTimer = setTimeout(() => {
+            this.idleTimer = null;
+            if (this.receivedInitialOutput || this.status === 'exited')
+                return;
+            try {
+                this.handle.write('\r');
+            }
+            catch (err) {
+                this.logger.error('session', 'idle fallback write failed', err);
+            }
+        }, idleFallbackMs);
+    }
+    get pid() {
+        return this.handle.pid;
+    }
+    info() {
+        return {
+            sessionId: this.sessionId,
+            namespace: this.namespace,
+            streamId: this.streamId,
+            pid: this.pid,
+            cwd: this.cwd,
+            cols: this.cols,
+            rows: this.rows,
+            createdAt: this.createdAt,
+            lastActivityAt: this.lastActivityAt,
+            status: this.status,
+            exitCode: this.exitCode,
+        };
+    }
+    onData(data) {
+        this.receivedInitialOutput = true;
+        this.lastActivityAt = new Date();
+        // Persist FIRST, even with zero listeners (R7a).
+        this.buffers.write(this.sessionId, data);
+        // Micro-task batch high-frequency output (R5).
+        this.pendingOutput += data;
+        if (this.flushScheduled)
+            return;
+        this.flushScheduled = true;
+        queueMicrotask(() => {
+            const output = this.pendingOutput;
+            this.pendingOutput = '';
+            this.flushScheduled = false;
+            this.outputSeq++;
+            const seq = this.outputSeq;
+            for (const listener of this.dataListeners) {
+                try {
+                    listener(output, seq);
+                }
+                catch (err) {
+                    this.logger.error('session', 'data listener error', err);
+                }
+            }
+        });
+    }
+    onExit(event) {
+        this.status = 'exited';
+        this.exitCode = event.exitCode;
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+        for (const listener of this.exitListeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                this.logger.error('session', 'exit listener error', err);
+            }
+        }
+    }
+    // ---- Listener management (R7c: callers clear before reattaching) --------
+    addDataListener(listener) {
+        this.dataListeners.add(listener);
+    }
+    removeDataListener(listener) {
+        this.dataListeners.delete(listener);
+    }
+    addExitListener(listener) {
+        this.exitListeners.add(listener);
+    }
+    removeExitListener(listener) {
+        this.exitListeners.delete(listener);
+    }
+    /** Clear ALL listeners — call before attaching fresh ones to avoid double output (R7c). */
+    clearListeners() {
+        this.dataListeners.clear();
+        this.exitListeners.clear();
+    }
+    get dataListenerCount() {
+        return this.dataListeners.size;
+    }
+    // ---- I/O ----------------------------------------------------------------
+    write(data) {
+        if (this.status === 'exited')
+            return false;
+        try {
+            this.handle.write(data);
+            this.lastActivityAt = new Date();
+            return true;
+        }
+        catch (err) {
+            this.logger.error('session', `write to ${this.sessionId} failed`, err);
+            return false;
+        }
+    }
+    resize(cols, rows) {
+        if (this.status === 'exited')
+            return false;
+        try {
+            this.handle.resize(cols, rows);
+            this.cols = cols;
+            this.rows = rows;
+            // Keep scrollback in sync with PTY dimensions (R15).
+            this.buffers.resize(this.sessionId, cols, rows);
+            return true;
+        }
+        catch (err) {
+            this.logger.error('session', `resize of ${this.sessionId} failed`, err);
+            return false;
+        }
+    }
+    /** Send Ctrl+C (R19). */
+    cancel() {
+        if (this.status === 'exited')
+            return;
+        try {
+            this.handle.write('\x03');
+        }
+        catch (err) {
+            this.logger.error('session', `cancel of ${this.sessionId} failed`, err);
+        }
+    }
+    /** Kill: Ctrl+C then SIGKILL after the grace window, or a direct signal (R19). */
+    kill(signal) {
+        try {
+            if (signal === 'SIGKILL' || signal === '9') {
+                this.handle.kill('SIGKILL');
+                return;
+            }
+            if (signal === 'SIGTERM' || signal === '15') {
+                this.handle.kill('SIGTERM');
+                return;
+            }
+            this.handle.write('\x03');
+            this.killTimer = setTimeout(() => {
+                this.killTimer = null;
+                if (this.status === 'exited')
+                    return;
+                try {
+                    this.handle.kill('SIGKILL');
+                }
+                catch {
+                    // already dead
+                }
+            }, this.killGraceMs);
+        }
+        catch (err) {
+            this.logger.error('session', `kill of ${this.sessionId} failed`, err);
+        }
+    }
+    serialize() {
+        return this.buffers.serialize(this.sessionId);
+    }
+    clearScreen() {
+        this.buffers.clear(this.sessionId);
+    }
+    bufferLength() {
+        return this.buffers.length(this.sessionId);
+    }
+    /** Tear down PTY subscriptions and timers. Does NOT dispose scrollback. */
+    dispose() {
+        try {
+            this.dataSub.dispose();
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            this.exitSub.dispose();
+        }
+        catch {
+            /* ignore */
+        }
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        if (this.killTimer)
+            clearTimeout(this.killTimer);
+        this.idleTimer = null;
+        this.killTimer = null;
+        this.clearListeners();
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/core/shell.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shell resolution and working-directory handling (R1).
+ *
+ * Unix: `process.env.SHELL || /bin/bash`, interactive (no `-c`).
+ * Windows: `powershell.exe -NoLogo`, interactive (no `-Command`).
+ * Defaults: `xterm-256color`, 80×24.
+ */
+import type { CheckShellResponse } from '../shared/index.js';
+export declare const isWindows: boolean;
+/** A resolved shell invocation. */
+export interface ShellInvocation {
+    shell: string;
+    args: string[];
+}
+/** Resolve the interactive shell + args for this platform (R1). */
+export declare function resolveShell(preferred?: string): ShellInvocation;
+/**
+ * Resolve a requested working directory to an existing absolute path, falling
+ * back to the user's home directory, then `process.cwd()`.
+ */
+export declare function resolveCwd(requested?: string): string;
+/** Report shell availability for the `check-shell` operation. */
+export declare function checkShell(): CheckShellResponse;
+//# sourceMappingURL=shell.d.ts.map

package/dist/core/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/core/shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,eAAO,MAAM,SAAS,SAA+B,CAAC;AAEtD,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAKhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,iEAAiE;AACjE,wBAAgB,UAAU,IAAI,kBAAkB,CAmB/C"}

package/dist/core/shell.js

@@ -0,0 +1,55 @@
+/**
+ * Shell resolution and working-directory handling (R1).
+ *
+ * Unix: `process.env.SHELL || /bin/bash`, interactive (no `-c`).
+ * Windows: `powershell.exe -NoLogo`, interactive (no `-Command`).
+ * Defaults: `xterm-256color`, 80×24.
+ */
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+export const isWindows = process.platform === 'win32';
+/** Resolve the interactive shell + args for this platform (R1). */
+export function resolveShell(preferred) {
+    if (isWindows) {
+        return { shell: preferred || 'powershell.exe', args: ['-NoLogo'] };
+    }
+    return { shell: preferred || process.env.SHELL || '/bin/bash', args: [] };
+}
+/**
+ * Resolve a requested working directory to an existing absolute path, falling
+ * back to the user's home directory, then `process.cwd()`.
+ */
+export function resolveCwd(requested) {
+    const home = (isWindows ? process.env.USERPROFILE : process.env.HOME) || homedir();
+    if (requested && requested !== '~') {
+        const expanded = requested.startsWith('~')
+            ? requested.replace('~', home || process.cwd())
+            : resolve(requested);
+        if (existsSync(expanded))
+            return expanded;
+    }
+    return home || process.cwd();
+}
+/** Report shell availability for the `check-shell` operation. */
+export function checkShell() {
+    if (isWindows) {
+        return {
+            available: true,
+            path: 'powershell.exe',
+            platform: process.platform,
+            isWindows: true,
+            shellType: 'PowerShell',
+        };
+    }
+    const path = process.env.SHELL || '/bin/bash';
+    const shellType = (path.split('/').pop() || 'shell').replace(/^\w/, (c) => c.toUpperCase());
+    return {
+        available: true,
+        path,
+        platform: process.platform,
+        isWindows: false,
+        shellType,
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/core/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/core/shell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAQtD,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,SAAkB;IAC9C,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,SAAS,IAAI,gBAAgB,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAkB;IAC5C,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;IAEnF,IAAI,SAAS,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAC/C,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtB,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC3C,CAAC;IAED,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU;IACzB,IAAI,SAAS,EAAE,CAAC;QACf,OAAO;YACN,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,YAAY;SACvB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5F,OAAO;QACN,SAAS,EAAE,IAAI;QACf,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,KAAK;QAChB,SAAS;KACT,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ptykit — production-grade PTY sessions over WebSocket for Node & Bun.
+ *
+ * This is the main entry (`ptykit`): the core session engine plus the
+ * WebSocket transport server. The browser client lives at `ptykit/client`
+ * and the Svelte adapter at `ptykit/svelte`.
+ */
+export * from './shared/index.js';
+export * from './core/index.js';
+export * from './server/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * ptykit — production-grade PTY sessions over WebSocket for Node & Bun.
+ *
+ * This is the main entry (`ptykit`): the core session engine plus the
+ * WebSocket transport server. The browser client lives at `ptykit/client`
+ * and the Svelte adapter at `ptykit/svelte`.
+ */
+export * from './shared/index.js';
+export * from './core/index.js';
+export * from './server/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/server/connection.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Transport-agnostic connection + room model.
+ *
+ * A `PtyKitConnection` is one WebSocket client. The transport (Bun or Node)
+ * supplies the concrete object; the server logic only depends on this shape.
+ * Integrator-supplied identity rides on `data` (set at upgrade time) and is what
+ * the `authorize` hook inspects.
+ */
+import type { WireFrame } from '../shared/index.js';
+export interface PtyKitConnection {
+    /** Stable per-connection id. */
+    readonly id: string;
+    /** Integrator-attached identity/context, set at upgrade (e.g. `{ user }`). */
+    data: Record<string, unknown>;
+    /** Send a frame to this client. */
+    send(frame: WireFrame): void;
+    /** Close the underlying socket. */
+    close(): void;
+}
+/**
+ * Room registry for collaborative broadcast (R11).
+ *
+ * Output for a session broadcasts to its room (default = namespace); every
+ * connection in the room receives it and filters by `sessionId` client-side.
+ * N clients ↔ 1 session.
+ */
+export declare class RoomRegistry {
+    private readonly rooms;
+    private readonly membership;
+    join(conn: PtyKitConnection, room: string): void;
+    /** Remove a connection from every room it joined (on disconnect). */
+    leaveAll(conn: PtyKitConnection): void;
+    /** Broadcast a frame to every connection in a room. */
+    broadcast(room: string, frame: WireFrame): void;
+    /** Number of connections currently in a room. */
+    size(room: string): number;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/server/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAChC,gCAAgC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,mCAAmC;IACnC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IAEvE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBhD,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAatC,uDAAuD;IACvD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAY/C,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG1B"}

package/dist/server/connection.js

@@ -0,0 +1,67 @@
+/**
+ * Transport-agnostic connection + room model.
+ *
+ * A `PtyKitConnection` is one WebSocket client. The transport (Bun or Node)
+ * supplies the concrete object; the server logic only depends on this shape.
+ * Integrator-supplied identity rides on `data` (set at upgrade time) and is what
+ * the `authorize` hook inspects.
+ */
+/**
+ * Room registry for collaborative broadcast (R11).
+ *
+ * Output for a session broadcasts to its room (default = namespace); every
+ * connection in the room receives it and filters by `sessionId` client-side.
+ * N clients ↔ 1 session.
+ */
+export class RoomRegistry {
+    rooms = new Map();
+    membership = new Map();
+    join(conn, room) {
+        let members = this.rooms.get(room);
+        if (!members) {
+            members = new Set();
+            this.rooms.set(room, members);
+        }
+        members.add(conn);
+        let joined = this.membership.get(conn);
+        if (!joined) {
+            joined = new Set();
+            this.membership.set(conn, joined);
+        }
+        joined.add(room);
+    }
+    /** Remove a connection from every room it joined (on disconnect). */
+    leaveAll(conn) {
+        const joined = this.membership.get(conn);
+        if (!joined)
+            return;
+        for (const room of joined) {
+            const members = this.rooms.get(room);
+            if (members) {
+                members.delete(conn);
+                if (members.size === 0)
+                    this.rooms.delete(room);
+            }
+        }
+        this.membership.delete(conn);
+    }
+    /** Broadcast a frame to every connection in a room. */
+    broadcast(room, frame) {
+        const members = this.rooms.get(room);
+        if (!members)
+            return;
+        for (const conn of members) {
+            try {
+                conn.send(frame);
+            }
+            catch {
+                // A dead socket will be cleaned up on its close event.
+            }
+        }
+    }
+    /** Number of connections currently in a room. */
+    size(room) {
+        return this.rooms.get(room)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/server/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/server/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACP,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IACjD,UAAU,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEvE,IAAI,CAAC,IAAsB,EAAE,IAAY;QACxC,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElB,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,qEAAqE;IACrE,QAAQ,CAAC,IAAsB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;oBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,uDAAuD;IACvD,SAAS,CAAC,IAAY,EAAE,KAAgB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACJ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACR,uDAAuD;YACxD,CAAC;QACF,CAAC;IACF,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IACxC,CAAC;CACD"}

package/dist/server/ids.d.ts

@@ -0,0 +1,2 @@
+export declare function nextConnectionId(): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/server/ids.ts"],"names":[],"mappings":"AAGA,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC"}

package/dist/server/ids.js

@@ -0,0 +1,7 @@
+/** Monotonic connection-id generator (process-local). */
+let counter = 0;
+export function nextConnectionId() {
+    counter += 1;
+    return `conn-${counter}-${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/server/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/server/ids.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,UAAU,gBAAgB;IAC/B,OAAO,IAAI,CAAC,CAAC;IACb,OAAO,QAAQ,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * WebSocket transport server — barrel.
+ */
+export { PtyKitServer, createPtyKitServer, type PtyKitServerOptions, type AuthorizeContext, type AuthorizeHook, type AuthorizeOperation, type RoomContext, type RoomResolver, type UpgradeHook, } from './pty-kit-server.js';
+export { RoomRegistry, type PtyKitConnection } from './connection.js';
+//# 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;;GAEG;AAEH,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,6 @@
+/**
+ * WebSocket transport server — barrel.
+ */
+export { PtyKitServer, createPtyKitServer, } from './pty-kit-server.js';
+export { RoomRegistry } from './connection.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;;GAEG;AAEH,OAAO,EACN,YAAY,EACZ,kBAAkB,GAQlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAyB,MAAM,iBAAiB,CAAC"}

package/dist/server/pty-kit-server.d.ts

@@ -0,0 +1,101 @@
+/**
+ * `createPtyKitServer` — the WebSocket transport over a `PtyKit` manager.
+ *
+ * WebSocket only (R9). Control plane = RPC request/response keyed by
+ * `requestId`; data plane = events broadcast to a collaborative room (R11) and
+ * filtered client-side by `sessionId`. Access is enforced by the `authorize`
+ * hook with anti-hijack ownership checks (R10).
+ */
+import type { PtyKit } from '../core/pty-kit.js';
+import { type Logger } from '../shared/index.js';
+import { type PtyKitConnection } from './connection.js';
+/** The operation an `authorize` check guards. */
+export type AuthorizeOperation = 'create' | 'attach' | 'write' | 'resize' | 'kill';
+export interface AuthorizeContext {
+    operation: AuthorizeOperation;
+    namespace: string;
+    sessionId?: string;
+    conn: PtyKitConnection;
+}
+/** Decide whether a connection may perform an operation. Return `false` to deny. */
+export type AuthorizeHook = (ctx: AuthorizeContext) => boolean | Promise<boolean>;
+export interface RoomContext {
+    namespace: string;
+    sessionId?: string;
+    conn: PtyKitConnection;
+}
+/** Resolve the broadcast room for a context. Default: the namespace. */
+export type RoomResolver = (ctx: RoomContext) => string;
+/** Per-connection identity factory, run at upgrade. Return `false` to reject. */
+export type UpgradeHook = (request: any) => Record<string, unknown> | false | Promise<Record<string, unknown> | false>;
+export interface PtyKitServerOptions {
+    /** WebSocket path to accept upgrades on. Default `'/'`. */
+    path?: string;
+    /**
+     * Access hook (R10). **Defaults to allow-all** for local DX — production
+     * deployments MUST provide one. See the README security note.
+     */
+    authorize?: AuthorizeHook;
+    /** Collaborative room resolver (R11). Default `(ctx) => ctx.namespace`. */
+    room?: RoomResolver;
+    /** Attach identity to a connection at upgrade; return `false` to reject. */
+    onUpgrade?: UpgradeHook;
+    /** Diagnostics sink. Off by default. */
+    logger?: Logger;
+}
+export declare class PtyKitServer {
+    readonly manager: PtyKit;
+    readonly path: string;
+    private readonly rooms;
+    private readonly options;
+    private readonly logger;
+    private readonly resolveRoom;
+    private bunTransport?;
+    private nodeTransport?;
+    constructor(manager: PtyKit, options?: PtyKitServerOptions);
+    /** Resolve connection identity at upgrade. Returns `false` to reject. */
+    resolveUpgrade(request: any): Promise<Record<string, unknown> | false>;
+    handleOpen(_conn: PtyKitConnection): void;
+    handleClose(conn: PtyKitConnection): void;
+    /** Process one inbound raw message (string or bytes) from a connection. */
+    handleMessage(conn: PtyKitConnection, raw: string | ArrayBuffer | Uint8Array): Promise<void>;
+    private dispatch;
+    private respond;
+    private respondError;
+    private authorize;
+    /** Look up a session, deriving the namespace for an ownership check. */
+    private requireSession;
+    private broadcast;
+    /**
+     * Install the single room-broadcast listener pair for a session, after
+     * clearing any previous listeners (R7c) so switching/returning clients never
+     * double up output. Output broadcasts to the whole room (collaborative);
+     * clients filter by `sessionId`.
+     */
+    private wireBroadcast;
+    private handleEvent;
+    private handleRpc;
+    private opCreateSession;
+    private opResize;
+    private opCancel;
+    private opKill;
+    private opClear;
+    private opPtyStatus;
+    private opListSessions;
+    private opStreamStatus;
+    private opMissedOutput;
+    private opReconnect;
+    /** Mount onto a Node `http.Server` (uses the optional `ws` package). */
+    attach(httpServer: any): Promise<void>;
+    /** Bun `fetch` handler — upgrades matching requests; returns undefined otherwise. */
+    get fetch(): (request: Request, bunServer: any) => Promise<Response | undefined>;
+    /** Bun `websocket` handlers object to pass to `Bun.serve`. */
+    get websocket(): {
+        open: (ws: any) => void;
+        message: (ws: any, message: string | ArrayBuffer | Uint8Array) => void;
+        close: (ws: any) => void;
+    };
+}
+/** Create a WebSocket server over a `PtyKit` manager. */
+export declare function createPtyKitServer(manager: PtyKit, options?: PtyKitServerOptions): PtyKitServer;
+//# sourceMappingURL=pty-kit-server.d.ts.map