raffel 1.1.21 → 1.1.25-next.186fa05

package/dist/adapters/ssh-session.js

@@ -0,0 +1,202 @@
+/**
+ * SSH Adapter — Session factory
+ *
+ * Wraps an ssh2 ServerChannel into the user-facing SshSession surface.
+ * Owns the lifecycle: parses input keys, manages window-resize, dispatches
+ * close events, builds the lazy tuiuiu bridge.
+ */
+import { parseKeys } from './ssh-keys.js';
+import { createTuiBridge } from './ssh-tui-bridge.js';
+export function createSshSession(opts) {
+    const { id, user, authMethod, authData, client, env, channel, kind, command, subsystem } = opts;
+    let pty = opts.pty;
+    const abortController = new AbortController();
+    const resizeHandlers = new Set();
+    const closeHandlers = new Set();
+    let closed = false;
+    let tuiBridge = null;
+    // ----- raw key event channel -----
+    // We buffer parsed KeyEvents in a queue and resolve pending iterators.
+    const keyQueue = [];
+    let keyWaiter = null;
+    function pushKey(k) {
+        if (keyWaiter) {
+            const w = keyWaiter;
+            keyWaiter = null;
+            w({ value: k, done: false });
+            return;
+        }
+        keyQueue.push(k);
+    }
+    function endKeys() {
+        if (keyWaiter) {
+            const w = keyWaiter;
+            keyWaiter = null;
+            w({ value: undefined, done: true });
+        }
+    }
+    const onData = (chunk) => {
+        for (const k of parseKeys(chunk))
+            pushKey(k);
+    };
+    channel.on('data', onData);
+    channel.once('close', () => notifyClosed());
+    channel.once('end', () => notifyClosed());
+    function notifyClosed() {
+        if (closed)
+            return;
+        closed = true;
+        abortController.abort();
+        channel.off('data', onData);
+        endKeys();
+        for (const h of closeHandlers) {
+            try {
+                h();
+            }
+            catch { /* user handler error — swallow */ }
+        }
+        if (tuiBridge) {
+            try {
+                tuiBridge.destroy();
+            }
+            catch { /* noop */ }
+            tuiBridge = null;
+        }
+    }
+    // ----- stdout / stderr as Writable-like views over channel -----
+    // ssh2 ServerChannel already IS a Duplex stream — we expose it directly
+    // as `stdout`. For consistency with Node's TTY model, downstream code
+    // calls `session.write(...)` or accesses `session.stdout`.
+    const stdoutAsWritable = channel;
+    const session = {
+        id,
+        user,
+        authMethod,
+        authData,
+        client,
+        env,
+        pty,
+        kind,
+        command,
+        subsystem,
+        signal: abortController.signal,
+        get cols() {
+            return pty?.cols ?? 80;
+        },
+        get rows() {
+            return pty?.rows ?? 24;
+        },
+        get term() {
+            return pty?.term ?? 'xterm';
+        },
+        // ssh2 ServerChannel extends Duplex, so the same object IS both the
+        // readable input side and the writable output side. Multiple listeners
+        // on 'data' coexist fine (Node EventEmitter), so the key parser, the
+        // optional tui bridge, and user-attached listeners all receive chunks.
+        stdin: channel,
+        stdout: stdoutAsWritable,
+        stderr: channel.stderr,
+        write(text) {
+            if (closed)
+                return;
+            try {
+                channel.write(text);
+            }
+            catch {
+                // channel closed — ignore
+            }
+        },
+        clear() {
+            this.write('\x1b[2J\x1b[H');
+        },
+        get keys() {
+            return {
+                [Symbol.asyncIterator]() {
+                    return {
+                        next() {
+                            if (keyQueue.length > 0) {
+                                return Promise.resolve({ value: keyQueue.shift(), done: false });
+                            }
+                            if (closed) {
+                                return Promise.resolve({
+                                    value: undefined,
+                                    done: true,
+                                });
+                            }
+                            return new Promise((resolve) => {
+                                keyWaiter = resolve;
+                            });
+                        },
+                        return() {
+                            return Promise.resolve({
+                                value: undefined,
+                                done: true,
+                            });
+                        },
+                    };
+                },
+            };
+        },
+        onResize(handler) {
+            resizeHandlers.add(handler);
+        },
+        onClose(handler) {
+            if (closed) {
+                // Already closed — fire async
+                queueMicrotask(handler);
+                return;
+            }
+            closeHandlers.add(handler);
+        },
+        close(exitCode = 0) {
+            if (closed)
+                return;
+            try {
+                channel.exit(exitCode);
+            }
+            catch {
+                // already exited
+            }
+            try {
+                channel.end();
+            }
+            catch {
+                // already ended
+            }
+            notifyClosed();
+        },
+        get tui() {
+            if (!tuiBridge) {
+                tuiBridge = createTuiBridge({
+                    source: channel,
+                    sink: stdoutAsWritable,
+                    cols: session.cols,
+                    rows: session.rows,
+                });
+            }
+            return { stdin: tuiBridge.stdin, stdout: tuiBridge.stdout };
+        },
+        _updateSize(cols, rows) {
+            if (pty)
+                pty = { ...pty, cols, rows };
+            else
+                pty = { cols, rows, width: 0, height: 0, term: 'xterm' };
+            for (const h of resizeHandlers) {
+                try {
+                    h(cols, rows);
+                }
+                catch { /* swallow */ }
+            }
+            if (tuiBridge)
+                tuiBridge.updateSize(cols, rows);
+        },
+        _notifyClosed() {
+            notifyClosed();
+        },
+        _tuiBridge() {
+            return tuiBridge;
+        },
+    };
+    return session;
+}
+//# sourceMappingURL=ssh-session.js.map

package/dist/adapters/ssh-session.js.map

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

package/dist/adapters/ssh-tui-bridge.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SSH Adapter — tuiuiu.js bridge
+ *
+ * Wraps SSH session stdin/stdout streams as TTY-compatible streams that
+ * tuiuiu.js `render()` (and similar TUI libs that check `isTTY`) can use
+ * transparently.
+ *
+ * - `isTTY = true` so tuiuiu enters interactive mode
+ * - `columns` / `rows` exposed and kept in sync with SSH window-change
+ * - `setRawMode()` is a no-op (SSH already delivers raw input)
+ * - `'resize'` events forwarded so tuiuiu can re-layout
+ *
+ * The bridge does NOT depend on tuiuiu.js at runtime — it just produces
+ * streams compatible with what tuiuiu expects. Users dynamically import
+ * tuiuiu in their handler and pass `session.tui`.
+ */
+import type { Readable as ReadableType, Writable as WritableType } from 'node:stream';
+import type { TtyReadable, TtyWritable } from './ssh-types.js';
+export interface TuiBridge {
+    stdin: TtyReadable;
+    stdout: TtyWritable;
+    /** Update reported window size; emits 'resize' on stdout. */
+    updateSize(cols: number, rows: number): void;
+    /** Close both ends — for adapter cleanup. */
+    destroy(): void;
+}
+/**
+ * Build a TTY-compatible {stdin, stdout} pair forwarding to/from the SSH
+ * channel's underlying streams.
+ */
+export declare function createTuiBridge(opts: {
+    source: ReadableType;
+    sink: WritableType;
+    cols: number;
+    rows: number;
+}): TuiBridge;
+//# sourceMappingURL=ssh-tui-bridge.d.ts.map

package/dist/adapters/ssh-tui-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-tui-bridge.d.ts","sourceRoot":"","sources":["../../src/adapters/ssh-tui-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,aAAa,CAAA;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE9D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,MAAM,EAAE,WAAW,CAAA;IACnB,6DAA6D;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5C,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,SAAS,CAsEZ"}

package/dist/adapters/ssh-tui-bridge.js

@@ -0,0 +1,90 @@
+/**
+ * SSH Adapter — tuiuiu.js bridge
+ *
+ * Wraps SSH session stdin/stdout streams as TTY-compatible streams that
+ * tuiuiu.js `render()` (and similar TUI libs that check `isTTY`) can use
+ * transparently.
+ *
+ * - `isTTY = true` so tuiuiu enters interactive mode
+ * - `columns` / `rows` exposed and kept in sync with SSH window-change
+ * - `setRawMode()` is a no-op (SSH already delivers raw input)
+ * - `'resize'` events forwarded so tuiuiu can re-layout
+ *
+ * The bridge does NOT depend on tuiuiu.js at runtime — it just produces
+ * streams compatible with what tuiuiu expects. Users dynamically import
+ * tuiuiu in their handler and pass `session.tui`.
+ */
+import { Readable, Writable } from 'node:stream';
+/**
+ * Build a TTY-compatible {stdin, stdout} pair forwarding to/from the SSH
+ * channel's underlying streams.
+ */
+export function createTuiBridge(opts) {
+    let cols = opts.cols;
+    let rows = opts.rows;
+    // --- stdin: a Readable that mirrors `source` and exposes TTY surface
+    const stdin = new Readable({
+        read() {
+            // pulled on demand from source via 'data' listener below
+        },
+    });
+    stdin.isTTY = true;
+    stdin.setRawMode =
+        function setRawMode() {
+            return this;
+        };
+    const onSourceData = (chunk) => {
+        stdin.push(chunk);
+    };
+    const onSourceEnd = () => {
+        stdin.push(null);
+    };
+    opts.source.on('data', onSourceData);
+    opts.source.once('end', onSourceEnd);
+    opts.source.once('close', onSourceEnd);
+    // --- stdout: a Writable that forwards to `sink` and exposes TTY surface
+    const stdout = new Writable({
+        write(chunk, _enc, cb) {
+            // Best-effort write; ignore failed writes (channel may have closed)
+            try {
+                opts.sink.write(chunk, cb);
+            }
+            catch {
+                cb();
+            }
+        },
+    });
+    stdout.isTTY = true;
+    Object.defineProperty(stdout, 'columns', {
+        get: () => cols,
+        configurable: true,
+    });
+    Object.defineProperty(stdout, 'rows', {
+        get: () => rows,
+        configurable: true,
+    });
+    function updateSize(newCols, newRows) {
+        cols = newCols;
+        rows = newRows;
+        stdout.emit('resize');
+    }
+    function destroy() {
+        opts.source.off('data', onSourceData);
+        opts.source.off('end', onSourceEnd);
+        opts.source.off('close', onSourceEnd);
+        try {
+            stdin.push(null);
+        }
+        catch {
+            // already ended
+        }
+        try {
+            stdout.end();
+        }
+        catch {
+            // already ended
+        }
+    }
+    return { stdin, stdout, updateSize, destroy };
+}
+//# sourceMappingURL=ssh-tui-bridge.js.map

package/dist/adapters/ssh-tui-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-tui-bridge.js","sourceRoot":"","sources":["../../src/adapters/ssh-tui-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAahD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAK/B;IACC,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACpB,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IAEpB,sEAAsE;IACtE,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC;QACzB,IAAI;YACF,yDAAyD;QAC3D,CAAC;KACF,CAAwD,CACxD;IAAC,KAAuC,CAAC,KAAK,GAAG,IAAI,CACrD;IAAC,KAA4D,CAAC,UAAU;QACvE,SAAS,UAAU;YACjB,OAAO,IAAI,CAAA;QACb,CAAC,CAAA;IAEH,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC,CAAA;IACD,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC,CAAA;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAEtC,yEAAyE;IACzE,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;QAC1B,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACnB,oEAAoE;YACpE,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE,EAAE,CAAA;YACN,CAAC;QACH,CAAC;KACF,CAA2B,CAC3B;IAAC,MAAwC,CAAC,KAAK,GAAG,IAAI,CAAA;IACvD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE;QACvC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE;QACpC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IAEF,SAAS,UAAU,CAAC,OAAe,EAAE,OAAe;QAClD,IAAI,GAAG,OAAO,CAAA;QACd,IAAI,GAAG,OAAO,CAAA;QACd,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACvB,CAAC;IAED,SAAS,OAAO;QACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QACrC,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,EAAE,CAAA;QACd,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAA;AAC/C,CAAC"}

package/dist/adapters/ssh-types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * SSH Adapter — Types
+ *
+ * Public types for the SSH adapter. Requires `ssh2` (optional peer dep)
+ * at runtime. Types here are intentionally decoupled from ssh2's internal
+ * types so the public surface stays stable.
+ */
+import type { Readable, Writable } from 'node:stream';
+import type { ConnectionFilter } from './utils/connection-filter.js';
+/**
+ * A parsed key event from the SSH session stdin.
+ *
+ * Recognized names mirror Node's readline `keypress` event for familiarity:
+ * 'return' (Enter), 'escape', 'backspace', 'tab', 'space',
+ * 'up' | 'down' | 'left' | 'right', 'home' | 'end', 'pageup' | 'pagedown',
+ * 'insert' | 'delete', 'f1'..'f12', single chars ('a', 'b', '1', ...).
+ */
+export interface KeyEvent {
+    /** Raw bytes received from the client */
+    raw: Buffer;
+    /** UTF-8 string representation */
+    str: string;
+    /** Recognized key name, if any */
+    name?: string;
+    /** Ctrl modifier was held */
+    ctrl: boolean;
+    /** Shift modifier was held (best-effort for letter keys) */
+    shift: boolean;
+    /** Meta/Alt modifier was held */
+    meta: boolean;
+    /** Original escape sequence for unrecognized keys */
+    sequence?: string;
+}
+/**
+ * Information about the requesting SSH client.
+ */
+export interface SshClientInfo {
+    /** Remote IP address */
+    ip: string;
+    /** Remote port */
+    port: number;
+    /** Address family ('IPv4' | 'IPv6') */
+    family: string;
+    /** Client software identifier (e.g. 'SSH-2.0-OpenSSH_9.0') */
+    identRaw: string;
+}
+/**
+ * Authentication request the user handler can accept or reject.
+ *
+ * Returning `true` accepts; returning `false` (or throwing) rejects.
+ */
+export type SshAuthHandler = ((req: SshAuthRequest) => boolean | Promise<boolean>) | true;
+export interface SshAuthRequest {
+    /** Username supplied by the client */
+    username: string;
+    /** Auth method being attempted */
+    method: 'none' | 'password' | 'publickey' | 'keyboard-interactive' | 'hostbased';
+    /** Password, when method === 'password' */
+    password?: string;
+    /** Public key info, when method === 'publickey' */
+    publicKey?: {
+        algo: string;
+        data: Buffer;
+    };
+    /** Client info */
+    client: SshClientInfo;
+}
+/**
+ * SSH authentication configuration. At least one method should be enabled.
+ */
+export interface SshAuthOptions {
+    /**
+     * Allow anonymous (no-auth) connections. Default: false.
+     * When true, the username sent by the client is preserved but no
+     * credential is required (terminal.shop-style).
+     */
+    none?: boolean | SshAuthHandler;
+    /** Password verifier */
+    password?: SshAuthHandler;
+    /** Public key verifier */
+    publicKey?: SshAuthHandler;
+}
+/**
+ * Pseudo-TTY information for the session.
+ */
+export interface SshPtyInfo {
+    cols: number;
+    rows: number;
+    width: number;
+    height: number;
+    term: string;
+}
+/**
+ * Handler invoked once an authenticated client opens a shell or subsystem.
+ *
+ * The handler controls the session lifecycle — it should `await` something
+ * (e.g. `session.signal` aborting, or `session.keys` iteration) to keep the
+ * channel open. When the handler returns, the session is closed.
+ */
+export type SshSessionHandler = (session: SshSession) => void | Promise<void>;
+/**
+ * The high-level SSH session object passed to user handlers.
+ *
+ * Provides three layers of API:
+ *   1. Raw streams — `stdin`, `stdout`, `stderr`
+ *   2. Helpers — `write`, `clear`, `keys`, `onResize`
+ *   3. tuiuiu bridge — `tui` (lazy)
+ *
+ * The session is closed when the handler returns, when the client
+ * disconnects, or when `close()` is called.
+ */
+export interface SshSession {
+    /** Unique session id */
+    readonly id: string;
+    /** Authenticated username */
+    readonly user: string;
+    /**
+     * Auth method used by this session.
+     * 'none' = anonymous (public access).
+     * Use this in handlers to branch between public and private behavior.
+     */
+    readonly authMethod: 'none' | 'password' | 'publickey';
+    /**
+     * Auth-method-specific data. Useful for identifying authenticated users
+     * (e.g. key fingerprint from publicKey auth).
+     */
+    readonly authData: {
+        publicKey?: {
+            algo: string;
+            data: Buffer;
+        };
+    };
+    /** Remote client info */
+    readonly client: SshClientInfo;
+    /** Environment variables the client requested (SetEnv) */
+    readonly env: Record<string, string>;
+    /** Pseudo-TTY info, or null if the client did not request a pty */
+    readonly pty: SshPtyInfo | null;
+    /** Convenience: current cols (or 80 if no pty) */
+    readonly cols: number;
+    /** Convenience: current rows (or 24 if no pty) */
+    readonly rows: number;
+    /** Convenience: current TERM (or 'xterm' if no pty) */
+    readonly term: string;
+    /** Raw stdin from the client (the pty input). */
+    readonly stdin: Readable;
+    /** Raw stdout to the client. */
+    readonly stdout: Writable;
+    /** Raw stderr to the client. */
+    readonly stderr: Writable;
+    /** Whether the client requested a 'shell' (interactive) vs an 'exec' (one-shot command). */
+    readonly kind: 'shell' | 'exec' | 'subsystem';
+    /** For 'exec' sessions: the command line. */
+    readonly command?: string;
+    /** For 'subsystem' sessions: the subsystem name. */
+    readonly subsystem?: string;
+    /** Aborts when the session closes (either side). */
+    readonly signal: AbortSignal;
+    /** Write text to stdout. Convenience for `stdout.write(text)`. */
+    write(text: string | Uint8Array): void;
+    /** Clear screen and home cursor (ANSI `\x1b[2J\x1b[H`). */
+    clear(): void;
+    /** Async iterable of parsed key events from stdin. */
+    readonly keys: AsyncIterable<KeyEvent>;
+    /** Register a window-resize handler. Fires with new cols/rows. */
+    onResize(handler: (cols: number, rows: number) => void): void;
+    /** Register a close handler. */
+    onClose(handler: () => void): void;
+    /** Close the session. Optional exit code (default 0). */
+    close(exitCode?: number): void;
+    /**
+     * Lazy TTY-compatible streams for use with tuiuiu.js `render()`.
+     * Returns `{ stdin, stdout }` where both wrap the raw streams with
+     * `isTTY = true`, `columns`, `rows`, and resize events.
+     *
+     * Throws if tuiuiu.js is not installed.
+     */
+    readonly tui: {
+        stdin: TtyReadable;
+        stdout: TtyWritable;
+    };
+}
+/**
+ * Minimal TTY-like Readable surface (subset Node's process.stdin offers).
+ * Used by the tuiuiu bridge — declared here to avoid leaking ssh2 types.
+ */
+export interface TtyReadable extends Readable {
+    isTTY: true;
+    setRawMode?(mode: boolean): this;
+}
+/**
+ * Minimal TTY-like Writable surface.
+ */
+export interface TtyWritable extends Writable {
+    isTTY: true;
+    columns: number;
+    rows: number;
+}
+/**
+ * Host key — either a PEM/OpenSSH-formatted Buffer/string, or an object
+ * with key + passphrase for encrypted keys.
+ */
+export type SshHostKey = Buffer | string | {
+    key: Buffer | string;
+    passphrase?: Buffer | string;
+};
+/**
+ * SSH adapter configuration.
+ */
+export interface SshAdapterOptions {
+    /** Port to listen on (typical: 2222 for dev, 22 needs root) */
+    port: number;
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /**
+     * Host private keys. If omitted or empty, an ephemeral RSA 2048 key is
+     * generated on `start()` — fine for dev, NOT for production (clients
+     * will see a key-changed warning each restart). For production, pass
+     * a stable key from disk.
+     */
+    hostKeys?: SshHostKey[];
+    /** Banner sent to clients before authentication. */
+    banner?: string;
+    /** Server software ident (default: 'SSH-2.0-Raffel') */
+    ident?: string;
+    /**
+     * Authentication configuration. If omitted, `none` is enabled
+     * (anonymous access) — terminal.shop-style. Override for real auth.
+     */
+    auth?: SshAuthOptions;
+    /**
+     * Session handler invoked once a client opens a shell.
+     * Required for the adapter to be useful.
+     */
+    onSession: SshSessionHandler;
+    /**
+     * Handler for `exec` requests (e.g. `ssh host some-command`).
+     * If omitted, exec requests are rejected.
+     */
+    onExec?: SshSessionHandler;
+    /**
+     * Handlers for named subsystems (e.g. SFTP would be 'sftp').
+     * If omitted, subsystem requests are rejected.
+     */
+    subsystems?: Record<string, SshSessionHandler>;
+    /** Inbound connection filter — controls which source IPs may connect. */
+    filter?: ConnectionFilter;
+    /** Keep-alive interval (ms). Default: 30000. 0 disables. */
+    keepAliveInterval?: number;
+    /** Max failed keep-alive attempts before dropping. Default: 3. */
+    keepAliveMaxFailures?: number;
+}
+/**
+ * SSH adapter handle.
+ */
+export interface SshAdapter {
+    /** Start the SSH server. */
+    start(): Promise<void>;
+    /** Stop the server and close all sessions. */
+    stop(): Promise<void>;
+    /** Number of currently active sessions. */
+    readonly sessionCount: number;
+    /** Bound port (after start). */
+    readonly port: number;
+    /** Bound host (after start). */
+    readonly host: string;
+}
+//# sourceMappingURL=ssh-types.d.ts.map

package/dist/adapters/ssh-types.d.ts.map

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

package/dist/adapters/ssh-types.js

@@ -0,0 +1,9 @@
+/**
+ * SSH Adapter — Types
+ *
+ * Public types for the SSH adapter. Requires `ssh2` (optional peer dep)
+ * at runtime. Types here are intentionally decoupled from ssh2's internal
+ * types so the public surface stays stable.
+ */
+export {};
+//# sourceMappingURL=ssh-types.js.map

package/dist/adapters/ssh-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-types.js","sourceRoot":"","sources":["../../src/adapters/ssh-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}