@vm0/cli 9.132.11 → 9.135.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "9.132.11",
+  "version": "9.135.0",
   "description": "CLI application",
   "repository": {
     "type": "git",

package/zero.js

@@ -11,6 +11,7 @@ import {
   Option,
   allowsCustomModel,
   completeSlackFileUpload,
+  completeTelegramFileUpload,
   configureGlobalProxyFromEnv,
   connectorTypeSchema,
   createSkill,
@@ -30,6 +31,7 @@ import {
   deployZeroSchedule,
   disableZeroSchedule,
   downloadSlackFile,
+  downloadTelegramFile,
   downloadWebFile,
   enableZeroSchedule,
   extractSecretNamesFromApis,
@@ -58,6 +60,7 @@ import {
   hasAuthMethods,
   hasModelSelection,
   initSlackFileUpload,
+  initTelegramFileUpload,
   inviteZeroOrgMember,
   isInteractive,
   isUUID,
@@ -112,7 +115,7 @@ import {
   upsertZeroOrgModelProvider,
   withErrorHandler,
   zeroAgentCustomSkillNameSchema
-} from "./chunk-S72CJD3V.js";
+} from "./chunk-7C3QXZRH.js";
 import {
   __toESM,
   init_esm_shims
@@ -13922,7 +13925,7 @@ var FEATURE_SWITCHES = {
   },
   ["auditLink" /* AuditLink */]: {
     maintainer: "ethan@vm0.ai",
-    description: "Show audit log links in Slack messages",
+    description: "Show audit log links in integration replies",
     enabled: false
   },
   ["audioInput" /* AudioInput */]: {
@@ -13950,6 +13953,12 @@ var FEATURE_SWITCHES = {
     description: "Replace the Invite people button in the agent chat page header with a New button that creates a new chat thread",
     enabled: false
   },
+  ["chatArtifactsDrawer" /* ChatArtifactsDrawer */]: {
+    maintainer: "ethan@vm0.ai",
+    description: "Show an artifacts button in the chat header that opens a drawer listing uploaded files grouped by run",
+    enabled: false,
+    enabledOrgIdHashes: STAFF_ORG_ID_HASHES
+  },
   ["chatThreadReadIndicator" /* ChatThreadReadIndicator */]: {
     maintainer: "ethan@vm0.ai",
     description: "Show the unread watermark dot and bold title for chat threads with unread messages in the sidebar",
@@ -16729,6 +16738,165 @@ Examples:
   Download a file:       zero slack download-file <file-id> -o /tmp/out.png`
 );
 
+// src/commands/zero/telegram/index.ts
+init_esm_shims();
+
+// src/commands/zero/telegram/download-file.ts
+init_esm_shims();
+import { join as join2 } from "path";
+import { tmpdir as tmpdir2 } from "os";
+function defaultOutPath2(fileId) {
+  return join2(tmpdir2(), `telegram-${fileId}`);
+}
+var downloadFileCommand2 = new Command().name("download-file").description("Download a Telegram file by id using the bot token").argument("<file-id>", "Telegram file id from a [Telegram file] block").option(
+  "-o, --out <path>",
+  "Output path for the downloaded file (default: /tmp/telegram-<file-id>)"
+).requiredOption(
+  "--bot-id <bot-id>",
+  "Telegram bot id from the [Telegram file] block"
+).addHelpText(
+  "after",
+  `
+Examples:
+  Download to default temp path: zero telegram download-file AgACAgUAAxkBAA --bot-id 123456789
+  Download to explicit path:     zero telegram download-file AgACAgUAAxkBAA --bot-id 123456789 -o /tmp/photo.jpg
+
+Output:
+  Prints a JSON object to stdout on success:
+    {"path":"/tmp/telegram-AgACAgUAAxkBAA","mimetype":"image/jpeg","size":12345}
+
+How to read the downloaded file:
+  - Images (png/jpg/gif/webp/svg): open the file path with your image viewing tool
+  - Videos (mp4/mov/webm): extract frames first with
+      ffmpeg -i <path> -vf "fps=1" -q:v 2 /tmp/<file-id>_frame_%03d.jpg
+    then view the extracted frames
+  - PDF/text/csv/json/markdown: read the file directly
+
+Notes:
+  - Uses the Telegram bot token on the server side
+  - Streams the file bytes directly to disk`
+).action(
+  withErrorHandler(
+    async (fileId, options) => {
+      const outPath = options.out ?? defaultOutPath2(fileId);
+      const result = await downloadTelegramFile(
+        fileId,
+        options.botId,
+        outPath
+      );
+      console.log(JSON.stringify(result));
+    }
+  )
+);
+
+// src/commands/zero/telegram/upload-file.ts
+init_esm_shims();
+import { readFileSync as readFileSync7, statSync as statSync2 } from "fs";
+import { basename as basename2, extname } from "path";
+var MIME_BY_EXTENSION = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".mp4": "video/mp4",
+  ".webm": "video/webm",
+  ".mov": "video/quicktime",
+  ".pdf": "application/pdf",
+  ".txt": "text/plain",
+  ".csv": "text/csv",
+  ".md": "text/markdown",
+  ".json": "application/json"
+};
+function inferContentType(localPath) {
+  const ext = extname(localPath).toLowerCase();
+  return MIME_BY_EXTENSION[ext] ?? "application/octet-stream";
+}
+function parseMessageThreadId(value) {
+  if (!value) return void 0;
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+    throw new Error("message-thread-id must be a positive integer");
+  }
+  return parsed;
+}
+var uploadFileCommand2 = new Command().name("upload-file").description("Upload a local file to a Telegram chat as the bot").requiredOption("-f, --file <path>", "Local file path to upload").requiredOption("--bot-id <bot-id>", "Telegram bot id to send through").requiredOption("-c, --chat-id <chat-id>", "Telegram chat id or @channel").option("--caption <text>", "Caption to accompany the file").option("--message-thread-id <id>", "Forum topic message thread id").option("--content-type <mime>", "Override inferred content type").addHelpText(
+  "after",
+  `
+Examples:
+  Upload a file:          zero telegram upload-file -f /tmp/report.pdf --bot-id 123456789 -c -1001234567890
+  Upload to a topic:      zero telegram upload-file -f /tmp/log.txt --bot-id 123456789 -c -1001234567890 --message-thread-id 42
+  With a caption:         zero telegram upload-file -f /tmp/data.csv --bot-id 123456789 -c @channel --caption "Daily report"
+
+Output:
+  Prints a JSON object to stdout on success:
+    {"messageId":123,"chatId":"-1001234567890","fileId":"...","filename":"report.pdf","mimetype":"application/pdf","size":12345,"url":"https://..."}
+
+Notes:
+  - Uses the Telegram bot token on the server side
+  - Uploads through VM0 storage first, then asks Telegram to fetch the file URL
+  - VM0 does not apply file type or size restrictions before calling Telegram`
+).action(
+  withErrorHandler(
+    async (options) => {
+      let fileSize;
+      try {
+        const stat = statSync2(options.file);
+        if (!stat.isFile()) {
+          throw new Error(`Not a regular file: ${options.file}`);
+        }
+        fileSize = stat.size;
+      } catch (error) {
+        if (error instanceof Error && error.message.startsWith("Not ")) {
+          throw error;
+        }
+        throw new Error(`File not found: ${options.file}`);
+      }
+      if (fileSize === 0) {
+        throw new Error("File is empty");
+      }
+      const filename = basename2(options.file);
+      const contentType = options.contentType ?? inferContentType(options.file);
+      const messageThreadId = parseMessageThreadId(options.messageThreadId);
+      const prepared = await initTelegramFileUpload({
+        filename,
+        contentType,
+        length: fileSize
+      });
+      const fileContent = readFileSync7(options.file);
+      const uploadResponse = await fetch(prepared.uploadUrl, {
+        method: "PUT",
+        headers: { "Content-Type": prepared.contentType },
+        body: new Uint8Array(fileContent)
+      });
+      if (!uploadResponse.ok) {
+        throw new Error(
+          `File upload failed: ${uploadResponse.status} ${uploadResponse.statusText}`
+        );
+      }
+      const result = await completeTelegramFileUpload({
+        uploadId: prepared.uploadId,
+        botId: options.botId,
+        chatId: options.chatId,
+        contentType: prepared.contentType,
+        caption: options.caption,
+        messageThreadId
+      });
+      console.log(JSON.stringify(result));
+    }
+  )
+);
+
+// src/commands/zero/telegram/index.ts
+var zeroTelegramCommand = new Command().name("telegram").description("Upload and download files from Telegram as the bot").addCommand(downloadFileCommand2).addCommand(uploadFileCommand2).addHelpText(
+  "after",
+  `
+Examples:
+  Upload a file:    zero telegram upload-file -f /tmp/report.pdf --bot-id <bot-id> -c <chat-id>
+  Download a file:  zero telegram download-file <file-id> --bot-id <bot-id> -o /tmp/out.jpg`
+);
+
 // src/commands/zero/variable/index.ts
 init_esm_shims();
 
@@ -16976,8 +17144,8 @@ init_esm_shims();
 
 // src/lib/skill-directory.ts
 init_esm_shims();
-import { readFileSync as readFileSync7, readdirSync } from "fs";
-import { join as join2 } from "path";
+import { readFileSync as readFileSync8, readdirSync } from "fs";
+import { join as join3 } from "path";
 var IGNORED_NAMES = /* @__PURE__ */ new Set(["node_modules", ".git", ".DS_Store"]);
 function readSkillDirectory(dirPath) {
   const files = [];
@@ -16987,11 +17155,11 @@ function readSkillDirectory(dirPath) {
       if (entry.name.startsWith(".") || IGNORED_NAMES.has(entry.name)) continue;
       const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
       if (entry.isDirectory()) {
-        walk(join2(dir, entry.name), relPath);
+        walk(join3(dir, entry.name), relPath);
       } else {
         files.push({
           path: relPath,
-          content: readFileSync7(join2(dir, entry.name), "utf-8")
+          content: readFileSync8(join3(dir, entry.name), "utf-8")
         });
       }
     }
@@ -17753,12 +17921,12 @@ init_esm_shims();
 import { execFile } from "child_process";
 import { readFile, unlink } from "fs/promises";
 import { randomUUID } from "crypto";
-import { join as join3 } from "path";
-import { tmpdir as tmpdir2 } from "os";
+import { join as join4 } from "path";
+import { tmpdir as tmpdir3 } from "os";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
 async function captureScreenshot() {
-  const tmpPath = join3(tmpdir2(), `vm0-screenshot-${randomUUID()}.jpg`);
+  const tmpPath = join4(tmpdir3(), `vm0-screenshot-${randomUUID()}.jpg`);
   try {
     await execFileAsync("screencapture", ["-x", "-t", "jpg", tmpPath]);
     const info = await getScreenInfo();
@@ -17787,7 +17955,7 @@ async function captureScreenshot() {
   }
 }
 async function captureRegionScreenshot(region) {
-  const tmpPath = join3(tmpdir2(), `vm0-zoom-${randomUUID()}.jpg`);
+  const tmpPath = join4(tmpdir3(), `vm0-zoom-${randomUUID()}.jpg`);
   try {
     const regionArg = `${region.x},${region.y},${region.width},${region.height}`;
     await execFileAsync("screencapture", [
@@ -18479,7 +18647,7 @@ var hostStopCommand = new Command().name("stop").description("Stop and unregiste
 // src/commands/zero/computer-use/client.ts
 init_esm_shims();
 import { writeFile, mkdir } from "fs/promises";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 
 // src/lib/computer-use/client.ts
 init_esm_shims();
@@ -18547,7 +18715,7 @@ var clientScreenshotCommand = new Command().name("screenshot").description("Capt
     const dir = "/tmp/computer-use";
     await mkdir(dir, { recursive: true });
     const timestamp = Date.now();
-    const filePath = join4(dir, `screenshot-${timestamp}.${data.format}`);
+    const filePath = join5(dir, `screenshot-${timestamp}.${data.format}`);
     const buffer = Buffer.from(data.image, "base64");
     await writeFile(filePath, buffer);
     process.stdout.write(`${filePath}
@@ -18575,7 +18743,7 @@ var clientZoomCommand = new Command().name("zoom").description("Capture a region
       const dir = "/tmp/computer-use";
       await mkdir(dir, { recursive: true });
       const timestamp = Date.now();
-      const filePath = join4(dir, `zoom-${timestamp}.${data.format}`);
+      const filePath = join5(dir, `zoom-${timestamp}.${data.format}`);
       const buffer = Buffer.from(data.image, "base64");
       await writeFile(filePath, buffer);
       process.stdout.write(`${filePath}
@@ -18772,12 +18940,12 @@ init_esm_shims();
 
 // src/commands/zero/web/download-file.ts
 init_esm_shims();
-import { join as join5 } from "path";
-import { tmpdir as tmpdir3 } from "os";
-function defaultOutPath2(fileId) {
-  return join5(tmpdir3(), `web-${fileId}`);
+import { join as join6 } from "path";
+import { tmpdir as tmpdir4 } from "os";
+function defaultOutPath3(fileId) {
+  return join6(tmpdir4(), `web-${fileId}`);
 }
-var downloadFileCommand2 = new Command().name("download-file").description("Download a web-uploaded file by id").argument("<file-id>", "File id (UUID returned by the upload API)").option(
+var downloadFileCommand3 = new Command().name("download-file").description("Download a web-uploaded file by id").argument("<file-id>", "File id (UUID returned by the upload API)").option(
   "-o, --out <path>",
   "Output path for the downloaded file (default: /tmp/web-<file-id>)"
 ).addHelpText(
@@ -18803,7 +18971,7 @@ Notes:
   - Streams the file bytes directly to disk`
 ).action(
   withErrorHandler(async (fileId, options) => {
-    const outPath = options.out ?? defaultOutPath2(fileId);
+    const outPath = options.out ?? defaultOutPath3(fileId);
     const result = await downloadWebFile(fileId, outPath);
     console.log(JSON.stringify(result));
   })
@@ -18811,7 +18979,7 @@ Notes:
 
 // src/commands/zero/web/upload-file.ts
 init_esm_shims();
-var uploadFileCommand2 = new Command().name("upload-file").description("Upload a local file and print a permanent URL").requiredOption("-f, --file <path>", "Local file path to upload").option("--content-type <mime>", "Override inferred content type").addHelpText(
+var uploadFileCommand3 = new Command().name("upload-file").description("Upload a local file and print a permanent URL").requiredOption("-f, --file <path>", "Local file path to upload").option("--content-type <mime>", "Override inferred content type").addHelpText(
   "after",
   `
 Examples:
@@ -18827,7 +18995,7 @@ Notes:
   - Returned URL is permanent (serves a short-lived signed redirect on access)
   - Safe to persist in chat messages or share over external channels
   - Max file size: 1 GB
-  - Allowed types: png / jpeg / gif / webp / svg / mp4 / webm / mov / pdf / txt / csv / md / json`
+  - Allowed types: png / jpeg / gif / webp / svg / mp4 / webm / mov / pdf / txt / csv / md / html / json`
 ).action(
   withErrorHandler(
     async (options) => {
@@ -18840,7 +19008,7 @@ Notes:
 );
 
 // src/commands/zero/web/index.ts
-var zeroWebCommand = new Command().name("web").description("Upload and download files via the web chat endpoint").addCommand(downloadFileCommand2).addCommand(uploadFileCommand2).addHelpText(
+var zeroWebCommand = new Command().name("web").description("Upload and download files via the web chat endpoint").addCommand(downloadFileCommand3).addCommand(uploadFileCommand3).addHelpText(
   "after",
   `
 Examples:
@@ -18860,6 +19028,7 @@ var COMMAND_CAPABILITY_MAP = {
   search: "chat-message:read",
   chat: "chat-message:write",
   slack: "slack:write",
+  telegram: ["telegram:read", "telegram:write"],
   whoami: null,
   "developer-support": null,
   "computer-use": "computer-use:write",
@@ -18876,6 +19045,7 @@ var DEFAULT_COMMANDS = [
   zeroSecretCommand,
   zeroChatCommand,
   zeroSlackCommand,
+  zeroTelegramCommand,
   zeroVariableCommand,
   zeroLogsCommand,
   zeroSearchCommand,
@@ -18889,7 +19059,13 @@ function shouldHideCommand(name, payload) {
   if (!payload) return false;
   const requiredCap = COMMAND_CAPABILITY_MAP[name];
   if (requiredCap === void 0) return true;
-  return requiredCap !== null && !payload.capabilities.includes(requiredCap);
+  if (requiredCap === null) return false;
+  if (typeof requiredCap !== "string") {
+    return !requiredCap.some((capability) => {
+      return payload.capabilities.includes(capability);
+    });
+  }
+  return !payload.capabilities.includes(requiredCap);
 }
 function registerZeroCommands(prog, commands) {
   const token = process.env.ZERO_TOKEN;
@@ -18902,12 +19078,14 @@ function registerZeroCommands(prog, commands) {
 var program = new Command();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.132.11").addHelpText(
+).version("9.135.0").addHelpText(
   "after",
   `
 Examples:
   Check a connector?     zero doctor check-connector --env-name <ENV_NAME>
   Send a Slack message?  zero slack message send --help
+  Upload Telegram?       zero telegram upload-file --help
+  Download Telegram?     zero telegram download-file --help
   Set up a schedule?     zero schedule setup --help
   Update yourself?       zero agent --help
   Manage custom skills?  zero skill --help