tmex-cli 0.11.0 → 0.12.0

package/dist/runtime/server.js

@@ -22550,7 +22550,7 @@ loadEnv();
 
 // src/runtime/server.ts
 import { existsSync as existsSync8 } from "fs";
-import { extname as extname2, join as join7, normalize, resolve as resolve6, sep } from "path";
+import { extname as extname2, join as join8, normalize, resolve as resolve6, sep } from "path";
 
 // ../../apps/gateway/src/crypto/errors.ts
 function contextLabel(context) {
@@ -22659,6 +22659,8 @@ var I18N_RESOURCES = {
         authKey: "Private Key",
         authAgent: "SSH Agent",
         authConfigRef: "SSH Config",
+        sshConfigRefPlaceholder: "Host alias, e.g. my-server",
+        sshConfigRefHint: "A Host alias from your ssh config, resolved via `ssh -G`. Not the path to the config file.",
         password: "Password",
         privateKey: "Private Key",
         privateKeyPlaceholder: "-----BEGIN OPENSSH PRIVATE KEY-----",
@@ -23382,12 +23384,45 @@ Time: {{time}}`,
           unknown: "Failed to load"
         },
         retry: "Retry (collapse then expand)",
+        menu: {
+          copyAbsolute: "Copy absolute path",
+          copyRelative: "Copy relative path",
+          sendToAgent: "Send to Agent",
+          expand: "Expand",
+          collapse: "Collapse",
+          upload: "Upload files here",
+          open: "Open"
+        },
+        copied: "Copied to clipboard",
+        copyFailed: "Copy failed",
+        sendToAgent: {
+          prompt: "Please work with this path: `{{path}}`"
+        },
+        upload: {
+          uploading: "Uploading {{name}}\u2026",
+          success: "Uploaded {{name}}",
+          fail: "Failed to upload {{name}}"
+        },
+        transfer: {
+          legUserToTmex: "Browser \u2192 tmex",
+          legTmexToServer: "tmex \u2192 Server",
+          legServerToTmex: "Server \u2192 tmex",
+          legTmexToUser: "tmex \u2192 Browser",
+          cancel: "Cancel",
+          canceled: "Canceled {{name}}",
+          downloaded: "Downloaded {{name}}",
+          downloadFailed: "Failed to download {{name}}",
+          dragDownloadStarted: "Started downloading {{name}} (handled by browser)",
+          tooLarge: "{{name}} exceeds the size limit ({{max}})"
+        },
+        agentLaunch: {
+          connectFailed: "Failed to connect to the device",
+          windowFailed: "Failed to create a window"
+        },
         install: {
           button: "Install rsync",
           scopeLocal: "server",
           scopeRemote: "remote",
-          connectFailed: "Failed to connect to the device",
-          windowFailed: "Failed to create a window",
           prompt: "rsync is not installed on {{device}} ({{scope}}). Please install rsync using the appropriate command for this system (e.g. `brew install rsync`, `sudo apt-get install -y rsync`, or `sudo yum install -y rsync`), then reply once it is done."
         }
       },
@@ -23487,6 +23522,8 @@ Time: {{time}}`,
         authKey: "\u79C1\u94A5",
         authAgent: "SSH Agent",
         authConfigRef: "SSH Config",
+        sshConfigRefPlaceholder: "Host \u522B\u540D\uFF0C\u5982 my-server",
+        sshConfigRefHint: "\u586B ssh config \u91CC\u7684 Host \u522B\u540D\uFF0C\u7ECF `ssh -G` \u89E3\u6790\uFF1B\u4E0D\u662F config \u6587\u4EF6\u8DEF\u5F84\u3002",
         password: "\u5BC6\u7801",
         privateKey: "\u79C1\u94A5",
         privateKeyPlaceholder: "-----BEGIN OPENSSH PRIVATE KEY-----",
@@ -24210,12 +24247,45 @@ Bot\uFF1A{{botName}}
           unknown: "\u52A0\u8F7D\u5931\u8D25"
         },
         retry: "\u91CD\u8BD5\uFF08\u6536\u8D77\u540E\u518D\u5C55\u5F00\uFF09",
+        menu: {
+          copyAbsolute: "\u590D\u5236\u7EDD\u5BF9\u4F4D\u7F6E",
+          copyRelative: "\u590D\u5236\u76F8\u5BF9\u4F4D\u7F6E",
+          sendToAgent: "\u53D1\u9001\u5230 Agent",
+          expand: "\u5C55\u5F00",
+          collapse: "\u6536\u8D77",
+          upload: "\u4E0A\u4F20\u6587\u4EF6\u5230\u8FD9\u4E2A\u6587\u4EF6\u5939",
+          open: "\u6253\u5F00"
+        },
+        copied: "\u5DF2\u590D\u5236\u5230\u526A\u8D34\u677F",
+        copyFailed: "\u590D\u5236\u5931\u8D25",
+        sendToAgent: {
+          prompt: "\u8BF7\u5904\u7406\u8FD9\u4E2A\u8DEF\u5F84\uFF1A`{{path}}`"
+        },
+        upload: {
+          uploading: "\u6B63\u5728\u4E0A\u4F20 {{name}}\u2026",
+          success: "\u5DF2\u4E0A\u4F20 {{name}}",
+          fail: "\u4E0A\u4F20 {{name}} \u5931\u8D25"
+        },
+        transfer: {
+          legUserToTmex: "\u7528\u6237 \u2192 tmex",
+          legTmexToServer: "tmex \u2192 \u670D\u52A1\u5668",
+          legServerToTmex: "\u670D\u52A1\u5668 \u2192 tmex",
+          legTmexToUser: "tmex \u2192 \u7528\u6237",
+          cancel: "\u53D6\u6D88",
+          canceled: "\u5DF2\u53D6\u6D88 {{name}}",
+          downloaded: "\u5DF2\u4E0B\u8F7D {{name}}",
+          downloadFailed: "\u4E0B\u8F7D {{name}} \u5931\u8D25",
+          dragDownloadStarted: "\u5DF2\u5F00\u59CB\u4E0B\u8F7D {{name}}\uFF08\u7531\u6D4F\u89C8\u5668\u63A5\u7BA1\uFF09",
+          tooLarge: "{{name}} \u8D85\u8FC7\u5927\u5C0F\u4E0A\u9650\uFF08{{max}}\uFF09"
+        },
+        agentLaunch: {
+          connectFailed: "\u8FDE\u63A5\u8BBE\u5907\u5931\u8D25",
+          windowFailed: "\u521B\u5EFA\u7A97\u53E3\u5931\u8D25"
+        },
         install: {
           button: "\u5B89\u88C5 rsync",
           scopeLocal: "\u670D\u52A1\u5668",
           scopeRemote: "\u8FDC\u7A0B",
-          connectFailed: "\u8FDE\u63A5\u8BBE\u5907\u5931\u8D25",
-          windowFailed: "\u521B\u5EFA\u7A97\u53E3\u5931\u8D25",
           prompt: "\u8BBE\u5907 {{device}}\uFF08{{scope}}\uFF09\u4E0A\u672A\u68C0\u6D4B\u5230 rsync\u3002\u8BF7\u6839\u636E\u7CFB\u7EDF\u9009\u62E9\u5408\u9002\u7684\u547D\u4EE4\u5B89\u88C5 rsync\uFF08\u4F8B\u5982 `brew install rsync`\u3001`sudo apt-get install -y rsync` \u6216 `sudo yum install -y rsync`\uFF09\uFF0C\u5B89\u88C5\u5B8C\u6210\u540E\u56DE\u590D\u6211\u3002"
         }
       },
@@ -24315,6 +24385,8 @@ Bot\uFF1A{{botName}}
         authKey: "\u79D8\u5BC6\u9375",
         authAgent: "SSH Agent",
         authConfigRef: "SSH Config",
+        sshConfigRefPlaceholder: "Host \u30A8\u30A4\u30EA\u30A2\u30B9\uFF08\u4F8B: my-server\uFF09",
+        sshConfigRefHint: "ssh config \u306E Host \u30A8\u30A4\u30EA\u30A2\u30B9\u3092\u5165\u529B\u3057\u307E\u3059\u3002`ssh -G` \u3067\u89E3\u6C7A\u3055\u308C\u307E\u3059\u3002config \u30D5\u30A1\u30A4\u30EB\u306E\u30D1\u30B9\u3067\u306F\u3042\u308A\u307E\u305B\u3093\u3002",
         password: "\u30D1\u30B9\u30EF\u30FC\u30C9",
         privateKey: "\u79D8\u5BC6\u9375",
         privateKeyPlaceholder: "-----BEGIN OPENSSH PRIVATE KEY-----",
@@ -25038,12 +25110,45 @@ Bot\uFF1A{{botName}}
           unknown: "\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557\u3057\u307E\u3057\u305F"
         },
         retry: "\u518D\u8A66\u884C\uFF08\u6298\u308A\u305F\u305F\u3093\u3067\u518D\u5C55\u958B\uFF09",
+        menu: {
+          copyAbsolute: "\u7D76\u5BFE\u30D1\u30B9\u3092\u30B3\u30D4\u30FC",
+          copyRelative: "\u76F8\u5BFE\u30D1\u30B9\u3092\u30B3\u30D4\u30FC",
+          sendToAgent: "Agent \u306B\u9001\u308B",
+          expand: "\u5C55\u958B",
+          collapse: "\u6298\u308A\u305F\u305F\u3080",
+          upload: "\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u306B\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9",
+          open: "\u958B\u304F"
+        },
+        copied: "\u30AF\u30EA\u30C3\u30D7\u30DC\u30FC\u30C9\u306B\u30B3\u30D4\u30FC\u3057\u307E\u3057\u305F",
+        copyFailed: "\u30B3\u30D4\u30FC\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
+        sendToAgent: {
+          prompt: "\u3053\u306E\u30D1\u30B9\u3092\u51E6\u7406\u3057\u3066\u304F\u3060\u3055\u3044\uFF1A`{{path}}`"
+        },
+        upload: {
+          uploading: "{{name}} \u3092\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u4E2D\u2026",
+          success: "{{name}} \u3092\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u3057\u307E\u3057\u305F",
+          fail: "{{name}} \u306E\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u306B\u5931\u6557\u3057\u307E\u3057\u305F"
+        },
+        transfer: {
+          legUserToTmex: "\u30D6\u30E9\u30A6\u30B6 \u2192 tmex",
+          legTmexToServer: "tmex \u2192 \u30B5\u30FC\u30D0\u30FC",
+          legServerToTmex: "\u30B5\u30FC\u30D0\u30FC \u2192 tmex",
+          legTmexToUser: "tmex \u2192 \u30D6\u30E9\u30A6\u30B6",
+          cancel: "\u30AD\u30E3\u30F3\u30BB\u30EB",
+          canceled: "{{name}} \u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F",
+          downloaded: "{{name}} \u3092\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3057\u307E\u3057\u305F",
+          downloadFailed: "{{name}} \u306E\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
+          dragDownloadStarted: "{{name}} \u306E\u30C0\u30A6\u30F3\u30ED\u30FC\u30C9\u3092\u958B\u59CB\uFF08\u30D6\u30E9\u30A6\u30B6\u304C\u51E6\u7406\uFF09",
+          tooLarge: "{{name}} \u306F\u30B5\u30A4\u30BA\u4E0A\u9650\uFF08{{max}}\uFF09\u3092\u8D85\u3048\u3066\u3044\u307E\u3059"
+        },
+        agentLaunch: {
+          connectFailed: "\u30C7\u30D0\u30A4\u30B9\u3078\u306E\u63A5\u7D9A\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
+          windowFailed: "\u30A6\u30A3\u30F3\u30C9\u30A6\u306E\u4F5C\u6210\u306B\u5931\u6557\u3057\u307E\u3057\u305F"
+        },
         install: {
           button: "rsync \u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB",
           scopeLocal: "\u30B5\u30FC\u30D0\u30FC",
           scopeRemote: "\u30EA\u30E2\u30FC\u30C8",
-          connectFailed: "\u30C7\u30D0\u30A4\u30B9\u3078\u306E\u63A5\u7D9A\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
-          windowFailed: "\u30A6\u30A3\u30F3\u30C9\u30A6\u306E\u4F5C\u6210\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
           prompt: "{{device}}\uFF08{{scope}}\uFF09\u306B rsync \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u30B7\u30B9\u30C6\u30E0\u306B\u5408\u308F\u305B\u305F\u65B9\u6CD5\u3067 rsync \u3092\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u3057\uFF08\u4F8B: `brew install rsync`\u3001`sudo apt-get install -y rsync`\u3001`sudo yum install -y rsync`\uFF09\u3001\u5B8C\u4E86\u3057\u305F\u3089\u8FD4\u4FE1\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
         }
       },
@@ -27583,6 +27688,7 @@ var config = {
   baseUrl: getEnv("TMEX_BASE_URL", "http://127.0.0.1:8085"),
   siteNameDefault: getEnv("TMEX_SITE_NAME", "tmex"),
   databaseUrl: getEnv("DATABASE_URL", "./tmex.db"),
+  transferMaxBytes: Number.parseInt(getEnv("TMEX_TRANSFER_MAX_BYTES", "2147483648"), 10),
   bellThrottleSecondsDefault: Number.parseInt(getEnv("TMEX_BELL_THROTTLE_SECONDS", "6"), 10),
   notificationThrottleSecondsDefault: Number.parseInt(getEnv("TMEX_NOTIFICATION_THROTTLE_SECONDS", "3"), 10),
   tmuxAllowPassthrough: getBooleanEnv("TMEX_TMUX_ALLOW_PASSTHROUGH", false),
@@ -86753,9 +86859,6 @@ function normalizeHttpUrl(input) {
     return null;
   }
 }
-function encodePercentForTelegramUrl(url2) {
-  return url2.replace(/%/g, "%25");
-}
 
 class EventNotifier {
   webhooks = [];
@@ -86899,8 +87002,7 @@ class EventNotifier {
     lines.push(...this.buildPaneMetaLines(event));
     const paneUrl = normalizeHttpUrl(buildPaneUrl(event));
     if (paneUrl) {
-      const tgSafePaneUrl = encodePercentForTelegramUrl(paneUrl);
-      lines.push("", `<a href="${escapeTelegramHtmlAttribute(tgSafePaneUrl)}">${escapeTelegramHtmlText(t2("notification.telegramBell.viewLink"))}</a>`);
+      lines.push("", `<a href="${escapeTelegramHtmlAttribute(paneUrl)}">${escapeTelegramHtmlText(t2("notification.telegramBell.viewLink"))}</a>`);
     }
     return lines.join(`
 `);
@@ -86920,8 +87022,7 @@ class EventNotifier {
     const topbarLabel = this.buildTerminalTopbarLabel(event);
     const footer = `from ${event.site.name}: ${topbarLabel}`;
     if (paneUrl) {
-      const tgSafePaneUrl = encodePercentForTelegramUrl(paneUrl);
-      lines.push("", `<a href="${escapeTelegramHtmlAttribute(tgSafePaneUrl)}">${escapeTelegramHtmlText(footer)}</a>`);
+      lines.push("", `<a href="${escapeTelegramHtmlAttribute(paneUrl)}">${escapeTelegramHtmlText(footer)}</a>`);
     } else {
       lines.push("", escapeTelegramHtmlText(footer));
     }
@@ -86961,8 +87062,7 @@ class EventNotifier {
     }
     const paneUrl = normalizeHttpUrl(buildPaneUrl(event));
     if (paneUrl) {
-      const tgSafePaneUrl = encodePercentForTelegramUrl(paneUrl);
-      lines.push("", `<a href="${escapeTelegramHtmlAttribute(tgSafePaneUrl)}">${esc2(t2("notification.directLink"))}</a>`);
+      lines.push("", `<a href="${escapeTelegramHtmlAttribute(paneUrl)}">${esc2(t2("notification.directLink"))}</a>`);
     }
     return lines.join(`
 `);
@@ -95883,10 +95983,12 @@ class ConnectionAlertNotifier {
     const classified = classifySshError(errObj);
     const friendlyMessage = t2(classified.messageKey, { ...classified.messageParams });
     const rawMessage = errObj.message;
+    const persistedMessage = rawMessage && !friendlyMessage.includes(rawMessage) ? `${friendlyMessage}
+${rawMessage}` : friendlyMessage;
     console.error(`[conn-alert] device ${device.id} (${device.name}) source=${source} type=${classified.type}: ${rawMessage}`);
     if (persist) {
       try {
-        this.persister(device.id, friendlyMessage, classified.type);
+        this.persister(device.id, persistedMessage, classified.type);
       } catch (dbErr) {
         console.error("[conn-alert] failed to persist runtime status:", dbErr);
       }
@@ -98251,7 +98353,7 @@ function resolveSshConfigRef(device, deps) {
   return parseSshConfigOutput(result.stdout, deps.env);
 }
 function resolveImplicitIdentityFilesForAgentAuth(device, host, port, username, deps) {
-  if (device.authMode !== "agent" || device.sshConfigRef?.trim()) {
+  if (device.authMode !== "agent") {
     return [];
   }
   const target = username ? `${username}@${host}` : host;
@@ -98273,7 +98375,7 @@ async function resolveSshConnectConfig(device, decrypt2, inputDeps = {}) {
     readTextFile: inputDeps.readTextFile ?? ((path) => readFileSync2(path, "utf8"))
   };
   const sshEnv = toSshAuthEnv(deps.env);
-  const resolvedConfig = resolveSshConfigRef(device, deps);
+  const resolvedConfig = device.authMode === "configRef" ? resolveSshConfigRef(device, deps) : null;
   const host = resolvedConfig?.host ?? device.host;
   const port = resolvedConfig?.port ?? device.port ?? 22;
   const username = resolvedConfig?.username ?? resolveSshUsername(device.username, device.authMode, sshEnv);
@@ -102871,7 +102973,7 @@ function deleteFileRoot(id) {
 }
 
 // ../../apps/gateway/src/files/device-storage.ts
-import { mkdtempSync as mkdtempSync2, readFileSync as readFileSync3, realpathSync, rmSync as rmSync2 } from "fs";
+import { mkdtempSync as mkdtempSync2, readFileSync as readFileSync3, realpathSync, rmSync as rmSync2, statSync } from "fs";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join5 } from "path";
 
@@ -103106,6 +103208,18 @@ function enqueueDeviceJob(deviceId, job) {
 }
 
 // ../../apps/gateway/src/files/rsync.ts
+var PROGRESS_RE = /^\s*([\d,]+)\s+(\d+)%\s+([\d.]+[KMGT]?B\/s)/;
+function parseRsyncProgress(line) {
+  const m = PROGRESS_RE.exec(line);
+  if (!m)
+    return null;
+  const transferred = Number.parseInt(m[1].replace(/,/g, ""), 10);
+  const pct = Number.parseInt(m[2], 10);
+  if (Number.isNaN(transferred) || Number.isNaN(pct))
+    return null;
+  return { transferred, pct, rate: m[3] };
+}
+
 class RsyncMissingLocalError extends Error {
   constructor(message) {
     super(message);
@@ -103127,8 +103241,36 @@ function baseSubprocessEnv() {
   out.LC_ALL = "C";
   return out;
 }
+async function readStdoutWithProgress(stream, onProgress, resetIdle) {
+  const reader = stream.getReader();
+  const decoder4 = new TextDecoder;
+  let full = "";
+  let buf = "";
+  for (;; ) {
+    const { done, value } = await reader.read();
+    if (done)
+      break;
+    resetIdle();
+    const text3 = decoder4.decode(value, { stream: true });
+    full += text3;
+    buf += text3;
+    const parts = buf.split(/[\r\n]/);
+    buf = parts.pop() ?? "";
+    for (const line of parts) {
+      const p = parseRsyncProgress(line);
+      if (p)
+        onProgress(p);
+    }
+  }
+  const tail = parseRsyncProgress(buf);
+  if (tail)
+    onProgress(tail);
+  return full;
+}
 async function runRsync(argv, opts = {}) {
+  const streaming = typeof opts.onProgress === "function";
   const timeoutMs = opts.timeoutMs ?? 20000;
+  const idleTimeoutMs = opts.idleTimeoutMs ?? 120000;
   let proc;
   try {
     proc = Bun.spawn(["rsync", ...argv], {
@@ -103141,21 +103283,36 @@ async function runRsync(argv, opts = {}) {
     throw new RsyncMissingLocalError(error51 instanceof Error ? error51.message : String(error51));
   }
   let timedOut = false;
-  const killTimer = setTimeout(() => {
-    timedOut = true;
-    try {
-      proc.kill();
-    } catch {}
-  }, timeoutMs);
-  const onAbort = () => {
+  const killProc = () => {
     try {
       proc.kill();
     } catch {}
   };
+  let killTimer;
+  const armFixed = () => {
+    killTimer = setTimeout(() => {
+      timedOut = true;
+      killProc();
+    }, timeoutMs);
+  };
+  const resetIdle = () => {
+    if (killTimer)
+      clearTimeout(killTimer);
+    killTimer = setTimeout(() => {
+      timedOut = true;
+      killProc();
+    }, idleTimeoutMs);
+  };
+  if (streaming)
+    resetIdle();
+  else
+    armFixed();
+  const onAbort = () => killProc();
   opts.signal?.addEventListener("abort", onAbort, { once: true });
   try {
+    const stdoutPromise = streaming ? readStdoutWithProgress(proc.stdout, opts.onProgress, resetIdle) : new Response(proc.stdout).text();
     const [stdout, stderr, exitCode] = await Promise.all([
-      new Response(proc.stdout).text(),
+      stdoutPromise,
       new Response(proc.stderr).text(),
       proc.exited
     ]);
@@ -103165,7 +103322,8 @@ async function runRsync(argv, opts = {}) {
     }
     return { stdout, stderr, exitCode };
   } finally {
-    clearTimeout(killTimer);
+    if (killTimer)
+      clearTimeout(killTimer);
     opts.signal?.removeEventListener("abort", onAbort);
   }
 }
@@ -103347,17 +103505,25 @@ function rsyncListArgs(spec, remotePath) {
   return args;
 }
 function rsyncCopyArgs(spec, remotePath, dest) {
-  const args = ["-L"];
+  const args = ["-L", "--progress"];
   if (spec.rsh)
     args.push("-e", spec.rsh);
   args.push(rsyncTargetArg(spec, remotePath), dest);
   return args;
 }
+function rsyncUploadArgs(spec, localSource, remoteDest) {
+  const args = ["--progress"];
+  if (spec.rsh)
+    args.push("-e", spec.rsh);
+  args.push(localSource, rsyncTargetArg(spec, remoteDest));
+  return args;
+}
 
 // ../../apps/gateway/src/files/device-storage.ts
 var RAW_MAX_BYTES = 50 * 1024 * 1024;
 var LIST_TIMEOUT_MS = 20000;
 var COPY_TIMEOUT_MS = 60000;
+var TRANSFER_IDLE_TIMEOUT_MS = 120000;
 function ok(data) {
   return { ok: true, data };
 }
@@ -103667,8 +103833,241 @@ async function readRawFile(rootId, inputPath) {
     }
   });
 }
+function sanitizeUploadName(raw) {
+  const base = raw.split("/").pop() ?? "";
+  if (base === "" || base === "." || base === "..")
+    return null;
+  if (base.includes("/") || base.includes("\\") || base.includes("\x00"))
+    return null;
+  return base;
+}
+async function pushFileToDevice(rootId, destDir, srcPath, name24, opts = {}) {
+  const safeName = sanitizeUploadName(name24);
+  if (!safeName)
+    return fail("invalid");
+  const r = resolveContext(rootId);
+  if (!r.ok)
+    return fail(r.code);
+  const { root, device } = r.ctx;
+  const norm = checkAndNormalize(device, root.path, destDir);
+  if (!norm.ok)
+    return fail(norm.code);
+  return enqueueDeviceJob(device.id, async () => {
+    let spec;
+    try {
+      spec = await buildRsyncDeviceSpec(device);
+    } catch (error51) {
+      if (error51 instanceof RsyncAuthError)
+        return fail(error51.code, error51.message);
+      throw error51;
+    }
+    try {
+      const destStat = await statViaRsync(spec, norm.path);
+      if (!destStat.ok)
+        return destStat;
+      if (destStat.data.type !== "dir")
+        return fail("not_a_directory");
+      const remoteDest = posixJoin(norm.path, safeName);
+      let res;
+      try {
+        res = await runRsync(rsyncUploadArgs(spec, srcPath, remoteDest), {
+          env: spec.env,
+          onProgress: opts.onProgress,
+          idleTimeoutMs: TRANSFER_IDLE_TIMEOUT_MS,
+          signal: opts.signal
+        });
+      } catch (error51) {
+        if (error51 instanceof RsyncMissingLocalError)
+          return fail("rsync_missing_local");
+        throw error51;
+      }
+      if (res.exitCode !== 0)
+        return fail(classifyRsyncFailure(res.exitCode, res.stderr), res.stderr);
+      return ok({ uploaded: safeName });
+    } finally {
+      spec.cleanup();
+    }
+  });
+}
+async function pullFileFromDevice(rootId, inputPath, opts = {}) {
+  const r = resolveContext(rootId);
+  if (!r.ok)
+    return fail(r.code);
+  const { root, device } = r.ctx;
+  const norm = checkAndNormalize(device, root.path, inputPath);
+  if (!norm.ok)
+    return fail(norm.code);
+  return enqueueDeviceJob(device.id, async () => {
+    let spec;
+    try {
+      spec = await buildRsyncDeviceSpec(device);
+    } catch (error51) {
+      if (error51 instanceof RsyncAuthError)
+        return fail(error51.code, error51.message);
+      throw error51;
+    }
+    try {
+      const st = await statViaRsync(spec, norm.path);
+      if (!st.ok)
+        return st;
+      if (st.data.type === "dir")
+        return fail("is_directory");
+      if (st.data.size != null && st.data.size > config.transferMaxBytes)
+        return fail("too_large");
+      const dir2 = mkdtempSync2(join5(tmpdir2(), "tmex-dl-"));
+      const dest = join5(dir2, "f");
+      const cleanup = () => {
+        try {
+          rmSync2(dir2, { recursive: true, force: true });
+        } catch {}
+      };
+      let res;
+      try {
+        res = await runRsync(rsyncCopyArgs(spec, norm.path, dest), {
+          env: spec.env,
+          onProgress: opts.onProgress,
+          idleTimeoutMs: TRANSFER_IDLE_TIMEOUT_MS,
+          signal: opts.signal
+        });
+      } catch (error51) {
+        cleanup();
+        if (error51 instanceof RsyncMissingLocalError)
+          return fail("rsync_missing_local");
+        throw error51;
+      }
+      if (res.exitCode !== 0) {
+        cleanup();
+        return fail(classifyRsyncFailure(res.exitCode, res.stderr), res.stderr);
+      }
+      const name24 = posixBasename(norm.path);
+      let size = st.data.size ?? 0;
+      try {
+        size = statSync(dest).size;
+      } catch {}
+      if (size > config.transferMaxBytes) {
+        cleanup();
+        return fail("too_large");
+      }
+      return ok({ tmpPath: dest, size, name: name24, mime: mimeOf(name24), cleanup });
+    } finally {
+      spec.cleanup();
+    }
+  });
+}
+
+// ../../apps/gateway/src/files/transfer-session.ts
+import { appendFileSync, mkdtempSync as mkdtempSync3, readdirSync, rmSync as rmSync3, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
+import { tmpdir as tmpdir3 } from "os";
+import { join as join6 } from "path";
+var sessions = new Map;
+var SESSION_TTL_MS = 30 * 60000;
+var downloads = new Map;
+function sweepStale(now2) {
+  for (const [id, s] of sessions) {
+    if (!s.committing && now2 - s.createdAt > SESSION_TTL_MS) {
+      removeUploadSession(id);
+    }
+  }
+  for (const [id, d] of downloads) {
+    if (now2 - d.createdAt > SESSION_TTL_MS) {
+      removeDownloadSession(id);
+    }
+  }
+}
+function createDownloadSession(data) {
+  sweepStale(Date.now());
+  const session = { id: crypto.randomUUID(), createdAt: Date.now(), ...data };
+  downloads.set(session.id, session);
+  return session;
+}
+function getDownloadSession(id) {
+  return downloads.get(id);
+}
+function removeDownloadSession(id) {
+  const d = downloads.get(id);
+  if (!d)
+    return;
+  downloads.delete(id);
+  try {
+    d.cleanup();
+  } catch {}
+}
+function createUploadSession(args) {
+  const now2 = Date.now();
+  sweepStale(now2);
+  const tmpDir = mkdtempSync3(join6(tmpdir3(), "tmex-up-"));
+  const tmpPath = join6(tmpDir, "f");
+  writeFileSync2(tmpPath, new Uint8Array(0));
+  const session = {
+    id: crypto.randomUUID(),
+    rootId: args.rootId,
+    destDir: args.destDir,
+    name: args.name,
+    size: args.size,
+    received: 0,
+    tmpDir,
+    tmpPath,
+    abort: new AbortController,
+    createdAt: now2,
+    committing: false
+  };
+  sessions.set(session.id, session);
+  return session;
+}
+function getUploadSession(id) {
+  return sessions.get(id);
+}
+function appendUploadChunk(id, offset, bytes) {
+  const s = sessions.get(id);
+  if (!s)
+    return { ok: false, reason: "not_found" };
+  if (offset !== s.received)
+    return { ok: false, reason: "bad_offset" };
+  if (s.received + bytes.byteLength > s.size)
+    return { ok: false, reason: "too_large" };
+  appendFileSync(s.tmpPath, bytes);
+  s.received += bytes.byteLength;
+  return { ok: true, received: s.received };
+}
+function removeUploadSession(id) {
+  const s = sessions.get(id);
+  if (!s)
+    return;
+  sessions.delete(id);
+  try {
+    s.abort.abort();
+  } catch {}
+  try {
+    rmSync3(s.tmpDir, { recursive: true, force: true });
+  } catch {}
+}
+var transferGcTimer = setInterval(() => sweepStale(Date.now()), 5 * 60000);
+transferGcTimer.unref?.();
+var ORPHAN_PREFIXES = ["tmex-up-", "tmex-dl-"];
+var ORPHAN_MAX_AGE_MS = 60 * 60000;
+function sweepOrphanTransferTemps() {
+  const base = tmpdir3();
+  let entries;
+  try {
+    entries = readdirSync(base);
+  } catch {
+    return;
+  }
+  const now2 = Date.now();
+  for (const name24 of entries) {
+    if (!ORPHAN_PREFIXES.some((p) => name24.startsWith(p)))
+      continue;
+    const full = join6(base, name24);
+    try {
+      if (now2 - statSync2(full).mtimeMs > ORPHAN_MAX_AGE_MS) {
+        rmSync3(full, { recursive: true, force: true });
+      }
+    } catch {}
+  }
+}
 
 // ../../apps/gateway/src/api/files.ts
+var UPLOAD_CHUNK_SIZE = 8 * 1024 * 1024;
 function json4(data, status = 200, headers = {}) {
   return new Response(JSON.stringify(data), {
     status,
@@ -103832,6 +104231,223 @@ async function handleRaw(url2) {
   }
   return new Response(result.data.data, { status: 200, headers });
 }
+async function handleUploadInit(req) {
+  let body;
+  try {
+    body = await req.json();
+  } catch {
+    return json4({ error: t2("apiError.invalidRequest") }, 400);
+  }
+  const rootId = typeof body.rootId === "string" ? body.rootId : "";
+  const destDir = typeof body.path === "string" ? body.path : "";
+  const rawName = typeof body.name === "string" ? body.name : "";
+  const size = typeof body.size === "number" && Number.isFinite(body.size) ? body.size : -1;
+  if (!rootId || !destDir || !rawName || size < 0) {
+    return json4({ error: t2("apiError.invalidRequest") }, 400);
+  }
+  const name24 = sanitizeUploadName(rawName);
+  if (!name24)
+    return codeError("invalid");
+  if (size > config.transferMaxBytes)
+    return codeError("too_large");
+  const stat = await statFile(rootId, destDir);
+  if (!stat.ok)
+    return codeError(stat.code, stat.detail);
+  if (stat.data.type !== "dir")
+    return codeError("not_a_directory");
+  const session = createUploadSession({ rootId, destDir, name: name24, size });
+  return json4({ uploadId: session.id, chunkSize: UPLOAD_CHUNK_SIZE });
+}
+async function handleUploadChunk(req, id, url2) {
+  const offset = Number.parseInt(url2.searchParams.get("offset") ?? "", 10);
+  if (Number.isNaN(offset) || offset < 0)
+    return json4({ error: t2("apiError.invalidRequest") }, 400);
+  const bytes = new Uint8Array(await req.arrayBuffer());
+  const res = appendUploadChunk(id, offset, bytes);
+  if (!res.ok) {
+    if (res.reason === "not_found")
+      return codeError("not_found");
+    if (res.reason === "too_large")
+      return codeError("too_large");
+    return json4({ error: t2("apiError.invalidRequest") }, 409);
+  }
+  return json4({ received: res.received });
+}
+function handleUploadCommit(id) {
+  const session = getUploadSession(id);
+  if (!session)
+    return codeError("not_found");
+  if (session.received !== session.size)
+    return codeError("invalid", "incomplete upload");
+  session.committing = true;
+  const encoder3 = new TextEncoder;
+  const stream = new ReadableStream({
+    start(controller) {
+      const emit = (obj) => {
+        try {
+          controller.enqueue(encoder3.encode(`${JSON.stringify(obj)}
+`));
+        } catch {}
+      };
+      pushFileToDevice(session.rootId, session.destDir, session.tmpPath, session.name, {
+        signal: session.abort.signal,
+        onProgress: (p) => emit({ type: "progress", ...p })
+      }).then((res) => {
+        if (res.ok)
+          emit({ type: "done", uploaded: res.data.uploaded });
+        else
+          emit({ type: "error", code: res.code, detail: res.detail });
+      }).catch((e) => emit({ type: "error", code: "unknown", detail: String(e) })).finally(() => {
+        try {
+          controller.close();
+        } catch {}
+        removeUploadSession(id);
+      });
+    },
+    cancel() {
+      removeUploadSession(id);
+    }
+  });
+  return new Response(stream, {
+    status: 200,
+    headers: { "Content-Type": "application/x-ndjson; charset=utf-8", "Cache-Control": "no-store" }
+  });
+}
+function handleUploadCancel(id) {
+  removeUploadSession(id);
+  return json4({ success: true });
+}
+function attachmentHeaders(name24, mime, size) {
+  const encoded = encodeURIComponent(name24);
+  const ascii = name24.replace(/["\\\r\n]/g, "_");
+  return {
+    "Content-Type": mime ?? "application/octet-stream",
+    "Content-Length": String(size),
+    "Content-Disposition": `attachment; filename="${ascii}"; filename*=UTF-8''${encoded}`,
+    "Cache-Control": "no-store"
+  };
+}
+function streamTempFile(tmpPath, cleanupAfter) {
+  let reader;
+  try {
+    reader = Bun.file(tmpPath).stream().getReader();
+  } catch {
+    cleanupAfter();
+    return null;
+  }
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        const { done, value } = await reader.read();
+        if (done) {
+          controller.close();
+          cleanupAfter();
+          return;
+        }
+        controller.enqueue(value);
+      } catch (e) {
+        controller.error(e);
+        cleanupAfter();
+      }
+    },
+    cancel() {
+      reader.cancel();
+      cleanupAfter();
+    }
+  });
+}
+function handleDownloadPrepare(req) {
+  let abort = null;
+  const encoder3 = new TextEncoder;
+  const stream = new ReadableStream({
+    async start(controller) {
+      const emit = (obj) => {
+        try {
+          controller.enqueue(encoder3.encode(`${JSON.stringify(obj)}
+`));
+        } catch {}
+      };
+      const close = () => {
+        try {
+          controller.close();
+        } catch {}
+      };
+      let body;
+      try {
+        body = await req.json();
+      } catch {
+        emit({ type: "error", code: "invalid" });
+        close();
+        return;
+      }
+      const rootId = typeof body.rootId === "string" ? body.rootId : "";
+      const path = typeof body.path === "string" ? body.path : "";
+      if (!rootId || !path) {
+        emit({ type: "error", code: "invalid" });
+        close();
+        return;
+      }
+      abort = new AbortController;
+      const result = await pullFileFromDevice(rootId, path, {
+        signal: abort.signal,
+        onProgress: (p) => emit({ type: "progress", ...p })
+      });
+      if (result.ok) {
+        const s = createDownloadSession({
+          tmpPath: result.data.tmpPath,
+          size: result.data.size,
+          name: result.data.name,
+          mime: result.data.mime,
+          cleanup: result.data.cleanup
+        });
+        emit({ type: "done", downloadId: s.id, size: s.size, name: s.name });
+      } else {
+        emit({ type: "error", code: result.code, detail: result.detail });
+      }
+      close();
+    },
+    cancel() {
+      abort?.abort();
+    }
+  });
+  return new Response(stream, {
+    status: 200,
+    headers: { "Content-Type": "application/x-ndjson; charset=utf-8", "Cache-Control": "no-store" }
+  });
+}
+function handleDownloadContent(id) {
+  const session = getDownloadSession(id);
+  if (!session)
+    return codeError("not_found");
+  const body = streamTempFile(session.tmpPath, () => removeDownloadSession(id));
+  if (!body)
+    return codeError("unknown");
+  return new Response(body, {
+    status: 200,
+    headers: attachmentHeaders(session.name, session.mime, session.size)
+  });
+}
+function handleDownloadCancel(id) {
+  removeDownloadSession(id);
+  return json4({ success: true });
+}
+async function handleDownload(req, url2) {
+  const rootId = url2.searchParams.get("rootId");
+  const path = url2.searchParams.get("path");
+  if (!rootId || !path)
+    return json4({ error: t2("apiError.invalidRequest") }, 400);
+  const result = await pullFileFromDevice(rootId, path, {
+    signal: req.signal,
+    onProgress: () => {}
+  });
+  if (!result.ok)
+    return codeError(result.code, result.detail);
+  const { tmpPath, size, name: name24, mime, cleanup } = result.data;
+  const body = streamTempFile(tmpPath, cleanup);
+  if (!body)
+    return codeError("unknown");
+  return new Response(body, { status: 200, headers: attachmentHeaders(name24, mime, size) });
+}
 function handleFilesApiRequest(req, path) {
   const url2 = new URL(req.url);
   if (path === "/api/files/roots" && req.method === "GET")
@@ -103852,6 +104468,32 @@ function handleFilesApiRequest(req, path) {
     return handleStat(url2);
   if (path === "/api/files/raw" && req.method === "GET")
     return handleRaw(url2);
+  if (path === "/api/files/download" && req.method === "GET")
+    return handleDownload(req, url2);
+  if (path === "/api/files/download/prepare" && req.method === "POST") {
+    return handleDownloadPrepare(req);
+  }
+  const dlContentMatch = path.match(/^\/api\/files\/download\/([^/]+)\/content$/);
+  if (dlContentMatch && req.method === "GET") {
+    return handleDownloadContent(decodeURIComponent(dlContentMatch[1]));
+  }
+  const dlCancelMatch = path.match(/^\/api\/files\/download\/([^/]+)$/);
+  if (dlCancelMatch && req.method === "DELETE") {
+    return handleDownloadCancel(decodeURIComponent(dlCancelMatch[1]));
+  }
+  if (path === "/api/files/upload/init" && req.method === "POST")
+    return handleUploadInit(req);
+  const commitMatch = path.match(/^\/api\/files\/upload\/([^/]+)\/commit$/);
+  if (commitMatch && req.method === "POST") {
+    return handleUploadCommit(decodeURIComponent(commitMatch[1]));
+  }
+  const uploadMatch = path.match(/^\/api\/files\/upload\/([^/]+)$/);
+  if (uploadMatch && req.method === "PUT") {
+    return handleUploadChunk(req, decodeURIComponent(uploadMatch[1]), url2);
+  }
+  if (uploadMatch && req.method === "DELETE") {
+    return handleUploadCancel(decodeURIComponent(uploadMatch[1]));
+  }
   return;
 }
 
@@ -104208,8 +104850,8 @@ function getBaseVersion() {
   if (cachedBase !== undefined)
     return cachedBase;
   let base = null;
-  if ("0.11.0") {
-    base = "0.11.0";
+  if ("0.12.0") {
+    base = "0.12.0";
   }
   if (!base && config.isProd) {
     base = readInstallMeta()?.cliVersion ?? null;
@@ -104300,8 +104942,8 @@ async function fetchChangelog(version3) {
 import { spawn } from "child_process";
 import { closeSync, existsSync as existsSync6, openSync } from "fs";
 import { mkdtemp, rm, writeFile } from "fs/promises";
-import { tmpdir as tmpdir3 } from "os";
-import { join as join6 } from "path";
+import { tmpdir as tmpdir4 } from "os";
+import { join as join7 } from "path";
 class UpgradeController {
   state = "idle";
   targetVersion = null;
@@ -104337,12 +104979,12 @@ class UpgradeController {
       if (!installDir) {
         throw new Error("install directory could not be resolved");
       }
-      stageDir = await mkdtemp(join6(tmpdir3(), "tmex-upg-"));
-      cacheDir = await mkdtemp(join6(tmpdir3(), "tmex-upg-cache-"));
-      await writeFile(join6(stageDir, "package.json"), `${JSON.stringify({ name: "tmex-upgrade-stage", private: true })}
+      stageDir = await mkdtemp(join7(tmpdir4(), "tmex-upg-"));
+      cacheDir = await mkdtemp(join7(tmpdir4(), "tmex-upg-cache-"));
+      await writeFile(join7(stageDir, "package.json"), `${JSON.stringify({ name: "tmex-upgrade-stage", private: true })}
 `);
       await this.runBunAdd(stageDir, cacheDir, version3);
-      const binPath = join6(stageDir, "node_modules", "tmex-cli", "bin", "tmex.js");
+      const binPath = join7(stageDir, "node_modules", "tmex-cli", "bin", "tmex.js");
       if (!existsSync6(binPath)) {
         throw new Error(`downloaded tmex-cli binary not found at ${binPath}`);
       }
@@ -104377,7 +105019,7 @@ class UpgradeController {
   spawnUpgrade(binPath, installDir, version3) {
     let logFd = null;
     try {
-      logFd = openSync(join6(installDir, "upgrade.log"), "a");
+      logFd = openSync(join7(installDir, "upgrade.log"), "a");
     } catch {
       logFd = null;
     }
@@ -104413,7 +105055,8 @@ function getSystemInfo() {
     installedViaCli: install.installedViaCli,
     deployment: install.deployment,
     canSelfUpdate,
-    serviceName: install.serviceName
+    serviceName: install.serviceName,
+    transferMaxBytes: config.transferMaxBytes
   };
 }
 
@@ -107949,6 +108592,7 @@ async function createGatewayRuntime(options = {}) {
   }
   runtimeController.reset();
   primeLocalShellPath();
+  sweepOrphanTransferTemps();
   const wsServer = new WebSocketServer;
   connectionAlertNotifier.setBroadcaster((deviceId, payload) => {
     wsServer.broadcastDeviceError(deviceId, payload);
@@ -108274,7 +108918,7 @@ async function serveFrontend(req, staticRoot) {
   if (!existsSync8(requestedPath) && extname2(url2.pathname) !== "") {
     return new Response(t3("runtime.notFound"), { status: 404 });
   }
-  const indexPath = join7(staticRoot, "index.html");
+  const indexPath = join8(staticRoot, "index.html");
   const targetPath = existsSync8(requestedPath) ? requestedPath : indexPath;
   if (!existsSync8(targetPath)) {
     return new Response(t3("runtime.frontendMissing"), { status: 500 });