codex-toys 0.135.0

package/dist/cli/remote-control.js

@@ -0,0 +1,357 @@
+import { setTimeout as delay } from "node:timers/promises";
+import { APP_CALL_METHOD, TOYBOX_INITIALIZE_METHOD, } from "../toybox/protocol.js";
+import { createLocalToyboxTransport, hasSshRemote, withSshRemoteToyboxTransport, } from "./remote-provider.js";
+export async function collectRemoteStatusInfo(options) {
+    const toybox = await probeToybox(options);
+    return {
+        toybox,
+        appServer: {
+            mode: "app-server",
+            status: toybox.status,
+            url: toybox.url,
+            remoteControl: toybox.remoteControl,
+            error: toybox.error,
+        },
+        recommendation: remoteRecommendation(toybox),
+    };
+}
+export async function startRemoteTurn(options) {
+    validateTurnOptions(options);
+    const surface = options.via === "app" ? "app-server" : "workspace";
+    return await withToyboxTransport(options, async (transport, url) => {
+        await initializeWorkspaceTransport(transport);
+        return await startTurnWithRequest(surface, url, options, async (method, params) => await workspaceAppServerRequest(transport, method, params));
+    });
+}
+export function formatRemoteStatusInfo(info) {
+    const lines = [
+        `toybox             ${probeLabel(info.toybox)}`,
+        `remote control     ${remoteControlLabel(info)}`,
+        `next               ${info.recommendation.nextCommand}`,
+    ];
+    return `${lines.join("\n")}\n`;
+}
+export function formatRemoteTurnStartResult(result) {
+    const lines = [
+        `turn surface        ${result.via} (${result.url})`,
+        `thread id           ${result.threadId}`,
+        `turn id             ${result.turnId}`,
+        `status              ${result.status}`,
+    ];
+    if (result.finalMessage) {
+        lines.push("", result.finalMessage);
+    }
+    if (result.error) {
+        lines.push(`error               ${result.error}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+async function probeToybox(options) {
+    try {
+        return await withToyboxTransport(options, async (transport, url) => {
+            const remoteControl = await withTimeout(async () => {
+                await initializeWorkspaceTransport(transport);
+                return await workspaceAppServerRequest(transport, "remoteControl/status/read");
+            }, options.timeoutMs, `toybox remote control probe timed out after ${options.timeoutMs}ms`);
+            return {
+                mode: "workspace",
+                status: "connected",
+                url,
+                remoteControl,
+            };
+        });
+    }
+    catch (error) {
+        return {
+            mode: "workspace",
+            status: "unavailable",
+            url: toyboxUrl(options),
+            error: errorMessage(error),
+        };
+    }
+}
+async function withToyboxTransport(options, callback) {
+    if (hasSshRemote(options)) {
+        return await withSshRemoteToyboxTransport(options, async (transport) => await callback(transport, "ssh://toybox"));
+    }
+    const transport = createLocalToyboxTransport(options);
+    try {
+        transport.start();
+        return await callback(transport, "toybox://local");
+    }
+    finally {
+        transport.close();
+    }
+}
+function validateTurnOptions(options) {
+    if (options.sandbox && options.permissions) {
+        throw new Error("--sandbox cannot be combined with --permissions");
+    }
+}
+function threadStartParams(options) {
+    return compactUndefined({
+        model: options.model,
+        cwd: options.cwd,
+        sandbox: options.sandbox,
+        approvalPolicy: options.approvalPolicy,
+        permissions: options.permissions,
+        experimentalRawEvents: false,
+        persistExtendedHistory: false,
+    });
+}
+function turnStartParams(threadId, options, flags = {}) {
+    return compactUndefined({
+        threadId,
+        cwd: options.cwd,
+        approvalPolicy: options.approvalPolicy,
+        sandboxPolicy: flags.includeSandboxPolicy
+            ? sandboxPolicyFromMode(options.sandbox)
+            : undefined,
+        permissions: options.permissions,
+        model: options.model,
+        input: [
+            {
+                type: "text",
+                text: options.prompt,
+                text_elements: [],
+            },
+        ],
+    });
+}
+async function startTurnWithRequest(surface, url, options, request) {
+    const startedAt = Date.now();
+    let threadResponse;
+    const existingThread = Boolean(options.threadId);
+    const threadId = options.threadId ??
+        nestedId(threadResponse = await request("thread/start", threadStartParams(options)), "thread", "thread/start");
+    const turnResponse = await request("turn/start", turnStartParams(threadId, options, {
+        includeSandboxPolicy: existingThread,
+    }));
+    const turn = record(record(turnResponse).turn);
+    const turnId = stringValue(turn.id) ?? nestedId(turnResponse, "turn", "turn/start");
+    const initialStatus = turnStatus(turn.status) ?? "accepted";
+    let status = initialStatus;
+    let finalMessage = null;
+    let error = null;
+    let durationMs = null;
+    if (options.wait) {
+        const waited = await waitForTurn({
+            threadId,
+            turnId,
+            timeoutMs: Math.max(1, options.timeoutMs - (Date.now() - startedAt) - 100),
+            request,
+        });
+        status = waited.status;
+        finalMessage = waited.finalMessage;
+        error = waited.error;
+        durationMs = waited.durationMs;
+    }
+    return {
+        via: surface,
+        surface,
+        url,
+        threadId,
+        turnId,
+        ...(options.cwd ? { cwd: options.cwd } : {}),
+        status,
+        finalMessage,
+        error,
+        durationMs,
+        thread: threadResponse ? record(threadResponse).thread : null,
+        turn: record(turnResponse).turn,
+    };
+}
+async function waitForTurn(options) {
+    const deadline = Date.now() + options.timeoutMs;
+    let latestTurn;
+    while (Date.now() <= deadline) {
+        const response = await options.request("thread/read", {
+            threadId: options.threadId,
+            includeTurns: true,
+        });
+        const thread = record(record(response).thread ?? response);
+        latestTurn = arrayValue(thread.turns)
+            .map(record)
+            .find((turn) => stringValue(turn.id) === options.turnId);
+        const status = turnStatus(latestTurn?.status);
+        const completedTurn = latestTurn;
+        if (completedTurn && status && status !== "inProgress") {
+            const items = arrayValue(completedTurn.items);
+            const finalItems = items.length > 0 ? items : await readTurnItems(options);
+            return {
+                status,
+                finalMessage: finalAgentMessage(finalItems),
+                error: turnError(completedTurn),
+                durationMs: numberValue(completedTurn.durationMs),
+            };
+        }
+        await delay(Math.min(500, Math.max(1, deadline - Date.now())));
+    }
+    return {
+        status: "timed_out",
+        finalMessage: latestTurn ? finalAgentMessage(arrayValue(latestTurn.items)) : null,
+        error: `turn did not complete within ${options.timeoutMs}ms`,
+        durationMs: null,
+    };
+}
+async function readTurnItems(options) {
+    try {
+        const response = await options.request("thread/turns/items/list", {
+            threadId: options.threadId,
+            turnId: options.turnId,
+            limit: 200,
+            sortDirection: "asc",
+        });
+        return arrayValue(record(response).data);
+    }
+    catch {
+        const response = await options.request("thread/turns/list", {
+            threadId: options.threadId,
+            limit: 50,
+            sortDirection: "desc",
+            itemsView: "full",
+        });
+        const turn = arrayValue(record(response).data)
+            .map(record)
+            .find((entry) => stringValue(entry.id) === options.turnId);
+        return arrayValue(turn?.items);
+    }
+}
+function finalAgentMessage(items) {
+    for (const item of items.slice().reverse()) {
+        const entry = record(item);
+        if (entry.type === "agentMessage") {
+            const text = stringValue(entry.text);
+            if (text) {
+                return text;
+            }
+        }
+    }
+    return null;
+}
+function turnStatus(value) {
+    if (value === "completed" ||
+        value === "interrupted" ||
+        value === "failed" ||
+        value === "inProgress") {
+        return value;
+    }
+    return undefined;
+}
+function sandboxPolicyFromMode(mode) {
+    if (mode === "danger-full-access") {
+        return { type: "dangerFullAccess" };
+    }
+    if (mode === "read-only") {
+        return { type: "readOnly", networkAccess: false };
+    }
+    if (mode === "workspace-write") {
+        return {
+            type: "workspaceWrite",
+            writableRoots: [],
+            networkAccess: false,
+            excludeTmpdirEnvVar: false,
+            excludeSlashTmp: false,
+        };
+    }
+    return undefined;
+}
+function turnError(turn) {
+    const error = record(turn?.error);
+    return stringValue(error.message) ?? null;
+}
+async function initializeWorkspaceTransport(transport) {
+    await transport.request(TOYBOX_INITIALIZE_METHOD, {
+        clientInfo: {
+            name: "codex-toys-remote-control",
+            title: "Codex Toys Remote Control",
+            version: "0.1.0",
+        },
+        capabilities: {
+            appPassThrough: true,
+        },
+    });
+}
+async function workspaceAppServerRequest(transport, method, params) {
+    return await transport.request(APP_CALL_METHOD, { method, params });
+}
+function remoteRecommendation(workspace) {
+    if (workspace.status === "connected") {
+        return {
+            preferred: "workspace",
+            nextCommand: "codex-toys turn run \"...\"",
+        };
+    }
+    return {
+        preferred: "none",
+        nextCommand: "codex-toys --ssh <target> --cwd <remote-workspace> remote preflight",
+    };
+}
+function remoteControlLabel(info) {
+    const remote = info.toybox.remoteControl ?? info.appServer.remoteControl;
+    if (!remote) {
+        return "unavailable";
+    }
+    return `${remote.status} (${remote.serverName}, installation ${remote.installationId})`;
+}
+function probeLabel(result) {
+    if (result.status === "connected") {
+        return `connected (${result.url})`;
+    }
+    return result.error
+        ? `unavailable (${result.error})`
+        : `unavailable (${result.url})`;
+}
+async function withTimeout(callback, timeoutMs, message) {
+    let timer;
+    try {
+        return await Promise.race([
+            callback(),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+function nestedId(response, key, method) {
+    const id = stringValue(record(record(response)[key]).id);
+    if (!id) {
+        throw new Error(`${method} did not return ${key}.id`);
+    }
+    return id;
+}
+function arrayValue(value) {
+    return Array.isArray(value) ? value : [];
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function compactUndefined(value) {
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (entry !== undefined) {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+function toyboxUrl(options) {
+    return hasSshRemote(options) ? "ssh://toybox" : "toybox://local";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=remote-control.js.map

package/dist/cli/remote-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-control.js","sourceRoot":"","sources":["../../src/cli/remote-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EACN,eAAe,EACf,wBAAwB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,0BAA0B,EAC1B,YAAY,EACZ,4BAA4B,GAE5B,MAAM,sBAAsB,CAAC;AAsC9B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,OAAyD;IAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO;QACN,MAAM;QACN,SAAS,EAAE;YACV,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;SACnB;QACD,cAAc,EAAE,oBAAoB,CAAC,MAAM,CAAC;KAC5C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAaV;IAC3B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IACnE,OAAO,MAAM,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;QAClE,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAC;QAC9C,OAAO,MAAM,oBAAoB,CAChC,OAAO,EACP,GAAG,EACH,OAAO,EACP,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CACxB,MAAM,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAC3D,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC5D,MAAM,KAAK,GAAG;QACb,sBAAsB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QAC/C,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE;QAChD,sBAAsB,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAA6B;IACxE,MAAM,KAAK,GAAG;QACb,uBAAuB,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,GAAG;QACnD,uBAAuB,MAAM,CAAC,QAAQ,EAAE;QACxC,uBAAuB,MAAM,CAAC,MAAM,EAAE;QACtC,uBAAuB,MAAM,CAAC,MAAM,EAAE;KACtC,CAAC;IACF,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,OAAyD;IAEzD,IAAI,CAAC;QACJ,OAAO,MAAM,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;YAClE,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,KAAK,IAAI,EAAE;gBAClD,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAC;gBAC9C,OAAO,MAAM,yBAAyB,CACrC,SAAS,EACT,2BAA2B,CAC3B,CAAC;YACH,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,+CACrB,OAAO,CAAC,SACT,IAAI,CAAC,CAAC;YACN,OAAO;gBACN,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,WAAW;gBACnB,GAAG;gBACH,aAAa;aACb,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa;YACrB,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC;YACvB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;SAC1B,CAAC;IACH,CAAC;AACF,CAAC;AAED,KAAK,UAAU,mBAAmB,CACjC,OAAyD,EACzD,QAAsE;IAEtE,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,4BAA4B,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CACtE,MAAM,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,CACzC,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC;QACJ,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,MAAM,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACpD,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAG5B;IACA,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACpE,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAM1B;IACA,OAAO,gBAAgB,CAAC;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,qBAAqB,EAAE,KAAK;QAC5B,sBAAsB,EAAE,KAAK;KAC7B,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACvB,QAAgB,EAChB,OAOC,EACD,QAEI,EAAE;IAEN,OAAO,gBAAgB,CAAC;QACvB,QAAQ;QACR,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,KAAK,CAAC,oBAAoB;YACxC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC;YACxC,CAAC,CAAC,SAAS;QACZ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE;YACN;gBACC,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,CAAC,MAAM;gBACpB,aAAa,EAAE,EAAE;aACjB;SACD;KACD,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CAClC,OAAmC,EACnC,GAAW,EACX,OAUC,EACD,OAAyB;IAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,cAAuB,CAAC;IAC5B,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;QAChC,QAAQ,CACP,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAC1E,QAAQ,EACR,cAAc,CACd,CAAC;IACH,MAAM,YAAY,GAAG,MAAM,OAAO,CACjC,YAAY,EACZ,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE;QAClC,oBAAoB,EAAE,cAAc;KACpC,CAAC,CACF,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC;IAC5D,IAAI,MAAM,GAAoC,aAAa,CAAC;IAC5D,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAChC,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;YAC1E,OAAO;SACP,CAAC,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACvB,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACnC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IACD,OAAO;QACN,GAAG,EAAE,OAAO;QACZ,OAAO;QACP,GAAG;QACH,QAAQ;QACR,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM;QACN,YAAY;QACZ,KAAK;QACL,UAAU;QACV,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC7D,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI;KAC/B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAK1B;IAMA,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAChD,IAAI,UAA+C,CAAC;IACpD,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CACrC,aAAa,EACb;YACC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,IAAI;SAClB,CACD,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC;QAC3D,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;aACnC,GAAG,CAAC,MAAM,CAAC;aACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,UAAU,CAAC;QACjC,IAAI,aAAa,IAAI,MAAM,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3E,OAAO;gBACN,MAAM;gBACN,YAAY,EAAE,iBAAiB,CAAC,UAAU,CAAC;gBAC3C,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC;gBAC/B,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC;aACjD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO;QACN,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QACjF,KAAK,EAAE,gCAAgC,OAAO,CAAC,SAAS,IAAI;QAC5D,UAAU,EAAE,IAAI;KAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,OAI5B;IACA,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CACrC,yBAAyB,EACzB;YACC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,GAAG;YACV,aAAa,EAAE,KAAK;SACpB,CACD,CAAC;QACF,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CACrC,mBAAmB,EACnB;YACC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,EAAE;YACT,aAAa,EAAE,MAAM;YACrB,SAAS,EAAE,MAAM;SACjB,CACD,CAAC;QACF,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;aAC5C,GAAG,CAAC,MAAM,CAAC;aACX,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgB;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,IACC,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,YAAY,EACrB,CAAC;QACF,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAC7B,IAAgC;IAEhC,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAChC,OAAO;YACN,IAAI,EAAE,gBAAgB;YACtB,aAAa,EAAE,EAAE;YACjB,aAAa,EAAE,KAAK;YACpB,mBAAmB,EAAE,KAAK;YAC1B,eAAe,EAAE,KAAK;SACtB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,IAAyC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,4BAA4B,CAC1C,SAA+B;IAE/B,MAAM,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE;QACjD,UAAU,EAAE;YACX,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,2BAA2B;YAClC,OAAO,EAAE,OAAO;SAChB;QACD,YAAY,EAAE;YACb,cAAc,EAAE,IAAI;SACpB;KACD,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACvC,SAA+B,EAC/B,MAAc,EACd,MAAgB;IAEhB,OAAO,MAAM,SAAS,CAAC,OAAO,CAAI,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,oBAAoB,CAC5B,SAA4B;IAE5B,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO;YACN,SAAS,EAAE,WAAW;YACtB,WAAW,EAAE,6BAA6B;SAC1C,CAAC;IACH,CAAC;IACD,OAAO;QACN,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,qEAAqE;KAClF,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAsB;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;IACzE,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,aAAa,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,UAAU,kBAAkB,MAAM,CAAC,cAAc,GAAG,CAAC;AACzF,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,cAAc,MAAM,CAAC,GAAG,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,KAAK;QAClB,CAAC,CAAC,gBAAgB,MAAM,CAAC,KAAK,GAAG;QACjC,CAAC,CAAC,gBAAgB,MAAM,CAAC,GAAG,GAAG,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,WAAW,CACzB,QAA0B,EAC1B,SAAiB,EACjB,OAAe;IAEf,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACzB,QAAQ,EAAE;YACV,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAChC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACjE,CAAC,CAAC;SACF,CAAC,CAAC;IACJ,CAAC;YAAS,CAAC;QACV,IAAI,KAAK,EAAE,CAAC;YACX,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,QAAiB,EAAE,GAAW,EAAE,MAAc;IAC/D,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1E,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CAAoC,KAAQ;IACpE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACF,CAAC;IACD,OAAO,MAAW,CAAC;AACpB,CAAC;AAED,SAAS,SAAS,CAAC,OAA4D;IAC9E,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAClE,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/dist/cli/remote-preflight.d.ts

@@ -0,0 +1,24 @@
+import { type SshRemoteProviderOptions } from "./remote-provider.ts";
+export type RemotePreflightCheck = {
+    name: string;
+    status: "ok" | "fail" | "skip";
+    detail?: string;
+    path?: string;
+    version?: string;
+    error?: string;
+    suggestion?: string;
+    stderr?: string;
+};
+export type RemotePreflightResult = {
+    ok: boolean;
+    sshTarget: string;
+    cwd?: string;
+    remotePathPrepend?: string;
+    toyboxCommand: string;
+    remoteCodexCommand: string;
+    remoteCodexArgs: string[];
+    checks: RemotePreflightCheck[];
+};
+export declare function collectRemotePreflight(options: SshRemoteProviderOptions): Promise<RemotePreflightResult>;
+export declare function formatRemotePreflight(result: RemotePreflightResult): string;
+//# sourceMappingURL=remote-preflight.d.ts.map

package/dist/cli/remote-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-preflight.d.ts","sourceRoot":"","sources":["../../src/cli/remote-preflight.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,wBAAwB,EAC7B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AASF,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAyFhC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgB3E"}

package/dist/cli/remote-preflight.js

@@ -0,0 +1,225 @@
+import { spawn } from "node:child_process";
+import { APP_CALL_METHOD, TOYBOX_INITIALIZE_METHOD, } from "../toybox/protocol.js";
+import { createSshToyboxTransport, resolveSshRemoteOptions, } from "./remote-provider.js";
+export async function collectRemotePreflight(options) {
+    const resolved = resolveSshRemoteOptions(options);
+    const checks = [];
+    const result = {
+        ok: false,
+        sshTarget: resolved.sshTarget,
+        ...(resolved.cwd ? { cwd: resolved.cwd } : {}),
+        ...(resolved.remotePathPrepend ? { remotePathPrepend: resolved.remotePathPrepend } : {}),
+        toyboxCommand: resolved.toyboxCommand,
+        remoteCodexCommand: resolved.remoteCodexCommand,
+        remoteCodexArgs: resolved.remoteCodexArgs,
+        checks,
+    };
+    const ssh = await runRemoteShell(resolved, "true", options.timeoutMs);
+    if (ssh.code !== 0) {
+        checks.push(failCheck("SSH", ssh, "Fix local OpenSSH config, target reachability, or use --ssh user@host."));
+        return result;
+    }
+    checks.push({ name: "SSH", status: "ok" });
+    if (resolved.cwd) {
+        const cwd = await runRemoteShell(resolved, `test -d ${shellQuote(resolved.cwd)} && printf '%s\\n' ${shellQuote(resolved.cwd)}`, options.timeoutMs);
+        if (cwd.code !== 0) {
+            checks.push(failCheck("cwd", cwd, "Create the remote workspace directory or pass --cwd /path/to/workspace."));
+            return result;
+        }
+        checks.push({ name: "cwd", status: "ok", detail: firstLine(cwd.stdout) ?? resolved.cwd });
+    }
+    else {
+        checks.push({
+            name: "cwd",
+            status: "skip",
+            suggestion: "Pass --cwd <remote-workspace> for workspace-backed commands.",
+        });
+    }
+    checks.push(await commandCheck(resolved, "node", "node", ["--version"], options.timeoutMs, {
+        validateVersion: (version) => /^v24\./.test(version),
+        suggestion: "Set CODEX_TOYS_REMOTE_PATH_PREPEND to a Node 24 bin directory or install Node 24 remotely.",
+    }));
+    checks.push(await commandCheck(resolved, "codex-toys", resolved.toyboxCommand, ["--help"], options.timeoutMs, {
+        suggestion: "Install codex-toys on the SSH target or set CODEX_TOYS_TOYBOX_COMMAND to its remote path.",
+    }));
+    checks.push(await commandCheck(resolved, "codex", resolved.remoteCodexCommand, ["--version"], options.timeoutMs, {
+        suggestion: "Set CODEX_TOYS_REMOTE_CODEX_COMMAND to the remote Codex binary path or add it through CODEX_TOYS_REMOTE_PATH_PREPEND.",
+    }));
+    if (checks.some((check) => check.status === "fail")) {
+        return result;
+    }
+    const toybox = await probeSshToybox(options);
+    checks.push(...toybox);
+    result.ok = checks.every((check) => check.status !== "fail");
+    return result;
+}
+export function formatRemotePreflight(result) {
+    return result.checks.map((check) => {
+        const label = check.name.padEnd(25, " ");
+        if (check.status === "ok") {
+            return `${label}ok${check.path ? ` ${check.path}` : ""}${check.version ? ` ${check.version}` : ""}${check.detail ? ` ${check.detail}` : ""}`;
+        }
+        if (check.status === "skip") {
+            return `${label}skip${check.suggestion ? ` ${check.suggestion}` : ""}`;
+        }
+        return `${label}fail ${[
+            check.error,
+            check.suggestion,
+        ].filter(Boolean).join(" ")}`;
+    }).join("\n") + "\n";
+}
+async function probeSshToybox(options) {
+    const transport = createSshToyboxTransport(options);
+    try {
+        transport.start();
+        const status = await transport.request("toybox.status", {});
+        const detail = statusDetail(status);
+        await initializeWorkspaceTransport(transport);
+        await transport.request(APP_CALL_METHOD, {
+            method: "thread/list",
+            params: { limit: 1, sourceKinds: [] },
+        });
+        return [
+            { name: "SSH toybox", status: "ok", detail },
+            { name: "app-server initialize", status: "ok" },
+        ];
+    }
+    catch (error) {
+        const stderr = transport.toyboxStderr.join("\n").trim();
+        return [{
+                name: "SSH toybox",
+                status: "fail",
+                error: errorMessage(error),
+                suggestion: "Inspect remote stderr, ensure codex-toys and codex run from non-interactive SSH, and adjust CODEX_TOYS_REMOTE_PATH_PREPEND if needed.",
+                ...(stderr ? { stderr: redact(stderr) } : {}),
+            }];
+    }
+    finally {
+        transport.close();
+    }
+}
+async function initializeWorkspaceTransport(transport) {
+    await transport.request(TOYBOX_INITIALIZE_METHOD, {
+        clientInfo: {
+            name: "codex-toys-remote-preflight",
+            title: "Codex Toys Remote Preflight",
+            version: "0.1.0",
+        },
+        capabilities: {
+            appPassThrough: true,
+        },
+    });
+}
+async function commandCheck(resolved, name, command, versionArgs, timeoutMs, options) {
+    const script = [
+        `command_path=$(command -v ${shellQuote(command)} 2>/dev/null || true)`,
+        `if [ -z "$command_path" ] && [ -x ${shellQuote(command)} ]; then command_path=${shellQuote(command)}; fi`,
+        `if [ -z "$command_path" ]; then echo ${shellQuote(`${command} not found`)} >&2; exit 127; fi`,
+        `printf '%s\\n' "$command_path"`,
+        `"$command_path" ${versionArgs.map(shellQuote).join(" ")} 2>&1 | head -n 1 || true`,
+    ].join("; ");
+    const output = await runRemoteShell(resolved, withRemotePath(resolved, script), timeoutMs);
+    if (output.code !== 0) {
+        return failCheck(name, output, options.suggestion);
+    }
+    const [path, version] = output.stdout.trim().split(/\r?\n/);
+    if (!path) {
+        return {
+            name,
+            status: "fail",
+            error: `${command} did not report a path`,
+            suggestion: options.suggestion,
+        };
+    }
+    if (version && options.validateVersion && !options.validateVersion(version)) {
+        return {
+            name,
+            status: "fail",
+            path,
+            version,
+            error: `${command} version ${version} does not satisfy required major 24`,
+            suggestion: options.suggestion,
+        };
+    }
+    return {
+        name,
+        status: "ok",
+        path,
+        ...(version ? { version } : {}),
+    };
+}
+async function runRemoteShell(resolved, remoteCommand, timeoutMs) {
+    const child = spawn(resolved.sshCommand, ["-T", resolved.sshTarget, remoteCommand], { stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    let timeout = false;
+    child.stdout?.setEncoding("utf8");
+    child.stderr?.setEncoding("utf8");
+    child.stdout?.on("data", (chunk) => {
+        stdout += chunk;
+    });
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk;
+    });
+    const timer = setTimeout(() => {
+        timeout = true;
+        child.kill("SIGTERM");
+    }, timeoutMs);
+    const exit = new Promise((resolve) => {
+        child.on("error", (error) => {
+            stderr += error.message;
+            resolve({ code: 1, signal: null, stdout, stderr });
+        });
+        child.on("exit", (code, signal) => {
+            resolve({ code: timeout ? 124 : code, signal, stdout, stderr });
+        });
+    });
+    try {
+        return await exit;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function withRemotePath(options, command) {
+    if (!options.remotePathPrepend) {
+        return command;
+    }
+    return `export PATH=${shellQuote(options.remotePathPrepend)}\${PATH:+":$PATH"} && ${command}`;
+}
+function failCheck(name, result, suggestion) {
+    const stderr = redact(result.stderr.trim());
+    const error = result.code === 124
+        ? "timed out"
+        : stderr || `remote command exited with code ${result.code ?? "unknown"}`;
+    return {
+        name,
+        status: "fail",
+        error,
+        suggestion,
+        ...(stderr ? { stderr } : {}),
+    };
+}
+function statusDetail(value) {
+    const record = typeof value === "object" && value !== null
+        ? value
+        : {};
+    const cwd = typeof record.cwd === "string" ? record.cwd : undefined;
+    const node = typeof record.node === "string" ? record.node : undefined;
+    return [cwd, node].filter(Boolean).join(" ") || undefined;
+}
+function firstLine(text) {
+    return text.trim().split(/\r?\n/).find(Boolean);
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function redact(value) {
+    return value
+        .replace(/(token|password|secret|key)=\S+/gi, "$1=<redacted>")
+        .replace(/(Bearer\s+)[A-Za-z0-9._~+/-]+=*/g, "$1<redacted>");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=remote-preflight.js.map

package/dist/cli/remote-preflight.js.map

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