@exla/rudder 0.0.0-stage → 3.4.1

package/dist/paste-bridge.js

@@ -0,0 +1,279 @@
+// Pasting files from this computer into a dashboard on the cloud machine.
+//
+// An agent on the home machine reads ITS clipboard and ITS disk: Claude Code's
+// Ctrl+V runs xclip there (no clipboard, nothing pasted), and a screenshot
+// dragged into the terminal arrives as a path like /Users/me/Desktop/shot.png
+// that does not exist there. So the attach client looks at what is about to go
+// up, and when it is a clipboard image (Ctrl+V) or a paste made only of local
+// file paths, it uploads the files first (the phone's upload route, into the
+// repo's .rudder/uploads) and sends the cloud paths as a paste instead. Claude
+// Code and Codex both turn a pasted image path into an attached image; the
+// dashboard's task box turns it into an [Image #N] chip.
+//
+// Everything else goes straight through, untouched and unbuffered.
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const PASTE_UPLOAD_MAX_BYTES = 25 * 1024 * 1024;
+const PASTE_BEGIN = "\x1b[200~";
+const PASTE_END = "\x1b[201~";
+const MAX_FILES = 20;
+/** Ctrl+V, as a plain control byte or in the kitty keyboard encoding. */
+export function isCtrlV(data) {
+    if (data.length === 1 && data[0] === 0x16) {
+        return true;
+    }
+    return /^\x1b\[118(?::\d*)*;5(?::1)?u$/.test(data.toString("latin1"));
+}
+/**
+ * The local files a paste names, or null when it is anything else. Every
+ * token must be an existing regular file, so a pasted snippet that merely
+ * mentions a path is never rewritten. Handles what terminals produce for a
+ * drop: 'quoted', "quoted", backslash-escaped spaces, file:// urls.
+ */
+export function pastedLocalFiles(text, home = os.homedir()) {
+    const tokens = shellTokens(text.trim());
+    if (!tokens || tokens.length === 0 || tokens.length > MAX_FILES) {
+        return null;
+    }
+    const files = [];
+    for (let token of tokens) {
+        if (token.startsWith("file://")) {
+            try {
+                token = decodeURIComponent(new URL(token).pathname);
+            }
+            catch {
+                return null;
+            }
+        }
+        if (token.startsWith("~/")) {
+            token = path.join(home, token.slice(2));
+        }
+        if (!path.isAbsolute(token)) {
+            return null;
+        }
+        try {
+            const stat = fs.statSync(token);
+            if (!stat.isFile() || stat.size === 0 || stat.size > PASTE_UPLOAD_MAX_BYTES) {
+                return null;
+            }
+        }
+        catch {
+            return null;
+        }
+        files.push(token);
+    }
+    return files;
+}
+function shellTokens(text) {
+    if (!text || /[\x00-\x08\x0b-\x1f\x7f]/.test(text)) {
+        return null;
+    }
+    const tokens = [];
+    let current = "";
+    let inToken = false;
+    let quote = null;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+            }
+            else if (ch === "\\" && quote === "\"" && i + 1 < text.length) {
+                current += text[++i];
+            }
+            else {
+                current += ch;
+            }
+            continue;
+        }
+        if (ch === "'" || ch === "\"") {
+            quote = ch;
+            inToken = true;
+        }
+        else if (ch === "\\" && i + 1 < text.length) {
+            current += text[++i];
+            inToken = true;
+        }
+        else if (/\s/.test(ch)) {
+            if (inToken) {
+                tokens.push(current);
+            }
+            current = "";
+            inToken = false;
+        }
+        else {
+            current += ch;
+            inToken = true;
+        }
+    }
+    if (quote) {
+        return null;
+    }
+    if (inToken) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+export class PasteBridge {
+    options;
+    /** Pass everything straight through (a target that cannot take uploads). */
+    disabled = false;
+    busy = false;
+    pending = [];
+    constructor(options) {
+        this.options = options;
+    }
+    /** Every keystroke chunk for the cloud goes through here, in order. */
+    forward(data) {
+        if (this.busy) {
+            this.pending.push(data);
+            return;
+        }
+        const job = this.disabled ? null : this.jobFor(data);
+        if (!job) {
+            this.options.send(data);
+            return;
+        }
+        this.busy = true;
+        void job.then((replacement) => {
+            this.options.send(replacement ?? data);
+        }).catch((error) => {
+            this.options.send(data);
+            this.options.status?.(`Could not send that file to the cloud: ${error.message}`);
+            setTimeout(() => this.options.status?.(null), 4000).unref?.();
+        }).finally(() => {
+            this.busy = false;
+            const queued = this.pending;
+            this.pending = [];
+            for (const chunk of queued) {
+                this.forward(chunk);
+            }
+        });
+    }
+    jobFor(data) {
+        if (isCtrlV(data)) {
+            if (!this.options.readClipboard) {
+                return null;
+            }
+            return this.fromClipboard();
+        }
+        const text = data.toString("utf8");
+        let inner = text;
+        let bracketed = false;
+        if (text.startsWith(PASTE_BEGIN) && text.endsWith(PASTE_END)) {
+            inner = text.slice(PASTE_BEGIN.length, text.length - PASTE_END.length);
+            bracketed = true;
+        }
+        else if (text.length < 4 || !/^['"~\/f]/.test(text)) {
+            return null;
+        }
+        const files = pastedLocalFiles(inner);
+        if (!files) {
+            return null;
+        }
+        const trailing = /\s$/.test(inner) ? " " : "";
+        return this.uploadAll(files).then((remote) => {
+            const body = remote.join(" ") + trailing;
+            return Buffer.from(bracketed ? PASTE_BEGIN + body + PASTE_END : body, "utf8");
+        });
+    }
+    async fromClipboard() {
+        const contents = await this.options.readClipboard().catch(() => null);
+        if (!contents) {
+            return null;
+        }
+        let remote;
+        if ("image" in contents) {
+            try {
+                remote = await this.uploadAll([contents.image], "image");
+            }
+            finally {
+                fs.rmSync(contents.image, { force: true });
+            }
+        }
+        else {
+            remote = await this.uploadAll(contents.files);
+        }
+        return Buffer.from(PASTE_BEGIN + remote.join(" ") + PASTE_END, "utf8");
+    }
+    async uploadAll(files, kind = "file") {
+        const noun = kind === "image" ? "image" : files.length === 1 ? path.basename(files[0]) : `${files.length} files`;
+        this.options.status?.(`Sending ${noun} to the cloud...`);
+        try {
+            const remote = [];
+            for (const file of files) {
+                remote.push(await this.options.upload(file, kind === "image" ? "clipboard.png" : path.basename(file)));
+            }
+            return remote;
+        }
+        finally {
+            this.options.status?.(null);
+        }
+    }
+}
+// The clipboard of THIS computer: files copied in Finder win, then an image
+// (a screenshot, "Copy Image"), the same order Claude Code uses locally.
+export async function readLocalClipboard() {
+    const out = path.join(os.tmpdir(), `rudder-clip-${process.pid}-${Date.now()}.png`);
+    if (process.platform === "darwin") {
+        const raw = await run("osascript", ["-l", "JavaScript", "-e", MAC_CLIPBOARD_SCRIPT, out]).catch(() => "");
+        try {
+            const parsed = JSON.parse(raw.trim() || "{}");
+            const files = (parsed.files ?? []).filter((file) => pastedLocalFiles(JSON.stringify(file)) !== null);
+            if (files.length) {
+                return { files };
+            }
+            if (parsed.image && fs.existsSync(parsed.image) && fs.statSync(parsed.image).size > 0) {
+                return { image: parsed.image };
+            }
+        }
+        catch {
+            // not JSON: no clipboard we can use
+        }
+        return null;
+    }
+    if (process.platform === "linux") {
+        for (const [cmd, args] of [["wl-paste", ["--type", "image/png"]], ["xclip", ["-selection", "clipboard", "-t", "image/png", "-o"]]]) {
+            const bytes = await runBytes(cmd, [...args]).catch(() => null);
+            if (bytes && bytes.length > 8 && bytes.subarray(1, 4).toString("latin1") === "PNG") {
+                fs.writeFileSync(out, bytes, { mode: 0o600 });
+                return { image: out };
+            }
+        }
+    }
+    return null;
+}
+const MAC_CLIPBOARD_SCRIPT = `
+ObjC.import('AppKit');
+function run(argv) {
+  const pb = $.NSPasteboard.generalPasteboard;
+  const opts = $.NSDictionary.dictionaryWithObjectForKey($.NSNumber.numberWithBool(true), $.NSPasteboardURLReadingFileURLsOnlyKey);
+  const urls = pb.readObjectsForClassesOptions($.NSArray.arrayWithObject($.NSURL), opts);
+  const files = [];
+  if (urls && !urls.isNil()) {
+    for (let i = 0; i < urls.count; i++) files.push(urls.objectAtIndex(i).path.js);
+  }
+  if (files.length) return JSON.stringify({ files });
+  const types = ObjC.deepUnwrap(pb.types) || [];
+  const imageTypes = ['public.png', 'public.tiff', 'public.jpeg', 'com.apple.pict'];
+  if (!types.some((t) => imageTypes.includes(t))) return '{}';
+  const image = $.NSImage.alloc.initWithPasteboard(pb);
+  if (image.isNil()) return '{}';
+  const rep = $.NSBitmapImageRep.imageRepWithData(image.TIFFRepresentation);
+  const png = rep.representationUsingTypeProperties($.NSBitmapImageFileTypePNG, $({}));
+  if (!png.writeToFileAtomically(argv[0], true)) return '{}';
+  return JSON.stringify({ image: argv[0] });
+}`;
+function run(cmd, args) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { timeout: 5000, maxBuffer: 1024 * 1024 }, (error, stdout) => (error ? reject(error) : resolve(String(stdout))));
+    });
+}
+function runBytes(cmd, args) {
+    return new Promise((resolve, reject) => {
+        execFile(cmd, args, { timeout: 5000, maxBuffer: PASTE_UPLOAD_MAX_BYTES, encoding: "buffer" }, (error, stdout) => (error ? reject(error) : resolve(stdout)));
+    });
+}
+//# sourceMappingURL=paste-bridge.js.map

package/dist/paste-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-bridge.js","sourceRoot":"","sources":["../src/paste-bridge.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,2EAA2E;AAC3E,yDAAyD;AACzD,EAAE;AACF,mEAAmE;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACvD,MAAM,WAAW,GAAG,WAAW,CAAC;AAChC,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,SAAS,GAAG,EAAE,CAAC;AAYrB,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE;IAChE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,KAAK,GAAG,kBAAkB,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,sBAAsB,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC,IAAI,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAK,GAAsB,IAAI,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACjB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChE,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAC9B,KAAK,GAAG,EAAE,CAAC;YACX,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;YACd,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,WAAW;IACL,OAAO,CAAqB;IAC7C,4EAA4E;IAC5E,QAAQ,GAAG,KAAK,CAAC;IACT,IAAI,GAAG,KAAK,CAAC;IACb,OAAO,GAAa,EAAE,CAAC;IAE/B,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,IAAY;QAClB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;YAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,0CAA2C,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5F,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAChE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;YAClB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACvE,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACzC,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAgB,CAAC;QACrB,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAe,EAAE,IAAI,GAAG,MAAM;QACpD,MAAM,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC;QACjH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,IAAI,kBAAkB,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzG,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAED,4EAA4E;AAC5E,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,CAAyC,CAAC;YACtF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACrG,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAU,EAAE,CAAC;YAC5I,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;gBACnF,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;EAoB3B,CAAC;AAEH,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvI,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAc;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAgB,CAAC,CAAC,CAAC,CAAC;IACxK,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/plan-mode.d.ts

@@ -0,0 +1,2 @@
+export declare const PLAN_MODE_CONTRACT: string;
+export declare function buildPlanPrompt(task: string): string;

package/dist/plan-mode.js

@@ -0,0 +1,22 @@
+export const PLAN_MODE_CONTRACT = [
+    "[RUDDER PLAN MODE]",
+    "You are running inside Rudder's own plan mode, not the backend's native implementation mode.",
+    "Your job is to investigate and produce a decision-complete implementation plan.",
+    "",
+    "Rules:",
+    "- Do not write, edit, create, delete, move, rename, install, commit, merge, deploy, migrate, or otherwise mutate local or remote state.",
+    "- Use only read-only inspection. It is OK to read files, search the repo, inspect git state or read-only CLI state when the active tool profile permits it, and use web search/fetch when it improves the plan.",
+    "- If secrets or environment state matter, inspect only what is needed and do not print secret values. Mention presence, absence, names, or configuration shape instead.",
+    "- Ask concise follow-up questions when important product or implementation choices cannot be discovered from the environment.",
+    "- When the plan is ready, put the final answer in a single <proposed_plan>...</proposed_plan> block.",
+    "[END RUDDER PLAN MODE]",
+].join("\n");
+export function buildPlanPrompt(task) {
+    return [
+        "Plan this task before implementation:",
+        task,
+        "",
+        "First inspect the repository and relevant external/read-only context. Ask follow-up questions if the plan cannot be made decision-complete from inspection alone.",
+    ].join("\n");
+}
+//# sourceMappingURL=plan-mode.js.map

package/dist/plan-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode.js","sourceRoot":"","sources":["../src/plan-mode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,8FAA8F;IAC9F,iFAAiF;IACjF,EAAE;IACF,QAAQ;IACR,yIAAyI;IACzI,iNAAiN;IACjN,yKAAyK;IACzK,+HAA+H;IAC/H,sGAAsG;IACtG,wBAAwB;CACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO;QACL,uCAAuC;QACvC,IAAI;QACJ,EAAE;QACF,mKAAmK;KACpK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/planner.d.ts

@@ -0,0 +1,27 @@
+import type { BackendId, EffortLevel, PlanDag, PlanNode, ReconcileResult } from "./types.js";
+export { loadInstructionFiles } from "./brain.js";
+export declare const PLANNER_MODEL = "claude-sonnet-5";
+export declare function parsePlanBlock(output: string): PlanDag;
+export declare function gateDecision(dag: PlanDag): {
+    autoRun: boolean;
+    reason: string;
+};
+export type PlanContext = {
+    root: string;
+    branch: string;
+};
+export declare function planTask(task: string, ctx: PlanContext): Promise<PlanDag>;
+/**
+ * Infer the new node's deps against the current frontier. On any LLM failure
+ * (timeout / no model / unparsable), fall back to a SOFT edge to every frontier
+ * node: this over-delivers context and never deadlocks. Never a default hard
+ * edge.
+ */
+export declare function reconcile(task: string, frontierNodes: PlanNode[], ctx: PlanContext): Promise<ReconcileResult>;
+export type FanoutOptions = {
+    backend?: BackendId;
+    model?: string;
+    effort?: EffortLevel;
+};
+export declare function buildFanoutDag(task: string, n: number, opts?: FanoutOptions): PlanDag;
+export declare function scaffoldPlan(repoRoot: string, dag: PlanDag): Promise<void>;