openmates 0.12.0-alpha.2 → 0.12.0-alpha.4

package/dist/{chunk-UG4LLEOG.js → chunk-MWM6T3MG.js}

@@ -2037,6 +2037,33 @@ function buildSubChatConfirmationPayload(params) {
     approve_count: params.approved ? params.approveCount ?? null : null
   };
 }
+function assertNoConnectedAccountSecretLeak(value) {
+  const serialized = JSON.stringify(value ?? {});
+  const forbidden = [
+    "refresh_token",
+    "access_token",
+    "provider_email",
+    "account_email",
+    "provider_account_id"
+  ];
+  for (const key of forbidden) {
+    if (serialized.includes(`"${key}"`)) {
+      throw new Error(`Connected account payload contains forbidden field: ${key}`);
+    }
+  }
+}
+function buildConnectedAccountDirectoryPayload(entries) {
+  if (!entries || entries.length === 0) return void 0;
+  assertNoConnectedAccountSecretLeak(entries);
+  return entries.map((entry) => ({ ...entry, capabilities: [...entry.capabilities] }));
+}
+function buildTurnTokenRefsRequestPayload(params) {
+  return {
+    chat_id: params.chatId,
+    message_id: params.messageId,
+    refs: params.refs.map((ref) => ({ ...ref }))
+  };
+}
 function categoryFromMemoryKey(key) {
   const separator = key.indexOf("-");
   if (separator <= 0 || separator === key.length - 1) return null;
@@ -2581,6 +2608,124 @@ var BLOCKED_SETTINGS_MUTATE_PATHS = /* @__PURE__ */ new Set([
   "/v1/settings/verify-action-code",
   "/v1/settings/user/disable-2fa"
 ]);
+function applyUnifiedDiffForEmbedVersion(content, patch) {
+  const contentLines = content.split("\n");
+  const lines = patch.split("\n");
+  const hunks = [];
+  let current = null;
+  for (const line of lines) {
+    const match = /^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(line);
+    if (match) {
+      if (current) hunks.push(current);
+      current = { start: Number(match[1]) - 1, oldLines: [], newLines: [] };
+      continue;
+    }
+    if (!current) continue;
+    if (line.startsWith(" ")) {
+      current.oldLines.push(line.slice(1));
+      current.newLines.push(line.slice(1));
+    } else if (line.startsWith("-")) {
+      current.oldLines.push(line.slice(1));
+    } else if (line.startsWith("+")) {
+      current.newLines.push(line.slice(1));
+    }
+  }
+  if (current) hunks.push(current);
+  for (const hunk of hunks.sort((a, b) => b.start - a.start)) {
+    const actual = contentLines.slice(hunk.start, hunk.start + hunk.oldLines.length);
+    if (actual.join("\n") !== hunk.oldLines.join("\n")) {
+      throw new Error("Version patch context does not match local content");
+    }
+    contentLines.splice(hunk.start, hunk.oldLines.length, ...hunk.newLines);
+  }
+  return contentLines.join("\n");
+}
+function buildUnifiedDiffForEmbedRestore(currentContent, restoredContent, currentVersion, newVersion) {
+  const currentLines = currentContent.split("\n");
+  const restoredLines = restoredContent.split("\n");
+  return [
+    `--- v${currentVersion}`,
+    `+++ v${newVersion}`,
+    `@@ -1,${Math.max(1, currentLines.length)} +1,${Math.max(1, restoredLines.length)} @@`,
+    ...currentLines.map((line) => `-${line}`),
+    ...restoredLines.map((line) => `+${line}`)
+  ].join("\n");
+}
+function parseEmbedContentObject(rawContent) {
+  try {
+    return JSON.parse(rawContent);
+  } catch {
+    return parseYamlLikeContent(rawContent);
+  }
+}
+async function encodeEmbedContentObject(content) {
+  try {
+    const { encode } = await import("@toon-format/toon");
+    return encode(content);
+  } catch {
+    return JSON.stringify(content);
+  }
+}
+function extractVersionedEmbedContent(content) {
+  if (typeof content.receiver === "string" || typeof content.subject === "string") {
+    return [
+      `To: ${typeof content.receiver === "string" ? content.receiver : ""}`,
+      `Subject: ${typeof content.subject === "string" ? content.subject : ""}`,
+      "",
+      typeof content.content === "string" ? content.content : "",
+      typeof content.footer === "string" ? content.footer : ""
+    ].join("\n").trim();
+  }
+  if (typeof content.remotion_source === "string") return content.remotion_source;
+  if (typeof content.code === "string") return content.code;
+  if (typeof content.html === "string") return content.html;
+  if (typeof content.table === "string") return content.table;
+  if (content.docx_model) return JSON.stringify(content.docx_model, null, 2);
+  if (typeof content.content === "string") return content.content;
+  throw new Error("Unsupported embed content shape for version restore.");
+}
+function buildRestoredEmbedContentObject(current, restoredContent, newVersion) {
+  const restored = { ...current, version_number: newVersion };
+  if (typeof current.receiver === "string" || typeof current.subject === "string") {
+    return { ...restored, ...parseMailVersionContent(restoredContent) };
+  }
+  if (typeof current.remotion_source === "string") {
+    return { ...restored, remotion_source: restoredContent, current_source_version: newVersion };
+  }
+  if (typeof current.code === "string") return { ...restored, code: restoredContent };
+  if (typeof current.html === "string") return { ...restored, html: restoredContent };
+  if (typeof current.table === "string") return { ...restored, table: restoredContent };
+  if (current.docx_model) {
+    try {
+      return { ...restored, docx_model: JSON.parse(restoredContent) };
+    } catch {
+      return { ...restored, content: restoredContent };
+    }
+  }
+  if (typeof current.content === "string") return { ...restored, content: restoredContent };
+  throw new Error("Unsupported embed content shape for version restore.");
+}
+function parseMailVersionContent(versionContent) {
+  const lines = versionContent.split("\n");
+  let receiver = "";
+  let subject = "";
+  const bodyLines = [];
+  for (const line of lines) {
+    if (line.toLowerCase().startsWith("to:")) {
+      receiver = line.slice(3).trim();
+    } else if (line.toLowerCase().startsWith("subject:")) {
+      subject = line.slice(8).trim();
+    } else {
+      bodyLines.push(line);
+    }
+  }
+  return {
+    receiver,
+    subject,
+    content: bodyLines.join("\n").trim(),
+    footer: ""
+  };
+}
 var OpenMatesClient = class _OpenMatesClient {
   apiUrl;
   session;
@@ -2600,6 +2745,30 @@ var OpenMatesClient = class _OpenMatesClient {
   hasSession() {
     return this.session !== null;
   }
+  async createTurnTokenRefs(params) {
+    if (params.refs.length === 0) return [];
+    const response = await this.http.post(
+      "/v1/token-broker/turn-token-refs",
+      buildTurnTokenRefsRequestPayload(params),
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok || !Array.isArray(response.data.refs)) {
+      throw new Error(`Failed to create connected-account token refs (HTTP ${response.status})`);
+    }
+    return response.data.refs.map((ref) => {
+      const input = params.refs.find(
+        (item) => item.connected_account_id === ref.connected_account_id && item.app_id === ref.app_id
+      );
+      return {
+        connected_account_id: ref.connected_account_id,
+        app_id: ref.app_id,
+        turn_token_ref: ref.turn_token_ref,
+        expires_at: ref.expires_at,
+        allowed_actions: input?.allowed_actions ?? [],
+        action_scope: input?.action_scope
+      };
+    });
+  }
   // -------------------------------------------------------------------------
   // Auth
   // -------------------------------------------------------------------------
@@ -3362,6 +3531,15 @@ var OpenMatesClient = class _OpenMatesClient {
     const createdAt = Math.floor(Date.now() / 1e3);
     const isNewChat = !params.chatId;
     ws.send("set_active_chat", { chat_id: chatId });
+    const connectedAccountDirectory = buildConnectedAccountDirectoryPayload(
+      params.connectedAccountDirectory
+    );
+    const connectedAccountTokenRefs = params.connectedAccountTokenRefInputs?.length ? await this.createTurnTokenRefs({
+      chatId,
+      messageId,
+      refs: params.connectedAccountTokenRefInputs
+    }) : [];
+    assertNoConnectedAccountSecretLeak(connectedAccountTokenRefs);
     const messagePayload = {
       chat_id: chatId,
       is_incognito: Boolean(params.incognito),
@@ -3379,6 +3557,12 @@ var OpenMatesClient = class _OpenMatesClient {
     if (memoryMetadataKeys.length > 0) {
       messagePayload.app_settings_memories_metadata = memoryMetadataKeys;
     }
+    if (connectedAccountDirectory) {
+      messagePayload.connected_account_directory = connectedAccountDirectory;
+    }
+    if (connectedAccountTokenRefs.length > 0) {
+      messagePayload.connected_account_token_refs = connectedAccountTokenRefs;
+    }
     let chatKeyBytes = null;
     let encryptedChatKey = null;
     let baselineMessagesV = 0;
@@ -3437,7 +3621,16 @@ var OpenMatesClient = class _OpenMatesClient {
     if (encryptedEmbeds.length > 0) {
       messagePayload.encrypted_embeds = encryptedEmbeds;
     }
-    ws.send("chat_message_added", messagePayload);
+    const confirmed = ws.waitForMessage(
+      "chat_message_confirmed",
+      (payload) => {
+        const eventPayload = payload;
+        return eventPayload.chat_id === chatId && eventPayload.message_id === messageId;
+      },
+      2e4
+    );
+    await ws.sendAsync("chat_message_added", messagePayload);
+    await confirmed;
     if (!params.incognito && chatKeyBytes) {
       const encryptedContent = await encryptWithAesGcmCombined(
         params.message,
@@ -3801,6 +3994,22 @@ var OpenMatesClient = class _OpenMatesClient {
         created_at: createdAt,
         updated_at: updatedAt
       });
+      if (Array.isArray(embed.version_history_rows)) {
+        for (const row of embed.version_history_rows) {
+          if (!row.embed_id || typeof row.version_number !== "number") continue;
+          const encryptedSnapshot = typeof row.snapshot === "string" ? await encryptWithAesGcmCombined(row.snapshot, embedKey) : void 0;
+          const encryptedPatch = typeof row.patch === "string" ? await encryptWithAesGcmCombined(row.patch, embedKey) : void 0;
+          if (!encryptedSnapshot && !encryptedPatch) continue;
+          await params.ws.sendAsync("store_embed_diff", {
+            embed_id: row.embed_id,
+            version_number: row.version_number,
+            encrypted_snapshot: encryptedSnapshot ?? null,
+            encrypted_patch: encryptedPatch ?? null,
+            hashed_user_id: hashedUserId,
+            created_at: normalizeUnixSeconds(row.created_at, now)
+          });
+        }
+      }
       if (!isChild) {
         const keys = [
           {
@@ -4031,7 +4240,8 @@ var OpenMatesClient = class _OpenMatesClient {
     if (!topSchema) return [];
     const requestsProp = topSchema.properties?.requests;
     const itemsRef = requestsProp?.items;
-    const itemSchema = itemsRef ? resolveSchema(itemsRef) : null;
+    const itemSchema = itemsRef ? resolveSchema(itemsRef) : topSchema;
+    const inputShape = itemsRef ? "requests" : "flat";
     if (!itemSchema?.properties) return [];
     const required = new Set(
       Array.isArray(itemSchema.required) ? itemSchema.required : []
@@ -4064,7 +4274,8 @@ var OpenMatesClient = class _OpenMatesClient {
         type: typeStr,
         description: resolved.description ?? "",
         required: required.has(name),
-        default: resolved.default
+        default: resolved.default,
+        inputShape
       };
     });
   }
@@ -4944,6 +5155,188 @@ Required: ${schema.required.join(", ")}`
     const origin = deriveWebOrigin(session.apiUrl);
     return buildEmbedShareUrl(origin, embedId, blob);
   }
+  async listEmbedVersions(embedIdOrShort) {
+    const embedId = await this.resolveEmbedId(embedIdOrShort);
+    const response = await this.http.get(
+      `/v1/embeds/${encodeURIComponent(embedId)}/versions`,
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok || !response.data) {
+      throw new Error(this.formatEmbedVersionError(response.data, `Failed to list embed versions (HTTP ${response.status})`));
+    }
+    return response.data;
+  }
+  async getEmbedVersion(embedIdOrShort, version) {
+    const embedId = await this.resolveEmbedId(embedIdOrShort);
+    const response = await this.http.get(
+      `/v1/embeds/${encodeURIComponent(embedId)}/versions/${version}`,
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok || !response.data) {
+      throw new Error(this.formatEmbedVersionError(response.data, `Failed to load embed version ${version} (HTTP ${response.status})`));
+    }
+    if (typeof response.data.content === "string" || !Array.isArray(response.data.rows)) {
+      return response.data;
+    }
+    return {
+      ...response.data,
+      content: await this.reconstructEncryptedEmbedVersion(embedId, response.data.rows)
+    };
+  }
+  async restoreEmbedVersion(embedIdOrShort, version) {
+    const embedId = await this.resolveEmbedId(embedIdOrShort);
+    const cache = await this.ensureSynced();
+    const masterKey = this.getMasterKeyBytes();
+    const embed = cache.embeds.find(
+      (entry) => String(entry.embed_id ?? entry.id ?? "") === embedId
+    );
+    if (!embed) {
+      throw new Error(`Embed '${embedId}' not found in local cache. Run 'openmates chats list' to sync first.`);
+    }
+    const { createHash: createHash5 } = await import("crypto");
+    const hashedEmbedId = createHash5("sha256").update(embedId).digest("hex");
+    const embedKey = await this.resolveEmbedKey(
+      cache,
+      masterKey,
+      embed,
+      embedId,
+      hashedEmbedId
+    );
+    if (!embedKey) {
+      throw new Error("Could not resolve embed encryption key for version restore.");
+    }
+    const target = await this.getEmbedVersion(embedId, version);
+    if (typeof target.content !== "string") {
+      throw new Error("Embed version content was not available for restore.");
+    }
+    const encryptedCurrentContent = embed.encrypted_content;
+    if (typeof encryptedCurrentContent !== "string") {
+      throw new Error("Current embed content is not available for encrypted restore.");
+    }
+    const currentToon = await decryptWithAesGcmCombined(encryptedCurrentContent, embedKey);
+    if (!currentToon) {
+      throw new Error("Could not decrypt current embed content for restore.");
+    }
+    const currentObject = parseEmbedContentObject(currentToon);
+    const currentVersion = typeof embed.version_number === "number" ? embed.version_number : target.current_version;
+    if (version === currentVersion) {
+      throw new Error("Selected version is already current.");
+    }
+    const currentContent = extractVersionedEmbedContent(currentObject);
+    const newVersion = currentVersion + 1;
+    const restoredObject = buildRestoredEmbedContentObject(currentObject, target.content, newVersion);
+    const restoredToon = await encodeEmbedContentObject(restoredObject);
+    const encryptedRestoredContent = await encryptWithAesGcmCombined(restoredToon, embedKey);
+    const restorePatch = buildUnifiedDiffForEmbedRestore(
+      currentContent,
+      target.content,
+      currentVersion,
+      newVersion
+    );
+    const encryptedPatch = await encryptWithAesGcmCombined(restorePatch, embedKey);
+    const contentHash = computeSHA256(target.content);
+    const now = Math.floor(Date.now() / 1e3);
+    const { ws } = await this.openWsClient();
+    try {
+      await ws.sendAsync("store_embed", {
+        embed_id: embedId,
+        encrypted_type: embed.encrypted_type,
+        encrypted_content: encryptedRestoredContent,
+        encrypted_text_preview: embed.encrypted_text_preview,
+        status: embed.status || "finished",
+        hashed_chat_id: embed.hashed_chat_id,
+        hashed_message_id: embed.hashed_message_id,
+        hashed_task_id: embed.hashed_task_id,
+        hashed_user_id: embed.hashed_user_id,
+        embed_ids: embed.embed_ids,
+        parent_embed_id: embed.parent_embed_id,
+        version_number: newVersion,
+        file_path: embed.file_path,
+        content_hash: contentHash,
+        text_length_chars: target.content.length,
+        is_private: embed.is_private ?? false,
+        is_shared: embed.is_shared ?? false,
+        created_at: normalizeUnixSeconds(embed.created_at, now),
+        updated_at: now
+      });
+      await ws.sendAsync("store_embed_diff", {
+        embed_id: embedId,
+        version_number: newVersion,
+        encrypted_snapshot: null,
+        encrypted_patch: encryptedPatch,
+        hashed_user_id: embed.hashed_user_id,
+        created_at: now
+      });
+    } finally {
+      ws.close();
+    }
+    clearSyncCache();
+    return {
+      embed_id: embedId,
+      restored_from_version: version,
+      version_number: newVersion,
+      content: target.content,
+      content_hash: contentHash
+    };
+  }
+  async reconstructEncryptedEmbedVersion(embedId, rows) {
+    const cache = await this.ensureSynced();
+    const masterKey = this.getMasterKeyBytes();
+    const embed = cache.embeds.find(
+      (entry) => String(entry.embed_id ?? entry.id ?? "") === embedId
+    );
+    if (!embed) {
+      throw new Error(`Embed '${embedId}' not found in local cache. Run 'openmates chats list' to sync first.`);
+    }
+    const { createHash: createHash5 } = await import("crypto");
+    const hashedEmbedId = createHash5("sha256").update(embedId).digest("hex");
+    const embedKey = await this.resolveEmbedKey(
+      cache,
+      masterKey,
+      embed,
+      embedId,
+      hashedEmbedId
+    );
+    if (!embedKey) {
+      throw new Error("Could not resolve embed encryption key for version history.");
+    }
+    const sortedRows = [...rows].sort((a, b) => a.version_number - b.version_number);
+    let content = null;
+    for (const row of sortedRows) {
+      if (row.encrypted_snapshot) {
+        content = await decryptWithAesGcmCombined(row.encrypted_snapshot, embedKey);
+        continue;
+      }
+      if (row.encrypted_patch && content !== null) {
+        const patch = await decryptWithAesGcmCombined(row.encrypted_patch, embedKey);
+        content = applyUnifiedDiffForEmbedVersion(content, patch ?? "");
+      }
+    }
+    if (content === null) {
+      throw new Error("Version history is missing the initial snapshot");
+    }
+    return content;
+  }
+  formatEmbedVersionError(data, fallback) {
+    if (data && typeof data === "object") {
+      const detail = data.detail;
+      const message = data.message;
+      if (typeof detail === "string" && detail.trim()) return detail;
+      if (typeof message === "string" && message.trim()) return message;
+    }
+    return fallback;
+  }
+  async resolveEmbedId(embedIdOrShort) {
+    if (embedIdOrShort.length >= 32) return embedIdOrShort;
+    const cache = await this.ensureSynced();
+    const embed = cache.embeds.find(
+      (entry) => String(entry.embed_id ?? "").startsWith(embedIdOrShort) || String(entry.id ?? "").startsWith(embedIdOrShort)
+    );
+    if (!embed) {
+      throw new Error(`Embed '${embedIdOrShort}' not found in local cache. Run 'openmates chats list' to sync first.`);
+    }
+    return String(embed.embed_id ?? embed.id ?? "");
+  }
   // ── Mention context builder ─────────────────────────────────────────
   /**
    * Build the context needed for CLI mention resolution.
@@ -5425,7 +5818,7 @@ function printLogo() {
 
 // src/cli.ts
 import { createInterface as createInterface3 } from "readline/promises";
-import { realpathSync } from "fs";
+import { realpathSync, writeFileSync as writeFileSync4 } from "fs";
 import { fileURLToPath } from "url";
 import { basename as basename3, dirname } from "path";
 import WebSocket2 from "ws";
@@ -22359,6 +22752,111 @@ var searchParentPreviewStressTestChat = {
   }
 };
 
+// ../ui/src/demo_chats/data/example_chats/rostock-heavy-rain-radar.ts
+var rostockHeavyRainRadarChat = {
+  chat_id: "example-rostock-heavy-rain-radar",
+  slug: "rostock-heavy-rain-radar",
+  title: "example_chats.rostock_heavy_rain_radar.title",
+  summary: "example_chats.rostock_heavy_rain_radar.summary",
+  icon: "weather",
+  category: "general_knowledge",
+  keywords: ["Rostock rain radar", "DWD weather", "heavy rain", "weather app", "rain map"],
+  follow_up_suggestions: [],
+  messages: [
+    {
+      "id": "cd0dbe83-29cf-476e-b8e7-856ac0c529be",
+      "role": "user",
+      "content": "example_chats.rostock_heavy_rain_radar.message_1",
+      "created_at": 1781465378
+    },
+    {
+      "id": "6c84c422-a71e-47b8-979d-6e2e9e91aad9",
+      "role": "assistant",
+      "content": "example_chats.rostock_heavy_rain_radar.message_2",
+      "created_at": 1781465401,
+      "category": "general_knowledge",
+      "model_name": "Gemini 3 Flash"
+    }
+  ],
+  embeds: [
+    {
+      "embed_id": "deb8e4c2-e07c-49c3-ae5c-300a21859563",
+      "type": "app_skill_use",
+      "content": "app_id: weather\nskill_id: rain_radar\nstatus: finished\nembed_id: deb8e4c2-e07c-49c3-ae5c-300a21859563\nquery: Rostock rain radar\nprovider: Deutscher Wetterdienst (DWD) via Bright Sky\nlocation:\n  name: Rostock\n  country: Germany\n  country_code: DE\n  admin1: Mecklenburg-Vorpommern\n  latitude: 54.0887\n  longitude: 12.14049\n  timezone: Europe/Berlin\ncoverage:\n  status: available\n  radius_km: 5\nsummary:\n  rain_expected: true\n  in_10_min: Heavy rain visible near Rostock.\n  next_2_hours: Heavy rain appears in the radar timeline near Rostock.\n  peak_intensity: heavy\n  preview_frame_id: frame-15\ntimeline[25]{frame_id,timestamp,kind,label,rain_at_location_mm_5min,max_intensity,rain_area_pct}:\n  frame-0,2026-06-14T20:25:00+02:00,past,-65 min,0,heavy,12.4\n  frame-1,2026-06-14T20:30:00+02:00,past,-60 min,0,heavy,38.8\n  frame-2,2026-06-14T20:35:00+02:00,past,-55 min,20.48,heavy,82.6\n  frame-3,2026-06-14T20:40:00+02:00,past,-50 min,33.28,heavy,100\n  frame-4,2026-06-14T20:45:00+02:00,past,-45 min,115.2,heavy,100\n  frame-5,2026-06-14T20:50:00+02:00,past,-40 min,89.6,heavy,100\n  frame-6,2026-06-14T20:55:00+02:00,past,-35 min,76.8,heavy,100\n  frame-7,2026-06-14T21:00:00+02:00,past,-30 min,102.4,heavy,100\n  frame-8,2026-06-14T21:05:00+02:00,past,-25 min,94.72,heavy,100\n  frame-9,2026-06-14T21:10:00+02:00,past,-20 min,66.56,heavy,100\n  frame-10,2026-06-14T21:15:00+02:00,past,-15 min,64,heavy,100\n  frame-11,2026-06-14T21:20:00+02:00,past,-10 min,120.32,heavy,100\n  frame-12,2026-06-14T21:25:00+02:00,past,-5 min,130.56,heavy,100\n  frame-13,2026-06-14T21:30:00+02:00,forecast,now,58.88,heavy,100\n  frame-14,2026-06-14T21:35:00+02:00,forecast,+5 min,87.04,heavy,100\n  frame-15,2026-06-14T21:40:00+02:00,forecast,+10 min,87.04,heavy,100\n  frame-16,2026-06-14T21:45:00+02:00,forecast,+15 min,61.44,heavy,100\n  frame-17,2026-06-14T21:50:00+02:00,forecast,+20 min,92.16,heavy,100\n  frame-18,2026-06-14T21:55:00+02:00,forecast,+25 min,94.72,heavy,100\n  frame-19,2026-06-14T22:00:00+02:00,forecast,+30 min,99.84,heavy,100\n  frame-20,2026-06-14T22:05:00+02:00,forecast,+35 min,140.8,heavy,100\n  frame-21,2026-06-14T22:10:00+02:00,forecast,+40 min,107.52,heavy,100\n  frame-22,2026-06-14T22:15:00+02:00,forecast,+45 min,145.92,heavy,100\n  frame-23,2026-06-14T22:20:00+02:00,forecast,+50 min,120.32,heavy,100\n  frame-24,2026-06-14T22:25:00+02:00,forecast,+55 min,151.04,heavy,100",
+      "parent_embed_id": null,
+      "embed_ids": null
+    }
+  ],
+  metadata: {
+    featured: true,
+    order: 101,
+    app_skill_examples: ["weather.rain_radar"]
+  }
+};
+
+// ../ui/src/demo_chats/data/example_chats/classic-car-reverse-image-search.ts
+var classicCarReverseImageSearchChat = {
+  chat_id: "example-classic-car-reverse-image",
+  slug: "classic-car-reverse-image-search",
+  title: "example_chats.classic_car_reverse_image_search.title",
+  summary: "example_chats.classic_car_reverse_image_search.summary",
+  icon: "search",
+  category: "general_knowledge",
+  keywords: ["reverse image search", "classic cars", "Mercedes-Benz 300 SL", "car identification", "Google Lens"],
+  follow_up_suggestions: [],
+  messages: [
+    {
+      "id": "0cbd9872-31f9-483a-9159-3361764e7982",
+      "role": "user",
+      "content": "example_chats.classic_car_reverse_image_search.message_1",
+      "created_at": 1781525084
+    },
+    {
+      "id": "c2dd4e8f-6026-4540-9355-13d02d94018c",
+      "role": "assistant",
+      "content": "example_chats.classic_car_reverse_image_search.message_2",
+      "created_at": 1781525128,
+      "category": "general_knowledge",
+      "model_name": "Gemini 3 Flash"
+    }
+  ],
+  embeds: [
+    {
+      "embed_id": "d7f2f391-7c8f-44e7-beb4-66bd846dd0ae",
+      "type": "app_skill_use",
+      "content": "app_id: images\nskill_id: search\nresult_count: 0\nembed_ids[0]:\nstatus: finished\nembed_id: d7f2f391-7c8f-44e7-beb4-66bd846dd0ae\nquery: Mercedes-Benz 300 SL Gullwing\nprovider: Brave Search",
+      "parent_embed_id": null,
+      "embed_ids": []
+    },
+    {
+      "embed_id": "45e9c346-341e-466e-aed1-67ee1412dce5",
+      "type": "app_skill_use",
+      "content": "app_id: web\nskill_id: search\nresult_count: 0\nembed_ids[0]:\nstatus: finished\nembed_id: 45e9c346-341e-466e-aed1-67ee1412dce5\nquery: Mercedes-Benz 300 SL Gullwing visual identification features\nprovider: Brave",
+      "parent_embed_id": null,
+      "embed_ids": []
+    },
+    {
+      "embed_id": "228d2a03-63cb-483a-b495-45489e55bc10",
+      "type": "app_skill_use",
+      "content": "app_id: images\nskill_id: search\nresult_count: 0\nembed_ids[0]:\nstatus: finished\nembed_id: 228d2a03-63cb-483a-b495-45489e55bc10\nfile_path: mercedes-300-sl-gullwing-example-jpg-b41-baf4d7\nprovider: Brave Search",
+      "parent_embed_id": null,
+      "embed_ids": []
+    },
+    {
+      "embed_id": "c512601d-508c-44ee-bdb9-b444c18ffe10",
+      "type": "image",
+      "content": "type: image\napp_id: images\nskill_id: upload\nstatus: finished\nfilename: mercedes-300-sl-gullwing-example.jpg\nsrc: https://upload.wikimedia.org/wikipedia/commons/thumb/3/31/Mercedes-Benz_300_SL_Gullwing.jpg/960px-Mercedes-Benz_300_SL_Gullwing.jpg\nembed_ref: mercedes-300-sl-gullwing-example-jpg-b41-baf4d7\ncontent_hash: 6620266404d276d92cf456ad5affb62ce35bf3fb50deca205fd0435d5145b017\nai_detection:\n  ai_generated: 0.001\n  provider: sightengine",
+      "parent_embed_id": null,
+      "embed_ids": null
+    }
+  ],
+  metadata: {
+    featured: true,
+    order: 102,
+    app_skill_examples: ["images.search", "web.search"]
+  }
+};
+
 // ../ui/src/demo_chats/exampleChatData.ts
 var ALL_EXAMPLE_CHATS = [
   giganticAirplanesChat,
@@ -22442,7 +22940,9 @@ var ALL_EXAMPLE_CHATS = [
   productTeaserRemotionVideoChat,
   dampedSineWavePlotChat,
   berlinCentralStationMapLocationChat,
-  launchReadinessChecklistDocChat
+  launchReadinessChecklistDocChat,
+  rostockHeavyRainRadarChat,
+  classicCarReverseImageSearchChat
 ].sort((a, b) => a.metadata.order - b.metadata.order);
 
 // ../ui/src/i18n/locales/en.json
@@ -24966,6 +25466,12 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
           text: "Get daily and hourly weather forecasts."
         }
       },
+      rain_radar: {
+        text: "Rain radar",
+        description: {
+          text: "Show nearby rain radar with an interactive timeline."
+        }
+      },
       day: {
         text: "Weather day"
       }
@@ -27577,6 +28083,34 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
     }
   },
   embeds: {
+    weather: {
+      rain_radar: {
+        no_rain: {
+          text: "No rain visible near this location."
+        },
+        unavailable: {
+          text: "Rain radar is unavailable for this location."
+        },
+        peak: {
+          text: "Peak"
+        },
+        at_location: {
+          text: "At location"
+        },
+        play: {
+          text: "Play"
+        },
+        pause: {
+          text: "Pause"
+        },
+        frames: {
+          text: "frames"
+        },
+        load_failed: {
+          text: "Radar data could not be loaded. Showing the summary view instead."
+        }
+      }
+    },
     search: {
       text: "Search"
     },
@@ -29031,6 +29565,20 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
         text: '```json\n{"type":"app_skill_use","embed_id":"d7f21a46-8f13-4f14-82c4-d868ba62bb8a","app_id":"nutrition","skill_id":"search_recipes","query":"chickpea and spinach dinner","provider":"Edamam","status":"finished"}\n```\n\nHere are three delicious, protein-packed vegetarian chickpea and spinach dinner recipes that you can whip up in under 35 minutes.\n\n### 1. 10-Minute Chickpea and Spinach Curry\nThis is an incredibly fast [curry](wiki:Curry) that relies on aromatics and pantry staples for a rich, satisfying flavor in record time.\n\n[!](embed:thefieryvegetarian.com-3sr)\n[!](embed:vegancocotte.com-IZt)\n[!](embed:vegancocotte.com-rFn)\n\n*   **Total Time:** 10 minutes\n*   **Protein Content:** ~10.5g per serving\n*   **Servings:** 4\n\n**Ingredients:**\n*   1 (15 oz) can [chickpeas](wiki:Chickpea) (drained and rinsed)\n*   1 (15 oz) can diced [tomatoes](wiki:Tomato)\n*   1 [onion](wiki:Onion), 4 [garlic](wiki:Garlic) cloves, 1 red chili, 1 tbsp ginger (all finely diced)\n*   3 tbsp curry paste & 2 tbsp [tomato paste](wiki:Tomato_paste)\n*   3 cups fresh [spinach](wiki:Spinach)\n*   1 tsp vegetable oil\n\n**Instructions:**\n1.  **Saut\xE9 Aromatics:** Heat oil in a large pot. Add diced onion, garlic, ginger, and chili. Saut\xE9 for about 1 minute until fragrant.\n2.  **Build Flavor:** Stir in the tomato paste and curry paste, saut\xE9ing for another minute to release the oils.\n3.  **Simmer:** Pour in the canned tomatoes and chickpeas. Cover and simmer on medium-high heat for 3\u20135 minutes.\n4.  **Wilt Spinach:** Stir in the fresh spinach leaves until they wilt (about 1\u20132 minutes). Serve immediately.\n\n---\n\n### 2. 15-Minute Skillet Chickpeas with Spinach and Tomatoes\nThis Mediterranean-style dish uses spices like [turmeric](wiki:Turmeric) and a finishing touch of lemon juice for a bright, healthy meal.\n\n[!](embed:runningonrealfood.com-R8H)\n[!](embed:americanhomecook.com-Alt)\n[!](embed:shortgirltallorder.com-QXv)\n\n*   **Total Time:** 15 minutes\n*   **Protein Content:** ~23.1g per serving\n*   **Servings:** 2\n\n**Ingredients:**\n*   1 (15 oz) can chickpeas (drained and rinsed)\n*   1 (14.5 oz) can diced tomatoes\n*   5 oz baby spinach\n*   1 small onion (diced) & 4 garlic cloves (sliced)\n*   \xBD tsp ground turmeric & \xBD tsp [red pepper flakes](wiki:Crushed_red_pepper)\n*   3 tbsp [olive oil](wiki:Olive_oil), lemon juice, and fresh herbs ([cilantro](wiki:Coriander) or [parsley](wiki:Parsley))\n\n**Instructions:**\n1.  **Fry Aromatics:** Heat oil in a skillet over low heat. Cook onion and garlic until translucent and slightly browned (3\u20135 minutes).\n2.  **Toast Spices:** Add turmeric and red pepper flakes. Toast for 1 minute, then add chickpeas with a drizzle of oil and salt/pepper. Sizzle for 5\u20137 minutes.\n3.  **Combine:** Stir in the tomatoes and simmer until the liquid reduces slightly.\n4.  **Finish:** Add spinach and stir until wilted. Off the heat, stir in lemon juice and top with fresh herbs and a dollop of [yogurt](wiki:Yogurt).\n\n---\n\n### 3. 20-Minute Middle Eastern Spinach and Chickpeas\nA simpler, cleaner version of the classic [tapas](wiki:Tapas) dish, focusing on the natural sweetness of saut\xE9ed onions and white beans.\n\n[!](embed:carolinescooking.com-Dy7)\n[!](embed:simpleveganblog.com-8dt)\n[!](embed:ourplantbasedworld.com-Krr)\n\n*   **Total Time:** 20 minutes\n*   **Protein Content:** ~8.7g per serving\n*   **Servings:** 4\n\n**Ingredients:**\n*   3 cups low-sodium canned chickpeas (drained and rinsed)\n*   2 cups baby spinach\n*   2/3 cup diced tomatoes\n*   \xBD large white onion (diced)\n*   2 tsp minced garlic\n*   1\xBD tbsp [extra-virgin olive oil](wiki:Olive_oil#Grades)\n\n**Instructions:**\n1.  **Soften Onions:** Heat olive oil in a pan. Saut\xE9 the onion for 2\u20133 minutes.\n2.  **Add Seasoning:** Stir in the garlic and saut\xE9 for another minute.\n3.  **Cook Down:** Pour in the tomatoes and cook for 1 minute.\n4.  **Simmer Beans:** Add the chickpeas and about 3\u20134 tablespoons of water (or [vegetable broth](wiki:Broth)). Cook for 10 minutes.\n5.  **Fold Spinach:** Gently fold in the baby spinach until just wilted. Season to taste and serve.\n\n---\n\n**Next steps for your meal prep:**\n*   Would you like to find some side dish suggestions, like a [basmati rice](wiki:Basmati) or [naan](wiki:Naan) recipe, to go with these?\n*   Are you interested in seeing some high-protein vegan dessert ideas to round out your dinner?'
       }
     },
+    classic_car_reverse_image_search: {
+      title: {
+        text: "Identify a Classic Car from a Photo"
+      },
+      summary: {
+        text: "Use reverse image search to identify a Mercedes-Benz 300 SL Gullwing from an uploaded photo."
+      },
+      message_1: {
+        text: "Use reverse image search on this uploaded classic car photo and identify the exact car model. Reply with the model name and one sentence explaining the visual clues.\n[!](embed:mercedes-300-sl-gullwing-example-jpg-b41-baf4d7)"
+      },
+      message_2: {
+        text: '```json\n{"type": "app_skill_use", "embed_id": "228d2a03-63cb-483a-b495-45489e55bc10", "app_id": "images", "skill_id": "search", "provider": "Brave Search"}\n```\n\n```json\n{"type": "app_skill_use", "embed_id": "45e9c346-341e-466e-aed1-67ee1412dce5", "app_id": "web", "skill_id": "search", "query": "Mercedes-Benz 300 SL Gullwing visual identification features", "provider": "Brave"}\n```\n\n```json\n{"type": "app_skill_use", "embed_id": "d7f2f391-7c8f-44e7-beb4-66bd846dd0ae", "app_id": "images", "skill_id": "search", "query": "Mercedes-Benz 300 SL Gullwing", "provider": "Brave Search"}\n```\n\nThe car in the photo is a **[Mercedes-Benz 300 SL Gullwing](wiki:Mercedes-Benz_300_SL)**.\n\nThis legendary model is most easily identified by its signature upward-opening "gullwing" doors, the prominent horizontal chrome bars flanking the large star in the grille, and the distinctive aerodynamic "eyebrows" positioned over the wheel arches.\n\nBased on the current date of June 15, 2026, this vehicle remains one of the most coveted and valuable collector cars in history.\n\n**Would you like to know more about this car?**\n- I can look up the current [market value and auction history](/#settings/apps/web) for the 300 SL.\n- I can find [technical specifications](/#settings/apps/web) or the history of its development as a racing car.'
+      }
+    },
     creativity_drawing_meetups_berlin: {
       title: {
         text: "Creativity Drawing Meetups Berlin"
@@ -30165,6 +30713,20 @@ Like [Denis Villeneuve](wiki:Denis_Villeneuve)\u2019s work, *Contact* avoids the
         text: '```json\n{"type": "app_skill_use", "embed_id": "3031e3c2-e832-40fa-99e0-126fe7a5077f", "app_id": "news", "skill_id": "search", "query": "right-to-repair laws EU recent news June 2026", "provider": "Brave"}\n```\n\n```json\n{"type": "app_skill_use", "embed_id": "e7366974-55a3-4025-8a0b-6d40f600fa6a", "app_id": "news", "skill_id": "search", "query": "right-to-repair laws US recent news June 2026", "provider": "Brave"}\n```\n\n```json\n{"type": "app_skill_use", "embed_id": "af660c08-2d9e-4684-ad3c-deceafd8ab0c", "app_id": "web", "skill_id": "search", "query": "expert analysis right-to-repair laws 2026 EU US", "provider": "Brave"}\n```\n\n```json\n{"type": "app_skill_use", "embed_id": "e4146998-76de-4683-a010-ceffcdb53005", "app_id": "images", "skill_id": "search", "query": "right to repair electronics repairability label EU", "provider": "Brave Search"}\n```\n\nAs of June 2026, the "Right to Repair" movement has reached a critical implementation phase in both the [European Union](wiki:European_Union) and the [United States](wiki:United_States). While the EU is moving toward a unified continental mandate, the US continues to see a patchwork of state-level victories and intense lobbying battles.\n\n### Recent Developments in the European Union\n\nThe most significant recent event is the EU\'s unveiling of its **"Tech Sovereignty" package** on June 3, 2026. This initiative aims to reduce dependence on US Big Tech by fostering homegrown alternatives and strengthening consumer rights.\n\n*   **Implementation Countdown:** The landmark [EU Right to Repair Directive](wiki:Right_to_repair) (Directive (EU) 2024/1799) is set to be fully enforceable across all member states by **July 31, 2026**. \n*   **Digital Product Passports:** Starting July 19, 2026, the EU will launch the **Digital Product Passport (DPP)** registry. This will require products (starting with batteries and textiles) to carry a QR code that provides data on durability and repairability.\n*   **Legal Warnings:** On June 4, 2026, the European Commission issued formal warnings to **20 member states** that missed the March 2026 deadline to transpose the "Green Transition" directive into national law. This directive is crucial for preventing [greenwashing](wiki:Greenwashing) and "premature [obsolescence](wiki:Obsolescence)."\n\n[!](embed:euronewsweek.co.uk-aq1)\n[!](embed:termopasty.com-0tB)\n[!](embed:ecomondo.com-9xC)\n\n### Recent Developments in the United States\n\nIn the US, the movement remains focused on the state level, as federal legislation remains stalled in [Congress](wiki:United_States_Congress).\n\n*   **State-Level Expansion:** As of mid-2026, over **one-quarter of Americans** live in states with enforceable Right to Repair laws. This is expected to jump to **35% by fall 2026** as new laws in **Texas** and **Connecticut** take full effect.\n*   **Corporate Lobbying:** Advocacy groups like the [Public Interest Research Group (PIRG)](wiki:Public_Interest_Research_Group) have reported continued lobbying efforts from companies like [Google](wiki:Google) and [Apple](wiki:Apple_Inc.) against "parts pairing" restrictions\u2014a practice where software locks replacement parts to a specific device.\n\n### What Experts are Saying\n\nLegal and technical experts are offering a mix of optimism and caution regarding these new laws:\n\n1.  **The "Tech Liberation" Debate:** While EU officials have hailed June 3, 2026, as "Tech Liberation Day," experts from the *Computer & Communications Industry Association* argue that true independence from [Big Tech](wiki:Big_Tech) will take decades, noting that Europe still lacks a rival to [Nvidia](wiki:Nvidia) or [TSMC](wiki:TSMC).\n2.  **Loopholes and Parts Pairing:** Experts at *Cybernews* and *Earth911* warn that while the laws mandate the *right* to repair, manufacturers still "hold the cards" through the high cost of original parts and [software locks](wiki:Digital_rights_management) (parts pairing). They argue that without stricter price controls on spare parts, repair may remain more expensive than replacement.\n3.  **Warranty Incentives:** Legal analysts from *Fieldfisher* highlight a "hidden gem" in the EU law: if a consumer chooses repair over replacement during the warranty period, the **warranty is extended by 12 months**. This is viewed as a major incentive to shift consumer behavior away from a "throwaway culture."\n\n> [Manufacturers will be obliged to repair in scope products, even if those products were purchased by consumers before 31 July 2026.](embed:fieldfisher.com-e9q)\n\n### Summary Table: 2026 Milestones\n\n```json\n{"type": "sheet", "embed_id": "e4d7b998-1c4c-4680-9ef6-2a0f34ce0249"}\n```\n\n\nHow would you like to proceed? I can help you look into specific state laws in the US or provide more details on the Digital Product Passport requirements.\n\n*   [Check US state-by-state status](/#settings/apps/web)\n*   [Find a local repair shop](/#settings/apps/maps)\n---\n*\u26A0\uFE0F This is educational information only and not legal advice. Consult a lawyer for legal advice.*'
       }
     },
+    rostock_heavy_rain_radar: {
+      title: {
+        text: "Rostock Heavy Rain Radar"
+      },
+      summary: {
+        text: "A live weather chat that checks DWD rain radar for Rostock and shows heavy rain on the radar timeline."
+      },
+      message_1: {
+        text: "Is it raining in Rostock right now? Show me the rain radar."
+      },
+      message_2: {
+        text: '```json\n{"type": "app_skill_use", "embed_id": "deb8e4c2-e07c-49c3-ae5c-300a21859563", "app_id": "weather", "skill_id": "rain_radar", "query": "Rostock rain radar", "provider": "Deutscher Wetterdienst (DWD) via Bright Sky", "location": "Rostock"}\n```\n\nYes, it is currently raining heavily in [Rostock](wiki:Rostock). According to the latest data from the [Deutscher Wetterdienst](wiki:Deutscher_Wetterdienst), the city is experiencing significant precipitation, which is expected to continue for at least the next two hours.\n\nThe radar indicates a 100% rain area coverage in your vicinity, with intensities reaching peak levels. You might want to stay indoors for a while!\n\nDo you want to see the [detailed hourly forecast](/#settings/apps/weather) for the rest of the night?'
+      }
+    },
     rust_vector_database_repos: {
       title: {
         text: "Rust Vector Database Repos"
@@ -40634,7 +41196,7 @@ The booking_token is shown in the output of:
     } catch {
     }
     if (!hasExplicitInput && inlineTokens.length === 0) {
-      const required = schemaParams.filter((p) => p.required);
+      const required = getEffectiveRequiredParams(schemaParams);
       if (required.length > 0) {
         const data = await client.getSkillInfo(app, skill, apiKey);
         await printSkillInfo(client, app, data);
@@ -40642,7 +41204,7 @@ The booking_token is shown in the output of:
       }
     }
     if (!hasExplicitInput && inlineTokens.length > 0 && schemaParams.length > 0) {
-      const required = schemaParams.filter((p) => p.required);
+      const required = getEffectiveRequiredParams(schemaParams);
       if (required.length > 1) {
         const example = {};
         for (const p of required) example[p.name] = `<${p.name}>`;
@@ -40650,7 +41212,7 @@ The booking_token is shown in the output of:
           `This skill requires ${required.length} fields: ${required.map((p) => p.name).join(", ")}
 
 Use --input to provide all fields:
-  openmates apps ${app} ${skill} --input '{"requests": [${JSON.stringify(example)}]}'
+  openmates apps ${app} ${skill} --input '${buildInputUsageExample(schemaParams, example)}'
 
 Run with --help for full parameter details:
   openmates apps ${app} ${skill} --help
@@ -40699,7 +41261,7 @@ App details:     openmates apps info <app-id>`
             `
 Usage:
   openmates apps ${app} ${skill} <value>
-  openmates apps ${app} ${skill} --input '{"requests": [{"${schemaParams[0]?.name ?? "query"}": "..."}]}'`
+  openmates apps ${app} ${skill} --input '${buildInputUsageExample(schemaParams)}'`
           );
         } else {
           console.error(
@@ -40844,17 +41406,38 @@ async function pollCodeRunStatus(client, statusPath, apiKey, jsonMode) {
   }
 }
 function buildSkillInput(flags, inlineTokens, schemaParams) {
+  const usesFlatInput = schemaParams?.some((p) => p.inputShape === "flat") ?? false;
   if (typeof flags.input === "string") {
-    return JSON.parse(flags.input);
+    const parsed = JSON.parse(flags.input);
+    if (usesFlatInput && Array.isArray(parsed.requests) && parsed.requests.length === 1) {
+      const firstRequest = parsed.requests[0];
+      if (firstRequest && typeof firstRequest === "object") {
+        return firstRequest;
+      }
+    }
+    return parsed;
   }
   const inlineText = inlineTokens.join(" ").trim();
   if (inlineText) {
-    const required = (schemaParams ?? []).filter((p) => p.required);
-    const paramName = required.length === 1 ? required[0].name : "query";
+    const required = getEffectiveRequiredParams(schemaParams ?? []);
+    const flatLocationParam = usesFlatInput ? (schemaParams ?? []).find((p) => p.name === "location") : void 0;
+    const paramName = required.length === 1 ? required[0].name : flatLocationParam?.name ?? "query";
+    if (usesFlatInput) return { [paramName]: inlineText };
     return { requests: [{ [paramName]: inlineText }] };
   }
   return {};
 }
+function getEffectiveRequiredParams(schemaParams) {
+  const required = schemaParams.filter((p) => p.required);
+  if (required.length > 0) return required;
+  const flatLocationParam = schemaParams.find((p) => p.inputShape === "flat" && p.name === "location");
+  return flatLocationParam ? [flatLocationParam] : [];
+}
+function buildInputUsageExample(schemaParams, exampleItem) {
+  const item = exampleItem ?? { [schemaParams[0]?.name ?? "query"]: "..." };
+  if (schemaParams.some((p) => p.inputShape === "flat")) return JSON.stringify(item);
+  return JSON.stringify({ requests: [item] });
+}
 async function suggestAppOrSkill(client, app, skill, apiKey) {
   try {
     const data = await client.listApps(apiKey);
@@ -40982,6 +41565,75 @@ async function handleEmbeds(client, subcommand, rest, flags) {
     }
     return;
   }
+  if (subcommand === "versions") {
+    const action = rest[0];
+    const embedId = rest[1];
+    if (!action || !embedId || !["list", "show", "restore"].includes(action)) {
+      console.error("Usage: openmates embeds versions <list|show|restore> <embed-id> [--version <n>]\n");
+      printEmbedsHelp();
+      process.exit(1);
+    }
+    if (action === "list") {
+      const versions = await client.listEmbedVersions(embedId);
+      if (flags.json === true) {
+        printJson2(versions);
+      } else {
+        process.stdout.write(`
+\x1B[1mEmbed versions\x1B[0m ${versions.embed_id}
+`);
+        for (const version2 of versions.versions) {
+          const marker = version2.version_number === versions.current_version ? " (current)" : "";
+          const date = new Date(version2.created_at * 1e3).toISOString();
+          process.stdout.write(`  v${version2.version_number}${marker}  ${date}
+`);
+        }
+        if (versions.readonly) process.stdout.write("\x1B[2mRead-only shared history\x1B[0m\n");
+      }
+      return;
+    }
+    const version = typeof flags.version === "string" ? parseInt(flags.version, 10) : NaN;
+    if (!Number.isFinite(version) || version <= 0) {
+      console.error("Missing or invalid --version <n>.");
+      process.exit(1);
+    }
+    if (action === "show") {
+      const result = await client.getEmbedVersion(embedId, version);
+      if (typeof result.content !== "string") {
+        throw new Error("Embed version content was not available after local reconstruction.");
+      }
+      if (typeof flags.output === "string") {
+        writeFileSync4(flags.output, result.content, "utf-8");
+        if (flags.json === true) {
+          printJson2({ ...result, output: flags.output });
+        } else {
+          process.stdout.write(`Wrote ${result.embed_id} v${result.version_number} to ${flags.output}
+`);
+        }
+      } else if (flags.json === true) {
+        printJson2(result);
+      } else {
+        process.stdout.write(`
+\x1B[1m${result.embed_id} v${result.version_number}\x1B[0m
+`);
+        process.stdout.write(`${result.content}
+`);
+      }
+      return;
+    }
+    if (flags.yes !== true) {
+      await confirmOrExit(`Restore embed ${embedId} to version ${version}? This creates a new latest version. [y/N] `);
+    }
+    const restored = await client.restoreEmbedVersion(embedId, version);
+    if (flags.json === true) {
+      printJson2(restored);
+    } else {
+      process.stdout.write(
+        `Restored v${restored.restored_from_version} as new v${restored.version_number} for ${restored.embed_id}.
+`
+      );
+    }
+    return;
+  }
   console.error(`Unknown embeds subcommand '${subcommand}'.
 `);
   printEmbedsHelp();
@@ -43092,7 +43744,9 @@ ${data.description}
     }
     process.stdout.write(`\x1B[1mExample\x1B[0m
 `);
-    const exampleJson = JSON.stringify({ requests: [exampleItem] }, null, 2).split("\n").map((l) => `  ${l}`).join("\n");
+    const usesFlatInput = params.some((p) => p.inputShape === "flat");
+    const examplePayload = usesFlatInput ? exampleItem : { requests: [exampleItem] };
+    const exampleJson = JSON.stringify(examplePayload, null, 2).split("\n").map((l) => `  ${l}`).join("\n");
     process.stdout.write(
       `  \x1B[2mopenmates apps ${appId} ${data.id} --input '\x1B[0m
 `
@@ -44056,13 +44710,20 @@ function printEmbedsHelp() {
   console.log(`Embeds commands:
   openmates embeds show <embed-id> [--json]
   openmates embeds share <embed-id> [--expires <seconds>] [--password <pwd>] [--json]
+  openmates embeds versions list <embed-id> [--json]
+  openmates embeds versions show <embed-id> --version <n> [--output <path>] [--json]
+  openmates embeds versions restore <embed-id> --version <n> [--yes] [--json]
 
 'show' displays the full decrypted content of an embed.
+The 'versions' commands list, inspect, and non-destructively restore history.
 The embed ID can be the full UUID or just the first 8 characters.
 Embed IDs are shown when viewing chat conversations (openmates chats show).
 
 Examples:
-  openmates embeds show a3f2b1c4`);
+  openmates embeds show a3f2b1c4
+  openmates embeds versions list a3f2b1c4
+  openmates embeds versions show a3f2b1c4 --version 1
+  openmates embeds versions restore a3f2b1c4 --version 1 --yes`);
 }
 function printInspirationsHelp() {
   console.log(`Inspirations command:

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   getExtForLang,
   serializeToYaml
-} from "./chunk-UG4LLEOG.js";
+} from "./chunk-MWM6T3MG.js";
 import "./chunk-AXNRPVLE.js";
 export {
   getExtForLang,

package/dist/index.d.ts

@@ -226,6 +226,29 @@ interface SubChatApprovalRequest {
     existingSubChats: number | null;
     remainingSubChats: number | null;
 }
+interface ConnectedAccountDirectoryEntry {
+    connected_account_id: string;
+    app_id: string;
+    account_ref: string;
+    label: string;
+    capabilities: string[];
+    runtime_modes?: Record<string, string>;
+}
+interface ConnectedAccountTurnTokenRefInput {
+    connected_account_id: string;
+    app_id: string;
+    allowed_actions: string[];
+    refresh_token_envelope: Record<string, unknown>;
+    action_scope?: Record<string, unknown>;
+}
+interface ConnectedAccountTurnTokenRef {
+    connected_account_id: string;
+    app_id: string;
+    turn_token_ref: string;
+    allowed_actions: string[];
+    action_scope?: Record<string, unknown>;
+    expires_at: number;
+}
 /** A single field definition within a memory type schema. */
 interface MemoryFieldDef {
     type: string;
@@ -266,6 +289,7 @@ interface SkillParam {
     description: string;
     required: boolean;
     default?: unknown;
+    inputShape?: "requests" | "flat";
 }
 interface ChatListPage {
     chats: ChatListItem[];
@@ -297,6 +321,35 @@ interface DecryptedEmbed {
     skillId: string | null;
     createdAt: number | null;
 }
+interface EmbedVersionMeta {
+    version_number: number;
+    created_at: number;
+    has_snapshot: boolean;
+    has_patch: boolean;
+    encrypted_snapshot?: string | null;
+    encrypted_patch?: string | null;
+}
+interface EmbedVersionsResponse {
+    embed_id: string;
+    current_version: number;
+    versions: EmbedVersionMeta[];
+    readonly: boolean;
+}
+interface EmbedVersionContentResponse {
+    embed_id: string;
+    version_number: number;
+    current_version: number;
+    content?: string;
+    rows?: EmbedVersionMeta[];
+    readonly: boolean;
+}
+interface EmbedVersionRestoreResponse {
+    embed_id: string;
+    restored_from_version: number;
+    version_number: number;
+    content: string;
+    content_hash: string;
+}
 /** Video metadata attached to a daily inspiration. */
 interface DailyInspirationVideo {
     youtube_id: string;
@@ -449,6 +502,11 @@ declare class OpenMatesClient {
     constructor(options?: OpenMatesClientOptions);
     static load(options?: OpenMatesClientOptions): OpenMatesClient;
     hasSession(): boolean;
+    createTurnTokenRefs(params: {
+        chatId: string;
+        messageId: string;
+        refs: ConnectedAccountTurnTokenRefInput[];
+    }): Promise<ConnectedAccountTurnTokenRef[]>;
     loginWithPairAuth(): Promise<void>;
     whoAmI(): Promise<Record<string, unknown>>;
     logout(): Promise<void>;
@@ -589,6 +647,10 @@ declare class OpenMatesClient {
         encryptedEmbeds?: EncryptedEmbed[];
         /** Prepared embeds to encrypt after the real chat/message IDs are known. */
         preparedEmbeds?: PreparedEmbed[];
+        /** Redacted connected-account directory for AI-visible account selection. */
+        connectedAccountDirectory?: ConnectedAccountDirectoryEntry[];
+        /** Refresh-token envelopes to convert into short-lived token refs before send. */
+        connectedAccountTokenRefInputs?: ConnectedAccountTurnTokenRefInput[];
     }): Promise<{
         status: "completed" | "waiting_for_user";
         chatId: string;
@@ -823,6 +885,12 @@ declare class OpenMatesClient {
      * @returns Full share URL, e.g. https://openmates.org/share/embed/{id}#key={blob}
      */
     createEmbedShareLink(embedIdOrShort: string, durationSeconds?: ShareDuration, password?: string): Promise<string>;
+    listEmbedVersions(embedIdOrShort: string): Promise<EmbedVersionsResponse>;
+    getEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionContentResponse>;
+    restoreEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionRestoreResponse>;
+    private reconstructEncryptedEmbedVersion;
+    private formatEmbedVersionError;
+    private resolveEmbedId;
     /**
      * Build the context needed for CLI mention resolution.
      * Fetches apps (with skills, focus modes, memory categories) and

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   getExtForLang,
   parseNewChatSuggestionText,
   serializeToYaml
-} from "./chunk-UG4LLEOG.js";
+} from "./chunk-MWM6T3MG.js";
 import "./chunk-AXNRPVLE.js";
 export {
   MATE_NAMES,

package/package.json

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