@exla/rudder 4.0.0-alpha.2 → 4.0.0-alpha.7

package/dist/fabric-remote.d.ts

@@ -0,0 +1,92 @@
+export type FabricObjectKind = "blob" | "directory" | "source_root" | "environment_root" | "checkpoint" | "action_key" | "action_result";
+export interface FabricObjectRef {
+    kind: FabricObjectKind;
+    algorithm: "sha256";
+    digest: string;
+    size_bytes: number;
+}
+export interface FabricLease {
+    format_version: 1;
+    lease_id: string;
+    expires_at_ms: number;
+}
+export interface FabricRootReceipt {
+    format_version: 1;
+    root_id: string;
+    root: FabricObjectRef;
+    durability: "replicated";
+    published_at_ms: number;
+    object_count: number;
+    total_bytes: number;
+}
+export interface FabricTransferSource {
+    pin(root: FabricObjectRef): Promise<string>;
+    unpin(ownedPinId: string): Promise<void>;
+    closure(root: FabricObjectRef): Promise<FabricObjectRef[]>;
+    read(reference: FabricObjectRef): Promise<Uint8Array>;
+}
+export interface FabricTransferResult {
+    receipt: FabricRootReceipt;
+    uploaded_objects: number;
+    uploaded_bytes: number;
+    cleanup_warning?: string;
+}
+export interface FabricLocalReceipt {
+    format_version: 1;
+    root: FabricObjectRef;
+    pin: string;
+    generation: number;
+    durability: "local";
+}
+export interface FabricTransferTarget {
+    beginStaging(ttlMs: number): Promise<FabricLease>;
+    renewStaging(leaseId: string, ttlMs: number): Promise<FabricLease>;
+    /** Must verify raw checksum, canonical typed schema, and the live lease. */
+    receive(leaseId: string, object: FabricObjectRef, bytes: Uint8Array): Promise<FabricObjectRef[]>;
+    /** Verify/sync the full reachable closure and atomically retain its root. */
+    publish(leaseId: string, pin: string, root: FabricObjectRef): Promise<FabricLocalReceipt>;
+    abandonStaging(leaseId: string): Promise<void>;
+}
+export interface FabricDownloadResult {
+    receipt: FabricRootReceipt;
+    local: FabricLocalReceipt;
+    downloaded_objects: number;
+    downloaded_bytes: number;
+}
+export declare class FabricRemoteError extends Error {
+    readonly code: string;
+    readonly status?: number | undefined;
+    constructor(code: string, message: string, status?: number | undefined);
+}
+export declare function validateFabricReference(value: unknown): FabricObjectRef;
+export declare function verifyFabricObject(reference: FabricObjectRef, bytes: Uint8Array): void;
+export declare class FabricRemoteClient {
+    private readonly options;
+    private readonly base;
+    private readonly concurrency;
+    private readonly requestTimeoutMs;
+    private readonly leaseTtlMs;
+    private readonly buffered;
+    constructor(options: {
+        /** Full authenticated endpoint base, ending /api/rudder/fabric. */
+        baseUrl: string;
+        authHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+        fetch?: typeof globalThis.fetch;
+        concurrency?: number;
+        requestTimeoutMs?: number;
+        leaseTtlMs?: number;
+    });
+    private request;
+    private json;
+    beginStaging(): Promise<FabricLease>;
+    renewStaging(leaseId: string): Promise<FabricLease>;
+    missing(objects: FabricObjectRef[]): Promise<FabricObjectRef[]>;
+    putObject(leaseId: string, reference: FabricObjectRef, bytes: Uint8Array): Promise<void>;
+    getObject(reference: FabricObjectRef): Promise<Buffer>;
+    publishRoot(root: string, leaseId: string, object: FabricObjectRef): Promise<FabricRootReceipt>;
+    getRoot(root: string): Promise<FabricRootReceipt>;
+    uploadRoot(root: string, object: FabricObjectRef, source: FabricTransferSource): Promise<FabricTransferResult>;
+    downloadRoot(root: string, target: FabricTransferTarget, pin: string): Promise<FabricDownloadResult>;
+}
+/** Lazy loading keeps the native transport out of ordinary remote-client use. */
+export declare function runFabricTransferCommand(args: string[], options?: import("./fabric-local.js").FabricTransferCommandOptions): Promise<void>;

package/dist/fabric-remote.js

@@ -0,0 +1,402 @@
+/** Authenticated bounded CAS transfer. The source adapter must pin the root
+ * durably and return a NEW owned pin identifier, never a caller's existing pin.
+ * This client does not mount filesystems or run an agent during transfer.
+ */
+import { createHash } from "node:crypto";
+export class FabricRemoteError extends Error {
+    code;
+    status;
+    constructor(code, message, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = "FabricRemoteError";
+    }
+}
+const fail = (code, message) => { throw new FabricRemoteError(code, message); };
+const kinds = new Set(["blob", "directory", "source_root", "environment_root", "checkpoint", "action_key", "action_result"]);
+const identity = (object) => `${object.kind}:${object.digest}:${object.size_bytes}`;
+export function validateFabricReference(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        fail("invalid_reference", "Invalid object reference");
+    const object = value;
+    if (Object.keys(object).length !== 4 || typeof object.kind !== "string" || !kinds.has(object.kind) || object.algorithm !== "sha256" || typeof object.digest !== "string" || !/^[a-f0-9]{64}$/.test(object.digest) || !Number.isSafeInteger(object.size_bytes) || Number(object.size_bytes) < 0 || Number(object.size_bytes) > 256 * 1024 * 1024 || (object.kind !== "blob" && Number(object.size_bytes) > 4 * 1024 * 1024))
+        fail("invalid_reference", "Invalid typed SHA-256 object reference");
+    return { kind: object.kind, algorithm: "sha256", digest: object.digest, size_bytes: object.size_bytes };
+}
+export function verifyFabricObject(reference, bytes) {
+    validateFabricReference(reference);
+    if (bytes.byteLength !== reference.size_bytes || createHash("sha256").update(bytes).digest("hex") !== reference.digest)
+        fail("checksum_mismatch", "Transferred object failed checksum verification");
+}
+function rootId(value) { if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(value))
+    fail("invalid_root_id", "Invalid root publication identifier"); return value; }
+function lease(value) {
+    const item = value;
+    if (!item || Object.keys(item).length !== 3 || item.format_version !== 1 || typeof item.lease_id !== "string" || !/^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/.test(item.lease_id) || !Number.isSafeInteger(item.expires_at_ms) || item.expires_at_ms <= 0)
+        fail("invalid_response", "Server returned an invalid staging lease");
+    return item;
+}
+function receipt(value, expectedId, expectedRoot) {
+    const item = value;
+    if (!item || Object.keys(item).length !== 7 || item.format_version !== 1 || item.root_id !== expectedId || item.durability !== "replicated" || !Number.isSafeInteger(item.published_at_ms) || item.published_at_ms < 0 || !Number.isSafeInteger(item.object_count) || item.object_count < 1 || item.object_count > 100_000 || !Number.isSafeInteger(item.total_bytes) || item.total_bytes < 0 || item.total_bytes > 4 * 1024 ** 3)
+        fail("invalid_response", "Server returned an invalid publication receipt");
+    const root = validateFabricReference(item.root);
+    if (expectedRoot && identity(root) !== identity(expectedRoot))
+        fail("invalid_response", "Publication receipt refers to another root");
+    return { ...item, root };
+}
+/** A single client cannot hold several large objects at once, even when the
+ * caller raises small-object concurrency. FIFO admission prevents starvation. */
+class ByteBudget {
+    available = 256 * 1024 * 1024;
+    queue = [];
+    acquire(bytes) {
+        return new Promise((resolve) => { this.queue.push({ bytes: Math.max(1, bytes), resolve }); this.drain(); });
+    }
+    drain() {
+        while (this.queue.length && this.queue[0].bytes <= this.available) {
+            const item = this.queue.shift();
+            this.available -= item.bytes;
+            let released = false;
+            item.resolve(() => { if (!released) {
+                released = true;
+                this.available += item.bytes;
+                this.drain();
+            } });
+        }
+    }
+}
+export class FabricRemoteClient {
+    options;
+    base;
+    concurrency;
+    requestTimeoutMs;
+    leaseTtlMs;
+    buffered = new ByteBudget();
+    constructor(options) {
+        this.options = options;
+        this.base = new URL(options.baseUrl.endsWith("/") ? options.baseUrl : `${options.baseUrl}/`);
+        if (!["http:", "https:"].includes(this.base.protocol) || this.base.username || this.base.password || this.base.search || this.base.hash)
+            fail("invalid_endpoint", "Invalid fabric endpoint");
+        this.concurrency = options.concurrency ?? 1;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 120_000;
+        this.leaseTtlMs = options.leaseTtlMs ?? 300_000;
+        if (!Number.isInteger(this.concurrency) || this.concurrency < 1 || this.concurrency > 8 || !Number.isInteger(this.requestTimeoutMs) || this.requestTimeoutMs < 1 || this.requestTimeoutMs > 120_000 || !Number.isInteger(this.leaseTtlMs) || this.leaseTtlMs < 1000 || this.leaseTtlMs > 3_600_000)
+            fail("invalid_limits", "Invalid transfer concurrency or deadline");
+    }
+    async request(path, method, body, binary, headers = {}, maxResponseBytes = 2 * 1024 * 1024) {
+        const controller = new AbortController();
+        let timer;
+        const work = (async () => {
+            const authHeaders = await this.options.authHeaders();
+            if (controller.signal.aborted)
+                fail("request_timeout", "Fabric request exceeded its deadline");
+            const response = await (this.options.fetch ?? globalThis.fetch)(new URL(path, this.base), {
+                method, redirect: "error", signal: controller.signal,
+                headers: { ...authHeaders, ...(body !== undefined ? { "Content-Type": "application/json" } : binary ? { "Content-Type": "application/octet-stream" } : {}), ...headers },
+                body: binary ? Buffer.isBuffer(binary) ? binary : Buffer.from(binary.buffer, binary.byteOffset, binary.byteLength) : body !== undefined ? JSON.stringify(body) : undefined,
+            });
+            if (!response.ok) {
+                await response.body?.cancel().catch(() => { });
+                // Never echo response bodies, auth headers, bucket keys or request data.
+                throw new FabricRemoteError("remote_rejected", `Fabric request failed (HTTP ${response.status})`, response.status);
+            }
+            const length = response.headers.get("content-length");
+            if (length !== null && (!/^\d+$/.test(length) || Number(length) > maxResponseBytes)) {
+                await response.body?.cancel().catch(() => { });
+                fail("too_large", "Fabric response exceeds byte limit");
+            }
+            if (!response.body)
+                return Buffer.alloc(0);
+            const reader = response.body.getReader();
+            const chunks = [];
+            // Known lengths use one bounded destination; retaining chunks and then
+            // concatenating would briefly double a 200 MiB compiler response.
+            const destination = length === null ? undefined : Buffer.allocUnsafe(Number(length));
+            let bytes = 0;
+            try {
+                while (true) {
+                    const part = await reader.read();
+                    if (part.done)
+                        break;
+                    const start = bytes;
+                    bytes += part.value.byteLength;
+                    if (bytes > maxResponseBytes || (destination && bytes > destination.length))
+                        fail("too_large", "Fabric response exceeds byte limit");
+                    if (destination)
+                        destination.set(part.value, start);
+                    else
+                        chunks.push(Buffer.from(part.value));
+                }
+            }
+            finally {
+                await reader.cancel().catch(() => { });
+            }
+            return destination ? destination.subarray(0, bytes) : Buffer.concat(chunks);
+        })();
+        try {
+            return await Promise.race([work, new Promise((_, reject) => { timer = setTimeout(() => { controller.abort(); reject(new FabricRemoteError("request_timeout", "Fabric request exceeded its deadline")); }, this.requestTimeoutMs); })]);
+        }
+        catch (failure) {
+            if (failure instanceof FabricRemoteError)
+                throw failure;
+            throw new FabricRemoteError("request_failed", "Fabric request failed");
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    async json(path, method, body) {
+        const bytes = await this.request(path, method, body);
+        try {
+            return JSON.parse(bytes.toString("utf8"));
+        }
+        catch {
+            return fail("invalid_response", "Fabric returned invalid JSON");
+        }
+    }
+    async beginStaging() { return lease(await this.json("staging", "POST", { format_version: 1, ttl_ms: this.leaseTtlMs })); }
+    async renewStaging(leaseId) {
+        lease({ format_version: 1, lease_id: leaseId, expires_at_ms: 1 });
+        return lease(await this.json(`staging/${leaseId}/renew`, "POST", { format_version: 1, ttl_ms: this.leaseTtlMs }));
+    }
+    async missing(objects) {
+        if (objects.length > 256)
+            fail("too_large", "Missing-object request exceeds batch limit");
+        objects.forEach(validateFabricReference);
+        const reply = await this.json("missing", "POST", { format_version: 1, objects });
+        if (!reply || reply.format_version !== 1 || !Array.isArray(reply.missing) || reply.missing.length > objects.length)
+            fail("invalid_response", "Invalid missing-object response");
+        const allowed = new Set(objects.map(identity));
+        const seen = new Set();
+        return reply.missing.map((value) => { const reference = validateFabricReference(value); const key = identity(reference); if (!allowed.has(key) || seen.has(key))
+            fail("invalid_response", "Server requested an undeclared or duplicate object"); seen.add(key); return reference; });
+    }
+    async putObject(leaseId, reference, bytes) {
+        verifyFabricObject(reference, bytes);
+        lease({ format_version: 1, lease_id: leaseId, expires_at_ms: 1 });
+        await this.request(`objects/${reference.kind}/${reference.digest}/${reference.size_bytes}`, "PUT", undefined, bytes, { "X-Rudder-Staging-Lease": leaseId });
+    }
+    async getObject(reference) {
+        validateFabricReference(reference);
+        const bytes = await this.request(`objects/${reference.kind}/${reference.digest}/${reference.size_bytes}`, "GET", undefined, undefined, {}, reference.size_bytes);
+        verifyFabricObject(reference, bytes);
+        return bytes;
+    }
+    async publishRoot(root, leaseId, object) {
+        rootId(root);
+        validateFabricReference(object);
+        lease({ format_version: 1, lease_id: leaseId, expires_at_ms: 1 });
+        return receipt(await this.json(`roots/${encodeURIComponent(root)}`, "POST", { format_version: 1, lease_id: leaseId, root: object }), root, object);
+    }
+    async getRoot(root) {
+        rootId(root);
+        return receipt(await this.json(`roots/${encodeURIComponent(root)}`, "GET"), root);
+    }
+    async uploadRoot(root, object, source) {
+        rootId(root);
+        validateFabricReference(object);
+        let ownedPin;
+        try {
+            ownedPin = await source.pin(object);
+        }
+        catch {
+            return fail("source_failed", "Could not pin the local transfer source");
+        }
+        if (typeof ownedPin !== "string" || !ownedPin.trim())
+            fail("invalid_source", "Source did not return an owned retention pin");
+        let result;
+        let failure;
+        try {
+            const inventory = await source.closure(object);
+            if (!Array.isArray(inventory) || inventory.length > 100_000)
+                fail("too_large", "Source inventory exceeds object limit");
+            const unique = new Map();
+            let total = 0;
+            for (const value of inventory) {
+                const reference = validateFabricReference(value);
+                if (!unique.has(identity(reference))) {
+                    unique.set(identity(reference), reference);
+                    total += reference.size_bytes;
+                }
+            }
+            if (!unique.has(identity(object)) || total > 4 * 1024 ** 3)
+                fail("invalid_source", "Source inventory is incomplete or exceeds byte limit");
+            let staging = await this.beginStaging();
+            let renewal;
+            const ensureLease = async (force = false) => {
+                if (!force && staging.expires_at_ms > Date.now() + Math.max(70_000, this.leaseTtlMs / 3))
+                    return;
+                renewal ??= this.renewStaging(staging.lease_id).then((updated) => { if (updated.lease_id !== staging.lease_id)
+                    fail("invalid_response", "Lease renewal changed identity"); staging = updated; }).finally(() => { renewal = undefined; });
+                await renewal;
+            };
+            let uploaded = 0, uploadedBytes = 0;
+            const all = [...unique.values()];
+            for (let start = 0; start < all.length; start += 256) {
+                await ensureLease();
+                const missing = await this.missing(all.slice(start, start + 256));
+                let cursor = 0;
+                let workerFailure;
+                // Wait for EVERY worker before releasing the source pin on failure.
+                await Promise.all(Array.from({ length: Math.min(this.concurrency, missing.length) }, async () => {
+                    while (cursor < missing.length && !workerFailure) {
+                        const reference = missing[cursor++];
+                        const release = await this.buffered.acquire(reference.size_bytes);
+                        try {
+                            await ensureLease();
+                            const bytes = await source.read(reference);
+                            verifyFabricObject(reference, bytes);
+                            await ensureLease();
+                            await this.putObject(staging.lease_id, reference, bytes);
+                            uploaded++;
+                            uploadedBytes += bytes.byteLength;
+                        }
+                        catch (error) {
+                            workerFailure = error;
+                        }
+                        finally {
+                            release();
+                        }
+                    }
+                }));
+                if (workerFailure)
+                    throw workerFailure;
+            }
+            await ensureLease(true);
+            result = { receipt: await this.publishRoot(root, staging.lease_id, object), uploaded_objects: uploaded, uploaded_bytes: uploadedBytes };
+        }
+        catch (error) {
+            failure = error instanceof FabricRemoteError ? error : new FabricRemoteError("source_failed", "Pinned source transfer failed");
+        }
+        finally {
+            try {
+                await source.unpin(ownedPin);
+            }
+            catch {
+                if (result)
+                    result.cleanup_warning = "Remote publication committed; its temporary local retention pin needs cleanup";
+                else
+                    failure ??= new FabricRemoteError("source_cleanup_failed", "Temporary local retention pin needs cleanup");
+            }
+        }
+        if (failure)
+            throw failure;
+        return result;
+    }
+    async downloadRoot(root, target, pin) {
+        rootId(root);
+        if (typeof pin !== "string" || !pin.trim() || pin.length > 512 || /[\x00-\x1f\x7f]/.test(pin))
+            fail("invalid_pin", "A local retention pin is required");
+        const published = await this.getRoot(root);
+        let staging;
+        let committed = false;
+        try {
+            staging = lease(await target.beginStaging(this.leaseTtlMs));
+            let renewal;
+            const ensureLease = async (force = false) => {
+                if (!force && staging.expires_at_ms > Date.now() + Math.max(this.requestTimeoutMs + 5000, this.leaseTtlMs / 3))
+                    return;
+                renewal ??= target.renewStaging(staging.lease_id, this.leaseTtlMs).then((value) => {
+                    const updated = lease(value);
+                    if (updated.lease_id !== staging.lease_id)
+                        fail("invalid_target", "Local renewal changed lease identity");
+                    staging = updated;
+                }).finally(() => { renewal = undefined; });
+                await renewal;
+            };
+            const queue = [];
+            const seen = new Set();
+            let total = 0, edges = 0, cursor = 0;
+            const add = (value, depth) => {
+                const object = validateFabricReference(value);
+                if (depth > 1024)
+                    fail("too_large", "Downloaded closure exceeds depth limit");
+                if (seen.has(identity(object)))
+                    return;
+                total += object.size_bytes;
+                seen.add(identity(object));
+                if (seen.size > 100_000 || total > 4 * 1024 ** 3)
+                    fail("too_large", "Downloaded closure exceeds transfer limits");
+                queue.push({ object, depth });
+            };
+            add(published.root, 0);
+            let workerFailure;
+            let active = 0;
+            const waiting = new Set();
+            const wake = () => { for (const resolve of waiting)
+                resolve(); waiting.clear(); };
+            await Promise.all(Array.from({ length: this.concurrency }, async () => {
+                while (!workerFailure) {
+                    if (cursor === queue.length) {
+                        // An in-flight metadata object can still reveal more work. Keep
+                        // idle workers available until the entire discovered graph drains.
+                        if (!active)
+                            return;
+                        await new Promise((resolve) => { waiting.add(resolve); });
+                        continue;
+                    }
+                    const { object, depth } = queue[cursor++];
+                    active++;
+                    let release;
+                    try {
+                        release = await this.buffered.acquire(object.size_bytes);
+                        if (workerFailure)
+                            continue;
+                        await ensureLease();
+                        if (workerFailure)
+                            continue;
+                        const bytes = await this.getObject(object);
+                        await ensureLease();
+                        const children = await target.receive(staging.lease_id, object, bytes);
+                        if (!Array.isArray(children))
+                            fail("invalid_target", "Local target returned invalid metadata references");
+                        edges += children.length;
+                        if (edges > 500_000 || (object.kind === "blob" && children.length))
+                            fail("invalid_target", "Local target returned invalid metadata edges");
+                        for (const child of children)
+                            add(child, depth + 1);
+                    }
+                    catch (error) {
+                        workerFailure ??= { error };
+                    }
+                    finally {
+                        release?.();
+                        active--;
+                        wake();
+                    }
+                }
+            }));
+            if (workerFailure)
+                throw workerFailure.error;
+            if (seen.size !== published.object_count || total !== published.total_bytes)
+                fail("invalid_response", "Published closure inventory differs from verified downloaded objects");
+            await ensureLease(true);
+            const local = await target.publish(staging.lease_id, pin, published.root);
+            if (!local || local.format_version !== 1 || local.durability !== "local" || local.pin !== pin || identity(validateFabricReference(local.root)) !== identity(published.root) || !Number.isSafeInteger(local.generation) || local.generation < 1)
+                fail("invalid_target", "Local target returned invalid retention evidence");
+            committed = true;
+            return { receipt: published, local, downloaded_objects: seen.size, downloaded_bytes: total };
+        }
+        catch (failure) {
+            if (failure instanceof FabricRemoteError)
+                throw failure;
+            throw new FabricRemoteError("target_failed", "Local download did not confirm complete durable publication");
+        }
+        finally {
+            if (staging && !committed) {
+                try {
+                    await target.abandonStaging(staging.lease_id);
+                }
+                catch { /* No durable success is returned; its bounded staging lease may need cleanup. */ }
+            }
+        }
+    }
+}
+/** Lazy loading keeps the native transport out of ordinary remote-client use. */
+export async function runFabricTransferCommand(args, options = {}) {
+    return (await import("./fabric-local.js")).runFabricTransferCommand(args, options);
+}
+//# sourceMappingURL=fabric-remote.js.map

package/dist/fabric-remote.js.map

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

package/dist/main.js

@@ -23,12 +23,25 @@ import { buildFanoutDag, gateDecision, planTask, scaffoldPlan } from "./planner.
 import { backfillLlmTaskSummaries, listRuns, loadConfig, popUndoEntry, projectStateDir, registerProject, runsDir } from "./state.js";
 import { discoverModelOptions } from "./models.js";
 import { resolveNativeBinaryPath } from "./native-binary.js";
+import { ensureEngineRunning, persistentProjectEngineRequested, runEngineCommand } from "./engine.js";
 import { cleanupRuns, deleteRun, listProjectRuns, mergeRun, printLogs, startRun, statusRuns, stopRun, syncRun, watchRun, workerRun, } from "./run-manager.js";
 import { appendCompletionNote, appendDecision, appendSharedContext, parseCompletionNoteArg, SHARED_CONTEXT_FILE, syncSharedContextToWorkspaces, writeCompletionNoteFile } from "./surfaces.js";
 import { commandExists, isTty, MissingToolError, newRunId, runCommand } from "./util.js";
 import { autoUpdateAndRerunIfNeeded, getUpdateAvailable } from "./version-check.js";
 import { printReport } from "./report.js";
 export async function main() {
+    // The SDK renderer owns its provider argv and stdio/control protocol. Route
+    // before general flag parsing so provider options never become Rudder tasks.
+    if (process.argv[2] === "__claude-sdk") {
+        const { runClaudeSdkBridge } = await import("./claude-sdk.js");
+        await runClaudeSdkBridge(process.argv.slice(3));
+        return;
+    }
+    if (process.argv[2] === "engine" && process.argv[3] === "api" && ["upload", "download"].includes(process.argv[4] ?? "")) {
+        const { runFabricTransferCommand } = await import("./fabric-remote.js");
+        await runFabricTransferCommand(process.argv.slice(4));
+        return;
+    }
     const parsed = parseArgs(process.argv.slice(2));
     if (shouldAutoUpdateForCommand(parsed.command) && await autoUpdateAndRerunIfNeeded(process.argv.slice(2))) {
         return;
@@ -95,6 +108,9 @@ export async function main() {
         return;
     }
     switch (parsed.command) {
+        case "engine":
+            await runEngineCommand(parsed.args[0], parsed.flags.repo ?? findRepoRoot(), parsed.flags.json);
+            return;
         case "tmux":
             throw new Error("The tmux dashboard has been removed. Run `rudder` or `rudder dashboard` to open the native dashboard.");
         case "attach": {
@@ -453,7 +469,7 @@ export function isInternalCommand(command) {
     return Boolean(command?.startsWith("__"));
 }
 // Commands that never touch a repository, so they never wait on a jj download.
-const JJ_FREE_COMMANDS = new Set(["__event", "__route-task", "telemetry", "feedback", "login", "logout", "help"]);
+const JJ_FREE_COMMANDS = new Set(["__event", "__route-task", "engine", "telemetry", "feedback", "login", "logout", "help"]);
 function shouldAutoUpdateForCommand(command) {
     if (command?.startsWith("__")) {
         return false;
@@ -760,6 +776,15 @@ async function maybeOnboard() {
 }
 async function openDashboard(parsed) {
     await refreshModelCache();
+    if (await attachSocketLive()) {
+        await runNativeCommand(["attach", "--dashboard"]);
+        return;
+    }
+    if (persistentProjectEngineRequested(findRepoRoot())) {
+        await ensureEngineRunning(findRepoRoot());
+        await runNativeCommand(["attach", "--dashboard"]);
+        return;
+    }
     if (await runNativeDashboard()) {
         return;
     }
@@ -1269,6 +1294,7 @@ Usage:
   rudder                         Open native dashboard with real agent panes
   rudder restart                 Clear local session and open dashboard
   rudder attach [agent]          Mirror one live agent pane of the running dashboard in this terminal
+  rudder engine [start|status|shutdown]   Control the persistent project engine
   rudder "task"
   rudder run [options] "task"
   rudder claude [options] "task"