tmuxes 0.1.0

package/dist/tmux/builder.js

@@ -0,0 +1,128 @@
+import { homedir } from 'node:os';
+import { config } from '../config.js';
+import { sshDestination } from '../targets.js';
+/**
+ * Single-quote a string for a POSIX shell. Needed ONLY for the remote ssh path:
+ * ssh concatenates the remote command words with spaces and re-parses them
+ * through the remote login shell, so each tmux arg must survive that re-parse.
+ * Local commands use pure argv (no shell) and need no quoting.
+ */
+export function sshQuote(arg) {
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+/** Local tmux management/attach argv — passed straight to spawn (shell:false). */
+export function localTmux(sub) {
+    return ['tmux', ...sub];
+}
+/**
+ * Remote tmux argv via the system ssh binary.
+ * - tty:false (management) → BatchMode + short ConnectTimeout so it fails fast
+ *   and never hangs on a prompt. Remote args are sshQuote'd.
+ * - tty:true (interactive attach) → -tt forces a remote PTY (and SIGWINCH
+ *   propagation). BatchMode is left default so host-key/agent prompts surface
+ *   in the terminal. Remote args are NOT quoted here: this argv is handed to a
+ *   PTY where the remote command words go to ssh as separate argv elements and
+ *   our inputs are already allowlist-validated.
+ */
+export function remoteTmux(t, sub, opts) {
+    const dest = sshDestination(t);
+    const portArgs = t.port ? ['-p', String(t.port)] : [];
+    if (opts.tty) {
+        return [
+            'ssh',
+            '-tt',
+            '-o',
+            `ConnectTimeout=${config.ssh.connectTimeoutTty}`,
+            '-o',
+            `ServerAliveInterval=${config.ssh.serverAliveInterval}`,
+            ...portArgs,
+            dest,
+            'tmux',
+            ...sub,
+        ];
+    }
+    return [
+        'ssh',
+        '-o',
+        'BatchMode=yes',
+        '-o',
+        `ConnectTimeout=${config.ssh.connectTimeoutMgmt}`,
+        ...portArgs,
+        dest,
+        'tmux',
+        ...sub.map(sshQuote),
+    ];
+}
+/**
+ * tmux inside a WSL distro (Windows host). We use `--exec` (NOT `--`): `--`
+ * runs the command through the distro's login shell, which would re-parse tmux
+ * format strings (`#{...}` is a comment, `|` a pipe) and mangle them; `--exec`
+ * execs the binary directly with no shell, so argv maps straight through with
+ * no quoting — like the local path. The interactive case sets TERM via `env`
+ * because WSL does not inherit the Windows TERM.
+ */
+export function wslTmux(distro, sub, opts) {
+    const prefix = opts.tty ? ['env', 'TERM=xterm-256color', 'tmux'] : ['tmux'];
+    return ['wsl.exe', '-d', distro, '--exec', ...prefix, ...sub];
+}
+/**
+ * Build a non-PTY argv to run an ARBITRARY command on a target (tmux, ls, cat,
+ * display-message, …). Same transport rules as management tmux: local runs the
+ * argv directly, wsl uses `--exec` (no shell), ssh uses BatchMode + sshQuote.
+ */
+export function commandArgv(t, argv) {
+    let full;
+    if (t.kind === 'local') {
+        full = argv;
+    }
+    else if (t.kind === 'wsl') {
+        full = ['wsl.exe', '-d', t.distro ?? '', '--exec', ...argv];
+    }
+    else {
+        const portArgs = t.port ? ['-p', String(t.port)] : [];
+        full = [
+            'ssh',
+            '-o',
+            'BatchMode=yes',
+            '-o',
+            `ConnectTimeout=${config.ssh.connectTimeoutMgmt}`,
+            ...portArgs,
+            sshDestination(t),
+            ...argv.map(sshQuote),
+        ];
+    }
+    return { file: full[0], args: full.slice(1) };
+}
+/** Build a management argv (no PTY) for a local / ssh / wsl target. */
+export function managementArgv(t, sub) {
+    return commandArgv(t, ['tmux', ...sub]);
+}
+/**
+ * Build the create-a-new-session argv, always starting in the user's HOME:
+ * - local → tmux `-c <homedir>` (explicit, regardless of the server's cwd),
+ * - wsl   → `wsl --cd ~` runs the command from the distro's home; tmux inherits,
+ * - ssh   → the remote command already runs from the remote `$HOME`; tmux inherits.
+ * `sub` is the new-session subcommand (named or auto-named `-P` form).
+ */
+export function newSessionArgv(t, sub) {
+    if (t.kind === 'local') {
+        return { file: 'tmux', args: [...sub, '-c', homedir()] };
+    }
+    if (t.kind === 'wsl') {
+        return { file: 'wsl.exe', args: ['-d', t.distro ?? '', '--cd', '~', '--exec', 'tmux', ...sub] };
+    }
+    return commandArgv(t, ['tmux', ...sub]);
+}
+/** Build an interactive attach argv (run inside a PTY) for a local / ssh / wsl target. */
+export function attachArgv(t, session) {
+    const sub = ['new-session', '-A', '-s', session]; // NO -d: the PTY supplies the terminal
+    let argv;
+    if (t.kind === 'local')
+        argv = localTmux(sub);
+    else if (t.kind === 'wsl')
+        argv = wslTmux(t.distro ?? '', sub, { tty: true });
+    else
+        argv = remoteTmux(t, sub, { tty: true });
+    return { file: argv[0], args: argv.slice(1) };
+}
+//# sourceMappingURL=builder.js.map

package/dist/tmux/builder.js.map

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

package/dist/tmux/formats.js

@@ -0,0 +1,55 @@
+/** tmux -F format strings + parsers.
+ *
+ *  tmux ESCAPES control characters in -F output (e.g. 0x1f comes back as the
+ *  literal text "\037"), so we cannot use a control byte as a separator. We use
+ *  a printable "|" and place the only free-form field (the name) LAST, then
+ *  rejoin the remainder — robust even if a name itself contains "|", because
+ *  the leading numeric fields never do. */
+const SEP = '|';
+export const SESSION_FORMAT = [
+    '#{session_windows}',
+    '#{session_attached}',
+    '#{session_created}',
+    '#{session_name}', // free-form → must be last
+].join(SEP);
+export const WINDOW_FORMAT = [
+    '#{window_index}',
+    '#{window_panes}',
+    '#{window_active}',
+    '#{window_name}', // free-form → must be last
+].join(SEP);
+export function parseSessions(stdout) {
+    return stdout
+        .split('\n')
+        .filter((l) => l.length > 0)
+        .map((line) => {
+        const parts = line.split(SEP);
+        return {
+            windows: Number(parts[0]) || 0,
+            attached: Number(parts[1]) > 0,
+            created: Number(parts[2]) || 0,
+            name: parts.slice(3).join(SEP), // name may legitimately contain "|"
+        };
+    })
+        .filter((s) => s.name);
+}
+export function parseWindows(stdout) {
+    return stdout
+        .split('\n')
+        .filter((l) => l.length > 0)
+        .map((line) => {
+        const parts = line.split(SEP);
+        return {
+            index: Number(parts[0]) || 0,
+            panes: Number(parts[1]) || 0,
+            active: Number(parts[2]) > 0,
+            name: parts.slice(3).join(SEP),
+        };
+    });
+}
+/** stderr patterns that mean "no sessions" rather than a real error. */
+const EMPTY_RE = /no server running|no sessions|error connecting to/i;
+export function isEmptySessionsError(stderr) {
+    return EMPTY_RE.test(stderr);
+}
+//# sourceMappingURL=formats.js.map

package/dist/tmux/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/tmux/formats.ts"],"names":[],"mappings":"AAAA;;;;;;2CAM2C;AAE3C,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB,EAAE,2BAA2B;CAC/C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,gBAAgB,EAAE,2BAA2B;CAC9C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAiBZ,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9B,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,oCAAoC;SACrE,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,wEAAwE;AACxE,MAAM,QAAQ,GAAG,oDAAoD,CAAC;AAEtE,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/tmux/sessions.js

@@ -0,0 +1,99 @@
+import { runCommand } from '../exec.js';
+import { managementArgv, newSessionArgv } from './builder.js';
+import { SESSION_FORMAT, WINDOW_FORMAT, parseSessions, parseWindows, isEmptySessionsError, } from './formats.js';
+import { isValidSessionName } from '../validate.js';
+/** A management error carrying the HTTP status the router should return. */
+export class TmuxError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'TmuxError';
+    }
+}
+// Hard ceiling so a wedged ssh can never hang a request (ssh also has ConnectTimeout).
+const REMOTE_TIMEOUT_MS = 15_000;
+function timeoutFor(target) {
+    // Bound ssh (network) and wsl (possible cold start) so a request can't hang.
+    return target.kind === 'local' ? undefined : REMOTE_TIMEOUT_MS;
+}
+async function run(target, sub) {
+    const { file, args } = managementArgv(target, sub);
+    return runCommand(file, args, { timeoutMs: timeoutFor(target) });
+}
+function firstStderrLine(stderr) {
+    return stderr.trim().split('\n')[0] || 'command failed';
+}
+export async function listSessions(target) {
+    const r = await run(target, ['list-sessions', '-F', SESSION_FORMAT]);
+    if (r.code === 0)
+        return parseSessions(r.stdout);
+    // "no server running" / "no sessions" is the normal empty case.
+    if (isEmptySessionsError(r.stderr))
+        return [];
+    throw new TmuxError(502, firstStderrLine(r.stderr));
+}
+export async function createSession(target, opts) {
+    let name = opts.name;
+    // New sessions always start in the user's home directory (newSessionArgv).
+    if (name) {
+        if (!isValidSessionName(name))
+            throw new TmuxError(400, 'invalid session name');
+        const { file, args } = newSessionArgv(target, ['new-session', '-d', '-s', name]);
+        const r = await runCommand(file, args, { timeoutMs: timeoutFor(target) });
+        if (r.code !== 0) {
+            if (/duplicate session/i.test(r.stderr)) {
+                throw new TmuxError(409, `session "${name}" already exists`);
+            }
+            throw new TmuxError(502, firstStderrLine(r.stderr));
+        }
+    }
+    else {
+        // Let tmux assign a numeric name and report it back.
+        const { file, args } = newSessionArgv(target, ['new-session', '-d', '-P', '-F', '#{session_name}']);
+        const r = await runCommand(file, args, { timeoutMs: timeoutFor(target) });
+        if (r.code !== 0)
+            throw new TmuxError(502, firstStderrLine(r.stderr));
+        name = r.stdout.trim();
+    }
+    if (opts.command && opts.command.length > 0) {
+        // Type the command literally, then press Enter. Two send-keys calls so the
+        // command text can never be misparsed as a key name.
+        await run(target, ['send-keys', '-t', name, '-l', opts.command]);
+        await run(target, ['send-keys', '-t', name, 'Enter']);
+    }
+    return { name };
+}
+export async function renameSession(target, name, newName) {
+    if (!isValidSessionName(newName))
+        throw new TmuxError(400, 'invalid new session name');
+    const r = await run(target, ['rename-session', '-t', name, newName]);
+    if (r.code === 0)
+        return;
+    if (/can't find session|session not found/i.test(r.stderr)) {
+        throw new TmuxError(404, `session "${name}" not found`);
+    }
+    if (/duplicate session/i.test(r.stderr)) {
+        throw new TmuxError(409, `session "${newName}" already exists`);
+    }
+    throw new TmuxError(502, firstStderrLine(r.stderr));
+}
+export async function killSession(target, name) {
+    const r = await run(target, ['kill-session', '-t', name]);
+    if (r.code === 0)
+        return;
+    if (/can't find session|session not found|no server running/i.test(r.stderr)) {
+        throw new TmuxError(404, `session "${name}" not found`);
+    }
+    throw new TmuxError(502, firstStderrLine(r.stderr));
+}
+export async function listWindows(target, name) {
+    const r = await run(target, ['list-windows', '-t', name, '-F', WINDOW_FORMAT]);
+    if (r.code === 0)
+        return parseWindows(r.stdout);
+    if (/can't find session|session not found|no server running/i.test(r.stderr)) {
+        throw new TmuxError(404, `session "${name}" not found`);
+    }
+    throw new TmuxError(502, firstStderrLine(r.stderr));
+}
+//# sourceMappingURL=sessions.js.map

package/dist/tmux/sessions.js.map

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

package/dist/validate.js

@@ -0,0 +1,65 @@
+/**
+ * Allowlist validation. Every value that reaches a spawned tmux/ssh argv is
+ * checked here first. We never spawn a shell (argv arrays + shell:false), so
+ * this is defense-in-depth, but it also keeps tmux target syntax sane.
+ */
+// '.' and ':' are tmux target delimiters (session:window.pane) — forbidden in names.
+const SESSION_NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const HOST_RE = /^[A-Za-z0-9._-]{1,255}$/;
+const USER_RE = /^[A-Za-z0-9._-]{1,64}$/;
+// ssh_config Host aliases: word chars, dots, hyphens (no wildcards/spaces).
+const HOST_ALIAS_RE = /^[A-Za-z0-9._-]{1,255}$/;
+export function isValidSessionName(name) {
+    return typeof name === 'string' && SESSION_NAME_RE.test(name);
+}
+export function isValidHost(host) {
+    return typeof host === 'string' && HOST_RE.test(host);
+}
+export function isValidUser(user) {
+    return typeof user === 'string' && USER_RE.test(user);
+}
+export function isValidHostAlias(alias) {
+    return typeof alias === 'string' && HOST_ALIAS_RE.test(alias);
+}
+export function isValidPort(port) {
+    return (typeof port === 'number' &&
+        Number.isInteger(port) &&
+        port >= 1 &&
+        port <= 65535);
+}
+/** Terminal geometry sent by clients. */
+export function isValidDimension(n) {
+    return typeof n === 'number' && Number.isInteger(n) && n >= 1 && n <= 1000;
+}
+/**
+ * Parse a "user@host:port" spec (used by the TMUXES_HOSTS env override).
+ * Returns null if any component is invalid.
+ */
+export function parseHostSpec(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed)
+        return null;
+    let user;
+    let rest = trimmed;
+    const at = rest.indexOf('@');
+    if (at !== -1) {
+        user = rest.slice(0, at);
+        rest = rest.slice(at + 1);
+        if (!isValidUser(user))
+            return null;
+    }
+    let port;
+    const colon = rest.indexOf(':');
+    if (colon !== -1) {
+        const portStr = rest.slice(colon + 1);
+        rest = rest.slice(0, colon);
+        const parsed = Number(portStr);
+        if (!isValidPort(parsed))
+            return null;
+        port = parsed;
+    }
+    if (!isValidHost(rest))
+        return null;
+    return { user, host: rest, port };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qFAAqF;AACrF,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAC1C,MAAM,OAAO,GAAG,wBAAwB,CAAC;AACzC,4EAA4E;AAC5E,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEhD,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC;QACT,IAAI,IAAI,KAAK,CACd,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC7E,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,IAAwB,CAAC;IAC7B,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACd,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,IAAwB,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,GAAG,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/winshell/manager.js

@@ -0,0 +1,258 @@
+import * as pty from 'node-pty';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { isWindows } from '../platform.js';
+import { log } from '../logger.js';
+const SCROLLBACK_CAP = 256 * 1024; // bytes of history replayed to a new client
+function nowEpoch() {
+    return Math.floor(Date.now() / 1000);
+}
+/** One persistent native shell (its own pty), shared by 0..N attached clients.
+ *  Survives client disconnects (the pty lives until killed or it exits), which
+ *  is what gives "refresh / reconnect / multi-tab" persistence. */
+export class WinShellSession {
+    name;
+    shell;
+    ptyProc;
+    onClosed;
+    created = nowEpoch();
+    clients = new Set();
+    scroll = [];
+    scrollBytes = 0;
+    disposed = false;
+    constructor(name, shell, ptyProc, onClosed) {
+        this.name = name;
+        this.shell = shell;
+        this.ptyProc = ptyProc;
+        this.onClosed = onClosed;
+        this.ptyProc.onData((d) => this.onData(d));
+        this.ptyProc.onExit(({ exitCode }) => this.onExit(exitCode));
+    }
+    get attached() {
+        return this.clients.size > 0;
+    }
+    onData(data) {
+        const buf = Buffer.from(data, 'utf8');
+        this.scroll.push(buf);
+        this.scrollBytes += buf.length;
+        while (this.scrollBytes > SCROLLBACK_CAP && this.scroll.length > 1) {
+            this.scrollBytes -= this.scroll.shift().length;
+        }
+        for (const c of this.clients)
+            if (c.isOpen())
+                c.sendBinary(buf);
+    }
+    onExit(code) {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const c of this.clients) {
+            c.sendControl({ type: 'exit', code });
+            c.close(1000, 'shell exited');
+        }
+        this.clients.clear();
+        this.onClosed(this.name);
+    }
+    /** Add a client: replay history, then it's live. Caller sends `ready` after. */
+    attach(client) {
+        if (this.scroll.length)
+            client.sendBinary(Buffer.concat(this.scroll));
+        this.clients.add(client);
+    }
+    detach(client) {
+        this.clients.delete(client); // pty stays alive — persistence across reconnects
+    }
+    write(data) {
+        if (!this.disposed)
+            this.ptyProc.write(data);
+    }
+    resize(cols, rows) {
+        try {
+            this.ptyProc.resize(cols, rows);
+        }
+        catch {
+            /* pty may have exited */
+        }
+    }
+    info() {
+        return { name: this.name, windows: 1, attached: this.attached, created: this.created };
+    }
+    dispose() {
+        if (this.disposed) {
+            this.onClosed(this.name);
+            return;
+        }
+        this.disposed = true;
+        try {
+            this.ptyProc.kill();
+        }
+        catch {
+            /* already gone */
+        }
+        for (const c of this.clients)
+            c.close(1000, 'killed');
+        this.clients.clear();
+        this.onClosed(this.name);
+    }
+}
+const NAME_RE = /^[A-Za-z0-9_-]{1,64}$/;
+/** Owns all native shell sessions for the local Windows machine. */
+export class WinShellManager {
+    sessions = new Map();
+    shells;
+    constructor(shells) {
+        this.shells = shells ?? detectShells();
+    }
+    listShells() {
+        return this.shells.map((s) => ({ id: s.id, label: s.label }));
+    }
+    resolveShell(shellId) {
+        if (shellId) {
+            const found = this.shells.find((s) => s.id === shellId);
+            if (found)
+                return found;
+        }
+        if (this.shells.length === 0)
+            throw new Error('no shell available');
+        return this.shells[0];
+    }
+    list() {
+        return [...this.sessions.values()]
+            .map((s) => s.info())
+            .sort((a, b) => a.created - b.created);
+    }
+    windows(name) {
+        const s = this.sessions.get(name);
+        if (!s)
+            return [];
+        return [{ index: 0, name: s.shell.label, panes: 1, active: true }];
+    }
+    has(name) {
+        return this.sessions.has(name);
+    }
+    autoName(shell) {
+        for (let i = 1; i < 10000; i++) {
+            const candidate = `${shell.id}-${i}`;
+            if (!this.sessions.has(candidate))
+                return candidate;
+        }
+        return `${shell.id}-${nowEpoch()}`;
+    }
+    /** Create a new shell session. Returns the (possibly auto-assigned) name. */
+    create(opts) {
+        const shell = this.resolveShell(opts.shellId);
+        const name = opts.name ?? this.autoName(shell);
+        if (!NAME_RE.test(name))
+            throw new ManagerError(400, 'invalid session name');
+        if (this.sessions.has(name))
+            throw new ManagerError(409, `session "${name}" already exists`);
+        const cols = opts.cols ?? 80;
+        const rows = opts.rows ?? 24;
+        let proc;
+        try {
+            proc = pty.spawn(shell.file, shell.args, {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd: homedir(),
+                env: { ...process.env, TERM: 'xterm-256color' },
+            });
+        }
+        catch (e) {
+            throw new ManagerError(502, `failed to start ${shell.label}: ${e.message}`);
+        }
+        const session = new WinShellSession(name, shell, proc, (n) => this.sessions.delete(n));
+        this.sessions.set(name, session);
+        if (opts.command && opts.command.length > 0)
+            session.write(`${opts.command}\r`);
+        log.info(`winshell created ${name} (${shell.label})`);
+        return { name };
+    }
+    rename(oldName, newName) {
+        if (!NAME_RE.test(newName))
+            throw new ManagerError(400, 'invalid new session name');
+        const s = this.sessions.get(oldName);
+        if (!s)
+            throw new ManagerError(404, `session "${oldName}" not found`);
+        if (this.sessions.has(newName))
+            throw new ManagerError(409, `session "${newName}" already exists`);
+        // Re-key the same live instance (its pty handlers read `this.name`).
+        this.sessions.delete(oldName);
+        s.name = newName;
+        this.sessions.set(newName, s);
+    }
+    kill(name) {
+        const s = this.sessions.get(name);
+        if (!s)
+            throw new ManagerError(404, `session "${name}" not found`);
+        s.dispose();
+    }
+    /** Attach a client to an existing session, creating it (default shell) if missing. */
+    attachOrCreate(name, cols, rows, client) {
+        let s = this.sessions.get(name);
+        if (!s) {
+            this.create({ name, cols, rows });
+            s = this.sessions.get(name);
+        }
+        else {
+            s.resize(cols, rows);
+        }
+        s.attach(client);
+        return s;
+    }
+    disposeAll() {
+        for (const s of [...this.sessions.values()])
+            s.dispose();
+    }
+}
+/** Manager error carrying an HTTP status for the router. */
+export class ManagerError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'ManagerError';
+    }
+}
+/** Detect launchable shells for this machine. Windows: PowerShell 7 (if on
+ *  PATH) → Windows PowerShell → cmd → Git Bash. Otherwise (test/fake): the
+ *  user's shell, so the whole path can be exercised on Linux. */
+export function detectShells() {
+    if (!isWindows) {
+        const file = process.env.SHELL || '/bin/bash';
+        return [{ id: 'shell', label: file.split('/').pop() || 'shell', file, args: ['-i'] }];
+    }
+    const shells = [];
+    const sysRoot = process.env.SystemRoot || process.env.windir || 'C:\\Windows';
+    const pwsh = findOnPath('pwsh.exe');
+    if (pwsh)
+        shells.push({ id: 'pwsh', label: 'PowerShell 7', file: pwsh, args: ['-NoLogo'] });
+    const winPs = join(sysRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    if (existsSync(winPs))
+        shells.push({ id: 'powershell', label: 'Windows PowerShell', file: winPs, args: ['-NoLogo'] });
+    const cmd = join(sysRoot, 'System32', 'cmd.exe');
+    if (existsSync(cmd))
+        shells.push({ id: 'cmd', label: 'Command Prompt', file: cmd, args: [] });
+    const gitBash = 'C:\\Program Files\\Git\\bin\\bash.exe';
+    if (existsSync(gitBash))
+        shells.push({ id: 'gitbash', label: 'Git Bash', file: gitBash, args: ['-i', '-l'] });
+    // Last-resort fallback so the target is never shell-less.
+    if (shells.length === 0)
+        shells.push({ id: 'cmd', label: 'Command Prompt', file: 'cmd.exe', args: [] });
+    return shells;
+}
+function findOnPath(exe) {
+    const dirs = (process.env.PATH || '').split(isWindows ? ';' : ':');
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        const candidate = join(dir, exe);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/** Singleton used by the REST and WS layers. */
+export const winShell = new WinShellManager();
+//# sourceMappingURL=manager.js.map

package/dist/winshell/manager.js.map

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

package/dist/ws/protocol.js

@@ -0,0 +1,4 @@
+/** Shared WebSocket control-message types. Terminal bytes travel as BINARY
+ *  frames; everything below travels as TEXT (JSON) frames. */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/ws/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/ws/protocol.ts"],"names":[],"mappings":"AAAA;8DAC8D"}