@heyditto/cli 2.11.0 → 2.12.1

package/dist/remote/host.js

@@ -0,0 +1,240 @@
+import os from "node:os";
+import { packageVersion } from "../config.js";
+import { readStoredAuth, updateStoredAuth } from "../store.js";
+import { HOST_WS_PATH, isServerFrame, } from "./protocol.js";
+const SEEN_TURNS_MAX = 1000;
+function wsUrl(baseUrl) {
+    const u = new URL(baseUrl);
+    u.protocol = u.protocol === "https:" ? "wss:" : "ws:";
+    u.pathname = `${u.pathname.replace(/\/+$/, "")}${HOST_WS_PATH}`;
+    u.search = "";
+    return u.toString();
+}
+export class HostClient {
+    options;
+    hostId;
+    socket;
+    connected = false;
+    closing = false;
+    attempt = 0;
+    heartbeat;
+    missedPongs = 0;
+    sessions = new Map();
+    catalogs = new Map();
+    seenTurns = [];
+    seenSet = new Set();
+    welcomeWaiters = [];
+    constructor(options) {
+        this.options = options;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    /** Starts connecting; resolves after the first `welcome` or after `timeoutMs` (still retrying in the background). */
+    async start(timeoutMs = 4000) {
+        this.hostId = (await readStoredAuth())?.hostId;
+        void this.connectLoop();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => resolve(false), timeoutMs);
+            this.welcomeWaiters.push(() => {
+                clearTimeout(timer);
+                resolve(true);
+            });
+        });
+    }
+    async connectLoop() {
+        while (!this.closing) {
+            try {
+                await this.connectOnce();
+            }
+            catch (err) {
+                this.options.log?.(`remote control: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            if (this.closing)
+                return;
+            const base = this.options.reconnectBaseMs ?? 1000;
+            const max = this.options.reconnectMaxMs ?? 30_000;
+            const delay = Math.min(max, base * 2 ** Math.min(this.attempt, 6)) * (0.75 + Math.random() * 0.5);
+            this.attempt += 1;
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+    connectOnce() {
+        return new Promise((resolve, reject) => {
+            const socket = new WebSocket(wsUrl(this.options.baseUrl), {
+                // Node's WebSocket (undici) accepts request headers; browsers do not, but this is the CLI.
+                headers: { Authorization: `Bearer ${this.options.apiKey}` },
+            });
+            this.socket = socket;
+            // Resolves only once the socket closes after a successful welcome, so the
+            // loop never opens a second connection next to a live one.
+            let welcomed = false;
+            let settled = false;
+            const fail = (message) => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(new Error(message));
+            };
+            socket.addEventListener("open", () => {
+                this.send({
+                    type: "hello",
+                    kind: "cli",
+                    name: this.options.name ?? os.hostname(),
+                    platform: `${process.platform}-${process.arch}`,
+                    version: packageVersion,
+                    capabilities: this.options.capabilities,
+                    ...(this.hostId ? { hostId: this.hostId } : {}),
+                });
+            });
+            socket.addEventListener("message", (event) => {
+                let parsed;
+                try {
+                    parsed = JSON.parse(typeof event.data === "string" ? event.data : String(event.data));
+                }
+                catch {
+                    return;
+                }
+                if (!isServerFrame(parsed))
+                    return;
+                if (parsed.type === "welcome") {
+                    welcomed = true;
+                    this.onWelcome(parsed);
+                    return;
+                }
+                this.dispatch(parsed);
+            });
+            socket.addEventListener("error", () => fail("connection failed"));
+            socket.addEventListener("close", (event) => {
+                this.stopHeartbeat();
+                const wasConnected = this.connected;
+                this.connected = false;
+                if (wasConnected && !this.closing)
+                    this.options.log?.(`remote control: disconnected (${event.code}); reconnecting`);
+                if (welcomed) {
+                    if (!settled) {
+                        settled = true;
+                        resolve();
+                    }
+                    return;
+                }
+                fail(`closed (${event.code}${event.reason ? ` ${event.reason}` : ""})`);
+            });
+        });
+    }
+    onWelcome(frame) {
+        this.connected = true;
+        this.attempt = 0;
+        this.missedPongs = 0;
+        if (frame.hostId && frame.hostId !== this.hostId) {
+            this.hostId = frame.hostId;
+            void updateStoredAuth({ hostId: frame.hostId }).catch(() => undefined);
+        }
+        this.startHeartbeat(frame.heartbeatSeconds || this.options.heartbeatSeconds || 30);
+        for (const session of this.sessions.values()) {
+            this.send(session);
+            const catalog = this.catalogs.get(session.sessionId);
+            if (catalog)
+                this.send(catalog);
+        }
+        const waiters = this.welcomeWaiters;
+        this.welcomeWaiters = [];
+        for (const w of waiters)
+            w();
+    }
+    dispatch(frame) {
+        switch (frame.type) {
+            case "ping":
+                this.send({ type: "pong", t: frame.t });
+                return;
+            case "pong":
+                this.missedPongs = 0;
+                return;
+            case "turn.deliver":
+                if (this.seenSet.has(frame.turnId)) {
+                    this.send({ type: "turn.ack", turnId: frame.turnId });
+                    return;
+                }
+                this.remember(frame.turnId);
+                this.options.handlers.onTurn(frame);
+                return;
+            case "turn.interrupt":
+                this.options.handlers.onInterrupt(frame.turnId);
+                return;
+            case "checkpoint.request":
+                this.options.handlers.onCheckpoint(frame);
+                return;
+            case "prompt.answer":
+                this.options.handlers.onPromptAnswer?.(frame);
+                return;
+            default:
+                return;
+        }
+    }
+    remember(turnId) {
+        this.seenSet.add(turnId);
+        this.seenTurns.push(turnId);
+        if (this.seenTurns.length > SEEN_TURNS_MAX) {
+            const old = this.seenTurns.shift();
+            if (old)
+                this.seenSet.delete(old);
+        }
+    }
+    startHeartbeat(seconds) {
+        this.stopHeartbeat();
+        this.heartbeat = setInterval(() => {
+            if (this.missedPongs >= 3) {
+                this.options.log?.("remote control: heartbeat lost; reconnecting");
+                this.socket?.close(4000, "heartbeat lost");
+                return;
+            }
+            this.missedPongs += 1;
+            this.send({ type: "ping", t: Date.now() });
+        }, Math.max(1, seconds) * 1000);
+        this.heartbeat.unref?.();
+    }
+    stopHeartbeat() {
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.heartbeat = undefined;
+    }
+    send(frame) {
+        const socket = this.socket;
+        if (!socket || socket.readyState !== WebSocket.OPEN)
+            return false;
+        socket.send(JSON.stringify(frame));
+        return true;
+    }
+    announce(session) {
+        const frame = { type: "session.announce", ...session };
+        this.sessions.set(session.sessionId, frame);
+        this.send(frame);
+    }
+    /** Announces a session's command catalog; re-sent with the session after a reconnect. */
+    commands(frame) {
+        const full = { type: "session.commands", ...frame };
+        this.catalogs.set(frame.sessionId, full);
+        this.send(full);
+    }
+    status(sessionId, status) {
+        const known = this.sessions.get(sessionId);
+        if (known)
+            known.status = status;
+        this.send({ type: "session.status", sessionId, status });
+    }
+    closed(sessionId) {
+        this.sessions.delete(sessionId);
+        this.catalogs.delete(sessionId);
+        this.send({ type: "session.closed", sessionId });
+    }
+    /** Announces every session closed and stops reconnecting. */
+    close() {
+        this.closing = true;
+        this.stopHeartbeat();
+        for (const id of [...this.sessions.keys()])
+            this.closed(id);
+        this.socket?.close(1000, "host exiting");
+        this.socket = undefined;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/remote/host.js.map

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

package/dist/remote/protocol.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Host bridge protocol v1 — the JSON frames a Remote Control host (this CLI,
+ * or ditto-desktop) exchanges with the backend over one WebSocket. Field
+ * names are the contract shared with the backend; keep them stable.
+ */
+export declare const HOST_WS_PATH = "/api/v5/hosts/ws";
+export declare const PROTOCOL_VERSION = "1.1";
+export type HostKind = "cli" | "desktop";
+export type SessionMode = "tui" | "headless";
+export type SessionStatus = "idle" | "running";
+export type HarnessName = "claude-code" | "codex";
+export interface HostCapabilities {
+    harnesses: HarnessName[];
+    attachments: true;
+    headless: boolean;
+    teleport: boolean;
+}
+export interface HelloFrame {
+    type: "hello";
+    kind: HostKind;
+    name: string;
+    platform: string;
+    version: string;
+    capabilities: HostCapabilities;
+    /** Identity from an earlier `welcome`, so the same machine keeps its host id. */
+    hostId?: string;
+}
+export interface WelcomeFrame {
+    type: "welcome";
+    hostId: string;
+    heartbeatSeconds: number;
+    serverTime: string;
+}
+export interface SessionAnnounceFrame {
+    type: "session.announce";
+    sessionId: string;
+    harness: HarnessName;
+    cwd: string;
+    mode: SessionMode;
+    status: SessionStatus;
+}
+export interface SessionStatusFrame {
+    type: "session.status";
+    sessionId: string;
+    status: SessionStatus;
+}
+export interface SessionClosedFrame {
+    type: "session.closed";
+    sessionId: string;
+}
+export interface Attachment {
+    id: string;
+    name: string;
+    mime: string;
+    size: number;
+    sha256: string;
+    /** Presigned GET url, valid for about 15 minutes. */
+    url: string;
+}
+export type TurnKind = "prompt" | "command" | "answer";
+export interface TurnDeliverFrame {
+    type: "turn.deliver";
+    turnId: string;
+    sessionId: string;
+    /** Default "prompt". */
+    kind?: TurnKind;
+    text: string;
+    attachments?: Attachment[];
+    /** kind "command": a harness slash command / skill from the session's catalog. */
+    command?: {
+        name: string;
+        args?: string;
+    };
+    /** kind "answer": the user's reply to a `prompt.request`. */
+    answer?: {
+        promptId: string;
+        value: string;
+    };
+}
+export type CommandSource = "builtin" | "custom" | "skill" | "plugin";
+/** One entry of a session's command catalog (`session.commands`). */
+export interface CommandEntry {
+    /** As typed after the slash (Claude `review`, `frontend-design:frontend-design`; Codex `prompts:deploy`), or `$skill` for Codex skills. */
+    name: string;
+    description: string;
+    source: CommandSource;
+    argsHint?: string;
+    /** Whether the command works in a headless session (`claude -p "/name args"` / `codex exec`). */
+    headless: boolean;
+}
+export interface SessionCommandsFrame {
+    type: "session.commands";
+    sessionId: string;
+    harness: HarnessName;
+    commands: CommandEntry[];
+}
+export type PromptKind = "permission" | "question" | "choice";
+export interface PromptRequestFrame {
+    type: "prompt.request";
+    promptId: string;
+    sessionId: string;
+    kind: PromptKind;
+    text: string;
+    options?: Array<{
+        id: string;
+        label: string;
+    }>;
+    default?: string;
+}
+export interface PromptAnswerFrame {
+    type: "prompt.answer";
+    promptId: string;
+    value: string;
+}
+export interface TurnInterruptFrame {
+    type: "turn.interrupt";
+    turnId: string;
+}
+export interface CheckpointRequestFrame {
+    type: "checkpoint.request";
+    sessionId: string;
+    reason?: string;
+}
+export interface TurnAckFrame {
+    type: "turn.ack";
+    turnId: string;
+}
+export interface TurnStartedFrame {
+    type: "turn.started";
+    turnId: string;
+}
+export interface TurnFinishedFrame {
+    type: "turn.finished";
+    turnId: string;
+    exitCode?: number | null;
+    interrupted?: boolean;
+    error?: string;
+    /** The command cannot run in this session's mode (e.g. a TUI-only builtin in headless mode). */
+    unsupported?: string;
+}
+export interface CheckpointDoneFrame {
+    type: "checkpoint.done";
+    sessionId: string;
+    generation: number;
+}
+export interface CheckpointFailedFrame {
+    type: "checkpoint.failed";
+    sessionId: string;
+    error: string;
+}
+export interface PingFrame {
+    type: "ping";
+    t?: number;
+}
+export interface PongFrame {
+    type: "pong";
+    t?: number;
+}
+/** Frames the host sends. */
+export type HostFrame = HelloFrame | SessionAnnounceFrame | SessionStatusFrame | SessionClosedFrame | SessionCommandsFrame | PromptRequestFrame | TurnAckFrame | TurnStartedFrame | TurnFinishedFrame | CheckpointDoneFrame | CheckpointFailedFrame | PingFrame | PongFrame;
+/** Frames the backend sends. */
+export type ServerFrame = WelcomeFrame | TurnDeliverFrame | TurnInterruptFrame | CheckpointRequestFrame | PromptAnswerFrame | PingFrame | PongFrame;
+export declare function isServerFrame(value: unknown): value is ServerFrame;

package/dist/remote/protocol.js

@@ -0,0 +1,11 @@
+/**
+ * Host bridge protocol v1 — the JSON frames a Remote Control host (this CLI,
+ * or ditto-desktop) exchanges with the backend over one WebSocket. Field
+ * names are the contract shared with the backend; keep them stable.
+ */
+export const HOST_WS_PATH = "/api/v5/hosts/ws";
+export const PROTOCOL_VERSION = "1.1";
+export function isServerFrame(value) {
+    return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+//# sourceMappingURL=protocol.js.map

package/dist/remote/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/remote/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AA6LtC,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/G,CAAC"}

package/dist/remote/pty.d.ts

@@ -0,0 +1,57 @@
+import type { Harness } from "../agents/types.js";
+/**
+ * Runs a harness inside a pseudo-terminal this process owns, mirrored to the
+ * real terminal, so Remote Control can type into the harness's own input box
+ * exactly as the user would. `@lydell/node-pty` is an optional dependency
+ * (node-pty repackaged as script-free prebuilt binaries per platform): when
+ * it is missing the launcher falls back to a plain spawn and says why remote
+ * control is off.
+ */
+interface PtyModule {
+    spawn(file: string, args: string[], options: {
+        name: string;
+        cols: number;
+        rows: number;
+        cwd: string;
+        env: NodeJS.ProcessEnv;
+    }): PtyProcess;
+}
+interface PtyProcess {
+    onData(cb: (data: string) => void): void;
+    onExit(cb: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(signal?: string): void;
+    pid: number;
+}
+/** Loads the PTY module, or explains what is missing. */
+export declare function loadPty(): {
+    pty?: PtyModule;
+    reason?: string;
+};
+export interface PtySession {
+    pid: number;
+    /** Writes raw bytes to the harness's input. */
+    write(data: string): void;
+    /** Pastes a prompt (bracketed, so newlines survive) and submits it. */
+    inject(prompt: string): Promise<void>;
+    /** Sends the harness its interrupt key. */
+    interrupt(harness: Harness): void;
+    /** Milliseconds since the harness last wrote to the screen. */
+    quietFor(): number;
+    /** Resolves with the exit code once the harness exits. */
+    exit: Promise<number | null>;
+    kill(): void;
+}
+export interface PtyOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    /** Mirror to the real terminal (raw mode, resize). Tests can turn it off. */
+    attachTerminal?: boolean;
+    onOutput?: (data: string) => void;
+}
+export declare function spawnInPty(command: string, args: string[], options: PtyOptions): Promise<PtySession>;
+export {};

package/dist/remote/pty.js

@@ -0,0 +1,104 @@
+import { chmod } from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+const requireModule = createRequire(import.meta.url);
+const PTY_PACKAGE = "@lydell/node-pty";
+/** The per-platform package that carries the prebuilt binary. */
+const PTY_PLATFORM_PACKAGE = `${PTY_PACKAGE}-${process.platform}-${process.arch}`;
+/** Loads the PTY module, or explains what is missing. */
+export function loadPty() {
+    try {
+        return { pty: requireModule(PTY_PACKAGE) };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            reason: `${PTY_PACKAGE} is not installed or has no prebuilt binary for ${process.platform}-${process.arch} (${message.split("\n")[0]}); reinstall with \`npm i -g @heyditto/cli\` without \`--omit=optional\``,
+        };
+    }
+}
+/**
+ * npm sometimes extracts the prebuilt `spawn-helper` without its execute bit,
+ * which surfaces as "posix_spawnp failed". The prebuilt package has no
+ * install script that could restore it, so we do: the bit is safe to set (it
+ * is the PTY package's own binary) and fixes the spawn on retry.
+ */
+async function repairSpawnHelper() {
+    try {
+        const entry = requireModule.resolve(PTY_PLATFORM_PACKAGE); // <pkg>/lib/index.js
+        const helper = path.join(path.dirname(entry), "..", "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+        await chmod(helper, 0o755);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+export async function spawnInPty(command, args, options) {
+    const loaded = loadPty();
+    if (!loaded.pty)
+        throw new Error(loaded.reason);
+    const pty = loaded.pty;
+    const cols = process.stdout.columns || 120;
+    const rows = process.stdout.rows || 40;
+    const spawnOnce = () => pty.spawn(command, args, { name: process.env.TERM || "xterm-256color", cols, rows, cwd: options.cwd, env: options.env });
+    let child;
+    try {
+        child = spawnOnce();
+    }
+    catch (err) {
+        if (!(await repairSpawnHelper()))
+            throw err;
+        child = spawnOnce();
+    }
+    let lastOutput = Date.now();
+    child.onData((data) => {
+        lastOutput = Date.now();
+        if (options.attachTerminal !== false)
+            process.stdout.write(data);
+        options.onOutput?.(data);
+    });
+    const cleanups = [];
+    if (options.attachTerminal !== false) {
+        const stdin = process.stdin;
+        const wasRaw = stdin.isTTY ? stdin.isRaw : false;
+        if (stdin.isTTY)
+            stdin.setRawMode(true);
+        stdin.resume();
+        const onInput = (data) => child.write(typeof data === "string" ? data : data.toString("utf8"));
+        stdin.on("data", onInput);
+        const onResize = () => child.resize(process.stdout.columns || cols, process.stdout.rows || rows);
+        process.stdout.on("resize", onResize);
+        cleanups.push(() => {
+            stdin.off("data", onInput);
+            process.stdout.off("resize", onResize);
+            if (stdin.isTTY)
+                stdin.setRawMode(Boolean(wasRaw));
+            stdin.pause();
+        });
+    }
+    const exit = new Promise((resolve) => {
+        child.onExit(({ exitCode, signal }) => {
+            for (const c of cleanups)
+                c();
+            resolve(signal ? 128 + signal : exitCode);
+        });
+    });
+    return {
+        pid: child.pid,
+        write: (data) => child.write(data),
+        inject: async (prompt) => {
+            child.write(`\u001b[200~${prompt}\u001b[201~`);
+            await sleep(120);
+            child.write("\r");
+        },
+        interrupt: (harness) => child.write(harness === "claude" ? "\u001b" : "\u0003"),
+        quietFor: () => Date.now() - lastOutput,
+        exit,
+        kill: () => child.kill(),
+    };
+}
+//# sourceMappingURL=pty.js.map

package/dist/remote/pty.js.map

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

package/dist/store.d.ts

@@ -23,6 +23,8 @@ export interface StoredAuth {
         name?: string;
         createdAt?: string;
     };
+    /** Remote Control identity the backend assigned this machine (from the host bridge `welcome`). */
+    hostId?: string;
 }
 export declare function readStoredAuth(): Promise<StoredAuth | undefined>;
 export declare function readStoredKey(): Promise<string | undefined>;

package/dist/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2B3C,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QAC7C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACvE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACnC,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAgB;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,OAAO,GAAG,CAAC,MAAM,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAe,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,SAAS;YAAE,OAAQ,MAAkC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjE,MAAM,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,QAAsC,EAAE;IACnF,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjE,MAAM,OAAO,GAAwB;QACnC,MAAM,EAAE,OAAO;QACf,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,SAAS;QACzB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC3E,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,cAAkC;IAC1F,IAAI,CAAC,cAAc;QAAE,OAAO,aAAa,CAAC;IAC1C,IAAI,MAAW,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAChC,KAAK,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IACjE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACnE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/teleport/commands.d.ts

@@ -73,4 +73,10 @@ export declare function cmdStorageTest(ref: string, options: OutputOptions): Pro
 export declare function cmdStorageRemove(ref: string): Promise<void>;
 export declare function cmdStorageMirror(ref: string, targetsArg: string): Promise<void>;
 export declare function registerTeleportCommands(program: Command, addExamples: (c: Command, ex: string) => Command): void;
+/**
+ * Remote Control checkpoint: push the session's root as a new generation and
+ * return its number. Same code path as `heyditto teleport push`, without the
+ * printing.
+ */
+export declare function checkpointPush(root: string, harness: string | undefined, sessionId: string | undefined): Promise<number>;
 export {};

package/dist/teleport/commands.js

@@ -489,4 +489,15 @@ export function registerTeleportCommands(program, addExamples) {
 function collect(value, previous) {
     return [...previous, value];
 }
+/**
+ * Remote Control checkpoint: push the session's root as a new generation and
+ * return its number. Same code path as `heyditto teleport push`, without the
+ * printing.
+ */
+export async function checkpointPush(root, harness, sessionId) {
+    const summary = await runPush(root, { harness, session: sessionId });
+    if (!summary)
+        throw new Error("checkpoint produced no generation");
+    return summary.generation;
+}
 //# sourceMappingURL=commands.js.map