@tickernelz/paperclip-pro-adapter-utils 2026.925.0

package/dist/runner-connectivity.test.js

@@ -0,0 +1,183 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildDirectRunnerConnectUrl, resolvePaperclipRunnerTransport, } from "./runner-connectivity.js";
+const capabilities = {
+    reusableLeases: false,
+    nativeSyncIn: false,
+    nativeSyncOut: false,
+    persistentProcessSessions: true,
+    independentControlCommands: true,
+    incrementalSessionOutput: true,
+    concurrentSyncOperations: false,
+    duplexCommandStream: false,
+    runnerWebSocketIngress: true,
+};
+function ingress() {
+    const endpoint = {
+        kind: "authenticated_websocket",
+        websocketUrl: "wss://43127-sandbox.proxy.daytona.test/api/runner/v1/connect/00000000-0000-4000-8000-000000000001",
+        secretHeaders: [{ name: "X-Daytona-Preview-Token", value: "secret" }],
+        generation: "generation-1",
+        refresh: async () => endpoint,
+        close: async () => undefined,
+    };
+    return endpoint;
+}
+describe("paperclip runner transport routing", () => {
+    it("keeps same-host runnerd on plaintext loopback", async () => {
+        const result = await resolvePaperclipRunnerTransport({
+            target: { kind: "local" },
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1:3100/api/runner/v1/connect/00000000-0000-4000-8000-000000000001",
+            runnerIngressAuthorized: false,
+        });
+        expect(result.mode).toBe("local_loopback");
+    });
+    it("selects provider ingress for Daytona-style capability even when a public URL exists", async () => {
+        const getRunnerIngressEndpoint = vi.fn(async () => ingress());
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "daytona",
+            remoteCwd: "/workspace",
+            leaseId: "lease-1",
+            effectiveCapabilities: capabilities,
+            getRunnerIngressEndpoint,
+        };
+        const result = await resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            runnerPublicUrl: "wss://paperclip.example.test",
+            runnerIngressAuthorized: true,
+        });
+        expect(result.mode).toBe("provider_ingress");
+        expect(getRunnerIngressEndpoint).toHaveBeenCalledOnce();
+    });
+    it("accepts the deprecated ingress input alias for existing consumers", async () => {
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "daytona",
+            remoteCwd: "/workspace",
+            leaseId: "lease-legacy",
+            effectiveCapabilities: capabilities,
+            getRunnerIngressEndpoint: vi.fn(async () => ingress()),
+        };
+        const result = await resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            enableRunnerPreviewIngress: true,
+        });
+        expect(result.mode).toBe("provider_ingress");
+    });
+    it("lets resolved authorization override the deprecated ingress alias", async () => {
+        const getRunnerIngressEndpoint = vi.fn(async () => ingress());
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "daytona",
+            remoteCwd: "/workspace",
+            leaseId: "lease-1",
+            effectiveCapabilities: capabilities,
+            getRunnerIngressEndpoint,
+        };
+        await expect(resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            runnerPublicUrl: "wss://paperclip.example.test",
+            runnerIngressAuthorized: false,
+            enableRunnerPreviewIngress: true,
+        })).rejects.toMatchObject({ code: "runner_ingress_unavailable" });
+        const missingAuthorization = {
+            target,
+            runId: "00000000-0000-4000-8000-000000000002",
+            localConnectUrl: "ws://127.0.0.1/unused",
+        };
+        await expect(resolvePaperclipRunnerTransport(missingAuthorization)).rejects.toMatchObject({ code: "runner_ingress_unavailable" });
+        expect(getRunnerIngressEndpoint).not.toHaveBeenCalled();
+    });
+    it("selects direct WSS only for a remote target with an explicit URL", async () => {
+        const target = {
+            kind: "remote",
+            transport: "ssh",
+            remoteCwd: "/workspace",
+            spec: {
+                host: "runner.internal",
+                port: 22,
+                username: "runner",
+                remoteWorkspacePath: "/workspace",
+                remoteCwd: "/workspace",
+                privateKey: null,
+                knownHosts: null,
+                strictHostKeyChecking: true,
+            },
+        };
+        const result = await resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            runnerPublicUrl: "wss://paperclip.example.test/runner-base/",
+            runnerCaBundlePath: "/etc/paperclip/runner-ca.pem",
+            runnerIngressAuthorized: false,
+        });
+        expect(result).toEqual({
+            mode: "direct_outbound",
+            connectUrl: "wss://paperclip.example.test/runner-base/api/runner/v1/connect/00000000-0000-4000-8000-000000000001",
+            caBundlePath: "/etc/paperclip/runner-ca.pem",
+        });
+    });
+    it("fails the selected ingress mode without falling through to direct WSS", async () => {
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "daytona",
+            remoteCwd: "/workspace",
+            leaseId: "lease-1",
+            effectiveCapabilities: capabilities,
+            getRunnerIngressEndpoint: async () => {
+                throw new Error("preview unavailable");
+            },
+        };
+        await expect(resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            runnerPublicUrl: "wss://paperclip.example.test",
+            runnerIngressAuthorized: true,
+        })).rejects.toThrow("preview unavailable");
+    });
+    it("never routes Daytona through direct outbound when ingress capability is unavailable", async () => {
+        const target = {
+            kind: "remote",
+            transport: "sandbox",
+            providerKey: "daytona",
+            remoteCwd: "/workspace",
+            leaseId: "lease-1",
+            effectiveCapabilities: {
+                ...capabilities,
+                runnerWebSocketIngress: false,
+            },
+        };
+        await expect(resolvePaperclipRunnerTransport({
+            target,
+            runId: "00000000-0000-4000-8000-000000000001",
+            localConnectUrl: "ws://127.0.0.1/unused",
+            runnerPublicUrl: "wss://paperclip.example.test",
+            runnerIngressAuthorized: true,
+        })).rejects.toMatchObject({ code: "runner_ingress_unavailable" });
+    });
+    it.each([
+        "ws://paperclip.example.test",
+        "wss://user@paperclip.example.test",
+        "wss://paperclip.example.test?token=secret",
+        "wss://paperclip.example.test#fragment",
+    ])("rejects unsafe direct runner URL %s", (runnerPublicUrl) => {
+        expect(() => buildDirectRunnerConnectUrl({
+            runnerPublicUrl,
+            runId: "00000000-0000-4000-8000-000000000001",
+        })).toThrow();
+    });
+});
+//# sourceMappingURL=runner-connectivity.test.js.map

package/dist/runner-connectivity.test.js.map

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

package/dist/runtime-progress.d.ts

@@ -0,0 +1,48 @@
+/** A sink for fully-formatted progress lines (newline included). */
+export type RuntimeProgressSink = (line: string) => void | Promise<void>;
+export type RuntimeProgressPhase = "Syncing" | "Restoring" | "Importing git history" | "Exporting git history";
+export type RuntimeProgressDirection = "to" | "from";
+export type RuntimeProgressTarget = "sandbox" | "ssh";
+export type RuntimeStatusPhase = "git_sync" | "config_sync" | "adapter_startup" | "restore" | "export" | "finalize";
+export interface RuntimeStatusUpdate {
+    phase: RuntimeStatusPhase;
+    message: string;
+    currentToolName?: string | null;
+    lastAssistantSnippet?: string | null;
+    lastEventAt?: Date | string | null;
+}
+export type RuntimeStatusSink = (update: RuntimeStatusUpdate) => void | Promise<void>;
+export interface RuntimeProgressReporterOptions {
+    sink: RuntimeProgressSink;
+    phase: RuntimeProgressPhase;
+    /** Optional per-phase label, e.g. "workspace" or an asset key. */
+    label?: string;
+    direction: RuntimeProgressDirection;
+    target: RuntimeProgressTarget;
+    /** Emit when the percentage crosses this step. Default 10. */
+    stepPercent?: number;
+    /** Emit when at least this many ms have elapsed since the last emit. Default 2000. */
+    minIntervalMs?: number;
+    /** Injectable clock for deterministic tests. Default `Date.now`. */
+    now?: () => number;
+}
+export interface RuntimeProgressReporter {
+    /**
+     * Report progress. Throttled: only emits on a step crossing or after
+     * `minIntervalMs`. When `totalBytes` is known and `doneBytes` reaches it, the
+     * terminal 100% line is emitted and the reporter is marked complete.
+     */
+    report(doneBytes: number, totalBytes: number | null): Promise<void>;
+    /**
+     * Emit the terminal completion line if it hasn't been emitted yet. Idempotent.
+     */
+    complete(doneBytes?: number, totalBytes?: number | null): Promise<void>;
+    /**
+     * Emit a terminal failure line if no terminal line has been emitted yet, so a
+     * failed transfer leaves an explicit marker instead of a dangling percentage.
+     * Idempotent and mutually exclusive with `complete()`.
+     */
+    fail(doneBytes?: number, totalBytes?: number | null): Promise<void>;
+}
+export declare function createRuntimeProgressReporter(options: RuntimeProgressReporterOptions): RuntimeProgressReporter;
+//# sourceMappingURL=runtime-progress.d.ts.map

package/dist/runtime-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-progress.d.ts","sourceRoot":"","sources":["../src/runtime-progress.ts"],"names":[],"mappings":"AAUA,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,WAAW,GACX,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,MAAM,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,KAAK,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,SAAS,GACT,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,wBAAwB,CAAC;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE;;;;OAIG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAaD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAqFzB"}

package/dist/runtime-progress.js

@@ -0,0 +1,99 @@
+// Shared, throttled progress reporting for execution-target sync/restore.
+//
+// Transports (sandbox / SSH) own the byte counting and call `report()` as bytes
+// move; orchestrators own the per-phase label and direction. The reporter
+// throttles emits so a long transfer doesn't flood the log: a line is emitted
+// only when the percentage crosses a step boundary (default every 10%) or once
+// at least `minIntervalMs` has elapsed since the last emit. The terminal
+// completion line is always emitted via `complete()` (or when `report()` reaches
+// the known total).
+const BYTES_PER_MB = 1024 * 1024;
+function formatMb(bytes) {
+    return (Math.max(0, bytes) / BYTES_PER_MB).toFixed(1);
+}
+function clampPercent(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, Math.round(value)));
+}
+export function createRuntimeProgressReporter(options) {
+    const stepPercent = options.stepPercent && options.stepPercent > 0 ? options.stepPercent : 10;
+    const minIntervalMs = options.minIntervalMs && options.minIntervalMs > 0 ? options.minIntervalMs : 2000;
+    const now = options.now ?? Date.now;
+    // "sandbox" is the transport key, not product vocabulary: progress lines are
+    // user-visible run status, and the product refers to the run's machine as an
+    // environment ("Paperclip Computer" on managed deployments).
+    const targetDisplay = options.target === "sandbox" ? "environment" : options.target;
+    const prefix = `[paperclip] ${options.phase}${options.label ? ` ${options.label}` : ""} ${options.direction} ${targetDisplay}`;
+    let lastEmitAt = null;
+    let lastStep = -1;
+    let lastDoneBytes = 0;
+    let lastTotalBytes = null;
+    let completed = false;
+    function buildLine(doneBytes, totalBytes) {
+        if (totalBytes != null && totalBytes > 0) {
+            const pct = clampPercent((doneBytes / totalBytes) * 100);
+            return `${prefix}: ${pct}% (${formatMb(doneBytes)}/${formatMb(totalBytes)} MB)\n`;
+        }
+        return `${prefix}: ${formatMb(doneBytes)} MB\n`;
+    }
+    function buildFailLine(doneBytes, totalBytes) {
+        if (totalBytes != null && totalBytes > 0) {
+            const pct = clampPercent((doneBytes / totalBytes) * 100);
+            return `${prefix}: failed at ${pct}% (${formatMb(doneBytes)}/${formatMb(totalBytes)} MB)\n`;
+        }
+        return `${prefix}: failed after ${formatMb(doneBytes)} MB\n`;
+    }
+    async function emit(doneBytes, totalBytes) {
+        lastEmitAt = now();
+        if (totalBytes != null && totalBytes > 0) {
+            lastStep = Math.floor(((doneBytes / totalBytes) * 100) / stepPercent);
+        }
+        await options.sink(buildLine(doneBytes, totalBytes));
+    }
+    return {
+        async report(doneBytes, totalBytes) {
+            lastDoneBytes = doneBytes;
+            lastTotalBytes = totalBytes;
+            if (completed)
+                return;
+            const elapsedOk = lastEmitAt == null || now() - lastEmitAt >= minIntervalMs;
+            if (totalBytes != null && totalBytes > 0) {
+                const terminal = doneBytes >= totalBytes;
+                const step = Math.floor(((doneBytes / totalBytes) * 100) / stepPercent);
+                const stepOk = step > lastStep;
+                if (terminal || stepOk || elapsedOk) {
+                    await emit(doneBytes, totalBytes);
+                }
+                if (terminal)
+                    completed = true;
+                return;
+            }
+            // Unknown total: no step boundaries, throttle purely on elapsed time.
+            if (elapsedOk) {
+                await emit(doneBytes, totalBytes);
+            }
+        },
+        async complete(doneBytes, totalBytes) {
+            if (completed)
+                return;
+            completed = true;
+            const total = totalBytes !== undefined ? totalBytes : lastTotalBytes;
+            const done = doneBytes !== undefined
+                ? doneBytes
+                : total != null && total > 0
+                    ? total
+                    : lastDoneBytes;
+            await options.sink(buildLine(done, total));
+        },
+        async fail(doneBytes, totalBytes) {
+            if (completed)
+                return;
+            completed = true;
+            const total = totalBytes !== undefined ? totalBytes : lastTotalBytes;
+            const done = doneBytes !== undefined ? doneBytes : lastDoneBytes;
+            await options.sink(buildFailLine(done, total));
+        },
+    };
+}
+//# sourceMappingURL=runtime-progress.js.map

package/dist/runtime-progress.js.map

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

package/dist/runtime-progress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-progress.test.d.ts.map

package/dist/runtime-progress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-progress.test.d.ts","sourceRoot":"","sources":["../src/runtime-progress.test.ts"],"names":[],"mappings":""}

package/dist/runtime-progress.test.js

@@ -0,0 +1,240 @@
+import { describe, expect, it } from "vitest";
+import { createRuntimeProgressReporter } from "./runtime-progress.js";
+const MB = 1024 * 1024;
+function makeClock(start = 0) {
+    let value = start;
+    return {
+        now: () => value,
+        advance: (ms) => {
+            value += ms;
+        },
+    };
+}
+describe("createRuntimeProgressReporter", () => {
+    it("formats the message with phase, label, direction, target, percent and MB", async () => {
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+        });
+        await reporter.report(12.6 * MB, 31.4 * MB);
+        expect(lines).toEqual(["[paperclip] Syncing workspace to environment: 40% (12.6/31.4 MB)\n"]);
+    });
+    it("omits the label when none is provided (e.g. git history)", async () => {
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Importing git history",
+            direction: "to",
+            target: "ssh",
+        });
+        await reporter.report(4 * MB, 4 * MB);
+        expect(lines).toEqual(["[paperclip] Importing git history to ssh: 100% (4.0/4.0 MB)\n"]);
+    });
+    it("suppresses intermediate emits that neither cross a step nor exceed the interval", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+            now: clock.now,
+        });
+        // First report always emits (step 0 crossed).
+        await reporter.report(1 * MB, 100 * MB); // 1%
+        // Still within the same 10% step and under 2s -> suppressed.
+        await reporter.report(2 * MB, 100 * MB); // 2%
+        await reporter.report(5 * MB, 100 * MB); // 5%
+        expect(lines).toHaveLength(1);
+        expect(lines[0]).toBe("[paperclip] Syncing workspace to environment: 1% (1.0/100.0 MB)\n");
+    });
+    it("emits when the percentage crosses a 10% step", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+            now: clock.now,
+        });
+        await reporter.report(1 * MB, 100 * MB); // 1% -> emit (step 0)
+        await reporter.report(15 * MB, 100 * MB); // 15% -> crosses into step 1 -> emit
+        expect(lines).toHaveLength(2);
+        expect(lines[1]).toBe("[paperclip] Syncing workspace to environment: 15% (15.0/100.0 MB)\n");
+    });
+    it("emits on the time threshold even without a step crossing", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+            now: clock.now,
+        });
+        await reporter.report(1 * MB, 100 * MB); // emit
+        await reporter.report(2 * MB, 100 * MB); // suppressed (same step, no time elapsed)
+        clock.advance(2000);
+        await reporter.report(3 * MB, 100 * MB); // 3% same step, but 2s elapsed -> emit
+        expect(lines).toHaveLength(2);
+        expect(lines[1]).toBe("[paperclip] Syncing workspace to environment: 3% (3.0/100.0 MB)\n");
+    });
+    it("always emits the terminal 100% line via report reaching the total", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Restoring",
+            label: "workspace",
+            direction: "from",
+            target: "sandbox",
+            now: clock.now,
+        });
+        await reporter.report(1 * MB, 100 * MB); // emit
+        await reporter.report(100 * MB, 100 * MB); // terminal -> always emit
+        expect(lines[lines.length - 1]).toBe("[paperclip] Restoring workspace from environment: 100% (100.0/100.0 MB)\n");
+    });
+    it("complete() emits the terminal 100% line even when intermediate emits were throttled", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+            now: clock.now,
+        });
+        await reporter.report(1 * MB, 100 * MB); // emit
+        await reporter.report(5 * MB, 100 * MB); // suppressed
+        await reporter.complete();
+        expect(lines[lines.length - 1]).toBe("[paperclip] Syncing workspace to environment: 100% (100.0/100.0 MB)\n");
+    });
+    it("complete() is idempotent and does not double-emit after a terminal report", async () => {
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "sandbox",
+        });
+        await reporter.report(100 * MB, 100 * MB); // terminal
+        await reporter.complete();
+        await reporter.complete();
+        expect(lines).toHaveLength(1);
+    });
+    it("reports MB-only (no percent) when the total is unknown, plus a completion line", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Restoring",
+            label: "workspace",
+            direction: "from",
+            target: "ssh",
+            now: clock.now,
+        });
+        await reporter.report(2 * MB, null); // first emit
+        await reporter.report(4 * MB, null); // suppressed (no time elapsed)
+        clock.advance(2000);
+        await reporter.report(8 * MB, null); // time elapsed -> emit
+        await reporter.complete();
+        expect(lines).toEqual([
+            "[paperclip] Restoring workspace from ssh: 2.0 MB\n",
+            "[paperclip] Restoring workspace from ssh: 8.0 MB\n",
+            "[paperclip] Restoring workspace from ssh: 8.0 MB\n",
+        ]);
+    });
+    it("fail() emits a terminal failure marker with the last percent instead of a dangling line", async () => {
+        const clock = makeClock();
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "ssh",
+            now: clock.now,
+        });
+        await reporter.report(40 * MB, 100 * MB); // emit at 40%
+        await reporter.fail();
+        expect(lines).toEqual([
+            "[paperclip] Syncing workspace to ssh: 40% (40.0/100.0 MB)\n",
+            "[paperclip] Syncing workspace to ssh: failed at 40% (40.0/100.0 MB)\n",
+        ]);
+    });
+    it("fail() falls back to an MB marker when the total is unknown", async () => {
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Restoring",
+            direction: "from",
+            target: "ssh",
+        });
+        await reporter.report(3 * MB, null);
+        await reporter.fail();
+        expect(lines.at(-1)).toBe("[paperclip] Restoring from ssh: failed after 3.0 MB\n");
+    });
+    it("fail() is suppressed after a terminal completion and complete() after a failure", async () => {
+        const lines = [];
+        const reporter = createRuntimeProgressReporter({
+            sink: (line) => {
+                lines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "ssh",
+        });
+        await reporter.report(100 * MB, 100 * MB); // terminal complete
+        await reporter.fail(); // suppressed — already completed
+        expect(lines).toHaveLength(1);
+        const failLines = [];
+        const failed = createRuntimeProgressReporter({
+            sink: (line) => {
+                failLines.push(line);
+            },
+            phase: "Syncing",
+            label: "workspace",
+            direction: "to",
+            target: "ssh",
+        });
+        await failed.report(20 * MB, 100 * MB);
+        await failed.fail();
+        await failed.complete(); // suppressed — already failed
+        expect(failLines).toHaveLength(2);
+        expect(failLines.at(-1)).toContain("failed at 20%");
+    });
+});
+//# sourceMappingURL=runtime-progress.test.js.map

package/dist/runtime-progress.test.js.map

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

package/dist/sandbox-callback-bridge-body.d.ts

@@ -0,0 +1,12 @@
+export interface SandboxCallbackBridgeBody {
+    body: string;
+    /** Omitted by older queue peers, whose bodies are UTF-8 text. */
+    bodyEncoding?: "utf8" | "base64";
+}
+/** JSON can escape each input byte as six characters. Metadata is bounded too. */
+export declare function sandboxBridgeEnvelopeLimit(maxBodyBytes: number): number;
+export declare function encodeSandboxBridgeBody(body: string | Buffer, maxBodyBytes: number): SandboxCallbackBridgeBody;
+/** Self-contained so the same decoder can be embedded in the remote gateway. */
+export declare function decodeSandboxBridgeBody(envelope: SandboxCallbackBridgeBody, maxBodyBytes: number): Buffer;
+export declare function sandboxBridgeBodyCodecSource(): string;
+//# sourceMappingURL=sandbox-callback-bridge-body.d.ts.map

package/dist/sandbox-callback-bridge-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-callback-bridge-body.d.ts","sourceRoot":"","sources":["../src/sandbox-callback-bridge-body.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAClC;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,yBAAyB,CAG9G;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAiBzG;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAGrD"}