openmates 0.16.0-alpha.7 → 0.16.0-alpha.9

package/dist/{chunk-Y2VI2HJI.js → chunk-QLNFHEEW.js}

@@ -45200,7 +45200,7 @@ var audioGenerateProductSuccessChimeChat = {
       content: "example_chats.audio_generate_product_success_chime.message_2",
       created_at: 1786382154,
       user_message_id: "0fe80324-42f5-4b87-9e11-0b0d8f36c9d5",
-      response_credits: 17,
+      response_credits: 31,
       category: "general_knowledge",
       model_name: "Gemini 3.5 Flash-Lite"
     }
@@ -45234,6 +45234,23 @@ var audioGenerateProductSuccessChimeChat = {
       created_at: 1786382147,
       updated_at: 1786382147,
       tool_inference_iterations: 1
+    },
+    {
+      id: "example-audio-generate-product-success-chime-usage-2",
+      type: "skill_execution",
+      source: "chat",
+      app_id: "audio",
+      skill_id: "generate",
+      model_used: "elevenlabs/eleven_text_to_sound_v2",
+      credits: 14,
+      server_provider: "ElevenLabs",
+      server_region: "US",
+      chat_id: "example-audio-generate-product-success-chime",
+      message_id: "0fe80324-42f5-4b87-9e11-0b0d8f36c9d5",
+      created_at: 1786382144,
+      updated_at: 1786382144,
+      tool_inference_iterations: 0,
+      code_run_duration_seconds: 0.679
     }
   ],
   metadata: {
@@ -45266,7 +45283,7 @@ var audioSpeakFriendlyWelcomeMessageChat = {
       content: "example_chats.audio_speak_friendly_welcome_message.message_2",
       created_at: 1786382255,
       user_message_id: "b39cb42f-ec3e-45ec-9339-801b54c7cb03",
-      response_credits: 18,
+      response_credits: 28,
       category: "onboarding_support",
       model_name: "Gemini 3.5 Flash-Lite"
     }
@@ -45300,6 +45317,23 @@ var audioSpeakFriendlyWelcomeMessageChat = {
       created_at: 1786382249,
       updated_at: 1786382249,
       tool_inference_iterations: 1
+    },
+    {
+      id: "example-audio-speak-friendly-welcome-message-usage-2",
+      type: "skill_execution",
+      source: "chat",
+      app_id: "audio",
+      skill_id: "speak",
+      model_used: "elevenlabs/eleven_flash_v2_5",
+      credits: 10,
+      server_provider: "ElevenLabs",
+      server_region: "US",
+      chat_id: "example-audio-speak-friendly-welcome-message",
+      message_id: "b39cb42f-ec3e-45ec-9339-801b54c7cb03",
+      created_at: 1786382246,
+      updated_at: 1786382246,
+      tool_inference_iterations: 0,
+      code_run_duration_seconds: 4.968
     }
   ],
   metadata: {
@@ -45417,6 +45451,420 @@ var ALL_EXAMPLE_CHATS = [
   audioSpeakFriendlyWelcomeMessageChat
 ].sort((a, b) => a.metadata.order - b.metadata.order);
 
+// ../ui/src/demo_chats/exampleChatFiles.ts
+var FILE_LIKE_TYPES = /* @__PURE__ */ new Set([
+  "audio",
+  "audio-recording",
+  "code",
+  "code-code",
+  "design",
+  "diagram",
+  "docs",
+  "docs-doc",
+  "document",
+  "image",
+  "images-image",
+  "mind-map",
+  "mind_map",
+  "model3d",
+  "music",
+  "notebook",
+  "pcb_schematic",
+  "pdf",
+  "recording",
+  "remotion-video",
+  "sheet",
+  "sheets",
+  "sheets-sheet",
+  "spreadsheet",
+  "svg",
+  "video"
+]);
+var URL_FIELDS = [
+  "downloadUrl",
+  "download_url",
+  "file_url",
+  "previewAudioUrl",
+  "preview_audio_url",
+  "previewImageUrl",
+  "preview_image_url",
+  "previewVideoUrl",
+  "preview_video_url",
+  "src",
+  "url",
+  "video_url"
+];
+var AUDIO_URL_FIELDS = [
+  "downloadUrl",
+  "download_url",
+  "file_url",
+  "previewAudioUrl",
+  "preview_audio_url",
+  "src",
+  "url"
+];
+var VIDEO_URL_FIELDS = [
+  "downloadUrl",
+  "download_url",
+  "file_url",
+  "previewVideoUrl",
+  "preview_video_url",
+  "video_url",
+  "src",
+  "url",
+  "previewImageUrl",
+  "preview_image_url"
+];
+var IMAGE_URL_FIELDS = [
+  "downloadUrl",
+  "download_url",
+  "file_url",
+  "previewImageUrl",
+  "preview_image_url",
+  "src",
+  "url"
+];
+var FILENAME_FIELDS = [
+  "filename",
+  "file_name",
+  "file_path",
+  "original_filename"
+];
+var MIME_EXTENSION = {
+  "application/pdf": "pdf",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+  "audio/mpeg": "mp3",
+  "audio/wav": "wav",
+  "image/jpeg": "jpg",
+  "image/png": "png",
+  "image/svg+xml": "svg",
+  "image/webp": "webp",
+  "model/gltf-binary": "glb",
+  "text/html": "html",
+  "text/markdown": "md",
+  "text/plain": "txt",
+  "video/mp4": "mp4"
+};
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeEmbedId(embedId) {
+  return embedId.startsWith("embed:") ? embedId.slice("embed:".length) : embedId;
+}
+function cleanString(value) {
+  if (typeof value !== "string") return "";
+  const trimmed = stripQuotes(value.trim());
+  if (!trimmed || trimmed === "null" || trimmed === "undefined") return "";
+  return trimmed;
+}
+function stripQuotes(value) {
+  const first = value[0];
+  if ((first === '"' || first === "'") && value.endsWith(first)) {
+    return value.slice(1, -1).replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\'/g, "'");
+  }
+  return value;
+}
+function numberValue2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value !== "string" || value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function parseFlatToonFields(content) {
+  const fields = {};
+  for (const line of content.split("\n")) {
+    if (!line || /^\s/.test(line)) continue;
+    const separatorIndex = line.indexOf(":");
+    if (separatorIndex <= 0) continue;
+    const key = line.slice(0, separatorIndex).trim();
+    const value = line.slice(separatorIndex + 1).trim();
+    if (!key || value === "") continue;
+    fields[key] = stripQuotes(value);
+  }
+  return fields;
+}
+function decodeEmbedContent(content) {
+  if (isRecord2(content)) return { ...content };
+  if (typeof content !== "string" || !content.trim()) return {};
+  const trimmed = content.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      return isRecord2(parsed) ? parsed : {};
+    } catch {
+      return parseFlatToonFields(content);
+    }
+  }
+  return parseFlatToonFields(content);
+}
+function stringField2(record, keys) {
+  for (const key of keys) {
+    const value = cleanString(record[key]);
+    if (value) return value;
+  }
+  return "";
+}
+function basenameFromUrl(url) {
+  if (url.startsWith("data:")) return "";
+  const withoutQuery = url.split(/[?#]/)[0] || "";
+  return withoutQuery.split("/").pop()?.replace(/[^a-zA-Z0-9._-]/g, "_") ?? "";
+}
+function extensionFromUrl(url) {
+  const basename4 = basenameFromUrl(url);
+  const dotIndex = basename4.lastIndexOf(".");
+  return dotIndex > 0 ? basename4.slice(dotIndex + 1).toLowerCase() : "";
+}
+function extensionFromLanguage(language) {
+  const normalized = language.toLowerCase();
+  const map = {
+    bash: "sh",
+    css: "css",
+    dockerfile: "Dockerfile",
+    html: "html",
+    javascript: "js",
+    json: "json",
+    markdown: "md",
+    python: "py",
+    rust: "rs",
+    svelte: "svelte",
+    text: "txt",
+    typescript: "ts",
+    yaml: "yml"
+  };
+  return (map[normalized] ?? normalized.replace(/[^a-z0-9]/g, "")) || "txt";
+}
+function nestedFormatFromToon(content) {
+  if (typeof content !== "string") return "";
+  const match = content.match(/\n\s+format:\s*([^\n]+)/);
+  return cleanString(match?.[1]);
+}
+function urlForType(type, record) {
+  if (type.includes("video") || type === "remotion-video") return stringField2(record, VIDEO_URL_FIELDS);
+  if (type.includes("audio") || type === "music" || type === "recording") return stringField2(record, AUDIO_URL_FIELDS);
+  if (type.includes("image") || type === "svg") return stringField2(record, IMAGE_URL_FIELDS);
+  return stringField2(record, URL_FIELDS);
+}
+function inferFallbackExtension(type, record, content) {
+  const mimeType = stringField2(record, ["mime_type", "file_type", "mimeType"]);
+  if (mimeType && MIME_EXTENSION[mimeType]) return MIME_EXTENSION[mimeType];
+  const urlExtension = extensionFromUrl(urlForType(type, record));
+  if (urlExtension) return urlExtension;
+  const nestedFormat = nestedFormatFromToon(content);
+  if (nestedFormat) return nestedFormat;
+  if (type.includes("video")) return "mp4";
+  if (type.includes("audio") || type === "music" || type === "recording") return "mp3";
+  if (type.includes("image")) return "png";
+  if (type.includes("pdf")) return "pdf";
+  if (type.includes("doc") || type === "document") return "docx";
+  if (type.includes("sheet") || type === "spreadsheet") return "xlsx";
+  if (type === "model3d") return "glb";
+  if (type.includes("code") || type === "notebook" || type === "pcb_schematic") {
+    return extensionFromLanguage(stringField2(record, ["language"]));
+  }
+  return "txt";
+}
+function inferTitle(embedId, type, record, content) {
+  const url = urlForType(type, record);
+  const urlBasename = basenameFromUrl(url);
+  const filename = stringField2(record, FILENAME_FIELDS);
+  if ((type.includes("video") || type === "music" || type === "audio") && urlBasename) {
+    return urlBasename;
+  }
+  if (filename) return filename.replace(/[/\\]/g, "_");
+  if (urlBasename) return urlBasename;
+  const title = stringField2(record, ["title"]);
+  if (title) {
+    const extension2 = inferFallbackExtension(type, record, content);
+    return `${title.replace(/[^a-zA-Z0-9._ -]/g, "_").trim()}.${extension2}`;
+  }
+  const extension = inferFallbackExtension(type, record, content);
+  return `${type || "file"}-${embedId.slice(0, 8)}.${extension}`;
+}
+function inferNodeType(title, type) {
+  const lowerTitle = title.toLowerCase();
+  if (type.includes("pdf") || lowerTitle.endsWith(".pdf")) return "pdf";
+  if (type.includes("image") || /\.(png|jpe?g|gif|webp|svg|avif|heic|heif)$/.test(lowerTitle)) return "image";
+  if (type.includes("video") || /\.(mp4|mov|webm|m4v)$/.test(lowerTitle)) return "video";
+  if (type.includes("audio") || type === "music" || type === "recording" || /\.(mp3|wav|m4a|ogg|webm)$/.test(lowerTitle)) return "recording";
+  if (type.includes("sheet") || type === "spreadsheet" || /\.(csv|xlsx?|ods)$/.test(lowerTitle)) return "sheets-sheet";
+  if (type.includes("doc") || type === "document" || /\.(docx?|odt|rtf)$/.test(lowerTitle)) return "docs-doc";
+  if (type === "model3d" || /\.(glb|gltf|obj|stl)$/.test(lowerTitle)) return "model3d";
+  if (type.includes("code") || type === "notebook" || type === "pcb_schematic") return "code-code";
+  return "file";
+}
+function iconNameForNodeType(nodeType) {
+  if (nodeType === "pdf") return "pdf";
+  if (nodeType === "image") return "image";
+  if (nodeType === "video") return "video";
+  if (nodeType === "recording") return "audio";
+  if (nodeType === "sheets-sheet") return "sheets";
+  if (nodeType === "docs-doc") return "document";
+  if (nodeType === "code-code") return "coding";
+  if (nodeType === "model3d") return "3dmodels";
+  return "files";
+}
+function labelForNodeType(nodeType, type) {
+  if (nodeType === "pdf") return "PDF";
+  if (nodeType === "image") return "Image";
+  if (nodeType === "video") return "Video";
+  if (nodeType === "recording") return type === "music" ? "Music" : "Audio";
+  if (nodeType === "sheets-sheet") return "Sheet";
+  if (nodeType === "docs-doc") return "Document";
+  if (nodeType === "code-code") return type === "notebook" ? "Notebook" : "Code file";
+  if (nodeType === "model3d") return "3D model";
+  return "File";
+}
+function formatBytes(bytes) {
+  if (!bytes || bytes <= 0) return "";
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(bytes < 10 * 1024 ? 1 : 0)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(bytes < 10 * 1024 * 1024 ? 1 : 0)} MB`;
+}
+function plural(value, singular, pluralLabel = `${singular}s`) {
+  return `${value} ${value === 1 ? singular : pluralLabel}`;
+}
+function buildMetadata(nodeType, type, record) {
+  const parts = [labelForNodeType(nodeType, type)];
+  const lineCount = numberValue2(record.line_count ?? record.lineCount);
+  const pageCount = numberValue2(record.page_count ?? record.pageCount);
+  const wordCount = numberValue2(record.word_count ?? record.wordCount);
+  const duration = numberValue2(record.duration_seconds ?? record.durationSeconds);
+  const size = numberValue2(record.byte_length ?? record.size_bytes ?? record.sizeBytes);
+  if (lineCount) parts.push(plural(lineCount, "line"));
+  if (pageCount) parts.push(plural(pageCount, "page"));
+  if (wordCount) parts.push(plural(wordCount, "word"));
+  if (duration) parts.push(`${duration.toFixed(duration < 10 ? 1 : 0)}s`);
+  const sizeLabel = formatBytes(size);
+  if (sizeLabel) parts.push(sizeLabel);
+  return parts.join(" | ");
+}
+function isSupportedPublicUrl(url) {
+  return url.startsWith("/") || url.startsWith("data:") || /^https?:\/\//i.test(url);
+}
+function extractEmbedIdsFromContent(content) {
+  const decoded = decodeEmbedContent(content);
+  const rawIds = decoded.embed_ids ?? decoded.embedIds;
+  const ids = typeof rawIds === "string" ? rawIds.split(/[|,]/) : rawIds;
+  if (!Array.isArray(ids)) return [];
+  return ids.map((id) => cleanString(id)).filter(Boolean).map(normalizeEmbedId);
+}
+function buildEmbedLookup(embeds) {
+  const lookup = /* @__PURE__ */ new Map();
+  for (const embed of embeds) {
+    if (!embed.embed_id) continue;
+    lookup.set(normalizeEmbedId(embed.embed_id), embed);
+  }
+  return lookup;
+}
+function buildEmbedRefLookup(embeds) {
+  const lookup = /* @__PURE__ */ new Map();
+  for (const embed of embeds) {
+    const embedId = normalizeEmbedId(embed.embed_id);
+    lookup.set(embedId, embedId);
+    lookup.set(`embed:${embedId}`, embedId);
+    const decoded = decodeEmbedContent(embed.content);
+    const embedRef = stringField2(decoded, ["embed_ref", "embedRef"]);
+    if (embedRef) {
+      lookup.set(embedRef, embedId);
+      lookup.set(`embed:${embedRef}`, embedId);
+    }
+  }
+  return lookup;
+}
+function extractReferencedExampleEmbedIds(messages, embeds) {
+  const refLookup = buildEmbedRefLookup(embeds);
+  const ids = /* @__PURE__ */ new Set();
+  const jsonBlockRe = /```(?:json_embed|json)\s*([\s\S]*?)\s*```/g;
+  const inlineEmbedRe = /embed:([a-zA-Z0-9_.:-]+)/g;
+  for (const message of messages) {
+    const content = message.content ?? "";
+    for (const match of Array.from(content.matchAll(jsonBlockRe))) {
+      try {
+        const parsed = JSON.parse(match[1].trim());
+        const embedId = cleanString(parsed.embed_id ?? parsed.embedId);
+        const resolved = refLookup.get(embedId) ?? refLookup.get(`embed:${embedId}`) ?? embedId;
+        if (resolved) ids.add(normalizeEmbedId(resolved));
+      } catch {
+      }
+    }
+    for (const match of Array.from(content.matchAll(inlineEmbedRe))) {
+      const rawRef = match[1];
+      const resolved = refLookup.get(rawRef) ?? refLookup.get(`embed:${rawRef}`) ?? rawRef;
+      if (resolved) ids.add(normalizeEmbedId(resolved));
+    }
+  }
+  return Array.from(ids);
+}
+function expandEmbedIds(embedIds, embeds) {
+  const lookup = buildEmbedLookup(embeds);
+  const seen = /* @__PURE__ */ new Set();
+  const queue = [...embedIds.map(normalizeEmbedId)];
+  while (queue.length > 0) {
+    const embedId = queue.shift();
+    if (!embedId || seen.has(embedId)) continue;
+    seen.add(embedId);
+    const embed = lookup.get(embedId);
+    if (!embed) continue;
+    const childIds = [
+      ...embed.embed_ids ?? [],
+      ...extractEmbedIdsFromContent(embed.content)
+    ];
+    for (const childId of childIds) {
+      const normalizedChildId = normalizeEmbedId(childId);
+      if (normalizedChildId && !seen.has(normalizedChildId)) queue.push(normalizedChildId);
+    }
+  }
+  return Array.from(seen);
+}
+function getEmbedFileReferences(embed) {
+  const embedId = cleanString(embed.embed_id ?? embed.embedId ?? embed.id);
+  if (!embedId) return [];
+  const decoded = decodeEmbedContent(embed.content);
+  const type = (stringField2(decoded, ["type", "embed_type", "embedType"]) || cleanString(embed.type) || "file").toLowerCase();
+  if (!FILE_LIKE_TYPES.has(type)) return [];
+  const title = inferTitle(embedId, type, decoded, embed.content);
+  const nodeType = inferNodeType(title, type);
+  const url = urlForType(type, decoded);
+  const mimeType = stringField2(decoded, ["mime_type", "file_type", "mimeType"]);
+  const createdAt = numberValue2(embed.created_at ?? embed.createdAt) ?? 0;
+  return [{
+    embedId: normalizeEmbedId(embedId),
+    contentRef: `embed:${normalizeEmbedId(embedId)}`,
+    title,
+    subtitle: labelForNodeType(nodeType, type),
+    type,
+    nodeType,
+    iconName: iconNameForNodeType(nodeType),
+    createdAt,
+    updatedAt: createdAt,
+    metadata: buildMetadata(nodeType, type, decoded),
+    appId: stringField2(decoded, ["app_id", "appId"]) || cleanString(embed.app_id ?? embed.appId) || null,
+    skillId: stringField2(decoded, ["skill_id", "skillId"]) || cleanString(embed.skill_id ?? embed.skillId) || null,
+    url: url && isSupportedPublicUrl(url) ? url : null,
+    mimeType: mimeType || null
+  }];
+}
+function collectExampleChatFileReferences(embeds, messages = []) {
+  if (embeds.length === 0) return [];
+  const lookup = buildEmbedLookup(embeds);
+  const referencedIds = extractReferencedExampleEmbedIds(messages, embeds);
+  const candidateIds = referencedIds.length > 0 ? expandEmbedIds(referencedIds, embeds) : embeds.map((embed) => normalizeEmbedId(embed.embed_id));
+  const rows = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const embedId of candidateIds) {
+    const embed = lookup.get(embedId);
+    if (!embed) continue;
+    for (const row of getEmbedFileReferences(embed)) {
+      const key = `${row.embedId}:${row.title}`.toLowerCase();
+      if (seen.has(key)) continue;
+      rows.push(row);
+      seen.add(key);
+    }
+  }
+  return rows;
+}
+
 // ../ui/src/i18n/locales/en.json
 var en_default = {
   activity: {
@@ -66284,8 +66732,10 @@ function getExampleChatConversation(query) {
       category: message.category ?? chat.category,
       modelName: message.model_name ?? null,
       createdAt: message.created_at,
-      embedIds: []
+      embedIds: extractReferencedExampleEmbedIds([message], chat.embeds)
     })),
+    embeds: chat.embeds,
+    files: collectExampleChatFileReferences(chat.embeds, chat.messages),
     followUpSuggestions: chat.follow_up_suggestions.map(translate)
   };
 }
@@ -70178,7 +70628,7 @@ async function requestProjectRemoteOperation(options) {
     throw new ProjectRequesterError("source_offline", "The selected Project source is offline.");
   }
   const timeoutMs = options.timeoutMs ?? REMOTE_PROTOCOL_TIMEOUT_MS;
-  let sourceSessionId = stringField2(options.source, "source_session_id");
+  let sourceSessionId = stringField3(options.source, "source_session_id");
   let keyEpoch = numberField(options.source, "key_epoch");
   let routingIdentity = null;
   if (!sourceSessionId || !keyEpoch) {
@@ -70330,7 +70780,7 @@ function parseJsonObject(value) {
   }
   throw new ProjectRequesterError("invalid_remote_payload", "The Project source returned an invalid payload.");
 }
-function stringField2(value, key) {
+function stringField3(value, key) {
   return typeof value[key] === "string" && value[key] ? value[key] : null;
 }
 function numberField(value, key) {
@@ -71263,7 +71713,7 @@ function splitTaskAskInstruction(instruction) {
   const suffix = instruction.includes(":") ? instruction.split(":").slice(1).join(":") : instruction;
   return suffix.split(/[,;]\s*/).map((title) => title.trim()).filter(Boolean).map((title) => ({ title }));
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isPrivateCliOutputKey(key) {
@@ -71271,7 +71721,7 @@ function isPrivateCliOutputKey(key) {
 }
 function sanitizeWorkspaceAskOutput(value) {
   if (Array.isArray(value)) return value.map((item) => sanitizeWorkspaceAskOutput(item));
-  if (!isRecord2(value)) return value;
+  if (!isRecord3(value)) return value;
   const sanitized = {};
   for (const [key, nested] of Object.entries(value)) {
     if (isPrivateCliOutputKey(key)) continue;
@@ -71281,20 +71731,20 @@ function sanitizeWorkspaceAskOutput(value) {
 }
 async function prepareTaskAskOutput(result, masterKey) {
   const output = sanitizeWorkspaceAskOutput(result);
-  if (isRecord2(result.task)) {
+  if (isRecord3(result.task)) {
     output.task = taskToJson(await decryptUserTask(result.task, masterKey));
   }
-  if (Array.isArray(result.tasks) && result.tasks.every(isRecord2)) {
+  if (Array.isArray(result.tasks) && result.tasks.every(isRecord3)) {
     output.tasks = (await decryptUserTasks(result.tasks, masterKey)).map(taskToJson);
   }
   return output;
 }
 async function preparePlanAskOutput(result, masterKey) {
   const output = sanitizeWorkspaceAskOutput(result);
-  if (isRecord2(result.plan)) {
+  if (isRecord3(result.plan)) {
     output.plan = planToJson(await decryptUserPlan(result.plan, masterKey));
   }
-  if (Array.isArray(result.plans) && result.plans.every(isRecord2)) {
+  if (Array.isArray(result.plans) && result.plans.every(isRecord3)) {
     output.plans = (await decryptUserPlans(result.plans, masterKey)).map(planToJson);
   }
   return output;
@@ -73608,6 +74058,28 @@ async function handleChats(client, subcommand, rest, flags, redactor) {
     }
     return;
   }
+  if (subcommand === "files") {
+    const chatId = rest[0];
+    if (!chatId) {
+      throw new Error("Missing chat ID. Usage: openmates chats files <chat-id> [--json]");
+    }
+    const resolvedId = chatId.toLowerCase() === "last" ? "__last__" : chatId;
+    if (apiKey) {
+      throw new Error("Chat file listing through --api-key is not supported; use an authenticated CLI session so encrypted chat embeds can be decrypted locally.");
+    }
+    if (!client.hasSession()) {
+      const example = resolveExampleChatForOpen(resolvedId === "__last__" ? "1" : resolvedId);
+      if (!example) {
+        throw new Error(`Example chat '${chatId}' not found. Run 'openmates chats list' to see available examples.`);
+      }
+      printChatFiles(example.chat, example.files, flags, { example: true });
+      return;
+    }
+    const { chat, messages } = await client.getChatMessages(resolvedId, teamContext);
+    const result = await loadChatFileReferencesForCli(client, messages);
+    printChatFiles(chat, result.files, flags, { errors: result.errors });
+    return;
+  }
   if (subcommand === "messages") {
     const chatId = rest[0];
     if (!chatId) {
@@ -74584,6 +75056,113 @@ function resolveExampleChatForOpen(target) {
   }
   return getExampleChatConversation(target);
 }
+function collectMessageEmbedIdsForFiles(messages) {
+  const ids = /* @__PURE__ */ new Set();
+  const inlineEmbedRefRe = /embed:([a-zA-Z0-9_.:-]+)/g;
+  for (const message of messages) {
+    for (const embedId of message.embedIds ?? []) {
+      if (embedId) ids.add(embedId);
+    }
+    for (const match of Array.from((message.content ?? "").matchAll(inlineEmbedRefRe))) {
+      if (match[1]) ids.add(match[1]);
+    }
+    for (const segment of parseMessageSegments(message.content ?? "")) {
+      if (segment.type === "embed" && segment.value) ids.add(segment.value);
+    }
+  }
+  return Array.from(ids);
+}
+function fileReferenceKey(file) {
+  return `${file.embedId}:${file.title}`.toLowerCase();
+}
+function chatFileReferenceFromEmbed(embed) {
+  return getEmbedFileReferences({
+    embedId: embed.embedId,
+    type: embed.type,
+    content: embed.content,
+    appId: embed.appId,
+    skillId: embed.skillId,
+    createdAt: embed.createdAt
+  });
+}
+async function loadChatFileReferencesForCli(client, messages) {
+  const queue = collectMessageEmbedIdsForFiles(messages);
+  const visitedEmbeds = /* @__PURE__ */ new Set();
+  const seenFiles = /* @__PURE__ */ new Set();
+  const files = [];
+  const errors = [];
+  while (queue.length > 0) {
+    const embedId = queue.shift();
+    if (!embedId || visitedEmbeds.has(embedId)) continue;
+    visitedEmbeds.add(embedId);
+    try {
+      const embed = await client.getEmbed(embedId);
+      for (const file of chatFileReferenceFromEmbed(embed)) {
+        const key = fileReferenceKey(file);
+        if (seenFiles.has(key)) continue;
+        files.push(file);
+        seenFiles.add(key);
+      }
+      for (const childId of extractEmbedIdsFromContent(embed.content)) {
+        if (childId && !visitedEmbeds.has(childId)) queue.push(childId);
+      }
+    } catch (error) {
+      errors.push({
+        embed_id: embedId,
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return { files, errors };
+}
+function chatFileToJson(file) {
+  return {
+    embed_id: file.embedId,
+    content_ref: file.contentRef,
+    title: file.title,
+    type: file.type,
+    node_type: file.nodeType,
+    metadata: file.metadata,
+    app_id: file.appId,
+    skill_id: file.skillId,
+    url: file.url,
+    mime_type: file.mimeType
+  };
+}
+function printChatFiles(chat, files, flags, options = {}) {
+  if (flags.json === true) {
+    printJson2({
+      chat_id: chat.id,
+      title: chat.title,
+      source: options.example ? "example" : "chat",
+      count: files.length,
+      files: files.map(chatFileToJson),
+      errors: options.errors ?? []
+    });
+    return;
+  }
+  const title = chat.title ?? chat.shortId ?? chat.id;
+  header(`Files for ${title}`);
+  if (options.example) {
+    process.stdout.write("\x1B[2mPublic example chat files are resolved from bundled static embed metadata.\x1B[0m\n");
+  }
+  if (files.length === 0) {
+    process.stdout.write("\x1B[2mNo files found for this chat.\x1B[0m\n");
+  } else {
+    for (const file of files) {
+      const appSkill = [file.appId, file.skillId].filter(Boolean).join("/");
+      const suffix = appSkill ? `  \x1B[2m${appSkill}\x1B[0m` : "";
+      process.stdout.write(`  \x1B[1m${file.title}\x1B[0m  \x1B[2m${file.metadata}\x1B[0m${suffix}
+`);
+      process.stdout.write(`    \x1B[2m${file.contentRef}${file.url ? `  ${file.url}` : ""}\x1B[0m
+`);
+    }
+  }
+  for (const error of options.errors ?? []) {
+    process.stderr.write(`Warning: could not inspect embed ${error.embed_id}: ${error.message}
+`);
+  }
+}
 async function openUrl(url) {
   const { exec: exec2 } = await import("child_process");
   const platform4 = process.platform;
@@ -80618,6 +81197,7 @@ function printChatsHelp() {
   openmates chats list [--limit <n>] [--page <n>] [--json]
   openmates chats show <chat-id> [--raw] [--json] [--all]
   openmates chats messages <chat-id> [--json]
+  openmates chats files <chat-id> [--json]
   openmates chats <chat-id> add-to-project <project-id> [--folder <folder-id>] [--openmates-only|--repo-copy|--remote-cache-copy|--remote-copy] [--json]
   openmates chats <chat-id> remove-from-project <project-id> [--json]
   openmates chats fork <chat-id> --from-message <message-id> [--title <title>] [--json]
@@ -80645,6 +81225,11 @@ Options for 'show':
   --raw         Show raw decrypted message content without rendering embeds
                 or cleaning embed references. Useful for debugging.
 
+Options for 'files':
+  Lists uploaded and generated files connected to a saved or public example chat.
+  Saved chats require an authenticated CLI session so encrypted embeds can be
+  decrypted locally. Public examples also work while logged out.
+
 Options for 'fork', 'rewind', and 'retry':
   --from-message <id>  Message boundary for non-destructive fork.
   --to-message <id>    Message boundary to keep when rewinding.
@@ -80722,6 +81307,8 @@ Examples:
   openmates chats open gigantic-airplanes-transporting-rocket-parts
   openmates chats show d262cb68
   openmates chats messages d262cb68
+  openmates chats files d262cb68
+  openmates chats files example-audio-speak-friendly-welcome-message --json
   openmates chats fork d262cb68 --from-message 8f4e2a1c --title "Clean branch"
   openmates chats rewind d262cb68 --to-message 8f4e2a1c --send "Continue from here" --yes
   openmates chats retry d262cb68 --yes

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   requireExactConfirmation,
   resolveProjectContext,
   serializeToYaml
-} from "./chunk-Y2VI2HJI.js";
+} from "./chunk-QLNFHEEW.js";
 import "./chunk-IWKP55ZB.js";
 import "./chunk-MLWBMJEN.js";
 export {

package/dist/index.js

@@ -39,7 +39,7 @@ import {
   renderPlanList,
   renderSupportInfo,
   serializeToYaml
-} from "./chunk-Y2VI2HJI.js";
+} from "./chunk-QLNFHEEW.js";
 import "./chunk-IWKP55ZB.js";
 import "./chunk-MLWBMJEN.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmates",
-  "version": "0.16.0-alpha.7",
+  "version": "0.16.0-alpha.9",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",