@pentoshi/clai 3.9.4 → 3.9.6

package/dist/interactive-session/transport-node-pty.js

@@ -1,219 +0,0 @@
-/**
- * Optional PTY transport.
- *
- * `node-pty` is an optional dependency loaded through a lazy dynamic import so
- * an absent or unloadable native artifact degrades capability instead of failing
- * application startup. Capability is per-platform and only claimed after the
- * module actually loads in this packaged layout; the release pipeline must prove
- * load/spawn/resize/cleanup on a matching-target runner before advertising it.
- */
-import { processIdentityTracker } from "../os/process-identity.js";
-import { supportsProcessGroups, terminateProcessTree, } from "../os/process-tree.js";
-import { resolveShell } from "../tools/shell.js";
-import { LaunchFailure, ptyControlBytes, } from "./transport.js";
-const MODULE_SPECIFIER = "node-pty";
-let loadPromise;
-let loadFailureReason;
-/** Lazily load node-pty at most once per process. */
-async function loadNodePty() {
-    loadPromise ??= (async () => {
-        try {
-            // Indirect specifier keeps the optional dependency out of the static
-            // import graph so startup, pipe mode, and legacy tools never load it.
-            const loaded = (await import(/* @vite-ignore */ MODULE_SPECIFIER));
-            const module = "spawn" in loaded ? loaded : loaded.default;
-            if (typeof module?.spawn !== "function") {
-                loadFailureReason = "node-pty loaded without a usable spawn export";
-                return undefined;
-            }
-            return module;
-        }
-        catch (error) {
-            loadFailureReason =
-                error instanceof Error && error.message.includes("Cannot find module")
-                    ? "node-pty is not installed for this target"
-                    : "node-pty native module failed to load for this target";
-            return undefined;
-        }
-    })();
-    return await loadPromise;
-}
-export async function probePtyCapability(platform = process.platform) {
-    const module = await loadNodePty();
-    if (module)
-        return { available: true, platform };
-    return {
-        available: false,
-        platform,
-        reason: loadFailureReason ?? "PTY capability is unavailable on this target",
-    };
-}
-/** Test seam: reset the memoized load so capability can be re-evaluated. */
-export function resetPtyCapabilityCache() {
-    loadPromise = undefined;
-    loadFailureReason = undefined;
-}
-class NodePtyTransport {
-    pty;
-    kind = "pty";
-    pid;
-    processGroupId;
-    identity;
-    outputListeners = new Set();
-    exitListeners = new Set();
-    subscriptions = [];
-    inputClosed = false;
-    exited = false;
-    disposed = false;
-    constructor(pty) {
-        this.pty = pty;
-        this.pid = pty.pid;
-        // A PTY child leads its own session, so the pid doubles as the group id.
-        this.processGroupId = supportsProcessGroups() ? pty.pid : undefined;
-        this.identity = processIdentityTracker.capture(pty.pid, { refresh: true });
-        this.subscriptions.push(pty.onData((data) => {
-            const bytes = typeof data === "string"
-                ? new Uint8Array(Buffer.from(data, "utf8"))
-                : new Uint8Array(data);
-            const event = {
-                stream: "terminal",
-                bytes,
-                observedAt: Date.now(),
-            };
-            for (const listener of [...this.outputListeners])
-                listener(event);
-        }));
-        this.subscriptions.push(pty.onExit(({ exitCode, signal }) => {
-            this.exited = true;
-            const outcome = {
-                endedAt: Date.now(),
-                exitCode,
-                ...(signal !== undefined ? { signal: String(signal) } : {}),
-            };
-            for (const listener of [...this.exitListeners])
-                listener(outcome);
-        }));
-    }
-    async write(bytes) {
-        if (this.inputClosed || this.exited) {
-            return { status: "not-delivered", deliveredBytes: 0 };
-        }
-        try {
-            // node-pty accepts latin1-safe strings; binary-preserving round trip.
-            this.pty.write(Buffer.from(bytes).toString("binary"));
-            return { status: "delivered", deliveredBytes: bytes.length };
-        }
-        catch (error) {
-            // A throwing master write cannot prove whether the child saw the bytes.
-            return { status: "unknown", deliveredBytes: 0, cause: error };
-        }
-    }
-    async control(action) {
-        const bytes = ptyControlBytes(action);
-        if (!bytes)
-            return { status: "not-delivered", deliveredBytes: 0 };
-        return await this.write(bytes);
-    }
-    /**
-     * A pseudoterminal has no portable half-close: send the platform EOF sequence
-     * once, then treat manager-level input as permanently closed.
-     */
-    async closeInput() {
-        if (this.inputClosed)
-            return { status: "delivered", deliveredBytes: 0 };
-        const bytes = ptyControlBytes("eof");
-        const result = bytes
-            ? await this.write(bytes)
-            : { status: "delivered", deliveredBytes: 0 };
-        this.inputClosed = true;
-        return result;
-    }
-    async resize(dimensions) {
-        this.pty.resize(dimensions.columns, dimensions.rows);
-    }
-    pauseOutput() {
-        this.pty.pause();
-    }
-    resumeOutput() {
-        this.pty.resume();
-    }
-    async requestTreeTermination(kind) {
-        return terminateProcessTree(this.pid, {
-            signal: kind === "graceful" ? "SIGTERM" : "SIGKILL",
-            ...(this.processGroupId !== undefined ? { processGroupId: this.processGroupId } : {}),
-        });
-    }
-    onOutput(listener) {
-        this.outputListeners.add(listener);
-        return () => {
-            this.outputListeners.delete(listener);
-        };
-    }
-    onExit(listener) {
-        this.exitListeners.add(listener);
-        return () => {
-            this.exitListeners.delete(listener);
-        };
-    }
-    async dispose() {
-        if (this.disposed)
-            return;
-        this.disposed = true;
-        this.outputListeners.clear();
-        this.exitListeners.clear();
-        for (const subscription of this.subscriptions) {
-            try {
-                subscription.dispose();
-            }
-            catch {
-                // Disposing an already-exited pty is not an error.
-            }
-        }
-        this.subscriptions.length = 0;
-        processIdentityTracker.forget(this.pid);
-    }
-}
-function stringEnv(env) {
-    const result = {};
-    for (const [key, value] of Object.entries(env)) {
-        if (typeof value === "string")
-            result[key] = value;
-    }
-    return result;
-}
-export async function startPtyTransport(request, overrides = {}) {
-    const module = overrides.module ?? await loadNodePty();
-    if (!module) {
-        throw new LaunchFailure("PTY_UNAVAILABLE", loadFailureReason ?? "PTY capability is unavailable on this target.", false, false);
-    }
-    const shell = overrides.shell === undefined ? resolveShell() : overrides.shell;
-    if (!shell) {
-        throw new LaunchFailure("SHELL_NOT_FOUND", "No usable command shell was found for an interactive session.", false, false);
-    }
-    let pty;
-    try {
-        pty = module.spawn(shell, process.platform === "win32" ? ["/c", request.command] : ["-c", request.command], {
-            cwd: request.cwd,
-            env: stringEnv({ ...(request.env ?? process.env), TERM: "xterm-256color" }),
-            cols: request.dimensions.columns,
-            rows: request.dimensions.rows,
-            name: "xterm-256color",
-        });
-        if (!pty.pid)
-            throw new Error("node-pty returned no pid");
-        return { transport: new NodePtyTransport(pty) };
-    }
-    catch (error) {
-        // Release the native terminal allocated before launch confirmation.
-        if (pty) {
-            try {
-                pty.kill();
-            }
-            catch {
-                // Best effort: the master may already be closed.
-            }
-        }
-        throw new LaunchFailure("PTY_SPAWN_FAILED", `PTY allocation failed before launch confirmation: ${error instanceof Error ? error.name : "unknown"}.`, false, false);
-    }
-}
-//# sourceMappingURL=transport-node-pty.js.map

package/dist/interactive-session/transport-node-pty.js.map

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

package/dist/interactive-session/transport-pipe.d.ts

@@ -1,9 +0,0 @@
-/**
- * Managed-pipe transport. Used directly for `terminalMode: "pipe"` and as the
- * single fallback for `"preferred"` when PTY capability is unavailable.
- *
- * This module never imports or probes PTY code, and it does not touch the spawn
- * options used by `shell.ts` or `jobs.ts`.
- */
-import { type LaunchRequest, type LaunchResult } from "./transport.js";
-export declare function startPipeTransport(request: LaunchRequest): Promise<LaunchResult>;

package/dist/interactive-session/transport-pipe.js

@@ -1,215 +0,0 @@
-/**
- * Managed-pipe transport. Used directly for `terminalMode: "pipe"` and as the
- * single fallback for `"preferred"` when PTY capability is unavailable.
- *
- * This module never imports or probes PTY code, and it does not touch the spawn
- * options used by `shell.ts` or `jobs.ts`.
- */
-import { spawn } from "node:child_process";
-import { augmentedPathEnv } from "../os/command.js";
-import { processIdentityTracker } from "../os/process-identity.js";
-import { supportsProcessGroups, terminateProcessTree, } from "../os/process-tree.js";
-import { resolveShell } from "../tools/shell.js";
-import { LaunchFailure, pipeControlAction, } from "./transport.js";
-class PipeTransport {
-    child;
-    kind = "pipe";
-    pid;
-    processGroupId;
-    identity;
-    outputListeners = new Set();
-    exitListeners = new Set();
-    inputClosed = false;
-    exited = false;
-    disposed = false;
-    outputDrained = false;
-    resolveOutputDrain;
-    outputDrain = new Promise((resolve) => {
-        this.resolveOutputDrain = resolve;
-    });
-    constructor(child) {
-        this.child = child;
-        this.pid = child.pid ?? -1;
-        this.processGroupId = supportsProcessGroups() ? child.pid : undefined;
-        this.identity = processIdentityTracker.capture(child.pid, { refresh: true });
-        child.stdout?.on("data", (chunk) => this.emitOutput("stdout", chunk));
-        child.stderr?.on("data", (chunk) => this.emitOutput("stderr", chunk));
-        // A broken input pipe after the child exits is an expected race, not a crash.
-        child.stdin?.on("error", () => undefined);
-        child.on("exit", (code, signal) => {
-            this.exited = true;
-            const outcome = {
-                endedAt: Date.now(),
-                ...(code !== null ? { exitCode: code } : {}),
-                ...(signal ? { signal } : {}),
-            };
-            for (const listener of [...this.exitListeners])
-                listener(outcome);
-        });
-        child.once("close", () => {
-            this.outputDrained = true;
-            this.resolveOutputDrain();
-        });
-    }
-    emitOutput(stream, chunk) {
-        const event = {
-            stream,
-            bytes: new Uint8Array(chunk),
-            observedAt: Date.now(),
-        };
-        for (const listener of [...this.outputListeners])
-            listener(event);
-    }
-    async write(bytes) {
-        const stdin = this.child.stdin;
-        if (!stdin || this.inputClosed || stdin.destroyed || this.exited) {
-            return { status: "not-delivered", deliveredBytes: 0 };
-        }
-        return await new Promise((resolve) => {
-            let settled = false;
-            const settle = (result) => {
-                if (settled)
-                    return;
-                settled = true;
-                resolve(result);
-            };
-            try {
-                stdin.write(Buffer.from(bytes), (error) => {
-                    // The callback fires after the bytes leave our buffer. A late error
-                    // cannot prove whether the child observed them, so it is `unknown`.
-                    if (error)
-                        settle({ status: "unknown", deliveredBytes: bytes.length, cause: error });
-                    else
-                        settle({ status: "delivered", deliveredBytes: bytes.length });
-                });
-            }
-            catch (error) {
-                settle({ status: "not-delivered", deliveredBytes: 0, cause: error });
-            }
-        });
-    }
-    async control(action) {
-        const mapped = pipeControlAction(action);
-        if (mapped.kind === "unsupported") {
-            return { status: "not-delivered", deliveredBytes: 0 };
-        }
-        if (mapped.kind === "bytes")
-            return await this.write(mapped.bytes);
-        if (mapped.kind === "close-input")
-            return await this.closeInput();
-        // Interrupt/suspend target the whole tree so a shell wrapper cannot swallow
-        // the signal while the real workload keeps running.
-        const outcome = terminateProcessTree(this.pid, {
-            signal: mapped.signal,
-            ...(this.processGroupId !== undefined ? { processGroupId: this.processGroupId } : {}),
-        });
-        return outcome === "failed"
-            ? { status: "unknown", deliveredBytes: 0 }
-            : { status: "delivered", deliveredBytes: 0 };
-    }
-    async closeInput() {
-        if (this.inputClosed)
-            return { status: "delivered", deliveredBytes: 0 };
-        this.inputClosed = true;
-        try {
-            this.child.stdin?.end();
-            return { status: "delivered", deliveredBytes: 0 };
-        }
-        catch (error) {
-            return { status: "unknown", deliveredBytes: 0, cause: error };
-        }
-    }
-    pauseOutput() {
-        this.child.stdout?.pause();
-        this.child.stderr?.pause();
-    }
-    resumeOutput() {
-        this.child.stdout?.resume();
-        this.child.stderr?.resume();
-    }
-    async requestTreeTermination(kind) {
-        return terminateProcessTree(this.pid, {
-            signal: kind === "graceful" ? "SIGTERM" : "SIGKILL",
-            ...(this.processGroupId !== undefined ? { processGroupId: this.processGroupId } : {}),
-        });
-    }
-    onOutput(listener) {
-        this.outputListeners.add(listener);
-        return () => {
-            this.outputListeners.delete(listener);
-        };
-    }
-    onExit(listener) {
-        this.exitListeners.add(listener);
-        return () => {
-            this.exitListeners.delete(listener);
-        };
-    }
-    async waitForOutputDrain() {
-        if (this.outputDrained)
-            return;
-        await this.outputDrain;
-    }
-    async dispose() {
-        if (this.disposed)
-            return;
-        this.disposed = true;
-        this.outputListeners.clear();
-        this.exitListeners.clear();
-        try {
-            this.child.stdin?.destroy();
-            this.child.stdout?.destroy();
-            this.child.stderr?.destroy();
-        }
-        catch {
-            // Streams may already be torn down by the exit path.
-        }
-        this.child.removeAllListeners();
-        processIdentityTracker.forget(this.child.pid);
-    }
-}
-/** Wait for the OS to confirm (or refuse) the spawn before reporting a launch. */
-function waitForSpawn(child) {
-    return new Promise((resolve) => {
-        const onSpawn = () => {
-            child.off("error", onError);
-            resolve(undefined);
-        };
-        const onError = (error) => {
-            child.off("spawn", onSpawn);
-            resolve(error);
-        };
-        child.once("spawn", onSpawn);
-        child.once("error", onError);
-    });
-}
-export async function startPipeTransport(request) {
-    const shell = resolveShell();
-    if (!shell) {
-        throw new LaunchFailure("SHELL_NOT_FOUND", "No usable command shell was found for an interactive session.", false, false);
-    }
-    const child = spawn(request.command, {
-        cwd: request.cwd,
-        shell,
-        // POSIX children get their own group so cleanup can signal the whole tree.
-        detached: supportsProcessGroups(),
-        stdio: ["pipe", "pipe", "pipe"],
-        env: { ...(request.env ?? process.env), PATH: augmentedPathEnv() },
-        windowsHide: true,
-    });
-    const error = await waitForSpawn(child);
-    if (error) {
-        try {
-            child.kill();
-        }
-        catch {
-            // Nothing started; there is no process to reap.
-        }
-        throw new LaunchFailure(error.code ?? "UNKNOWN", `Interactive session launch failed before spawn: ${error.code ?? "UNKNOWN"}.`, false, error.code === "ENOENT" || error.code === "EAGAIN");
-    }
-    if (!child.pid) {
-        throw new LaunchFailure("NO_PID", "The interactive session process reported no process id after spawn.", false, true);
-    }
-    return { transport: new PipeTransport(child) };
-}
-//# sourceMappingURL=transport-pipe.js.map

package/dist/interactive-session/transport-pipe.js.map

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

package/dist/interactive-session/transport.d.ts

@@ -1,104 +0,0 @@
-/**
- * Session transport contracts plus the single centralized table that maps text
- * submission and named controls onto transport/platform byte sequences.
- *
- * A launch is confirmed only after the OS acknowledges spawn. Host stdin is
- * never inherited: agent-controlled sessions must not be able to take the
- * user's controlling terminal.
- */
-import type { TreeSignalOutcome } from "../os/process-tree.js";
-import type { Unsubscribe } from "./runtime.js";
-import type { ControlInput, OutputStream, ProcessOutcome, SessionTransportKind, SubmitBehavior, TerminalDimensions } from "./types.js";
-export interface TransportOutput {
-    readonly stream: OutputStream;
-    readonly bytes: Uint8Array;
-    readonly observedAt: number;
-}
-export type DeliveryResult = {
-    readonly status: "delivered";
-    readonly deliveredBytes: number;
-} | {
-    readonly status: "not-delivered";
-    readonly deliveredBytes: 0;
-    readonly cause?: unknown;
-} | {
-    readonly status: "unknown";
-    readonly deliveredBytes: number;
-    readonly cause?: unknown;
-};
-export interface SessionTransport {
-    readonly kind: SessionTransportKind;
-    readonly pid: number;
-    readonly processGroupId?: number | undefined;
-    /** Hashed start-time evidence captured at launch confirmation. */
-    readonly identity: string | undefined;
-    write(bytes: Uint8Array): Promise<DeliveryResult>;
-    control(action: ControlInput): Promise<DeliveryResult>;
-    closeInput(): Promise<DeliveryResult>;
-    resize?(dimensions: TerminalDimensions): Promise<void>;
-    pauseOutput(): void;
-    resumeOutput(): void;
-    requestTreeTermination(kind: "graceful" | "forceful"): Promise<TreeSignalOutcome>;
-    onOutput(listener: (event: TransportOutput) => void): Unsubscribe;
-    onExit(listener: (outcome: ProcessOutcome) => void): Unsubscribe;
-    /** Settles after transport output sources can emit no additional bytes. */
-    waitForOutputDrain?(): Promise<void>;
-    dispose(): Promise<void>;
-}
-export interface LaunchRequest {
-    readonly command: string;
-    readonly cwd: string;
-    readonly env?: NodeJS.ProcessEnv | undefined;
-}
-export interface LaunchResult {
-    readonly transport: SessionTransport;
-}
-export interface PtyCapability {
-    readonly available: boolean;
-    readonly platform: NodeJS.Platform;
-    /** Non-secret diagnostic for why PTY is unavailable on this target. */
-    readonly reason?: string | undefined;
-}
-export interface SessionTransportFactory {
-    capability(platform?: NodeJS.Platform): Promise<PtyCapability>;
-    startPipe(request: LaunchRequest): Promise<LaunchResult>;
-    startPty(request: LaunchRequest & {
-        dimensions: TerminalDimensions;
-    }): Promise<LaunchResult>;
-}
-/**
- * A transient pre-spawn failure proves no process side effect occurred, so the
- * manager may retry the launch exactly once.
- */
-export declare class LaunchFailure extends Error {
-    readonly code: string;
-    readonly spawnConfirmed: boolean;
-    readonly transient: boolean;
-    constructor(code: string, message: string, spawnConfirmed: boolean, transient: boolean);
-}
-/** PTY line discipline expects CR; a pipe expects LF. */
-export declare function enterSequence(kind: SessionTransportKind): Uint8Array;
-export declare function encodeTextInput(text: string, submit: SubmitBehavior, kind: SessionTransportKind): Uint8Array;
-/**
- * Byte payload for a named control on a PTY. `undefined` means the control has
- * no byte form on that platform and must be reported as unsupported or handled
- * out of band (signals on a pipe).
- */
-export declare function ptyControlBytes(action: ControlInput, platform?: NodeJS.Platform): Uint8Array | undefined;
-/**
- * Pipe controls: `interrupt`/`suspend` are process signals because there is no
- * line discipline, `eof` half-closes stdin, and the rest are the same bytes a
- * terminal would have delivered.
- */
-export type PipeControlAction = {
-    readonly kind: "signal";
-    readonly signal: NodeJS.Signals;
-} | {
-    readonly kind: "bytes";
-    readonly bytes: Uint8Array;
-} | {
-    readonly kind: "close-input";
-} | {
-    readonly kind: "unsupported";
-};
-export declare function pipeControlAction(action: ControlInput, platform?: NodeJS.Platform): PipeControlAction;

package/dist/interactive-session/transport.js

@@ -1,89 +0,0 @@
-/**
- * Session transport contracts plus the single centralized table that maps text
- * submission and named controls onto transport/platform byte sequences.
- *
- * A launch is confirmed only after the OS acknowledges spawn. Host stdin is
- * never inherited: agent-controlled sessions must not be able to take the
- * user's controlling terminal.
- */
-/**
- * A transient pre-spawn failure proves no process side effect occurred, so the
- * manager may retry the launch exactly once.
- */
-export class LaunchFailure extends Error {
-    code;
-    spawnConfirmed;
-    transient;
-    constructor(code, message, spawnConfirmed, transient) {
-        super(message);
-        this.code = code;
-        this.spawnConfirmed = spawnConfirmed;
-        this.transient = transient;
-        this.name = "LaunchFailure";
-    }
-}
-// --- Text and control mappings ------------------------------------------
-/** PTY line discipline expects CR; a pipe expects LF. */
-export function enterSequence(kind) {
-    return Buffer.from(kind === "pty" ? "\r" : "\n", "utf8");
-}
-export function encodeTextInput(text, submit, kind) {
-    const body = Buffer.from(text, "utf8");
-    if (submit === "none")
-        return body;
-    return Buffer.concat([body, Buffer.from(enterSequence(kind))]);
-}
-const ARROWS = {
-    up: "\u001b[A",
-    down: "\u001b[B",
-    right: "\u001b[C",
-    left: "\u001b[D",
-};
-/**
- * Byte payload for a named control on a PTY. `undefined` means the control has
- * no byte form on that platform and must be reported as unsupported or handled
- * out of band (signals on a pipe).
- */
-export function ptyControlBytes(action, platform = process.platform) {
-    switch (action) {
-        case "interrupt":
-            return Buffer.from([0x03]);
-        case "eof":
-            // Windows consoles terminate input with Ctrl+Z followed by Enter.
-            return platform === "win32"
-                ? Buffer.from([0x1a, 0x0d])
-                : Buffer.from([0x04]);
-        case "suspend":
-            return platform === "win32" ? undefined : Buffer.from([0x1a]);
-        case "escape":
-            return Buffer.from([0x1b]);
-        case "tab":
-            return Buffer.from([0x09]);
-        case "backspace":
-            return Buffer.from([0x7f]);
-        case "up":
-        case "down":
-        case "left":
-        case "right":
-            return Buffer.from(ARROWS[action], "utf8");
-        default:
-            return undefined;
-    }
-}
-export function pipeControlAction(action, platform = process.platform) {
-    if (action === "interrupt") {
-        return platform === "win32"
-            ? { kind: "signal", signal: "SIGTERM" }
-            : { kind: "signal", signal: "SIGINT" };
-    }
-    if (action === "suspend") {
-        return platform === "win32"
-            ? { kind: "unsupported" }
-            : { kind: "signal", signal: "SIGTSTP" };
-    }
-    if (action === "eof")
-        return { kind: "close-input" };
-    const bytes = ptyControlBytes(action, platform);
-    return bytes ? { kind: "bytes", bytes } : { kind: "unsupported" };
-}
-//# sourceMappingURL=transport.js.map

package/dist/interactive-session/transport.js.map

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