openmates 0.11.0-alpha.16 → 0.11.0-alpha.17

package/dist/{chunk-SFTCIVE2.js → chunk-AXNRPVLE.js}

@@ -23,6 +23,49 @@ function getUploadOrigin(apiUrl) {
   }
   return "https://app.openmates.org";
 }
+function getUploadMimeType(filename) {
+  const ext = extname(filename).toLowerCase();
+  switch (ext) {
+    case ".jpg":
+    case ".jpeg":
+      return "image/jpeg";
+    case ".png":
+      return "image/png";
+    case ".webp":
+      return "image/webp";
+    case ".gif":
+      return "image/gif";
+    case ".heic":
+      return "image/heic";
+    case ".heif":
+      return "image/heif";
+    case ".bmp":
+      return "image/bmp";
+    case ".tif":
+    case ".tiff":
+      return "image/tiff";
+    case ".svg":
+      return "image/svg+xml";
+    case ".pdf":
+      return "application/pdf";
+    case ".mp3":
+      return "audio/mpeg";
+    case ".m4a":
+    case ".mp4":
+      return "audio/mp4";
+    case ".wav":
+      return "audio/wav";
+    case ".webm":
+      return "audio/webm";
+    case ".ogg":
+    case ".oga":
+      return "audio/ogg";
+    case ".aac":
+      return "audio/aac";
+    default:
+      return "application/octet-stream";
+  }
+}
 async function uploadFile(filePath, session) {
   const filename = basename(filePath);
   const fileBytes = readFileSync(filePath);
@@ -36,7 +79,7 @@ async function uploadFile(filePath, session) {
   let lastError;
   for (let attempt = 1; attempt <= UPLOAD_MAX_ATTEMPTS; attempt++) {
     try {
-      const blob = new Blob([fileBytes]);
+      const blob = new Blob([fileBytes], { type: getUploadMimeType(filename) });
       const formData = new FormData();
       formData.append("file", blob, filename);
       response = await fetch(uploadUrl, {
@@ -89,6 +132,73 @@ async function uploadFile(filePath, session) {
   const data = await response.json();
   return data;
 }
+async function transcribeUploadedAudio(uploadResult, filename, session, options = {}) {
+  const s3Key = uploadResult.files?.original?.s3_key ?? Object.values(uploadResult.files ?? {})[0]?.s3_key;
+  if (!s3Key) {
+    throw new Error("Upload succeeded but no audio file key was returned.");
+  }
+  const cookies = [];
+  if (session.cookies?.auth_refresh_token) {
+    cookies.push(`auth_refresh_token=${session.cookies.auth_refresh_token}`);
+  }
+  const requestItem = {
+    id: options.requestId ?? uploadResult.embed_id,
+    embed_id: uploadResult.embed_id,
+    s3_key: s3Key,
+    s3_base_url: uploadResult.s3_base_url,
+    aes_key: uploadResult.aes_key,
+    aes_nonce: uploadResult.aes_nonce,
+    vault_wrapped_aes_key: uploadResult.vault_wrapped_aes_key,
+    filename,
+    mime_type: uploadResult.content_type
+  };
+  if (options.chatId) {
+    requestItem.chat_id = options.chatId;
+  }
+  const response = await fetch(
+    `${session.apiUrl.replace(/\/$/, "")}/v1/apps/audio/skills/transcribe`,
+    {
+      method: "POST",
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        ...cookies.length > 0 ? { Cookie: cookies.join("; ") } : {}
+      },
+      body: JSON.stringify({ requests: [requestItem] }),
+      signal: AbortSignal.timeout(10 * 60 * 1e3)
+    }
+  );
+  if (!response.ok) {
+    let detail = `Transcription failed (HTTP ${response.status}).`;
+    try {
+      const data2 = await response.json();
+      detail = data2.detail ?? data2.error ?? detail;
+    } catch {
+    }
+    throw new Error(detail);
+  }
+  const data = await response.json();
+  if (data.success === false) {
+    throw new Error(data.error ?? "Transcription failed.");
+  }
+  const requestId = options.requestId ?? uploadResult.embed_id;
+  const group = data.data?.results?.find((item) => item.id === requestId) ?? data.data?.results?.[0];
+  const result = group?.results?.[0];
+  if (!result) {
+    throw new Error(group?.error ?? "Transcription response did not include a result.");
+  }
+  if (result.error) {
+    throw new Error(result.error);
+  }
+  return {
+    transcript: result.transcript ?? null,
+    transcript_original: result.transcript_original ?? null,
+    transcript_corrected: result.transcript_corrected ?? null,
+    use_corrected: result.use_corrected ?? null,
+    correction_model: result.correction_model ?? null,
+    model: result.model ?? null
+  };
+}
 function getProfileImageMime(filename) {
   const ext = extname(filename).toLowerCase();
   if (ext === ".jpg" || ext === ".jpeg") return "image/jpeg";
@@ -127,5 +237,6 @@ async function uploadProfileImage(filePath, session) {
 
 export {
   uploadFile,
+  transcribeUploadedAudio,
   uploadProfileImage
 };

package/dist/{chunk-TUPR2SL3.js → chunk-LOVSX3MQ.js}

@@ -1,6 +1,7 @@
 import {
+  transcribeUploadedAudio,
   uploadFile
-} from "./chunk-SFTCIVE2.js";
+} from "./chunk-AXNRPVLE.js";
 
 // src/client.ts
 import { randomUUID as randomUUID2 } from "crypto";
@@ -2687,6 +2688,15 @@ var OpenMatesClient = class _OpenMatesClient {
         }
       }
     }
+    if (params.preparedEmbeds && params.preparedEmbeds.length > 0) {
+      messagePayload.embeds = params.preparedEmbeds.map((embed) => ({
+        embed_id: embed.embedId,
+        type: embed.type,
+        content: embed.content,
+        status: embed.status,
+        text_preview: embed.textPreview
+      }));
+    }
     const encryptedEmbeds = [...params.encryptedEmbeds ?? []];
     if (!params.incognito && params.preparedEmbeds && params.preparedEmbeds.length > 0) {
       const masterKey = this.getMasterKeyBytes();
@@ -3328,7 +3338,7 @@ var OpenMatesClient = class _OpenMatesClient {
     return this.settingsPost("user/username", { username });
   }
   async updateProfileImage(filePath) {
-    const { uploadProfileImage } = await import("./uploadService-3CAJXU4L.js");
+    const { uploadProfileImage } = await import("./uploadService-S464XJRA.js");
     const result = await uploadProfileImage(filePath, this.requireSession());
     if (result.status === "rejected") {
       throw new Error(result.detail ?? "Profile image rejected by content safety checks.");
@@ -5100,6 +5110,16 @@ var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([
   "tif",
   "svg"
 ]);
+var AUDIO_EXTENSIONS = /* @__PURE__ */ new Set([
+  "mp3",
+  "m4a",
+  "mp4",
+  "wav",
+  "webm",
+  "ogg",
+  "oga",
+  "aac"
+]);
 function isEnvFile(filename) {
   const lower = filename.toLowerCase();
   return lower === ".env" || lower.startsWith(".env.") || lower === ".envrc";
@@ -5120,6 +5140,9 @@ function isImageFile(filename) {
 function isPDFFile(filename) {
   return getExt(filename) === "pdf";
 }
+function isAudioFile(filename) {
+  return AUDIO_EXTENSIONS.has(getExt(filename));
+}
 var LANGUAGE_MAP = {
   ts: "typescript",
   tsx: "typescript",
@@ -5264,10 +5287,14 @@ function processFiles(filePaths, redactor) {
       const result = processPDFFile(resolvedPath, filename);
       if (result) embeds.push(result);
       else errors.push({ path: rawPath, error: "Failed to process PDF" });
+    } else if (isAudioFile(filename)) {
+      const result = processAudioFile(resolvedPath, filename);
+      if (result) embeds.push(result);
+      else errors.push({ path: rawPath, error: "Failed to process audio" });
     } else {
       errors.push({
         path: rawPath,
-        error: `Unsupported file type: .${ext}. Supported: code/text, images, PDFs.`
+        error: `Unsupported file type: .${ext}. Supported: code/text, images, PDFs, audio.`
       });
     }
   }
@@ -5396,6 +5423,40 @@ function processPDFFile(filePath, filename) {
     return null;
   }
 }
+function processAudioFile(filePath, filename) {
+  try {
+    const embedId = generateEmbedId();
+    const embedContent = toonEncodeContent({
+      app_id: "audio",
+      skill_id: "transcribe",
+      type: "audio-recording",
+      status: "uploading",
+      filename
+    });
+    const embed = {
+      embedId,
+      type: "audio-recording",
+      content: embedContent,
+      textPreview: filename,
+      status: "processing"
+    };
+    return {
+      embed,
+      referenceBlock: createEmbedReferenceBlock("audio-recording", embedId),
+      displayName: filename,
+      secretsRedacted: false,
+      zeroKnowledge: false,
+      requiresUpload: true,
+      localPath: filePath
+    };
+  } catch (e) {
+    process.stderr.write(
+      `\x1B[31mError:\x1B[0m Failed to process ${filename}: ${e instanceof Error ? e.message : String(e)}
+`
+    );
+    return null;
+  }
+}
 function formatEmbedsForMessage(embeds) {
   if (embeds.length === 0) return "";
   return "\n" + embeds.map((e) => e.referenceBlock).join("\n");
@@ -6514,7 +6575,8 @@ function formatTs(ts) {
 
 // src/server.ts
 import { execSync, spawn as nodeSpawn } from "child_process";
-import { copyFileSync, existsSync as existsSync5, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
+import { randomBytes as randomBytes2 } from "crypto";
+import { copyFileSync, existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
 import { createInterface as createInterface2 } from "readline";
 import { homedir as homedir5 } from "os";
 import { join as join3, resolve as resolve3 } from "path";
@@ -6552,16 +6614,17 @@ function removeServerConfig() {
     rmSync2(filePath);
   }
 }
-var COMPOSE_MARKER = join2("backend", "core", "docker-compose.yml");
+var SOURCE_COMPOSE_MARKER = join2("backend", "core", "docker-compose.yml");
+var IMAGE_COMPOSE_MARKER = join2("backend", "core", "docker-compose.selfhost.yml");
 function isOpenMatesDir(dir) {
-  return existsSync4(join2(dir, COMPOSE_MARKER));
+  return existsSync4(join2(dir, SOURCE_COMPOSE_MARKER)) || existsSync4(join2(dir, IMAGE_COMPOSE_MARKER));
 }
 function resolveServerPath(flags) {
   if (typeof flags.path === "string" && flags.path) {
     const explicit = resolve2(flags.path);
     if (!isOpenMatesDir(explicit)) {
       throw new Error(
-        `${explicit} does not appear to be an OpenMates installation (missing ${COMPOSE_MARKER}).`
+        `${explicit} does not appear to be an OpenMates installation (missing ${SOURCE_COMPOSE_MARKER} or ${IMAGE_COMPOSE_MARKER}).`
       );
     }
     return explicit;
@@ -6580,11 +6643,67 @@ function resolveServerPath(flags) {
 }
 
 // src/server.ts
-var COMPOSE_FILE = join3("backend", "core", "docker-compose.yml");
+var SOURCE_COMPOSE_FILE = join3("backend", "core", "docker-compose.yml");
+var IMAGE_COMPOSE_FILE = join3("backend", "core", "docker-compose.selfhost.yml");
 var COMPOSE_OVERRIDE = join3("backend", "core", "docker-compose.override.yml");
 var DEFAULT_INSTALL_PATH = join3(homedir5(), "openmates");
 var REPO_URL = "https://github.com/glowingkitty/OpenMates.git";
 var DEV_BRANCH = "dev";
+var DEFAULT_IMAGE_REGISTRY = "ghcr.io/glowingkitty";
+var MINIMAL_ENV_TEMPLATE = `# OpenMates self-host image-mode environment
+SECRET__MISTRAL_AI__API_KEY=
+SECRET__CEREBRAS__API_KEY=
+SECRET__GROQ__API_KEY=
+SECRET__OPENAI__API_KEY=
+SECRET__ANTHROPIC__API_KEY=
+SECRET__GOOGLE_AI_STUDIO__API_KEY=
+SECRET__OPENROUTER__API_KEY=
+SECRET__TOGETHER__API_KEY=
+SECRET__BRAVE__API_KEY=
+SECRET__FIRECRAWL__API_KEY=
+SECRET__CONTEXT7__API_KEY=
+DATABASE_ADMIN_EMAIL=admin@example.com
+DATABASE_ADMIN_PASSWORD=
+DATABASE_NAME=directus
+DATABASE_USERNAME=directus
+DATABASE_PASSWORD=
+DIRECTUS_TOKEN=
+DIRECTUS_SECRET=
+DRAGONFLY_PASSWORD=
+OPENOBSERVE_ROOT_EMAIL=admin@openmates.internal
+OPENOBSERVE_ROOT_PASSWORD=
+INTERNAL_API_SHARED_TOKEN=
+TUNNEL_TRIGGER_SECRET=<PLACEHOLDER>
+SERVER_ENVIRONMENT=production
+FRONTEND_URLS="http://localhost:5173"
+TRUSTED_PROXY_IPS="172.16.0.0/12"
+CORE_SIDECAR_URL=http://admin-sidecar:8001
+CLEAR_CACHE_ON_UPDATE=true
+SIGNUP_LIMIT=20
+SELF_HOST_SIGNUP_MODE=invite_only
+SELF_HOST_SIGNUP_ALLOWED_DOMAINS=
+SELF_HOST_FIRST_INVITE_CODE=
+APPLICATION_PREVIEW_ORIGIN=
+OPENMATES_IMAGE_REGISTRY=${DEFAULT_IMAGE_REGISTRY}
+OPENMATES_IMAGE_TAG=
+GIT_WORK_DIR=
+DOCKER_GID=999
+`;
+var VAULT_CONFIG_TEMPLATE = `# Minimal Vault configuration
+listener "tcp" {
+  address = "0.0.0.0:8200"
+  tls_disable = true
+}
+
+storage "file" {
+  path = "/vault/file"
+}
+
+api_addr = "http://0.0.0.0:8200"
+ui = false
+disable_mlock = true
+log_level = "info"
+`;
 var LLM_PROVIDER_ENV_KEYS = /* @__PURE__ */ new Set([
   "SECRET__MISTRAL_AI__API_KEY",
   "SECRET__CEREBRAS__API_KEY",
@@ -6605,8 +6724,21 @@ function runInteractive(cmd, args, cwd) {
     child.on("error", reject);
   });
 }
-function composeArgs(installPath, withOverrides) {
-  const args = ["compose", "--env-file", ".env", "-f", COMPOSE_FILE];
+function loadConfigForInstallPath(installPath) {
+  const config = loadServerConfig();
+  return config?.installPath === installPath ? config : null;
+}
+function getInstallMode(installPath, config = loadConfigForInstallPath(installPath)) {
+  if (config?.installMode) return config.installMode;
+  if (existsSync5(join3(installPath, IMAGE_COMPOSE_FILE))) return "image";
+  return "source";
+}
+function shouldPullImages() {
+  return process.env.OPENMATES_SKIP_IMAGE_PULL !== "1";
+}
+function composeArgs(installPath, withOverrides, installMode = getInstallMode(installPath)) {
+  const composeFile = installMode === "image" ? IMAGE_COMPOSE_FILE : SOURCE_COMPOSE_FILE;
+  const args = ["compose", "--env-file", ".env", "-f", composeFile];
   if (withOverrides && existsSync5(join3(installPath, COMPOSE_OVERRIDE))) {
     args.push("-f", COMPOSE_OVERRIDE);
   }
@@ -6651,6 +6783,80 @@ function getPackageVersion() {
     return "";
   }
 }
+function getDefaultImageTag() {
+  const version = getPackageVersion();
+  return version ? `v${version}` : "dev";
+}
+function defaultTemplateRefForVersion(version) {
+  return /-(alpha|beta|rc)(\.|\d|$)/.test(version) ? DEV_BRANCH : `v${version}`;
+}
+function randomHex(bytes) {
+  return randomBytes2(bytes).toString("hex");
+}
+function generateInviteCode() {
+  const digits = Array.from(randomBytes2(12), (byte) => String(byte % 10)).join("");
+  return `${digits.slice(0, 4)}-${digits.slice(4, 8)}-${digits.slice(8, 12)}`;
+}
+function getEnvVar(content, name) {
+  const match = content.match(new RegExp(`^${name}=(.*)$`, "m"));
+  return match?.[1]?.replace(/^"|"$/g, "") ?? "";
+}
+function setEnvVar(content, name, value) {
+  const line = `${name}=${value}`;
+  const pattern = new RegExp(`^${name}=.*$`, "m");
+  if (pattern.test(content)) {
+    return content.replace(pattern, line);
+  }
+  const separator = content.endsWith("\n") ? "" : "\n";
+  return `${content}${separator}${line}
+`;
+}
+function setEnvIfEmpty(content, name, value) {
+  return getEnvVar(content, name) ? content : setEnvVar(content, name, value);
+}
+async function fetchText(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to download ${url}: HTTP ${response.status}`);
+  }
+  return response.text();
+}
+async function loadSelfHostComposeTemplate(version) {
+  const templateDir = process.env.OPENMATES_SELFHOST_TEMPLATE_DIR;
+  if (templateDir) {
+    return readFileSync5(join3(resolve3(templateDir), IMAGE_COMPOSE_FILE), "utf-8");
+  }
+  const overrideUrl = process.env.OPENMATES_SELFHOST_COMPOSE_URL;
+  if (overrideUrl) {
+    return fetchText(overrideUrl);
+  }
+  const ref = defaultTemplateRefForVersion(version);
+  return fetchText(
+    `https://raw.githubusercontent.com/glowingkitty/OpenMates/${ref}/backend/core/docker-compose.selfhost.yml`
+  );
+}
+async function writeImageModeRuntimeFiles(installPath, imageTag) {
+  const coreDir = join3(installPath, "backend", "core");
+  const vaultConfigDir = join3(coreDir, "vault", "config");
+  mkdirSync3(vaultConfigDir, { recursive: true });
+  writeFileSync3(join3(coreDir, "docker-compose.selfhost.yml"), await loadSelfHostComposeTemplate(getPackageVersion()));
+  writeFileSync3(join3(vaultConfigDir, "vault.hcl"), VAULT_CONFIG_TEMPLATE);
+  const envPath = join3(installPath, ".env");
+  let envContent = existsSync5(envPath) ? readFileSync5(envPath, "utf-8") : MINIMAL_ENV_TEMPLATE;
+  envContent = setEnvIfEmpty(envContent, "DATABASE_ADMIN_PASSWORD", randomHex(12));
+  envContent = setEnvIfEmpty(envContent, "DATABASE_PASSWORD", randomHex(12));
+  envContent = setEnvIfEmpty(envContent, "DIRECTUS_TOKEN", randomHex(32));
+  envContent = setEnvIfEmpty(envContent, "DIRECTUS_SECRET", randomHex(32));
+  envContent = setEnvIfEmpty(envContent, "DRAGONFLY_PASSWORD", randomHex(12));
+  envContent = setEnvIfEmpty(envContent, "OPENOBSERVE_ROOT_PASSWORD", randomHex(32));
+  envContent = setEnvIfEmpty(envContent, "INTERNAL_API_SHARED_TOKEN", randomHex(32));
+  envContent = setEnvIfEmpty(envContent, "SELF_HOST_FIRST_INVITE_CODE", generateInviteCode());
+  envContent = setEnvVar(envContent, "OPENMATES_IMAGE_TAG", imageTag);
+  envContent = setEnvVar(envContent, "OPENMATES_IMAGE_REGISTRY", DEFAULT_IMAGE_REGISTRY);
+  envContent = setEnvVar(envContent, "GIT_WORK_DIR", installPath);
+  writeFileSync3(envPath, envContent.endsWith("\n") ? envContent : `${envContent}
+`);
+}
 function defaultCloneBranchForVersion(version) {
   return /-(alpha|beta|rc)(\.|\d|$)/.test(version) ? DEV_BRANCH : null;
 }
@@ -6700,9 +6906,9 @@ async function serverStatus(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
-  const args = [...composeArgs(installPath, withOverrides), "ps"];
+  const args = [...composeArgs(installPath, withOverrides, getInstallMode(installPath, config)), "ps"];
   if (flags.json === true) {
     args.push("--format", "json");
   }
@@ -6715,13 +6921,20 @@ async function serverStart(flags) {
   ensureGitWorkDirEnv(installPath);
   warnIfMissingLlmCredentials(installPath);
   const withOverrides = flags["with-overrides"] === true;
-  const args = [...composeArgs(installPath, withOverrides), "up", "-d"];
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
+  const installMode = getInstallMode(installPath, config);
+  const pullArgs = [...composeArgs(installPath, withOverrides, installMode), "pull"];
+  const args = [...composeArgs(installPath, withOverrides, installMode), "up", "-d"];
   if (config && withOverrides && config.composeProfile !== "full") {
     saveServerConfig({ ...config, composeProfile: "full" });
   }
   console.error("Starting OpenMates server...");
-  const code = await runInteractive("docker", args, installPath);
+  let code = 0;
+  if (installMode === "image" && shouldPullImages()) {
+    code = await runInteractive("docker", pullArgs, installPath);
+    if (code !== 0) process.exit(code);
+  }
+  code = await runInteractive("docker", args, installPath);
   if (code !== 0) process.exit(code);
   if (flags.json === true) {
     printJson({ command: "start", status: "success", path: installPath });
@@ -6739,9 +6952,9 @@ async function serverStop(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
-  const args = [...composeArgs(installPath, withOverrides), "down"];
+  const args = [...composeArgs(installPath, withOverrides, getInstallMode(installPath, config)), "down"];
   console.error("Stopping OpenMates server...");
   const code = await runInteractive("docker", args, installPath);
   if (code !== 0) process.exit(code);
@@ -6755,26 +6968,32 @@ async function serverRestart(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
+  const installMode = getInstallMode(installPath, config);
   if (flags.rebuild === true) {
+    if (installMode === "image") {
+      throw new Error(
+        "Image-mode installs use prebuilt images and cannot rebuild locally. Run 'openmates server update' to pull newer images, or reinstall with --from-source to build from source."
+      );
+    }
     console.error("Rebuilding OpenMates server (this may take a few minutes)...");
-    const downArgs = [...composeArgs(installPath, withOverrides), "down"];
+    const downArgs = [...composeArgs(installPath, withOverrides, installMode), "down"];
     let code = await runInteractive("docker", downArgs, installPath);
     if (code !== 0) process.exit(code);
     try {
       exec("docker volume rm openmates-cache-data", installPath);
     } catch {
     }
-    const buildArgs = [...composeArgs(installPath, withOverrides), "build"];
+    const buildArgs = [...composeArgs(installPath, withOverrides, installMode), "build"];
     code = await runInteractive("docker", buildArgs, installPath);
     if (code !== 0) process.exit(code);
-    const upArgs = [...composeArgs(installPath, withOverrides), "up", "-d"];
+    const upArgs = [...composeArgs(installPath, withOverrides, installMode), "up", "-d"];
     code = await runInteractive("docker", upArgs, installPath);
     if (code !== 0) process.exit(code);
   } else {
     console.error("Restarting OpenMates server...");
-    const args = [...composeArgs(installPath, withOverrides), "restart"];
+    const args = [...composeArgs(installPath, withOverrides, installMode), "restart"];
     const code = await runInteractive("docker", args, installPath);
     if (code !== 0) process.exit(code);
   }
@@ -6788,9 +7007,9 @@ async function serverLogs(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
-  const args = [...composeArgs(installPath, withOverrides), "logs"];
+  const args = [...composeArgs(installPath, withOverrides, getInstallMode(installPath, config)), "logs"];
   if (flags.follow === true || flags.f === true) {
     args.push("--follow");
   }
@@ -6808,14 +7027,56 @@ async function serverLogs(flags) {
   if (code !== 0) process.exit(code);
 }
 async function serverInstall(flags) {
-  requireGit();
   const installPath = typeof flags.path === "string" ? resolve3(flags.path) : DEFAULT_INSTALL_PATH;
   const sourcePath = typeof flags["source-path"] === "string" ? resolve3(flags["source-path"]) : null;
-  if (existsSync5(join3(installPath, "setup.sh"))) {
+  const fromSource = flags["from-source"] === true || sourcePath !== null;
+  if (existsSync5(join3(installPath, SOURCE_COMPOSE_FILE)) || existsSync5(join3(installPath, IMAGE_COMPOSE_FILE))) {
     console.error(`OpenMates already exists at ${installPath}.`);
     console.error("Use 'openmates server update' to update, or choose a different --path.");
     process.exit(1);
   }
+  if (!fromSource) {
+    requireDocker();
+    mkdirSync3(installPath, { recursive: true });
+    if (typeof flags["env-path"] === "string") {
+      const envSource = resolve3(flags["env-path"]);
+      if (!existsSync5(envSource)) {
+        throw new Error(`Env file not found: ${envSource}`);
+      }
+      copyFileSync(envSource, join3(installPath, ".env"));
+      console.error(`Copied ${envSource} to ${installPath}/.env`);
+    }
+    const imageTag = typeof flags["image-tag"] === "string" ? flags["image-tag"] : getDefaultImageTag();
+    console.error(`Preparing OpenMates image-mode install at ${installPath}...`);
+    await writeImageModeRuntimeFiles(installPath, imageTag);
+    try {
+      exec("docker network create openmates", installPath);
+    } catch {
+    }
+    saveServerConfig({
+      installPath,
+      installedAt: Date.now(),
+      composeProfile: "core",
+      installMode: "image",
+      imageTag
+    });
+    if (flags.json === true) {
+      printJson({ command: "install", status: "success", path: installPath, mode: "image", imageTag });
+    } else {
+      const firstInvite = getEnvVar(readFileSync5(join3(installPath, ".env"), "utf-8"), "SELF_HOST_FIRST_INVITE_CODE");
+      console.log(`
+OpenMates installed at ${installPath}`);
+      console.log(`Mode: image (${DEFAULT_IMAGE_REGISTRY}, tag ${imageTag})`);
+      console.log("\nNext steps:");
+      console.log("  1. Run: openmates server start");
+      console.log("  2. Open http://localhost:5173");
+      if (firstInvite) console.log(`  3. Sign up with invite code: ${firstInvite}`);
+      console.log("  4. After signup, make yourself admin: openmates server make-admin your@email.com");
+      console.log("\nOptional: edit .env first to add LLM provider API keys. Source builds are available with --from-source.");
+    }
+    return;
+  }
+  requireGit();
   const cloneSource = sourcePath ?? REPO_URL;
   const cloneBranch = sourcePath ? null : defaultCloneBranchForVersion(getPackageVersion());
   const cloneArgs = ["clone"];
@@ -6856,10 +7117,11 @@ async function serverInstall(flags) {
   saveServerConfig({
     installPath,
     installedAt: Date.now(),
-    composeProfile: "core"
+    composeProfile: "core",
+    installMode: "source"
   });
   if (flags.json === true) {
-    printJson({ command: "install", status: "success", path: installPath });
+    printJson({ command: "install", status: "success", path: installPath, mode: "source" });
   } else {
     console.log(`
 OpenMates installed at ${installPath}`);
@@ -6871,11 +7133,29 @@ OpenMates installed at ${installPath}`);
   }
 }
 async function serverUpdate(flags) {
-  requireGit();
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
   console.error("Updating OpenMates...");
+  const config = loadConfigForInstallPath(installPath);
+  const withOverrides = config?.composeProfile === "full";
+  const installMode = getInstallMode(installPath, config);
+  if (installMode === "image") {
+    const pullArgs = [...composeArgs(installPath, withOverrides, installMode), "pull"];
+    console.error("Pulling prebuilt images...");
+    let code2 = await runInteractive("docker", pullArgs, installPath);
+    if (code2 !== 0) process.exit(code2);
+    const upArgs2 = [...composeArgs(installPath, withOverrides, installMode), "up", "-d"];
+    code2 = await runInteractive("docker", upArgs2, installPath);
+    if (code2 !== 0) process.exit(code2);
+    if (flags.json === true) {
+      printJson({ command: "update", status: "success", path: installPath, mode: "image" });
+    } else {
+      console.log("Server images pulled and containers restarted.");
+    }
+    return;
+  }
+  requireGit();
   if (flags.force === true) {
     console.error("Stashing local changes...");
     try {
@@ -6903,13 +7183,11 @@ async function serverUpdate(flags) {
     } catch {
     }
   }
-  const config = loadServerConfig();
-  const withOverrides = config?.composeProfile === "full";
-  const buildArgs = [...composeArgs(installPath, withOverrides), "build"];
+  const buildArgs = [...composeArgs(installPath, withOverrides, installMode), "build"];
   console.error("Rebuilding containers...");
   let code = await runInteractive("docker", buildArgs, installPath);
   if (code !== 0) process.exit(code);
-  const upArgs = [...composeArgs(installPath, withOverrides), "up", "-d"];
+  const upArgs = [...composeArgs(installPath, withOverrides, installMode), "up", "-d"];
   code = await runInteractive("docker", upArgs, installPath);
   if (code !== 0) process.exit(code);
   if (flags.json === true) {
@@ -6922,8 +7200,9 @@ async function serverReset(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
+  const installMode = getInstallMode(installPath, config);
   const userDataOnly = flags["delete-user-data-only"] === true;
   if (userDataOnly) {
     console.error("\nWARNING: This will delete all user data (database and cache).");
@@ -6943,24 +7222,26 @@ async function serverReset(flags) {
   }
   console.error("Resetting server...");
   if (userDataOnly) {
-    const downArgs = [...composeArgs(installPath, withOverrides), "down"];
+    const downArgs = [...composeArgs(installPath, withOverrides, installMode), "down"];
     let code = await runInteractive("docker", downArgs, installPath);
     if (code !== 0) process.exit(code);
-    for (const vol of ["openmates-cache-data", "openmates-cms-database-data"]) {
+    for (const vol of ["openmates-cache-data", "openmates-postgres-data", "openmates-cms-database-data"]) {
       try {
         exec(`docker volume rm ${vol}`, installPath);
         console.error(`  Removed volume: ${vol}`);
       } catch {
       }
     }
-    const buildArgs = [...composeArgs(installPath, withOverrides), "build"];
-    code = await runInteractive("docker", buildArgs, installPath);
-    if (code !== 0) process.exit(code);
-    const upArgs = [...composeArgs(installPath, withOverrides), "up", "-d"];
+    if (installMode === "source") {
+      const buildArgs = [...composeArgs(installPath, withOverrides, installMode), "build"];
+      code = await runInteractive("docker", buildArgs, installPath);
+      if (code !== 0) process.exit(code);
+    }
+    const upArgs = [...composeArgs(installPath, withOverrides, installMode), "up", "-d"];
     code = await runInteractive("docker", upArgs, installPath);
     if (code !== 0) process.exit(code);
   } else {
-    const args = [...composeArgs(installPath, withOverrides), "down", "-v"];
+    const args = [...composeArgs(installPath, withOverrides, installMode), "down", "-v"];
     const code = await runInteractive("docker", args, installPath);
     if (code !== 0) process.exit(code);
   }
@@ -7003,7 +7284,7 @@ async function serverUninstall(flags) {
   requireDocker();
   const installPath = resolveServerPath(flags);
   ensureGitWorkDirEnv(installPath);
-  const config = loadServerConfig();
+  const config = loadConfigForInstallPath(installPath);
   const withOverrides = config?.composeProfile === "full";
   const keepData = flags["keep-data"] === true;
   console.error("\nWARNING: This will completely uninstall OpenMates:");
@@ -7025,7 +7306,7 @@ async function serverUninstall(flags) {
     }
   }
   console.error("Uninstalling OpenMates...");
-  const downArgs = [...composeArgs(installPath, withOverrides), "down", "--rmi", "local"];
+  const downArgs = [...composeArgs(installPath, withOverrides, getInstallMode(installPath, config)), "down", "--rmi", "local"];
   if (!keepData) {
     downArgs.push("-v");
   }
@@ -7058,13 +7339,13 @@ OpenMates Server Management
 Usage: openmates server <command> [options]
 
 Commands:
-  install         Install OpenMates server (clone repo + run setup)
+  install         Install OpenMates server (prebuilt GHCR images by default)
   start           Start the server
   stop            Stop the server
   restart         Restart the server
   status          Show server status (container health)
   logs            Display server logs
-  update          Update to latest version (git pull + rebuild)
+  update          Update to latest version (pull images, or git pull + rebuild for source installs)
   make-admin      Grant admin privileges to a user
   reset           Reset server data (requires confirmation)
   uninstall       Completely remove OpenMates (requires confirmation)
@@ -7078,7 +7359,9 @@ Command Options:
   install:
     --path <dir>        Install directory (default: ~/openmates)
     --env-path <file>   Copy a pre-existing .env file during install
-    --source-path <dir> Clone from a local checkout instead of GitHub (CI/testing)
+    --image-tag <tag>   Prebuilt image tag (default: CLI version tag)
+    --from-source       Clone/build from source instead of using prebuilt GHCR images
+    --source-path <dir> Clone from a local checkout instead of GitHub (implies --from-source)
 
   start:
     --with-overrides    Include admin UIs (Directus CMS, Grafana)
@@ -9338,8 +9621,44 @@ async function sendMessageStreaming(client, params, redactor) {
             try {
               const session = client.getSession();
               const uploadResult = await uploadFile(fe.localPath, session);
-              fe.embed.content = toonEncodeContent({
-                type: fe.embed.type === "pdf" ? "pdf" : "image",
+              const embedType = fe.embed.type;
+              const audioTranscription = embedType === "audio-recording" ? await transcribeUploadedAudio(
+                uploadResult,
+                fe.displayName,
+                session,
+                { chatId: params.chatId, requestId: uploadResult.embed_id }
+              ) : null;
+              const uploadedContent = embedType === "audio-recording" ? {
+                app_id: "audio",
+                skill_id: "transcribe",
+                type: "audio-recording",
+                status: "finished",
+                filename: fe.displayName,
+                mime_type: uploadResult.content_type,
+                transcript: audioTranscription?.transcript ?? null,
+                transcript_original: audioTranscription?.transcript_original ?? null,
+                transcript_corrected: audioTranscription?.transcript_corrected ?? null,
+                use_corrected: audioTranscription?.use_corrected ?? null,
+                correction_model: audioTranscription?.correction_model ?? null,
+                model: audioTranscription?.model ?? null,
+                s3_base_url: uploadResult.s3_base_url,
+                files: uploadResult.files,
+                aes_key: uploadResult.aes_key,
+                aes_nonce: uploadResult.aes_nonce,
+                vault_wrapped_aes_key: uploadResult.vault_wrapped_aes_key
+              } : embedType === "pdf" ? {
+                type: "pdf",
+                status: "processing",
+                filename: fe.displayName,
+                page_count: uploadResult.page_count ?? null,
+                content_hash: uploadResult.content_hash,
+                s3_base_url: uploadResult.s3_base_url,
+                files: uploadResult.files,
+                aes_key: uploadResult.aes_key,
+                aes_nonce: uploadResult.aes_nonce,
+                vault_wrapped_aes_key: uploadResult.vault_wrapped_aes_key
+              } : {
+                type: "image",
                 app_id: "images",
                 skill_id: "upload",
                 status: "finished",
@@ -9351,10 +9670,15 @@ async function sendMessageStreaming(client, params, redactor) {
                 aes_nonce: uploadResult.aes_nonce,
                 vault_wrapped_aes_key: uploadResult.vault_wrapped_aes_key,
                 ai_detection: uploadResult.ai_detection
-              });
-              fe.embed.status = fe.embed.type === "pdf" ? "processing" : "finished";
+              };
+              fe.embed.content = toonEncodeContent(uploadedContent);
+              fe.embed.status = embedType === "pdf" ? "processing" : "finished";
               fe.embed.contentHash = uploadResult.content_hash;
               fe.embed.embedId = uploadResult.embed_id;
+              fe.referenceBlock = createEmbedReferenceBlock(
+                embedType,
+                uploadResult.embed_id
+              );
               if (!params.json) {
                 process.stderr.write(
                   `\x1B[32m  \u2713\x1B[0m \x1B[2m${fe.displayName} uploaded\x1B[0m

package/dist/cli.js

@@ -2,8 +2,8 @@
 import {
   getExtForLang,
   serializeToYaml
-} from "./chunk-TUPR2SL3.js";
-import "./chunk-SFTCIVE2.js";
+} from "./chunk-LOVSX3MQ.js";
+import "./chunk-AXNRPVLE.js";
 export {
   getExtForLang,
   serializeToYaml

package/dist/index.js

@@ -7,8 +7,8 @@ import {
   getExtForLang,
   parseNewChatSuggestionText,
   serializeToYaml
-} from "./chunk-TUPR2SL3.js";
-import "./chunk-SFTCIVE2.js";
+} from "./chunk-LOVSX3MQ.js";
+import "./chunk-AXNRPVLE.js";
 export {
   MATE_NAMES,
   MEMORY_TYPE_REGISTRY,

package/dist/{uploadService-3CAJXU4L.js → uploadService-S464XJRA.js}

@@ -1,8 +1,10 @@
 import {
+  transcribeUploadedAudio,
   uploadFile,
   uploadProfileImage
-} from "./chunk-SFTCIVE2.js";
+} from "./chunk-AXNRPVLE.js";
 export {
+  transcribeUploadedAudio,
   uploadFile,
   uploadProfileImage
 };

package/package.json

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